---
name: atualizar-painel
description: Atualiza o painel financeiro (painel.html) quando o usuário coloca um extrato novo na pasta. Use quando ele disser que colocou/baixou um extrato novo, pedir para atualizar o painel, ou mencionar um mês que ainda não aparece no painel.
---

# Atualizar o painel financeiro

O painel (`painel.html`) é gerado pelo script `gerar_painel.py` a partir de
TODOS os arquivos `extrato-*.csv` desta pasta. O visual fica em
`modelo_painel.html`. Não edite `painel.html` à mão: ele é sobrescrito.

## Passos

1. **Ache o extrato novo.** Liste os `extrato-*.csv` da pasta. O nome tem que
   seguir o padrão `extrato-<mes>-<ano>.csv` (ex.: `extrato-nov-2026.csv`).
   Se o usuário salvou com outro nome (ex.: `Extrato (3).csv`), pergunte de
   que mês é e renomeie para o padrão.

2. **Confira o formato** abrindo as primeiras linhas do arquivo novo. Tem que
   ser igual aos outros: separador `;`, colunas
   `Data;Lançamento;Detalhes;Valor;Saldo`, datas `dd/mm/aaaa`, valores no
   formato `1.234,56`, uma linha `Saldo Anterior` no começo e uma
   `S A L D O` no fim (mês fechado). Se faltar a linha `S A L D O` (extrato
   parcial, mês em andamento), acrescente ao final uma linha
   `<data do último lançamento>;S A L D O;;;<saldo do último lançamento>`
   e avise o usuário que o mês ainda está aberto. Se o formato for outro
   (outro banco, Excel, PDF), PARE e explique ao usuário; não adivinhe.

3. **Faça uma cópia de segurança** do painel atual:
   `cp painel.html painel-anterior.html`.

4. **Gere o painel:** `python3 gerar_painel.py` na pasta.
   - `OK: N lançamentos de M meses (...)` = deu certo. Confira se o mês novo
     aparece no intervalo.
   - `ERRO ... saldo não bate` = o arquivo veio cortado ou com linha
     duplicada. Não force; mostre a linha ao usuário.
   - `AVISO: saldo final de X difere do inicial de Y` = falta um mês no meio
     ou o extrato novo não continua do anterior. Conte ao usuário.
   - `AVISO: sem categoria` = estabelecimento novo. Pergunte ao usuário a
     categoria, acrescente a palavra-chave na lista `CATEGORIAS` do
     `gerar_painel.py` e rode de novo. Até lá, ele aparece como "Outros".

5. **Confira o resultado** procurando o mês novo no arquivo gerado, por
   exemplo `grep -o '"mes": "2026-11"' painel.html`. Se houver Chrome,
   tire um print:
   `google-chrome --headless=new --screenshot=prints/painel-atual.png --window-size=1280,2400 file://$PWD/painel.html`
   e olhe a imagem.

6. **Diga ao usuário**, em linguagem simples: qual mês entrou, receitas,
   despesas e saldo final desse mês, se alguma categoria ficou em vermelho
   (cresceu mais de 20% contra o mês anterior), e que basta abrir de novo o
   `painel.html` (ou apertar F5 se já estiver aberto).

## Regras

- Nunca apague nem altere os extratos originais, exceto renomear (passo 1) ou
  acrescentar a linha `S A L D O` em extrato parcial (passo 2).
- Não envie os extratos para nenhum serviço da internet.
- Se o extrato novo for de um mês que já existe, pergunte se é para
  substituir o antigo antes de fazer qualquer coisa.
