{"id":26058841,"url":"https://github.com/r4mpo/perfect-laravel-base","last_synced_at":"2026-05-16T11:31:58.212Z","repository":{"id":280694587,"uuid":"942822560","full_name":"r4mpo/perfect-laravel-base","owner":"r4mpo","description":"Base Laravel SOLID: Uma estrutura Laravel organizada e escalável, seguindo os princípios de SOLID, com foco em desacoplamento e manutenção de longo prazo. Conta com autenticação JWT, DTOs, Services, Repositories, validações e testes unitários. Ideal para projetos Laravel que exigem alta qualidade e fácil expansão.","archived":false,"fork":false,"pushed_at":"2025-04-24T00:30:44.000Z","size":172,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-08T02:53:30.268Z","etag":null,"topics":["arquitetura","jwt","laravel-framework","php","solid","swagger"],"latest_commit_sha":null,"homepage":"https://www.linkedin.com/posts/erick-agostinho-684563227_laravel-solidprinciples-desenvolvimentoweb-activity-7302794239950614528-Xcdw?utm_source=share\u0026utm_medium=member_desktop\u0026rcm=ACoAADjbagQB5XcjzfRhHS7oGvk8izVnjs9QNjc","language":"PHP","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/r4mpo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-04T18:22:23.000Z","updated_at":"2025-04-24T00:30:48.000Z","dependencies_parsed_at":"2025-03-04T20:32:30.691Z","dependency_job_id":"16b3ef58-3b97-48cc-9092-fada6d9a7021","html_url":"https://github.com/r4mpo/perfect-laravel-base","commit_stats":null,"previous_names":["r4mpo/perfect-laravel-base"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/r4mpo/perfect-laravel-base","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4mpo%2Fperfect-laravel-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4mpo%2Fperfect-laravel-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4mpo%2Fperfect-laravel-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4mpo%2Fperfect-laravel-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/r4mpo","download_url":"https://codeload.github.com/r4mpo/perfect-laravel-base/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/r4mpo%2Fperfect-laravel-base/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33100815,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-16T04:41:52.686Z","status":"ssl_error","status_checked_at":"2026-05-16T04:41:52.009Z","response_time":115,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["arquitetura","jwt","laravel-framework","php","solid","swagger"],"created_at":"2025-03-08T12:40:32.943Z","updated_at":"2026-05-16T11:31:58.194Z","avatar_url":"https://github.com/r4mpo.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"Erick Agostinho (@r4mpo) - 2025\n\n---\n\n# **Base Laravel - Arquitetura SOLID**\n\nEste repositório serve como uma **base de projeto Laravel** otimizada, que adota as melhores práticas de **arquitetura** e  **desenvolvimento sustentável** , com ênfase nos princípios do  **SOLID** , buscando garantir  **escabilidade** , **desacoplamento** e **manutenibilidade** de longo prazo. Ele oferece uma estrutura robusta e testada, ideal para ser usada como ponto de partida em projetos Laravel que exijam alto nível de organização e extensibilidade.\n\n## **🔍 Visão Geral da Estrutura**\n\nO projeto é estruturado de forma a seguir padrões de arquitetura que permitem fácil integração de novos recursos e funcionalidades sem impactar negativamente o código existente. Sua arquitetura pode ser representada com os seguintes componentes principais:\n\n### **📦 Componentes Arquiteturais:**\n\n* **DTO (Data Transfer Objects):** Utilizado para garantir a transferência de dados de forma organizada e consistente.\n* **Helpers:** Funções reutilizáveis que auxiliam no desempenho e organização do código.\n* **Controllers:** Responsáveis por orquestrar as requisições e interagir com os **Services** e  **Repositories**.\n* **Requests:** Validação e sanitização dos dados de entrada da API, garantindo segurança e integridade.\n* **Middlewares:** Responsáveis por aplicar regras de acesso, autenticação e autorização, entre outros filtros de segurança.\n* **Models:** Representação das entidades no banco de dados, com métodos que ajudam na manipulação desses dados.\n* **Queries:** Permite a execução de consultas SQL personalizadas e otimizadas.\n* **Repositories:** Implementação do padrão de repositório, facilitando o acesso a dados, centralizando a lógica de consulta e permitindo fácil manutenção.\n* **Services:** Contém a lógica de negócios, desacoplando a implementação das  **Controllers**.\n* **Value Objects:** Representação de objetos imutáveis, como tipos de dados ricos que devem ser usados de forma controlada e segura.\n* **Interfaces:** Conjunto de padrões envolvendo parâmetros e retornos esperados em funções específicas.\n\n### **📖 Documentação**\n\nA documentação da API está disponível e acessível através do Swagger, que proporciona uma interface interativa para testar os endpoints da aplicação.\n\n* **Acesse a documentação** : [http://localhost:8000/api/documentation](http://localhost:8000/api/documentation)\n\n### **✅ Testes e Cobertura**\n\nO projeto também possui uma cobertura de testes unitários, garantindo a funcionalidade das operações principais e proporcionando segurança contra quebras no código, principalmente em operações de inserção no banco de dados.\n\n---\n\n## **🚀 Recursos e Benefícios:**\n\n* **🔒 Segurança:** Middleware de autenticação e validações de segurança de ponta.\n* **⚡ Performance:** Design otimizado para alta performance, com uso de cache e queries eficientes.\n* **🔄 Escalabilidade:** A arquitetura projetada para fácil expansão e adição de novas funcionalidades.\n* **✅ Testabilidade:** Testes unitários completos para garantir a qualidade do código.\n* **📚 Documentação Interativa:** Swagger para documentação dinâmica e fácil de utilizar.\n\n## **⚙️ Tecnologias Utilizadas:**\n\n* **PHP 8.2.12**\n* **Laravel 12.0.1**\n* **JWT Auth (para autenticação)**\n* **Swagger (para documentação da API)**\n* **MySQL (banco de dados)**\n\n---\n\nEste repositório é a escolha ideal para equipes que buscam manter o código bem estruturado e fácil de escalar à medida que o projeto cresce. Ao seguir os princípios de  **SOLID** , garantimos um código limpo, legível e adaptável.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr4mpo%2Fperfect-laravel-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fr4mpo%2Fperfect-laravel-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fr4mpo%2Fperfect-laravel-base/lists"}