ExamplesSample projectDocs
ARCHITECTURE — Agendou
Aplicação Next.js única (frontend + API routes) conversando com o Supabase (PostgreSQL + Auth). Sem serviços extras: o MVP não precisa de cache nem fila.
1 min de leitura
Exemplo da AEX Engineering (projeto fictício).
Visão geral
Aplicação Next.js única (frontend + API routes) conversando com o Supabase (PostgreSQL + Auth). Sem serviços extras: o MVP não precisa de cache nem fila.
Diagrama de componentes
Camadas e responsabilidades
| Camada | Responsabilidade | Neste projeto |
|---|---|---|
| Frontend | Interface com o usuário. | Next.js (páginas pública e painel) |
| Backend | Regras de negócio e API. | Next.js API routes |
| Banco principal | Persistência. | Supabase / PostgreSQL |
| Autenticação | Sessões do prestador. | Supabase Auth |
| Orquestração/Deploy | Publicação. | Docker + Coolify |
Integrações externas
| Integração | Uso | Observações |
|---|---|---|
| Supabase | Banco, auth e storage | Único serviço externo do MVP |
Decisões-chave
- Next.js full-stack para reduzir superfície e acelerar o MVP → ver
DECISIONS.md - Sem Redis no MVP: não há gargalo que justifique → ver
DECISIONS.md
Estratégia de escala
Stack enxuta agora. Se o volume de agendamentos crescer a ponto de exigir cache ou processamento assíncrono (ex.: lembretes), avaliamos Redis e workers — não antes.
Modelo de dados: DATABASE.md · Contrato da API: API.md · Decisões: DECISIONS.md