Operações
Operações Compose locais, health, workers e tooling opcional.
Serviços Compose
| Serviço | Função |
|---|---|
| nginx | Gateway same-origin |
| api | API Laravel / PHP-FPM |
| web | UI Next.js |
| queue | Worker Redis (notificações de mail) |
| scheduler | Loop schedule:run (ainda sem schedules de produto) |
| mariadb / redis | Dados primários e filas |
| localfakemail | Captura SMTP de desenvolvimento |
Worker de fila para mail· implementado
Cron jobs de produto no scheduler· planeado
Health e comandos
- GET /api/v1/health — liveness da API
- GET /healthz — health do processo web
- make up / make down / make logs / make ps
- make migrate — migrações Laravel
- make test / make test-financial / make test-e2e
Perfis opcionais
- antivirus — sidecar ClamAV
- sonar — SonarQube local (não substitui revisão de segurança; runners GitHub não alcançam Sonar em localhost)
Perfis opcionais ClamAV / Sonar· parcialmente implementado
Backup e recuperação
Trate volumes MariaDB e armazenamento de documentos privados como responsabilidade do operador. Use dump/restore MariaDB padrão e mantenha backups de APP_KEY alinhados com colunas encriptadas. Ver docs/operations.md no repositório para notas mais profundas.