Como a documentação está organizada
A documentação é organizada por fase do roadmap, não por categoria. Quando algo é transversal (LGPD, multi-tenant), mora em arquitetura-geral/.
| Pasta | Propósito | Status |
|---|---|---|
docs/00-fontes-originais/ | Materiais brutos iniciais (PDF, DOCX) | Histórico |
docs/01-estrategia/ | Briefing executivo e escopo original | Leia primeiro |
docs/02-fase-1-concierge-crm/ | Fase ativa: IA de aquisição + CRM | Em execução |
docs/03-fase-2-webapp-financeiro/ | PWA operacional + financeiro próprio | Planejada |
docs/04-fase-3-app-plataforma/ | App nativo + plataforma multi-unidade | Protótipo congelado |
docs/arquitetura-geral/ | Decisões transversais (LGPD, multi-tenant, IA-First) | Vivo |
Documentos da Fase 1 (em execução)
- README.md — visão da fase, componentes, prazos.
- decisoes-pendentes.md — bloqueios pra começar (ver também formulário de insumos).
- cronograma.md — detalhe das 5 etapas.
- orcamento-apis-llm.md — custos de API e LLM.
- metricas.md — métricas candidatas.
- integracoes/ — specs de WhatsApp e ManyChat (a criar conforme avançar).
Código no repositório
O repositório atual contém protótipo da Fase 3 em apps/mobile, telas de booking em apps/admin e migrations Supabase. Todas marcadas com STATUS.md dizendo o que pode/não pode ser mexido.
| Caminho | Status |
|---|---|
apps/admin | Parcialmente reaproveitável. Código novo da Fase 1 (CRM de leads) nasce em rotas novas (/leads, /conversas, /configuracoes/concierge). |
apps/mobile | Protótipo Fase 3 — congelado. Não mexer agora. |
supabase/migrations | Append-only. Novas migrations prefixam a fase: 20260510_fase1_*. |
packages/{database,shared,integrations,ui} | Esqueletos vazios — preencher conforme a Fase 1 demandar. |
n8n/workflows | Vazio — receberá workflows do concierge IA. |
Princípios técnicos transversais
- IA First — a IA é o motor. Decisões de arquitetura partem disso.
- CRM como fonte da verdade da jornada do lead.
- LGPD desde o primeiro contato — base legal explícita, consentimento registrado, retenção controlada.
- Multi-tenant desde o dia 1 — Rede → Unidade → Aluno. Mesmo com 1 unidade.
Para colaborar
- Antes de mexer em código, leia o
STATUS.mdda pasta. - Antes de criar migration, prefixe com a fase:
20260510_fase1_leads_pipeline.sql. - Antes de adicionar dependência, confirme que faz sentido pra fase atual.
- Decisão técnica transversal: documente em
docs/arquitetura-geral/, não dentro da fase.
Repositório
Os arquivos descritos acima vivem no monorepo TechBurn. Acesso via Git — peça pra Acaya se você ainda não tem.