Commit inicial - upload de todos os arquivos da pasta

2026-07-24 15:51:10 -03:00
commit efa06def71
44 changed files with 3604 additions and 0 deletions
@@ -0,0 +1,69 @@
+# Lernotafiscal
+
+Aplicativo web para importar notas e cupons fiscais (PDF/imagem), revisar a
+extração e acompanhar despesas confirmadas. A leitura dos documentos usa
+**OpenAI Vision** quando há chave configurada, com **fallback** para OCR/heurística
+local. Feito para rodar numa VPS.
+
+## Recursos
+
+- Login simples (usuário/senha, hash bcrypt, sessão por cookie assinado).
+- Upload de PDF/JPG/PNG com **confirmação em lote** antes de gravar: mostra o
+  número de documentos e o valor total, e destaca itens ilegíveis para correção.
+- Data ilegível/ausente → **1º dia do mês corrente** (regra única compartilhada
+  por IA e cadastro manual).
+- **CRUD** completo de documentos (criar, editar, excluir, listar/filtrar).
+- Dashboard com KPIs, gastos por mês e por fornecedor.
+- Tema claro/escuro (persistido no navegador).
+- Banco **SQLite** (WAL), sem serviço externo.
+
+## Stack
+
+FastAPI + Uvicorn · Jinja2 (server-rendered) · SQLite · OpenAI (Vision) com
+fallback OCR (PyMuPDF + Tesseract) · bcrypt.
+
+## Rodar localmente
+
+```bash
+python -m venv .venv
+.venv/Scripts/activate            # Windows;  no Linux/Mac: source .venv/bin/activate
+pip install -r requirements.txt
+cp .env.example .env              # defina ADMIN_PASSWORD e SECRET_KEY
+python app.py                     # http://127.0.0.1:8000
+```
+
+Sem `OPENAI_API_KEY` o app usa OCR/heurística local (o Tesseract precisa estar
+instalado no sistema para OCR de imagens). Com a chave, a extração usa a IA.
+
+### Migrar histórico (opcional)
+
+```bash
+python scripts/migrate_notas.py   # importa Skill/dados/lernotafiscal.db -> app
+```
+
+## Testes
+
+```bash
+python -m unittest
+```
+
+## Deploy em VPS
+
+Guia completo (Ubuntu + systemd + Nginx + HTTPS) em [DEPLOY.md](DEPLOY.md).
+
+## Estrutura
+
+```
+app/                aplicação FastAPI (config, database, auth, rotas, templates)
+app/ai_extraction   extração via OpenAI Vision
+app/ingestion       orquestra IA -> fallback OCR local
+lernotafiscal/      motor de extração heurística/OCR reutilizado no fallback
+scripts/            utilitários (migrate_notas.py)
+deploy/             unit systemd + config nginx
+```
+
+## Variáveis de ambiente
+
+Veja [.env.example](.env.example). Principais: `SECRET_KEY`, `ADMIN_USERNAME`,
+`ADMIN_PASSWORD`, `OPENAI_API_KEY`, `OPENAI_MODEL`, `DB_PATH`, `MAX_UPLOAD_BYTES`,
+`SESSION_HTTPS_ONLY`.