7934afcf0d
- Add comprehensive root README with badges, architecture diagram, and setup guide - Update backend README with security middlewares and endpoint documentation - Update frontend README with design system and page structure - Update seeder-api README with generated data and credentials - Add internal module READMEs (middleware, handlers, components) - Document Clean Architecture layers and request flow - Add environment variables reference table
2.6 KiB
2.6 KiB
Internal - Backend Core
Este diretório contém toda a lógica interna do backend, seguindo princípios de Clean Architecture.
📁 Estrutura de Módulos
| Diretório | Camada | Responsabilidade |
|---|---|---|
api/ |
Interface | Handlers e middlewares (Clean Arch) |
core/ |
Domain | Entidades, ports e use cases (DDD) |
database/ |
Infrastructure | Conexão GORM com PostgreSQL |
dto/ |
Interface | Data Transfer Objects (request/response) |
handlers/ |
Interface | Controllers HTTP (legacy) |
infrastructure/ |
Infrastructure | Implementações de ports |
middleware/ |
Interface | Middlewares de segurança |
models/ |
Infrastructure | Modelos GORM |
router/ |
Interface | Configuração de rotas |
services/ |
Application | Lógica de negócios (legacy) |
utils/ |
Shared | Utilitários (JWT, Sanitizer) |
🏗️ Fluxo de Requisição
HTTP Request
│
▼
┌─────────────┐
│ Middleware │ (Auth, CORS, Rate Limit, Security Headers)
└─────────────┘
│
▼
┌─────────────┐
│ Router │ (router/router.go)
└─────────────┘
│
▼
┌─────────────┐
│ Handler │ (api/handlers/ ou handlers/)
└─────────────┘
│
▼
┌─────────────┐
│ UseCase │ (core/usecases/)
└─────────────┘
│
▼
┌─────────────┐
│ Repository │ (infrastructure/persistence/)
└─────────────┘
│
▼
┌─────────────┐
│ Database │ (PostgreSQL via GORM)
└─────────────┘
📦 Módulos Detalhados
api/
Implementação Clean Architecture dos handlers e middlewares.
handlers/- Controllers HTTP novosmiddleware/- Auth com JWT Service
core/
Camada de domínio puro seguindo DDD.
domain/entity/- Entidades sem dependências externasports/- Interfaces de repositórios e serviçosusecases/- Casos de uso (Login, CreateUser, etc.)
middleware/
Middlewares de segurança aplicados globalmente.
auth.go- Validação JWT + RBACcors.go- Whitelist de origensrate_limit.go- 100 req/min por IPsecurity_headers.go- Headers OWASP
utils/
Utilitários compartilhados.
jwt.go- Geração e validação de tokenssanitizer.go- Sanitização de inputs (XSS prevention)