Para que serve: hub obrigatório da regra
ai-context— o que o projeto é e para qual documento ir antes de editar código Fonte da verdade: os documentos do índice; cada um declara os arquivos de código que descreve Relacionados: especificacao · ambiente-e-operacao · DESIGN
Leia este arquivo no início de qualquer prompt. Detalhe técnico vive no documento dono, não aqui.
Fluxo é um controle financeiro pessoal web: entradas, saídas, contas, categorias, importação mensal OFX (Santander), orçamentos por categoria, investimentos (caixinhas), wishlist, contas a pagar e dashboard/relatórios com Apache ECharts.
Tagline: Veja seu dinheiro com clareza.
Dependências declaradas em package.json (amostra): concurrently.
- Living docs canônicos (board#7): os 12 documentos do índice abaixo existem neste repositório.
- Código vence documentação; atualize o dono no mesmo turno em que o comportamento mudar.
- README é pitch vendável; setup/ops ficam em
docs/ambiente-e-operacao.md.
Resumo curto — detalhe em especificacao; histórico em historico-de-mudancas e CHANGELOG.
Guia de produto e entrega deste repositório. Complementa
docs/context.md(contexto operacional para IA e stack).
Ano: 2026 | Estado: além do MVP — v1.2 (UX, OFX Santander, domínio) + polish mobile escopo A
| Documento | Conteúdo | Quando ler |
|---|---|---|
| context.md | Este hub | Sempre, no início do prompt (regra ai-context) |
| especificacao.md | O que o produto/ferramenta faz hoje | Antes de propor feature ou aceite |
| arquitetura.md | Estrutura, ciclo de request, fronteiras | Antes de empacotar, rotear ou deploy |
| api.md | Rotas, erros, contratos | Antes de mudar contrato HTTP / CLI I/O |
| banco-de-dados.md | Schema, migrations, storage | Antes de SQL, migration ou persistência |
| regras-de-negocio.md | Algoritmos e regras do domínio | Antes de reimplementar lógica |
| frontend.md | Rotas, páginas, tema, cliente | Antes de tela, navegação ou UI |
| ambiente-e-operacao.md | Env, scripts, setup, CI, build | Antes de subir ambiente ou publicar |
| seguranca.md | Auth, tokens, isolamento, segredos | Antes de mexer em auth ou dados de usuário |
| DESIGN.md | Tokens, tipografia, padrões de UI | Antes de token visual ou padrão de tela |
| historico-de-mudancas.md | Changelog por data (não é estado atual) | Só para o que mudou quando |
| fluxo-de-trabalho-ia.md | Rules/skills e consulta por etapa | Antes de criar issue/epic ou desviar do processo |
| README.md | Pitch do repositório | Onboarding humano |
| CONTRIBUTING.md | Fluxo de contribuição | Antes de abrir PR |
| CHANGELOG.md | Mudanças versionadas | Release / histórico curto |
Código vence documentação. A regra ai-context manda ler este hub e o documento dono antes de editar, e atualizar o dono no mesmo turno em que o código muda.