https://github.com/tlsilva89/finance-control
Um sistema completo de controle financeiro pessoal
https://github.com/tlsilva89/finance-control
nodejs sqlite tailwindcss typescript vue
Last synced: 3 months ago
JSON representation
Um sistema completo de controle financeiro pessoal
- Host: GitHub
- URL: https://github.com/tlsilva89/finance-control
- Owner: tlsilva89
- Created: 2025-06-28T00:43:00.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-06-28T19:36:17.000Z (12 months ago)
- Last Synced: 2025-06-28T20:33:46.891Z (12 months ago)
- Topics: nodejs, sqlite, tailwindcss, typescript, vue
- Language: Vue
- Homepage:
- Size: 302 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Finance Control
**Sistema Inteligente de Gestão Financeira Pessoal**
O 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.
---
## 🚀 Funcionalidades Principais
- **Visão Geral Dinâmica**: Painel com indicadores em tempo real de Ganhos, Saídas Reais, Saldo Final e Metas de Economia
- **Gestão de Cartões**: Monitoramento detalhado de faturas, limites e datas de fechamento/vencimento
- **Análise Inteligente**: Relatórios detalhados com distribuição de custos e evolução patrimonial semestral
- **Calculadora de Divisão da Casa**: Ferramenta utilitária para divisão justa de gastos comuns entre moradores ou familiares
- **Gestão de Custos Fixos**: Controle rigoroso de assinaturas (streaming, software) e serviços (água, luz, internet)
- **Exportação de Dados**: Geração de relatórios mensais em PDF para auditoria pessoal
---
## 🛠️ Tecnologias Utilizadas
### Frontend
- **Angular 19+**: Framework base utilizando Signals para alta performance
- **Tailwind CSS v4**: Estilização de última geração com design system Dark Premium
- **Chart.js**: Visualização de dados através de gráficos interativos
- **Ng-Icons**: Biblioteca de ícones Heroicons integrada
- **Nginx**: Servidor web e Proxy Reverso para ambiente de produção
### Backend
- **C# (.NET 10)**: API de alto desempenho e escalável
- **PostgreSQL**: Banco de dados relacional robusto
- **JWT (JSON Web Token)**: Autenticação segura de usuários
- **Entity Framework Core**: ORM para persistência de dados
---
## 📦 Estrutura do Projeto
```
finance-control/
├── backend/ # API em .NET 10
│ ├── Dockerfile # Configuração para containerização da API
│ └── ...
└── frontend/ # Aplicação Angular
├── src/ # Código fonte do sistema
├── public/ # Ativos estáticos e logotipos
├── Dockerfile # Build multi-stage para Angular + Nginx
└── nginx.conf # Configuração de Proxy Reverso (/api)
```
---
## 🐳 Deploy com Docker (TrueNAS Scale)
A aplicação foi desenhada para rodar em containers, facilitando o gerenciamento no TrueNAS ou qualquer ambiente Docker.
### Exemplo de Docker Compose
```yaml
services:
finance-api:
image: tlsilva89/finance-api:latest
container_name: finance-api
environment:
- ConnectionStrings__DefaultConnection=Host=SEU_IP;Database=financecontrol;...
- JwtSettings__Secret=SUA_CHAVE_MESTRA
restart: always
finance-web:
image: tlsilva89/finance-web:latest
container_name: finance-web
depends_on:
- finance-api
ports:
- '6013:6013'
restart: always
```
---
## ⚙️ Configuração de Desenvolvimento
### 1. Clone o repositório
```bash
git clone https://github.com/seu-usuario/finance-control.git
```
### 2. Frontend
```bash
cd frontend
npm install
npm start # Acessível em http://localhost:6013
```
### 3. Backend
```bash
cd backend
dotnet restore
dotnet run # Acessível em http://localhost:6012
```
---
## 🛡️ Arquitetura de Rede
O 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.
---
## 📄 Licença
Este projeto está sob licença proprietária. Todos os direitos reservados.
---
**Powered by Digital Spark**
*Transformando dados financeiros em inteligência estratégica.*