ADR-0001: API First¶
Status: Superseded — substituída pela prática real observada nos produtos.
Contexto¶
A visão original da CoreFlow Platform (01/07/2026) previa que toda funcionalidade nascesse com API REST desde o primeiro dia ("API First"), antes mesmo da interface web.
Decisão Real¶
Na prática, os 8 produtos do ambiente hauxtech nascem como aplicações Django Templates server-rendered. API REST (DRF) é adicionada depois, sob demanda, via skill hx-implementar-api, quando há necessidade real de consumo externo ou integração entre produtos.
Estado em 17/09/2026:
| Produto | API REST |
|---|---|
| CoreFlow Stock | Sim, DRF completo desde a origem (Fase 8) |
| CoreFlow Time, People, ERP, Planner AI, CRM | Sim, DRF adicionado pós-MVP |
| CoreFlow Infra | Endpoints de ingestão sem DRF (Django Views + JsonResponse) |
| CoreFlow Assets | Não tem API REST |
Consequências¶
- Produtos não pagam o custo de desenhar uma API pública antes de validar o domínio via UI.
- API é adicionada apenas onde há consumidor real (ex.: CoreFlow ERP consumido pelo CoreFlow Charge), evitando over-engineering.
- Não há padronização automática de API entre produtos — cada adoção via
hx-implementar-apisegue o mesmo padrão (Token DRF,drf-spectacular), mas a decisão de quando adicionar é caso a caso.