{"id":21525190,"url":"https://github.com/kadraknb/delivery-app","last_synced_at":"2026-04-15T19:33:14.966Z","repository":{"id":167310814,"uuid":"642913412","full_name":"kadraknb/delivery-app","owner":"kadraknb","description":"Nessa aplicação, fui responsável por criar e integrar tanto o back-end quanto o front-end, criando uma plataforma de delivery de cerveja.","archived":false,"fork":false,"pushed_at":"2023-06-22T10:40:00.000Z","size":1915,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-24T05:25:04.998Z","etag":null,"topics":["api-rest","axios-react","backend","css","docker","front-end","html","javascript","mocha-chai","mysql","nodejs","react","sql"],"latest_commit_sha":null,"homepage":"https://ondelivery.up.railway.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kadraknb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-19T16:25:02.000Z","updated_at":"2023-07-08T09:25:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"dc0da8d6-67f9-4b57-b611-aeba8b4e128f","html_url":"https://github.com/kadraknb/delivery-app","commit_stats":null,"previous_names":["kadraknb/delivery-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadraknb%2Fdelivery-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadraknb%2Fdelivery-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadraknb%2Fdelivery-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kadraknb%2Fdelivery-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kadraknb","download_url":"https://codeload.github.com/kadraknb/delivery-app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244085008,"owners_count":20395523,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-rest","axios-react","backend","css","docker","front-end","html","javascript","mocha-chai","mysql","nodejs","react","sql"],"created_at":"2024-11-24T01:33:28.568Z","updated_at":"2026-04-15T19:33:14.915Z","avatar_url":"https://github.com/kadraknb.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# App de Delivery\n\n\u003c!--\n## descrição do projeto --\u003e\n\u003c!-- - Nessa aplicação, fui responsável por criar e integrar tanto o backend quanto o frontend, criando uma plataforma de delivery de cerveja. 🍻 --\u003e\n\nBem-vindo ao repositório do projeto App de Delivery! Essa aplicação consiste em uma plataforma de delivery de cerveja. 🍻\n\n---\n\n# Orientações\n\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e ⚠️ Configurações mínimas para execução do projeto\u003c/strong\u003e\u003c/summary\u003e\u003cbr /\u003e\n\nNa sua máquina você deve ter:\n\n- Docker\n- Docker-compose versão \u003e=1.29.2\n\n---\n\n\n## Instalação do Docker\n\nSiga as instruções apropriadas para o sistema operacional que você está usando:\n\n- ### Windows:\n  - Faça o download do instalador do Docker para Windows [aqui](https://www.docker.com/products/docker-desktop).\n\n- ### macOS:\n  - Faça o download do instalador do Docker para macOS [aqui](https://www.docker.com/products/docker-desktop).\n\n- ### Linux:\n\n  - Para distribuições baseadas em Debian/Ubuntu, você pode seguir as instruções de instalação [aqui](https://docs.docker.com/engine/install/ubuntu/).\n\n  - Para distribuições baseadas em Fedora, você pode seguir as instruções de instalação [aqui](https://docs.docker.com/engine/install/fedora/).\n  \n  - Para outras distribuições Linux, consulte a documentação oficial do Docker para obter instruções específicas.\n\n---\n\n## Instalação do Docker Compose\n\nCertifique-se de ter o Docker Compose instalado na versão 1.29 ou superior. Siga as instruções abaixo:\n\n- ### Windows:\n\n  - O Docker Compose já é instalado junto com o Docker Desktop para Windows. Se você seguiu as instruções de instalação do Docker para Windows, o Docker Compose também deve estar disponível.\n\n- ### macOS:\n\n  - O Docker Compose já é instalado junto com o Docker Desktop para macOS. Se você seguiu as instruções de instalação do Docker para macOS, o Docker Compose também deve estar disponível.\n\n- ### Linux:\n  - Faça o download do executável do Docker Compose:\n    ```bash\n    sudo curl -L \"https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)\" -o /usr/local/bin/docker-compose\n    ```\n\n  - Dê permissão de execução ao arquivo:\n    ```bash\n    sudo chmod +x /usr/local/bin/docker-compose\n    ```\n\n  - Verifique se a instalação foi bem-sucedida:\n    ```bash\n    docker-compose --version\n    ```\n\nCertifique-se de verificar se o Docker e o Docker Compose foram instalados corretamente executando os comandos docker --version e docker-compose --version no terminal. Ambos os comandos devem retornar as versões instaladas.\n\n---\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\n    \u003cstrong\u003e🚀 Instalação e execução\u003c/strong\u003e\n  \u003c/summary\u003e\u003cbr\u003e\n\n1. Clone o repositório\n\n- ```bash\n  git clone git@github.com:kadraknb/delivery-app.git\n  cd delivery-app\n  ```\n\n2. Inicializar o projeto\n\n- ```bash\n  scripts/start.sh\n  ```\n\n3. Acesso do projeto \n\n- http://localhost:3000\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n  \u003csummary\u003e\n    \u003cstrong\u003e🪛 Scripts Principais\u003c/strong\u003e\n  \u003c/summary\u003e\u003cbr\u003e\n\n**Aqui estão os scripts principais definidos na raiz do projeto:**\n\n- `start`: Limpa as portas `3000` , `3001` e `3002`, faz o build do Docker e inicia o **`banco de dados`**, **`backend`** e **`frontend`**\n\n  ```bash\n  scripts/start.sh\n  ```\n\n- `stop`: Para e deleta as aplicações em execução no `Docker`.;\n\n  ```bash\n  scripts/stop.sh\n  ```\n\n- `logs`: Exibe os logs das aplicações em execução no `Docker`;\n\n  ```bash\n  scripts/logs.sh\n  ```\n\n- `db:start`: Executa os scripts do `Sequelize` para inicializar o **banco de dados**\n\n  ```bash\n  scripts/start-db.sh\n  ```\n\n- `db:drop`: Executa os scripts do `Sequelize` para excluir o **banco de dados**\n\n  ```bash\n  scripts/drop-db.sh\n  ```\n\n- `db:reset`: Executa os scripts do `Sequelize` para restaurar o **banco de dados**\n\n  ```bash\n  scripts/reset-db.sh\n  ```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🏗️ Estrutura do projeto\u003c/strong\u003e\u003c/summary\u003e\u003cbr /\u003e\n\nO projeto é organizado da seguinte forma:\n\n1 . **Banco de dados:** Utiliza um container Docker MySQL configurado no Docker Compose, acessível pela porta 3002 do localhost.\n\n2 . **Back-end:** Desenvolvido com as seguintes dependências:\n\n- `express`\n- `joi`\n- `json web token`\n- `md5`\n- `sequelize`\n- `mysql2`\n- `nodemon`\n- `mocha`\n- `chai`\n\n3 . **Front-end:** Desenvolvido com as seguintes dependências:\n\n- `react`\n- `history`\n- `axios`\n- `web-vitals`\n\n4 . **Docker:** O Docker Compose é utilizado para reunir todos os serviços (backend, frontend e banco de dados) e executar o projeto completo.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e🛠 Desenvolvido\u003c/strong\u003e\u003c/summary\u003e\u003cbr /\u003e\n\n---\n\n## `Fluxo Comum`\n\nO Fluxo comum deve garantir que seja possível **fazer login** e **registrar** no sistema.\n\n---\n\n## `Fluxo do Cliente`\n\nO fluxo do cliente deve garantir que seja possível **navegar e escolher produtos**, **adicionar produtos ao carrinho**, **fazer checkout (gerar uma nova venda)**, **consultar pedidos** e **acessar detalhes do mesmo**.\n\n---\n\n## `Fluxo da Pessoa Vendedora`\n\nO fluxo da pessoa vendedora deve garantir que é possível listar pedidos relacionados àquela pessoa vendedora e manipular o status desses pedidos.\n\n---\n\n## `Validação do Status do Pedido`\n\nA validação de status consiste em uma série de testes que devem assegurar que os status do pedido sejam alterados e refletidos para clientes e pessoas vendedoras.\n\n---\n\n## `Fluxo da Pessoa Administradora`\n\nO fluxo da pessoa administradora deve possibilitar o cadastro de clientes e pessoas vendedoras, tal como a remoção dos mesmos.\n\n---\n\n## `Cobertura de Testes`\n\nA cobertura de testes deve garantir que, tanto no `front-end` quanto no `back-end`, os sistemas foram testados e possuem componentes e/ou funções estáveis e à prova de erros.\n\n---\n\n\u003c/details\u003e\n\n\u003cbr /\u003e\n\n---\n\n## 📪 Contato\n\n- Email: [vagner_cardoso_s@outlook.com](vagner_cardoso_s@outlook.com)\n- GitHub: [kadraknb](https://github.com/kadraknb)\n- LinkedIn: [vagner-cardos-santos](https://www.linkedin.com/in/vagner-cardos-santos/)\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadraknb%2Fdelivery-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkadraknb%2Fdelivery-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkadraknb%2Fdelivery-app/lists"}