Documentação do Pipeline de Finanças Pessoais¶
Este manual explica de ponta a ponta como o sistema de automação de finanças pessoais funciona. Ele tira o extrato do e-mail do Gmail, lê os dados, limpa as sujeiras e preenche a planilha — tudo em segundos e sem intervenção humana.
Código de referência do projeto
PER-FIN-PIPE-DOC — Pipeline de Finanças Pessoais.
Visão geral¶
O sistema conecta as peças principais em uma esteira automática:
| Peça | Papel |
|---|---|
| C6 Bank | Origem do extrato (PDF por e-mail). |
| Gmail | Recebe o e-mail e aplica a etiqueta processar_extrato. |
| Google Apps Script | Salva o PDF no Drive e aciona o GitHub; depois faz a limpeza. |
GitHub (etl_extrato_c6) |
Extrai, valida a integridade e carrega os dados na planilha. |
| Google Sheets | Planilha [00] Controle Financeiro (abas lancamentos e Apontamentos). |
| Hermes Agent | Classifica as transações marcadas como Classificar. |
Por onde começar¶
- Fluxo do sistema — o passo a passo completo, do banco até a revisão.
- Classificação e regras — categorias, subcategorias e regras de valor.
- Arquitetura de auditoria — o vínculo 1:1 por ID entre as abas.
- Manutenção e problemas — os pontos vitais quando algo falha.
- Contexto rápido (IDs) — bloco pronto para colar em um assistente.
- Pendências — o que ainda falta documentar tecnicamente.