╔═══════════════════════════════════════════════════════════════════════════════╗
║                     DIRETRIZES DE DESENVOLVIMENTO - v3.0                       ║
║                                                                                 ║
║  ⚠️  ESTE ARQUIVO NÃO DEVE SER EDITADO APÓS QUALQUER COMMIT/PUSH               ║
║  ⚠️  Representa o contrato de desenvolvimento desde a versão 1.19.2            ║
║  ⚠️  Substitui .DIRETRIZES_DESENVOLVIMENTO_v2 (v2.0)                           ║
║                                                                                 ║
╚═══════════════════════════════════════════════════════════════════════════════╝

DATA DE CRIAÇÃO: 10 de Dezembro de 2025
VERSÃO INICIAL: 1.19.2
VERSÃO DAS DIRETRIZES: 3.0
STATUS: ATIVO E IMUTÁVEL

═══════════════════════════════════════════════════════════════════════════════
                              REGRAS DE DESENVOLVIMENTO
═══════════════════════════════════════════════════════════════════════════════

───────────────────────────────────────────────────────────────────────────────
REGRA #1: CONTROLE DE VERSÃO SEMÂNTICO
───────────────────────────────────────────────────────────────────────────────

✓ Formato: MAJOR.MINOR.PATCH (exemplo: 1.19.2)
✓ Incrementar versão em CADA commit/push
✓ Manter sincronizado em: VERSION, CHANGELOG.md

Regra de Incremento:
  - MAJOR (X.0.0): Mudanças incompatíveis, redesign completo
  - MINOR (0.X.0): Novas funcionalidades
  - PATCH (0.0.X): Correções de bugs, ajustes menores

───────────────────────────────────────────────────────────────────────────────
REGRA #2: VALIDAÇÃO OBRIGATÓRIA EM PRODUÇÃO
───────────────────────────────────────────────────────────────────────────────

✓ TODAS as mudanças devem ser testadas em https://webmoney.cnxifly.com
✓ Workflow obrigatório:
  1. Editar código
  2. Deploy para servidor (./deploy.sh)
  3. Testar no domínio
  4. Commit/push apenas após validação
  5. Só então editar novamente

✗ PROIBIDO commit sem teste em produção

───────────────────────────────────────────────────────────────────────────────
REGRA #3: DOCUMENTAÇÃO ESSENCIAL
───────────────────────────────────────────────────────────────────────────────

Arquivos de documentação mantidos (apenas estes):

| Arquivo | Propósito | Atualizar quando |
|---------|-----------|------------------|
| VERSION | Número da versão | Cada commit |
| CHANGELOG.md | Histórico de mudanças | Cada commit |
| README.md | Visão geral do projeto | Mudanças significativas |
| ESTRUTURA_PROJETO.md | Estrutura técnica | Novos arquivos/endpoints |
| CREDENCIAIS_SERVIDOR.md | Acessos | Mudança de credenciais |
| .DIRETRIZES_DESENVOLVIMENTO_v3 | Este arquivo | NUNCA (criar nova versão) |

Arquivos de referência (não atualizar frequentemente):
- ESPECIFICACIONES_WEBMONEY.md (especificação original)
- APRENDIZADOS_TECNICOS.md (soluções de problemas)
- ROTEIRO_INSTALACAO_SERVIDOR.md (guia de instalação)
- DKIM_DNS_RECORD.txt (configuração DNS)

───────────────────────────────────────────────────────────────────────────────
REGRA #4: SCRIPTS DE DEPLOY
───────────────────────────────────────────────────────────────────────────────

✓ SEMPRE usar os scripts de deploy:

  Frontend: cd frontend && ./deploy.sh
  Backend:  cd backend && ./deploy.sh

✗ NUNCA enviar arquivos manualmente via scp para diretórios errados
✓ Os scripts garantem o caminho correto:
  - Frontend → /var/www/webmoney/frontend/dist
  - Backend  → /var/www/webmoney/backend

───────────────────────────────────────────────────────────────────────────────
REGRA #5: CHECKLIST DE COMMIT
───────────────────────────────────────────────────────────────────────────────

Antes de CADA commit:
  ☑ VERSION atualizado
  ☑ CHANGELOG.md atualizado
  ☑ Deploy executado (./deploy.sh)
  ☑ Testado em webmoney.cnxifly.com
  ☑ Sem erros no console do navegador
  ☑ Mensagem de commit descritiva

───────────────────────────────────────────────────────────────────────────────
REGRA #6: PROIBIÇÕES EXPLÍCITAS
───────────────────────────────────────────────────────────────────────────────

✗ NÃO editar arquivos sem commit anterior
✗ NÃO criar documentação específica de versão (ex: DEPLOY_v1.9.0.md)
✗ NÃO duplicar informação em múltiplos arquivos
✗ NÃO fazer deploy manual (usar scripts)
✗ NÃO commitar sem testar em produção

═══════════════════════════════════════════════════════════════════════════════
                              INFRAESTRUTURA
═══════════════════════════════════════════════════════════════════════════════

───────────────────────────────────────────────────────────────────────────────
SERVIDOR DE PRODUÇÃO
───────────────────────────────────────────────────────────────────────────────

IP: 213.165.93.60
Acesso: sshpass -p 'Master9354' ssh root@213.165.93.60

Estrutura:
  /var/www/webmoney/
  ├── backend/          # Laravel API
  └── frontend/
      └── dist/         # React build (Nginx root)

───────────────────────────────────────────────────────────────────────────────
DOMÍNIOS
───────────────────────────────────────────────────────────────────────────────

| Subdomínio | Função |
|------------|--------|
| webmoney.cnxifly.com | Aplicação principal |
| phpmyadmin.cnxifly.com | Banco de dados |
| webmail.cnxifly.com | Email |
| mail.cnxifly.com | PostfixAdmin |

───────────────────────────────────────────────────────────────────────────────
STACK TECNOLÓGICA
───────────────────────────────────────────────────────────────────────────────

| Camada | Tecnologia |
|--------|------------|
| Backend | Laravel 12 + PHP 8.4-FPM |
| Frontend | React 18 + Vite 7 + Bootstrap 5 |
| Banco | MariaDB 11.4 |
| Cache | Redis |
| Servidor | Nginx + SSL (Let's Encrypt) |
| Auth | Laravel Sanctum (Bearer Tokens) |

═══════════════════════════════════════════════════════════════════════════════
                              SEGURANÇA
═══════════════════════════════════════════════════════════════════════════════

Implementado em v1.19.0:

| Recurso | Configuração |
|---------|--------------|
| Rate Limiting | Login: 5/min, Register: 10/hour |
| CORS | Restrito a webmoney.cnxifly.com |
| Token Expiration | 7 dias |
| Cookies | HttpOnly, Secure, SameSite=lax, Encrypt=true |
| Headers | X-XSS-Protection, X-Content-Type-Options, X-Frame-Options, CSP |
| Cookie Consent | Banner LGPD/GDPR |

═══════════════════════════════════════════════════════════════════════════════
                              ESTADO ATUAL
═══════════════════════════════════════════════════════════════════════════════

Versão: 1.19.2
Data: 10 de Dezembro de 2025
Status: Produção estável

Funcionalidades:
  ✅ Autenticação (login, registro, logout)
  ✅ Dashboard (gráficos, análises)
  ✅ Contas bancárias (CRUD, multi-moeda)
  ✅ Transações (agrupamento por semana, filtros)
  ✅ Categorias (175 pré-configuradas, auto-classificação)
  ✅ Centros de custo
  ✅ Importação de extratos (XLSX, CSV, OFX, PDF)
  ✅ Detecção de duplicatas (auto-delete)
  ✅ Detecção de transferências
  ✅ Contas passivo (financiamentos)
  ✅ Multi-idioma (ES, PT-BR, EN) com detecção por país
  ✅ Tema dark
  ✅ Cookie consent (LGPD/GDPR)
  ✅ Segurança hardening

═══════════════════════════════════════════════════════════════════════════════
                              HISTÓRICO DE DIRETRIZES
═══════════════════════════════════════════════════════════════════════════════

| Versão | Data | Mudanças |
|--------|------|----------|
| v1.0 | 2025-12-07 | Criação inicial |
| v2.0 | 2025-12-08 | Adicionada REGRA #8 (ESTRUTURA_PROJETO) |
| v3.0 | 2025-12-10 | Simplificação, remoção de redundâncias, estado atual |

Arquivos de diretrizes:
  - .DIRETRIZES_DESENVOLVIMENTO (v1.0 - EXCLUÍDO)
  - .DIRETRIZES_DESENVOLVIMENTO_v2 (v2.0 - arquivado)
  - .DIRETRIZES_DESENVOLVIMENTO_v3 (v3.0 - ATIVO)

═══════════════════════════════════════════════════════════════════════════════
                              ⚠️ LEMBRETE FINAL
═══════════════════════════════════════════════════════════════════════════════

ANTES de editar qualquer arquivo:
  1. ✓ Último commit foi feito?
  2. ✓ VERSION será incrementado?
  3. ✓ CHANGELOG será atualizado?
  4. ✓ Deploy será feito via script?
  5. ✓ Teste em produção será realizado?

Este documento é IMUTÁVEL. Qualquer mudança requer criar v4.0.

═══════════════════════════════════════════════════════════════════════════════