webmoney/README.md

115 lines
3.9 KiB
Markdown

# WEBMoney - ConneXiFly
**Versão atual:** `1.27.1`
**Última atualização:** 13 de Dezembro de 2025
## 🌐 Visão Geral
Sistema de gestão financeira pessoal com interface moderna e funcionalidades avançadas.
| Componente | URL |
|------------|-----|
| **Aplicação** | https://webmoney.cnxifly.com |
| **API Backend** | https://webmoney.cnxifly.com/api |
| **phpMyAdmin** | https://phpmyadmin.cnxifly.com |
| **Webmail** | https://webmail.cnxifly.com |
## 🛠️ Stack Tecnológica
| Camada | Tecnologia |
|--------|------------|
| **Backend** | Laravel 12 + PHP 8.4 |
| **Frontend** | React 18 + Vite 7 + Bootstrap 5 |
| **Banco de Dados** | MariaDB 11.4 |
| **Cache/Sessões** | Redis |
| **Servidor** | Nginx + SSL (Let's Encrypt) |
| **Autenticação** | Laravel Sanctum (Bearer Tokens) |
## ✅ Funcionalidades
### Core
- 🔐 **Autenticação** - Login/registro com tokens seguros
- 📊 **Dashboard** - Gráficos de fluxo de caixa, calendário, próximos vencimentos e vencidos
- 💰 **Contas Bancárias** - CRUD com ícones, cores e multi-moeda
- 📁 **Categorias** - 175 categorias com auto-classificação por keywords
- 🏢 **Centros de Custo** - Organização por projetos/departamentos
- 💳 **Transações** - Agrupamento por semana, filtros avançados
### Avançado
- 📥 **Importação de Extratos** - XLSX, XLS, CSV, OFX, PDF
- 🔍 **Detecção de Duplicatas** - Identificação inteligente com auto-delete
- 🔄 **Detecção de Transferências** - Identifica movimentações entre contas
- 💸 **Detecção de Reembolsos** - Identifica pares gasto/devolução que se anulam
- 🏦 **Contas Passivo** - Financiamentos e empréstimos com parcelas
- 🔁 **Transações Recorrentes** - Templates com geração automática de parcelas
### Interface
- 🌙 **Tema Dark** - Interface profissional escura
- 🌍 **Multi-idioma** - ES, PT-BR, EN (detecção automática por país)
- 💱 **Multi-moeda** - 15 moedas suportadas
- 📱 **Responsivo** - Desktop e mobile
- 🍪 **Cookie Consent** - Banner LGPD/GDPR compliance
### Segurança (v1.19.0)
- 🛡️ **Rate Limiting** - 5 tentativas de login/min
- 🔒 **Security Headers** - XSS, CSP, HSTS
- 🍪 **Cookie Hardening** - HttpOnly, Secure, SameSite
- 🌐 **CORS** - Restrito ao domínio de produção
## 📦 Estrutura do Projeto
```
webmoney/
├── backend/ # Laravel API
│ ├── app/
│ │ ├── Http/Controllers/Api/ # Endpoints
│ │ ├── Models/ # Eloquent Models
│ │ └── Services/ # Lógica de negócio
│ ├── database/migrations/ # Schema do banco
│ └── routes/api.php # Rotas da API
├── frontend/ # React SPA
│ ├── src/
│ │ ├── components/ # Componentes reutilizáveis
│ │ ├── pages/ # Páginas da aplicação
│ │ ├── services/ # Chamadas API
│ │ └── i18n/ # Traduções
│ └── dist/ # Build de produção
├── VERSION # Versão atual
├── CHANGELOG.md # Histórico de mudanças
└── ESTRUTURA_PROJETO.md # Documentação técnica detalhada
```
## 🚀 Deploy
### Frontend
```bash
cd frontend && ./deploy.sh
```
### Backend
```bash
cd backend && ./deploy.sh
```
## 📖 Documentação
| Arquivo | Descrição |
|---------|-----------|
| `CHANGELOG.md` | Histórico completo de versões |
| `ESTRUTURA_PROJETO.md` | Estrutura detalhada, endpoints, banco |
| `CREDENCIAIS_SERVIDOR.md` | Acessos ao servidor (confidencial) |
| `ESPECIFICACIONES_WEBMONEY.md` | Especificação funcional original |
| `.DIRETRIZES_DESENVOLVIMENTO_v2` | Regras de desenvolvimento |
## 🔗 Links Úteis
- **Servidor:** 213.165.93.60
- **Domínio:** cnxifly.com
- **Repositório:** github.com/marcoitaloesp-ai/webmoney
---
© 2025 ConneXiFly - WEBMoney