Skip to content

Latest commit

 

History

History
63 lines (42 loc) · 3.44 KB

context.md

File metadata and controls

63 lines (42 loc) · 3.44 KB

Fluxo — contexto

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.

Objetivo

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.


Stack e operação

Dependências declaradas em package.json (amostra): concurrently.

Decisões fixas

  1. Living docs canônicos (board#7): os 12 documentos do índice abaixo existem neste repositório.
  2. Código vence documentação; atualize o dono no mesmo turno em que o comportamento mudar.
  3. README é pitch vendável; setup/ops ficam em docs/ambiente-e-operacao.md.

Estado atual

Resumo curto — detalhe em especificacao; histórico em historico-de-mudancas e CHANGELOG.

Fluxo — especificação do projeto

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


Objetivo

Índice

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

Manutenção

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.