1 line
4.0 KiB
JSON
1 line
4.0 KiB
JSON
{"repo": "celibertojr/controle-cartao-com-ia", "files": {"README.md": {"75b961fbc46dc05720b7efc882ba0584ffd599f5": {"t": 1785595152.9308672, "n": 3563, "h": "e037edd2431bb53a", "c": "# Controle de Cartão de Crédito com IA\n\nAplicativo desktop em Python + Tkinter para controle pessoal de gastos de cartão de crédito,\ncom classificação automática, importação de fatura PDF, previsão de parcelas, dashboard gráfico\ne assistente de IA integrado.\n\n---\n\n## Requisitos\n\n- Python **3.11 ou superior**\n- Tkinter (já incluso no Python para Windows; no Linux: `sudo apt install python3-tk`)\n\n---\n\n## Instalação\n\n```bash\npip install -r controle_cartao_ia/requirements.txt\n```\n\n| Pacote | Uso |\n|---|---|\n| `requests` | Chamadas à API de IA |\n| `pdfplumber` | Leitura de faturas PDF |\n| `matplotlib` | Gráficos do dashboard |\n| `openpyxl` | Exportação para Excel |\n\n---\n\n## Execução\n\n```bash\npython main.py\n```\n\nNa primeira execução, o sistema pedirá que você crie uma senha de acesso e gerará automaticamente\num código de recuperação — anote-o em local seguro.\n\n---\n\n## Onde ficam os dados?\n\nTodos os dados pessoais ficam **fora do repositório**, na pasta do usuário:\n\n| Sistema | Caminho |\n|---|---|\n| Windows | `C:\\Users\\<usuario>\\.controle_cartao_ia\\` |\n| Linux / macOS | `~/.controle_cartao_ia/` |\n\n```\n~/.controle_cartao_ia/\n├── cartao.db ← banco SQLite com todos os lançamentos\n├── config.json ← URL da IA, modelo, hash da senha (nunca texto puro)\n└── backups/ ← backups gerados pelo app\n```\n\nIsso garante que **nenhum dado pessoal vai para o repositório** — nem API keys, nem senha, nem histórico de gastos.\n\n---\n\n## Estrutura do projeto\n\n```\ncontrole-Cartao-com-IA/\n├── main.py ← ponto de entrada\n├── README.md\n└── controle_cartao_ia/\n ├── requirements.txt\n └── app/\n ├── utils.py ← constantes, datas, moeda, classificação\n ├── database.py ← banco SQLite\n ├── ai_advisor.py ← integração com IA\n ├── pdf_importer.py ← leitura de faturas PDF\n ├── charts.py ← gráficos matplotlib\n └── gui.py ← interface Tkinter completa\n```\n\n---\n\n## Funcionalidades\n\n- Cadastro manual de gastos com suporte a parcelamento automático\n- Importação de fatura em PDF com revisão e sugestão de correção pela IA\n- Classificação automática por palavras-chave + IA para categorias desconhecidas\n- Categorias personalizadas (a IA sugere palavras-chave)\n- Meta mensal com barra de progresso, alertas e herança automática do mês anterior\n- Projeção dos próximos 12 meses com base em parcelas e gastos recorrentes\n- Dashboard com 5 tipos de gráfico (pizza, barras, linha, progresso, horizontal)\n- Chat lateral com assistente de IA — perguntas livres e análise detalhada\n- Edição de qualquer lançamento via duplo clique\n- Exportação para Excel — mês atual ou histórico completo\n- Backup e restauração do banco com um clique\n- Login com senha (SHA-256) + código de recuperação\n- Painel de Manutenção para limpeza seletiva do banco de dados\n- Funciona completamente sem IA: fallback local sempre disponível\n\n---\n\n## Configuração da IA\n\nAcesse **Configurações → IA** dentro do app.\n\n| Provedor | URL | Modelo de exemplo |\n|---|---|---|\n| Ollama (local) | `http://localhost:11434/api/chat` | `llama3.1:8b` |\n| Xiaomi MiMo | `https://api.xiaomimimo.com/v1` | `mimo-v2.5-pro` |\n| OpenRouter | `https://openrouter.ai/api/v1` | `openai/gpt-4o-mini` |\n| OpenAI | `https://api.openai.com/v1` | `gpt-4o-mini` |\n\nA URL pode ser a base (`/v1`) ou o endpoint completo — o sistema detecta e completa automaticamente.\n\n> Sem IA configurada, o sistema exibe análise local automática e funciona normalmente.\n\n---\n\n## Licença\n\nUso pessoal.\n"}}}} |