LerNota/.claude/skills/openspec-onboard/leiame.md

Tenho uma ideia/problema ↓ /opsx:explore ↓ /opsx:propose minha-mudanca ↓ /opsx:apply minha-mudanca ↓ /opsx:verify minha-mudanca ↓ /opsx:archive minha-mudanca ↓ CONCLUÍDO //////////////////////////////////

Comando	Significado
/opsx:explore	🔍 Investigar/pensar
/opsx:propose nome	📝 Planejar uma nova alteração
/opsx:apply nome	🔨 Implementar
/opsx:verify nome	✅ Conferir implementação
/opsx:archive nome	📦 Finalizar
/opsx:onboard	🎓 Aprender o processo
/opsx:new nome	Criar mudança passo a passo
/opsx:continue nome	Continuar mudança
/opsx:ff nome	⚡ Gerar artefatos rapidamente
////////////////////////////////
analise td projeto
Objetivos:

1. criar tabela categoria campos: id, categoria, palavra_chave

Funcionalidades:

1. AI deve ler nome do fornecedor e categorizar automaticamente, caso não consiga a AI deve consultar as palavras chaves da tabela categoria se encontrar utilizar o campo categoria para categorizar
2. Ajustar Dashboard para mostrar e filtrar os gastos por categoria
3. criar mecanismo de segurança para não entrar em loop infinito qdo acionar AI, PARA EVITAR CONSUMO exagerado de tokens
4. criar "CRUD" tabela categoria, seguir mesmo layout atual do projeto
5. Qdo AI não conseguir categorizar mesmo procurando por palavra_chave na tabela categoria deve gravar no banco: "Não Encontrado" com Id = 01 da tabela de categoria/clear ///////////////////////////////
6. acrescentar no Formulario "Documents": Select (tabela categoria ASC) campo: categoria na rota: /documents/new
7. Em Dashboard: "Ultimos Lançamentos" incluir coluna: "Categoria" logo apos coluna fornecedor
8. Rota: /documents incluir coluna: "Categoria" logo apos coluna fornecedor /////////////////////////////// Objetivo: atualmente OCR captura data do documento, mudar para competencia tipo: mes/ano Exemplo: Jun/26, Jul/26. Então:
9. alterar estrutura da tabela remover campo data
10. Criar campos: mes e ano
11. Antes de clicar no botão: Enviar revisar Perguntar Competencia: Mes/Ano
12. Preencher campo: Competencia deve: Select mes (Jan,Fev,Mar,Abr,... Dez) e Ano (2026,2027,2028,2029,2030)
13. Carregar no banco dados
14. Aplicar correções no Dashboard e filtros em tds rotas

////////////////////// Comandos usados:

1. Encontrar o processo que ocupava a porta 8000

netstat -ano | findstr :8000 wmic process where "ProcessId=" get ProcessId,ParentProcessId,CommandLine

2. Finalizar o processo antigo

taskkill /F /PID

3. Reiniciar o servidor

cd C:\LerNotaFiscal .venv\Scripts\python.exe app.py

Servidor rodando de novo em http://127.0.0.1:8000.