{"id":29130489,"url":"https://github.com/tlsilva89/finance-control","last_synced_at":"2026-04-11T06:02:22.980Z","repository":{"id":301744933,"uuid":"1009917800","full_name":"tlsilva89/finance-control","owner":"tlsilva89","description":"Um sistema completo de controle financeiro pessoal","archived":false,"fork":false,"pushed_at":"2025-06-28T19:36:17.000Z","size":309,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-28T20:33:46.891Z","etag":null,"topics":["nodejs","sqlite","tailwindcss","typescript","vue"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tlsilva89.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-28T00:43:00.000Z","updated_at":"2025-06-28T20:11:46.000Z","dependencies_parsed_at":"2025-06-28T20:43:56.358Z","dependency_job_id":null,"html_url":"https://github.com/tlsilva89/finance-control","commit_stats":null,"previous_names":["tlsilva89/financecontrol","tlsilva89/finance-control"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tlsilva89/finance-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlsilva89%2Ffinance-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlsilva89%2Ffinance-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlsilva89%2Ffinance-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlsilva89%2Ffinance-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tlsilva89","download_url":"https://codeload.github.com/tlsilva89/finance-control/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tlsilva89%2Ffinance-control/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262708005,"owners_count":23351532,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nodejs","sqlite","tailwindcss","typescript","vue"],"created_at":"2025-06-30T04:05:55.356Z","updated_at":"2026-04-11T06:02:22.952Z","avatar_url":"https://github.com/tlsilva89.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Finance Control\n\n**Sistema Inteligente de Gestão Financeira Pessoal**\n\nO Finance Control é uma plataforma de alta performance desenvolvida para oferecer controle total sobre a saúde financeira. Com uma interface moderna, inspirada em dashboards analíticos de alto padrão, o sistema consolida receitas, despesas fixas, assinaturas e gestão de cartões em um único painel inteligente.\n\n---\n\n## 🚀 Funcionalidades Principais\n\n- **Visão Geral Dinâmica**: Painel com indicadores em tempo real de Ganhos, Saídas Reais, Saldo Final e Metas de Economia\n- **Gestão de Cartões**: Monitoramento detalhado de faturas, limites e datas de fechamento/vencimento\n- **Análise Inteligente**: Relatórios detalhados com distribuição de custos e evolução patrimonial semestral\n- **Calculadora de Divisão da Casa**: Ferramenta utilitária para divisão justa de gastos comuns entre moradores ou familiares\n- **Gestão de Custos Fixos**: Controle rigoroso de assinaturas (streaming, software) e serviços (água, luz, internet)\n- **Exportação de Dados**: Geração de relatórios mensais em PDF para auditoria pessoal\n\n---\n\n## 🛠️ Tecnologias Utilizadas\n\n### Frontend\n- **Angular 19+**: Framework base utilizando Signals para alta performance\n- **Tailwind CSS v4**: Estilização de última geração com design system Dark Premium\n- **Chart.js**: Visualização de dados através de gráficos interativos\n- **Ng-Icons**: Biblioteca de ícones Heroicons integrada\n- **Nginx**: Servidor web e Proxy Reverso para ambiente de produção\n\n### Backend\n- **C# (.NET 10)**: API de alto desempenho e escalável\n- **PostgreSQL**: Banco de dados relacional robusto\n- **JWT (JSON Web Token)**: Autenticação segura de usuários\n- **Entity Framework Core**: ORM para persistência de dados\n\n---\n\n## 📦 Estrutura do Projeto\n\n```\nfinance-control/\n├── backend/            # API em .NET 10\n│   ├── Dockerfile      # Configuração para containerização da API\n│   └── ...\n└── frontend/           # Aplicação Angular\n    ├── src/            # Código fonte do sistema\n    ├── public/         # Ativos estáticos e logotipos\n    ├── Dockerfile      # Build multi-stage para Angular + Nginx\n    └── nginx.conf      # Configuração de Proxy Reverso (/api)\n```\n\n---\n\n## 🐳 Deploy com Docker (TrueNAS Scale)\n\nA aplicação foi desenhada para rodar em containers, facilitando o gerenciamento no TrueNAS ou qualquer ambiente Docker.\n\n### Exemplo de Docker Compose\n\n```yaml\nservices:\n  finance-api:\n    image: tlsilva89/finance-api:latest\n    container_name: finance-api\n    environment:\n      - ConnectionStrings__DefaultConnection=Host=SEU_IP;Database=financecontrol;...\n      - JwtSettings__Secret=SUA_CHAVE_MESTRA\n    restart: always\n\n  finance-web:\n    image: tlsilva89/finance-web:latest\n    container_name: finance-web\n    depends_on:\n      - finance-api\n    ports:\n      - '6013:6013'\n    restart: always\n```\n\n---\n\n## ⚙️ Configuração de Desenvolvimento\n\n### 1. Clone o repositório\n\n```bash\ngit clone https://github.com/seu-usuario/finance-control.git\n```\n\n### 2. Frontend\n\n```bash\ncd frontend\nnpm install\nnpm start # Acessível em http://localhost:6013\n```\n\n### 3. Backend\n\n```bash\ncd backend\ndotnet restore\ndotnet run # Acessível em http://localhost:6012\n```\n\n---\n\n## 🛡️ Arquitetura de Rede\n\nO sistema utiliza o Nginx como ponto de entrada no frontend. Toda chamada realizada para `/api` é automaticamente redirecionada via Proxy Reverso para o container `finance-api`, eliminando problemas de CORS e simplificando a configuração de DNS local.\n\n---\n\n## 📄 Licença\n\nEste projeto está sob licença proprietária. Todos os direitos reservados.\n\n---\n\n**Powered by Digital Spark**  \n*Transformando dados financeiros em inteligência estratégica.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftlsilva89%2Ffinance-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftlsilva89%2Ffinance-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftlsilva89%2Ffinance-control/lists"}