Erick Agostinho (@r4mpo) - 2025
Este 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.
O 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:
- DTO (Data Transfer Objects): Utilizado para garantir a transferência de dados de forma organizada e consistente.
- Helpers: Funções reutilizáveis que auxiliam no desempenho e organização do código.
- Controllers: Responsáveis por orquestrar as requisições e interagir com os Services e Repositories.
- Requests: Validação e sanitização dos dados de entrada da API, garantindo segurança e integridade.
- Middlewares: Responsáveis por aplicar regras de acesso, autenticação e autorização, entre outros filtros de segurança.
- Models: Representação das entidades no banco de dados, com métodos que ajudam na manipulação desses dados.
- Queries: Permite a execução de consultas SQL personalizadas e otimizadas.
- 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.
- Services: Contém a lógica de negócios, desacoplando a implementação das Controllers.
- Value Objects: Representação de objetos imutáveis, como tipos de dados ricos que devem ser usados de forma controlada e segura.
- Interfaces: Conjunto de padrões envolvendo parâmetros e retornos esperados em funções específicas.
A 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.
- Acesse a documentação : http://localhost:8000/api/documentation
O 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.
- 🔒 Segurança: Middleware de autenticação e validações de segurança de ponta.
- ⚡ Performance: Design otimizado para alta performance, com uso de cache e queries eficientes.
- 🔄 Escalabilidade: A arquitetura projetada para fácil expansão e adição de novas funcionalidades.
- ✅ Testabilidade: Testes unitários completos para garantir a qualidade do código.
- 📚 Documentação Interativa: Swagger para documentação dinâmica e fácil de utilizar.
- PHP 8.2.12
- Laravel 12.0.1
- JWT Auth (para autenticação)
- Swagger (para documentação da API)
- MySQL (banco de dados)
Este 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.