webmoney/docs/DOCUMENTO_INSTITUCIONAL.md
marco 54cccdd095 refactor: migração para desenvolvimento direto no servidor
- Removido README.md padrão do Laravel (backend)
- Removidos scripts de deploy (não mais necessários)
- Atualizado copilot-instructions.md para novo fluxo
- Adicionada documentação de auditoria do servidor
- Sincronizado código de produção com repositório

Novo workflow:
- Trabalhamos diretamente em /root/webmoney (symlink para /var/www/webmoney)
- Mudanças PHP são instantâneas
- Mudanças React requerem 'npm run build'
- Commit após validação funcional
2025-12-19 11:45:32 +01:00

569 lines
18 KiB
Markdown
Executable File
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 🌐 WebMoney - Documento Institucional
## Conteúdo para Website e Marketing
**Versão:** 1.0
**Data:** Dezembro 2025
---
## 📑 Índice
1. [Tagline e Proposta de Valor](#1-tagline-e-proposta-de-valor)
2. [Sobre o Sistema](#2-sobre-o-sistema)
3. [Funcionalidades](#3-funcionalidades)
4. [Público-Alvo](#4-público-alvo)
5. [Diferenciais](#5-diferenciais)
6. [Casos de Uso](#6-casos-de-uso)
7. [Especificações Técnicas](#7-especificações-técnicas)
8. [FAQ](#8-faq)
9. [Conteúdo para Redes Sociais](#9-conteúdo-para-redes-sociais)
---
## 1. Tagline e Proposta de Valor
### Taglines Sugeridas
**Principal:**
> "WebMoney - Sua gestão financeira simplificada"
**Alternativas:**
- "Controle total das suas finanças em um só lugar"
- "Importa. Categoriza. Analisa. Tudo automático."
- "De extratos bancários a insights financeiros"
- "Gestão financeira inteligente para pessoas e empresas"
### Proposta de Valor (Elevator Pitch)
> **WebMoney** é uma plataforma de gestão financeira que transforma seus extratos bancários em inteligência financeira. Importe extratos de qualquer banco, categorize automaticamente com IA, controle financiamentos e recorrências, e tenha visão completa do seu fluxo de caixa. Tudo em uma interface moderna, multi-idioma e acessível de qualquer dispositivo.
---
## 2. Sobre o Sistema
### Descrição Curta (50 palavras)
WebMoney é uma plataforma web de gestão financeira pessoal e empresarial. Permite importar extratos bancários, categorizar transações automaticamente, controlar financiamentos, gerenciar recorrências e visualizar seu fluxo de caixa em tempo real. Suporta múltiplas contas, moedas e idiomas.
### Descrição Média (150 palavras)
WebMoney é uma solução completa de gestão financeira desenvolvida para simplificar o controle de finanças pessoais e de pequenas empresas.
A plataforma permite importar extratos de qualquer banco nos formatos CSV, Excel, OFX ou até PDF, e automaticamente categoriza suas transações usando um sistema inteligente de palavras-chave.
Com recursos avançados como controle de financiamentos com conciliação de parcelas, transações recorrentes automatizadas, detecção inteligente de transferências entre contas e reembolsos, o WebMoney elimina o trabalho manual e fornece insights valiosos sobre suas finanças.
O dashboard apresenta gráficos de fluxo de caixa, análise de variações de pagamento, calendário financeiro e alertas de transações vencidas. Tudo isso em uma interface moderna e responsiva, disponível em português, espanhol e inglês, com suporte a múltiplas moedas.
### Descrição Longa (300 palavras)
**WebMoney** nasceu da necessidade real de uma ferramenta que simplificasse a gestão financeira sem exigir conhecimento contábil ou horas de trabalho manual.
**O Problema:**
A maioria das pessoas e pequenas empresas enfrenta dificuldades para manter o controle financeiro atualizado. Baixar extratos, categorizar manualmente centenas de transações, lembrar de contas fixas, conciliar pagamentos de financiamentos - tarefas que consomem tempo e frequentemente ficam desatualizadas.
**A Solução:**
WebMoney automatiza todo esse processo. Basta importar seus extratos bancários uma vez por mês e o sistema faz o resto. O motor de categorização inteligente aprende suas preferências e categoriza transações automaticamente. Financiamentos são extraídos de PDFs com reconhecimento óptico. Contas recorrentes são lançadas automaticamente. Transferências entre contas são detectadas e vinculadas.
**Recursos Principais:**
- **Importação Universal**: CSV, Excel, OFX e PDF de qualquer banco
- **Categorização Automática**: Sistema de palavras-chave que aprende com você
- **Multi-Conta**: Gerencie contas correntes, poupança, cartões, investimentos
- **Multi-Moeda**: BRL, EUR, USD, GBP e outras
- **Passivos**: Controle financiamentos com extração automática de parcelas
- **Recorrências**: Automatize lançamentos de contas fixas
- **Detecção Inteligente**: Identifica transferências e reembolsos
- **Dashboard Completo**: Gráficos, calendário, alertas em tempo real
**Para Quem:**
- Pessoas que querem organizar suas finanças pessoais
- Autônomos e profissionais liberais
- Pequenas empresas e startups
- Gestores que precisam de visão consolidada
**Tecnologia:**
Desenvolvido com tecnologias modernas (Laravel + React), o WebMoney é uma aplicação web responsiva que funciona em qualquer dispositivo com navegador, sem necessidade de instalação.
---
## 3. Funcionalidades
### 3.1 Lista de Features (para página de funcionalidades)
#### 💳 Gestão de Contas
**Gerencie todas as suas contas em um só lugar**
- Contas correntes, poupança, cartões de crédito
- Carteiras digitais e investimentos
- Saldos atualizados em tempo real
- Ajuste manual quando necessário
- Cores e ícones personalizáveis
#### 📥 Importação de Extratos
**Importe de qualquer banco em segundos**
- Formatos: CSV, XLSX, XLS, OFX, PDF
- Mapeamento inteligente de colunas
- Detecção automática de duplicatas
- Presets para bancos populares
- Salve configurações para reutilizar
#### 🏷️ Categorização Automática
**Nunca mais categorize manualmente**
- Sistema de palavras-chave aprendiz
- Categorias hierárquicas (pai/filho)
- Categorização em lote com um clique
- Subcategorias para detalhamento
- Cores e ícones visuais
#### 🏢 Centros de Custo
**Organize por projeto, cliente ou departamento**
- Estrutura independente das categorias
- Palavras-chave para associação automática
- Relatórios por centro de custo
- Ideal para freelancers e empresas
#### 💰 Controle de Transações
**Visão completa de todas as movimentações**
- Visualização por semana
- Filtros avançados
- Dividir transações (split)
- Transferências entre contas
- Status: pendente, pago, cancelado
#### 📋 Passivos e Financiamentos
**Controle total de suas dívidas**
- Importação de PDF com OCR
- Extração automática de parcelas
- Conciliação com transações
- Análise de juros e taxas
- Progresso visual do pagamento
#### 🔄 Transações Recorrentes
**Automatize suas contas fixas**
- Múltiplas frequências (diária a anual)
- Pausar e retomar
- Conciliar com transações existentes
- Alertas de vencimento
- Criar a partir de transação
#### ↔️ Detecção de Transferências
**Identifica automaticamente transferências**
- Detecta débitos e créditos correspondentes
- Níveis de confiança (alta, média, baixa)
- Confirmação individual ou em lote
- Tolerância de dias configurável
#### 🔁 Detecção de Reembolsos
**Encontra estornos automaticamente**
- Identifica pares compra/reembolso
- Vinculação automática
- Facilita reconciliação
#### 📊 Dashboard Analítico
**Insights financeiros em tempo real**
- Cards de resumo financeiro
- Gráfico de fluxo de caixa
- Calendário de transações
- Alertas de vencimento
- Análise de variações
#### 🌐 Multi-Idioma
**Use no seu idioma**
- Português do Brasil
- Español
- English
- Interface completa traduzida
#### 💱 Multi-Moeda
**Gerencie finanças em qualquer moeda**
- BRL, EUR, USD, GBP e outras
- Cada conta com sua moeda
- Formatação automática
- Símbolos corretos
---
## 4. Público-Alvo
### 4.1 Personas
#### Persona 1: O Profissional Organizado
**Nome:** Carlos, 35 anos
**Profissão:** Desenvolvedor de Software
**Renda:** R$ 15.000/mês
**Dor:** Não consegue manter planilhas atualizadas, perde tempo categorizando extratos manualmente
**Solução:** WebMoney importa seus extratos e categoriza automaticamente
#### Persona 2: O Empreendedor Digital
**Nome:** Ana, 28 anos
**Profissão:** Designer Freelancer
**Renda:** Variável, R$ 8-20.000/mês
**Dor:** Precisa separar gastos pessoais de profissionais, controlar clientes diferentes
**Solução:** WebMoney com centros de custo por cliente
#### Persona 3: O Devedor Controlado
**Nome:** Roberto, 42 anos
**Profissão:** Gerente Comercial
**Renda:** R$ 12.000/mês
**Dor:** Tem financiamento de carro e casa, perde controle das parcelas
**Solução:** WebMoney importa PDFs de financiamento e concilia automaticamente
#### Persona 4: O Casal Unido
**Nomes:** Julia e Pedro, 30 anos
**Profissão:** Advogada e Contador
**Renda:** R$ 25.000/mês combinado
**Dor:** Múltiplas contas, cartões, e precisam de visão consolidada
**Solução:** WebMoney centraliza todas as contas com detecção de transferências
---
## 5. Diferenciais
### 5.1 Comparativo com Concorrentes
| Recurso | WebMoney | Organizze | Mobills | GuiaBolso |
|---------|----------|-----------|---------|-----------|
| Importação CSV/Excel | ✅ | ✅ | ❌ | ❌ |
| Importação PDF | ✅ | ❌ | ❌ | ❌ |
| Importação OFX | ✅ | ✅ | ✅ | ✅ |
| Categorização Automática | ✅ | ✅ | ✅ | ✅ |
| Palavras-chave Customizáveis | ✅ | Limitado | Limitado | ❌ |
| Centros de Custo | ✅ | ❌ | ❌ | ❌ |
| Controle de Financiamentos | ✅ | Básico | ❌ | ❌ |
| Recorrências Avançadas | ✅ | ✅ | ✅ | ✅ |
| Detecção de Transferências | ✅ | ❌ | ❌ | ✅ |
| Detecção de Reembolsos | ✅ | ❌ | ❌ | ❌ |
| Multi-Idioma | ✅ | ❌ | ❌ | ❌ |
| Multi-Moeda Real | ✅ | Limitado | ❌ | ❌ |
| Divisão de Transações | ✅ | ✅ | ❌ | ❌ |
| Web + Responsivo | ✅ | ✅ | App | App |
### 5.2 Diferenciais Únicos
1. **Importação Universal**: Único a importar PDFs de extratos e contratos com OCR
2. **Centros de Custo**: Organização adicional ideal para profissionais
3. **Detecção Dupla**: Identifica transferências E reembolsos automaticamente
4. **Multi-Idioma Nativo**: PT-BR, ES, EN - não tradução automática
5. **Open Source Friendly**: Código limpo e documentado
---
## 6. Casos de Uso
### Caso 1: Organização Mensal de Finanças Pessoais
**Situação:** Maria recebe o extrato do banco todo mês e gasta horas copiando para uma planilha.
**Com WebMoney:**
1. Maria baixa o extrato em CSV do internet banking
2. Importa no WebMoney em 30 segundos
3. O sistema categoriza 80% automaticamente
4. Maria categoriza o restante em lote
5. Dashboard mostra quanto gastou em cada categoria
**Tempo economizado:** 3 horas/mês
---
### Caso 2: Freelancer com Múltiplos Clientes
**Situação:** João é designer e precisa separar gastos por cliente para faturamento.
**Com WebMoney:**
1. João cria centros de custo por cliente
2. Adiciona palavras-chave (nome do cliente nos pagamentos)
3. Transações são associadas automaticamente
4. Relatórios por centro de custo para declaração
**Benefício:** Organização profissional sem esforço
---
### Caso 3: Controle de Financiamento de Veículo
**Situação:** Roberto tem financiamento de carro com 48 parcelas e perde o controle.
**Com WebMoney:**
1. Roberto importa o PDF da simulação/contrato
2. WebMoney extrai todas as parcelas automaticamente
3. Quando paga, o sistema detecta e concilia
4. Dashboard mostra progresso: 12/48 pagas
**Benefício:** Visão clara do progresso e parcelas restantes
---
### Caso 4: Casal com Finanças Compartilhadas
**Situação:** Julia e Pedro têm 4 contas bancárias e 3 cartões de crédito.
**Com WebMoney:**
1. Cadastram todas as contas no sistema
2. Importam extratos de todas as fontes
3. Sistema detecta transferências entre contas deles
4. Dashboard consolida saldo total real
**Benefício:** Visão unificada das finanças do casal
---
### Caso 5: Controle de Assinaturas
**Situação:** Ana não sabe quanto gasta com Netflix, Spotify, iCloud, etc.
**Com WebMoney:**
1. Ana categoriza uma vez como "Assinaturas"
2. Cria recorrências para cada serviço
3. Sistema alerta variações de preço
4. Dashboard mostra total mensal em assinaturas
**Benefício:** Consciência do custo total de assinaturas
---
## 7. Especificações Técnicas
### 7.1 Stack Tecnológico
#### Backend
- **Framework:** Laravel 12 (PHP 8.4)
- **API:** RESTful com Laravel Sanctum (autenticação)
- **Database:** SQLite (development) / MySQL/PostgreSQL (production)
- **Cache:** Redis (opcional)
#### Frontend
- **Framework:** React 18
- **Build Tool:** Vite 7
- **Estilização:** Bootstrap 5 + CSS Custom
- **Gráficos:** Chart.js / Recharts
- **Internacionalização:** react-i18next
#### Infraestrutura
- **Servidor:** PHP-FPM + Nginx
- **Contêiner:** Docker (opcional)
- **SSL:** Let's Encrypt
### 7.2 Requisitos de Sistema
#### Para Usuários
- Navegador moderno (Chrome, Firefox, Safari, Edge)
- Conexão à internet
- Não requer instalação
#### Para Hospedagem
- PHP 8.2+
- Node.js 18+ (para build)
- Banco de dados (SQLite/MySQL/PostgreSQL)
- 1GB RAM mínimo
- 10GB armazenamento
### 7.3 Segurança
- Autenticação por token (Bearer)
- Senhas hasheadas com bcrypt
- HTTPS obrigatório em produção
- Proteção CSRF
- Rate limiting em APIs
- Validação de entrada
- Sanitização de dados
### 7.4 API Endpoints (Resumo)
| Grupo | Endpoints | Descrição |
|-------|-----------|-----------|
| Auth | 4 | Login, registro, logout, perfil |
| Accounts | 6 | CRUD + ajustes de saldo |
| Transactions | 15+ | CRUD + split, transfer, reconcile |
| Categories | 8 | CRUD + keywords + batch |
| Cost Centers | 5 | CRUD + keywords |
| Import | 8 | Upload, map, process |
| Liabilities | 6 | CRUD + installments |
| Recurring | 10 | Templates + instances |
| Detection | 6 | Transfers + refunds |
| Dashboard | 8 | Charts + widgets |
---
## 8. FAQ
### Perguntas Frequentes
**P: O WebMoney se conecta diretamente ao meu banco?**
R: Não. O WebMoney não se conecta via Open Banking. Você baixa o extrato do seu banco e importa manualmente. Isso garante maior segurança e privacidade.
**P: Meus dados financeiros estão seguros?**
R: Sim. Os dados são armazenados com criptografia, senhas são hasheadas e toda comunicação usa HTTPS. Não compartilhamos dados com terceiros.
**P: Posso usar no celular?**
R: Sim! O WebMoney é responsivo e funciona perfeitamente em smartphones e tablets através do navegador.
**P: Quantas contas posso cadastrar?**
R: Não há limite. Você pode cadastrar quantas contas, categorias e transações precisar.
**P: O sistema funciona com bancos digitais?**
R: Sim! Funciona com qualquer banco que permita exportar extratos em CSV, Excel ou OFX - incluindo Nubank, Inter, C6, etc.
**P: Posso dividir uma transação em várias categorias?**
R: Sim! O recurso de Split permite dividir uma transação, como uma compra de supermercado que inclui alimentação e limpeza.
**P: Como funciona a detecção de transferências?**
R: O sistema analisa suas transações e identifica automaticamente quando um débito em uma conta corresponde a um crédito em outra (mesmo valor, datas próximas).
**P: Posso usar em espanhol ou inglês?**
R: Sim! O sistema suporta nativamente Português, Espanhol e Inglês. Basta selecionar no menu.
**P: Precisa instalar alguma coisa?**
R: Não! WebMoney é uma aplicação web. Basta acessar pelo navegador.
---
## 9. Conteúdo para Redes Sociais
### 9.1 Posts para Instagram/LinkedIn
**Post 1: Introdução**
```
🚀 Chega de planilhas!
Conheça o WebMoney - sua gestão financeira simplificada.
✅ Importe extratos de qualquer banco
✅ Categorização automática
✅ Controle de financiamentos
✅ Multi-conta e multi-moeda
Sua vida financeira organizada em minutos!
#gestaofinanceira #financaspessoais #controle #organizacao
```
**Post 2: Feature - Importação**
```
📥 Importação Universal
Com o WebMoney você importa extratos em:
• CSV
• Excel
• OFX
• Até PDF!
Funciona com qualquer banco: Nubank, Itaú, Bradesco, Inter, C6...
Adeus digitação manual! 👋
#extratobancario #importacao #financas
```
**Post 3: Feature - Categorização**
```
🏷️ Nunca mais categorize manualmente!
O WebMoney aprende suas preferências e categoriza transações automaticamente.
Como funciona:
1⃣ Defina palavras-chave (ex: "UBER" = Transporte)
2⃣ Importe seu extrato
3⃣ Pronto! Categorização automática
Tempo economizado: 3 horas/mês 🕐
#automacao #produtividade #financas
```
**Post 4: Feature - Passivos**
```
📋 Financiamento sob controle
Tem financiamento de carro, casa ou empréstimo?
Com o WebMoney você:
✅ Importa o PDF do contrato
✅ Extrai parcelas automaticamente
✅ Concilia com pagamentos
✅ Visualiza progresso
Saiba exatamente quanto falta pagar!
#financiamento #dividas #controle
```
**Post 5: Feature - Multi-idioma**
```
🌍 Fale nossa língua!
O WebMoney está disponível em:
🇧🇷 Português
🇪🇸 Español
🇺🇸 English
Gestão financeira sem barreiras de idioma.
#multilingual #global #financas
```
### 9.2 Headlines para Anúncios
- "Importe seu extrato em 30 segundos"
- "Categorização automática que aprende com você"
- "Múltiplas contas, uma visão consolidada"
- "De 3 horas para 5 minutos"
- "Financiamentos sob controle total"
- "Sua planilha de gastos. Só que automática."
### 9.3 Call to Actions
- "Comece grátis agora"
- "Experimente sem compromisso"
- "Organize suas finanças hoje"
- "Veja como funciona"
- "Crie sua conta grátis"
---
## 📎 Anexos
### Anexo A: Lista Completa de Ícones de Contas
- bi-bank (Banco)
- bi-piggy-bank (Poupança)
- bi-credit-card (Cartão)
- bi-wallet (Carteira)
- bi-graph-up (Investimentos)
- bi-cash-stack (Dinheiro)
- bi-phone (Digital)
### Anexo B: Tipos de Conta
- checking (Conta Corrente)
- savings (Poupança)
- credit_card (Cartão de Crédito)
- investment (Investimentos)
- cash (Dinheiro)
- digital_wallet (Carteira Digital)
- other (Outros)
### Anexo C: Frequências de Recorrência
- daily (Diária)
- weekly (Semanal)
- biweekly (Quinzenal)
- monthly (Mensal)
- bimonthly (Bimestral)
- quarterly (Trimestral)
- semiannual (Semestral)
- annual (Anual)
---
*Documento gerado em Dezembro 2025*
*WebMoney - Sua gestão financeira simplificada*