{"id":26014541,"url":"https://github.com/brenonsc/laravel-sales-manager","last_synced_at":"2026-05-29T12:31:35.362Z","repository":{"id":263337589,"uuid":"890046159","full_name":"brenonsc/laravel-sales-manager","owner":"brenonsc","description":"Repositório criado com o objetivo de armazenar uma API em Laravel que gerencia usuários, clientes, endereços, produtos e vendas.","archived":false,"fork":false,"pushed_at":"2024-11-21T18:32:31.000Z","size":127,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-07T18:56:51.912Z","etag":null,"topics":["docker","jwt-authentication","laravel","mysql","php","sales","swagger"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/brenonsc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-11-17T21:43:31.000Z","updated_at":"2025-09-26T17:16:29.000Z","dependencies_parsed_at":"2024-11-18T00:30:18.569Z","dependency_job_id":null,"html_url":"https://github.com/brenonsc/laravel-sales-manager","commit_stats":null,"previous_names":["brenonsc/laravel-sales-manager"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/brenonsc/laravel-sales-manager","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brenonsc%2Flaravel-sales-manager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brenonsc%2Flaravel-sales-manager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brenonsc%2Flaravel-sales-manager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brenonsc%2Flaravel-sales-manager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brenonsc","download_url":"https://codeload.github.com/brenonsc/laravel-sales-manager/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brenonsc%2Flaravel-sales-manager/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33652979,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["docker","jwt-authentication","laravel","mysql","php","sales","swagger"],"created_at":"2025-03-06T02:31:41.829Z","updated_at":"2026-05-29T12:31:35.340Z","avatar_url":"https://github.com/brenonsc.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Sales Manager 💰📊\n![License](https://badgen.net/badge/License/MIT/purple?icon=)\n![PHP](https://badgen.net/badge/icon/v8.3/blue?icon=php\u0026label)\n![Laravel](https://badgen.net/badge/Laravel/v11/green?icon=)\n![Docker](https://badgen.net/badge/icon/Available?icon=docker\u0026label)\n\nO **Laravel Sales Manager** é uma aplicação backend desenvolvida em Laravel com integração via Docker e documentação de endpoints em Swagger. O sistema gerencia usuários, clientes, endereços, produtos e vendas, com autenticação JWT para segurança e rastreamento eficiente.\n\u003cbr\u003e\n\u003cbr\u003e\n\n## Tecnologias utilizadas\u0026nbsp; 🔨\n\u003cdiv\u003e\n    \u003cimg align='center' height='70' width='70' title='PHP' alt='php' src='https://cdn-icons-png.flaticon.com/512/5968/5968332.png' /\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg align='center' height='50' width='50' title='Laravel' alt='laravel' src='https://cdn.worldvectorlogo.com/logos/laravel-3.svg' /\u003e\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg align='center' height='48' width='50' title='JsonWebToken' alt='jsonwebtoken' src='https://images.ctfassets.net/kbkgmx9upatd/6E4gdxqqmafg9Usjz9etTU/bc93ad8e3cea217c3de390239ff34c8c/jwt-hero.png' /\u003e \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n    \u003cimg align='center' height='50' width='50' title='MySQL' alt='mysql' src='https://cdn-icons-png.flaticon.com/512/5968/5968313.png' /\u003e \u0026nbsp;\n    \u003cimg align='center' height='62' width='72' title='Swagger' alt='swagger' src='https://github.com/bush1D3v/tsbank_api/assets/133554156/6739401f-d03b-47f8-b01f-88da2a9075d1' /\u003e \u0026nbsp;\n    \u003cimg align='center' height='55' width='55' title='Docker' alt='docker' src='https://cdn4.iconfinder.com/data/icons/logos-and-brands/512/97_Docker_logo_logos-512.png' /\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n## Requisitos\u0026nbsp; ☑️\n\n1. 🐳 **Docker**: Caso não tenha instalado, baixe no [site oficial do Docker](https://www.docker.com/products/docker-desktop).\n2. 🐱 **Git**: Para clonar o repositório.\n\u003cbr\u003e\n\n## Passos para Instalação\u0026nbsp; 🖥️\n\n1. **Clone o Repositório**  \n   Abra o terminal, navegue até a pasta desejada e execute:  \n   ```bash\n   git clone https://github.com/brenonsc/laravel-sales-manager.git\n   ```\n\n2. **Entre na Pasta do Projeto**  \n   ```bash\n   cd laravel-sales-manager\n   ```\n\n3. **Inicie o Projeto**  \n   Execute o comando para configurar o ambiente e subir os containers Docker:  \n   ```bash\n   cp .env.example .env \u0026\u0026 docker compose up --build\n   ```\n\n4. **(Opcional)** **_Gere uma nova chave JWT_**  \n   \u003e **⚠️ Importante:** Este passo garante segurança no processo de autenticação.  \n   Abra uma nova aba no terminal e execute o comando após os containers estarem ativos:  \n   ```bash\n   docker compose exec app php artisan jwt:secret\n   ```\n\u003cbr\u003e\n\n## Endpoints Documentados\u0026nbsp; 🟢\n\nOs endpoints estão documentados em **Swagger** e podem ser acessados via:  \n- [http://localhost:8000](http://localhost:8000)  \n- [http://localhost:8000/api/docs](http://localhost:8000/api/docs)\n\u003cbr\u003e\n\n## Principais Endpoints\u0026nbsp; ▶️\n\n### **Autenticação**\u0026nbsp; 🔐\n\n**Controller:** `AuthController`  \n- **POST /login**: Autentica o usuário e retorna um token JWT.  \n- **POST /signup**: Registra um novo usuário.  \n- **POST /logout**: Encerra a sessão autenticada.  \n- **GET /me**: Retorna os dados do usuário autenticado.  \n\n---\n\n### **Clientes**\u0026nbsp; :busts_in_silhouette:\n\n**Controller:** `ClientController`  \n- **GET /clients**: Lista todos os clientes.  \n- **GET /clients/{id}**: Exibe detalhes de um cliente específico.  \n- **POST /clients**: Cria um novo cliente com seus endereços.  \n- **PUT /clients/{id}**: Atualiza informações do cliente e seu endereço.  \n- **DELETE /clients/{id}**: Deleta logicamente um cliente.  \n\n---\n\n### **Produtos**\u0026nbsp; 📦\n\n**Controller:** `ProductController`  \n- **GET /products**: Lista produtos ativos.  \n- **GET /products/{id}**: Exibe detalhes de um produto.  \n- **POST /products**: Cria um novo produto.  \n- **PUT /products/{id}**: Atualiza informações de um produto.  \n- **DELETE /products/{id}**: Marca um produto como inativo.  \n\n---\n\n### **Vendas**\u0026nbsp; :chart_with_upwards_trend:\n\n**Controller:** `SaleController`  \n- **GET /sales**: Lista todas as vendas.  \n- **POST /sales**: Registra uma nova venda.  \n\n\u003cbr\u003e\n\n## Testes\u0026nbsp; :man_scientist:\n\nEsta aplicação possui **testes unitários** implementados para todos os **controllers**, garantindo a funcionalidade e a estabilidade da aplicação.\n\n#### Executando os Testes\n\nPara rodar os testes, siga os passos abaixo:\n\n1. Execute as migrações no ambiente de testes:\n   ```bash\n   docker compose exec app php artisan migrate --env=testing\n   ```\n\n2. Execute os testes:\n   ```bash\n   docker compose exec app php artisan test\n   ```\n\u003cbr\u003e\n\n## Licença\u0026nbsp; :clipboard:\n\nEste software está licenciado sob a [Licença MIT](https://github.com/brenonsc/laravel-sales-manager/blob/main/LICENSE).\n\u003cbr\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrenonsc%2Flaravel-sales-manager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrenonsc%2Flaravel-sales-manager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrenonsc%2Flaravel-sales-manager/lists"}