History

Tiago Yamamoto 7d99e77468 refactor: unify schema - eliminate core_* tables BREAKING CHANGE: Removed core_companies, core_users, core_user_roles tables Migrations: - Create 020_unify_schema.sql: adds tenant_id, email, name to users table - Create user_roles table (replaces core_user_roles) - Disable 009_create_core_tables.sql (renamed to .disabled) - Update 010_seed_super_admin.sql to use unified tables Backend Repositories: - company_repository.go: use companies table with INT id - user_repository.go: use users/user_roles with INT id conversion Seeders: - All seeders now use companies/users/user_roles tables - Removed all core_* table insertions - Query companies by slug to get SERIAL id This eliminates the redundancy between core_* and legacy tables.		2025-12-24 11:06:31 -03:00
..
api	feat: implement dynamic dashboard, auth hardening (pepper/httponly) and backend tests	2025-12-24 01:30:33 -03:00
core	fix(backend): Resolve compilation error in update_user.go	2025-12-23 19:24:58 -03:00
database	feat: prefer DATABASE_URL format for db connection, fallback to individual params	2025-12-23 23:23:42 -03:00
dto	feat: implement dynamic dashboard, auth hardening (pepper/httponly) and backend tests	2025-12-24 01:30:33 -03:00
handlers	feat: implement dynamic dashboard, auth hardening (pepper/httponly) and backend tests	2025-12-24 01:30:33 -03:00
infrastructure	refactor: unify schema - eliminate core_* tables	2025-12-24 11:06:31 -03:00
middleware	feat: security refactor, server-side pagination, and docs update	2025-12-23 00:50:51 -03:00
models	feat: enhance job form with currency, salary periods, contract types, and add ER diagram docs	2025-12-23 22:49:33 -03:00
router	feat: implement dynamic dashboard, auth hardening (pepper/httponly) and backend tests	2025-12-24 01:30:33 -03:00
services	feat: implement dynamic dashboard, auth hardening (pepper/httponly) and backend tests	2025-12-24 01:30:33 -03:00
utils	docs: complete project documentation overhaul	2025-12-09 19:36:36 -03:00
README.md	docs: complete project documentation overhaul	2025-12-09 19:36:36 -03:00

README.md

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 novos
middleware/ - Auth com JWT Service

`core/`

Camada de domínio puro seguindo DDD.

domain/entity/ - Entidades sem dependências externas
ports/ - Interfaces de repositórios e serviços
usecases/ - Casos de uso (Login, CreateUser, etc.)

`middleware/`

Middlewares de segurança aplicados globalmente.

auth.go - Validação JWT + RBAC
cors.go - Whitelist de origens
rate_limit.go - 100 req/min por IP
security_headers.go - Headers OWASP

`utils/`

Utilitários compartilhados.

jwt.go - Geração e validação de tokens
sanitizer.go - Sanitização de inputs (XSS prevention)