# 🚀 PLANO MESTRE DE IMPLEMENTAÇÃO: SIGEFP (FASE DE ENDURECIMENTO)

**Versão:** 1.0 (Auditada)
**Objetivo:** Transitar de um protótipo funcional para um Sistema de Estado de alta disponibilidade, corrigindo riscos críticos e completando a interface de finanças.

---

## 🏗️ FASE 1: HARDENING E SEGURANÇA (PRIORIDADE CRÍTICA - BACKEND)

Esta fase foca em eliminar riscos de integridade de dados e preparar o sistema para escala nacional.

### 1. Refatoração de Identificadores (UUID Bridge)
- **Problema**: `PaymentOrderService` usa `.hashCode()` para referências Long entre módulos.
- **Ação**: Implementar uma estratégia de ID sequencial real ou migrar referências cruzadas para UUID nativo no banco de dados.
- **Arquivo Alvo**: `sigefp-treasury/src/main/java/br/gov/sigefp/treasury/service/PaymentOrderService.java`

### 2. Iniciação da Suíte de Testes (Cobertura 0% -> 40%)
- **Foco**: Motores de Cálculo e Integração Orçamentária.
- **Ações**:
    - Criar `PayrollServiceTest` para validar INPS, IRPS e Selo.
    - Criar `BudgetExecutionServiceTest` para testar bloqueio de saldo insuficiente.
    - Implementar Testes de Integração para o fluxo `RH -> Budget -> Treasury`.

### 3. Padronização de Exceções e Respostas Erro
- **Ação**: Expandir o `GlobalExceptionHandler` com `ErrorCode` específicos para falta de saldo, agente inativo e período fechado.

---

## 💻 FASE 2: COMPLETUDE DO FRONTEND (MÓDULOS PLACEHOLDER)

Transformar as rotas vazias em interfaces funcionais baseadas na lógica já existente no backend.

### 1. Módulo de Orçamento (Budget UI)
- **Páginas**: 
    - `FiscalYearsPage`: Gestão de abertura/fechamento de exercícios.
    - `BudgetLinesPage`: Visualização de saldos alocados vs. comprometidos.
    - `BudgetExecutionPage`: Consulta de movimentos orçamentários.

### 2. Módulo de Tesouraria (Treasury UI)
- **Páginas**:
    - `PaymentBatchesPage`: Criação e envio de lotes de pagamento para o Banco Central.
    - `PaymentOrdersPage`: Visualização e auditoria de ordens de pagamento individuais.

### 3. Dashboard Real-Time
- **Ação**: Substituir os gráficos mockados por chamadas reais aos endpoints `/api/rh/agents/stats` e futuros endpoints de execução orçamentária.

---

## ⚖️ FASE 3: LÓGICA DE NEGÓCIO E CONFORMIDADE LEGAL

Assegurar que o sistema execute as regras do Decreto 12-A/94 de forma automática.

### 1. Automação de Progressão/Promoção
- **Ação**: Integrar `PerformanceEvaluationService` com `CareerEventService`. Ao atingir a pontuação necessária em 3 anos, o sistema deve sugerir a promoção do agente.

### 2. Fechamento de Ciclo de Folha
- **Ação**: Implementar no Frontend a funcionalidade de "Encerrar Período", que dispara a liquidação orçamentária definitiva para todos os itens de folha.

---

## 📊 MÉTRICAS DE SUCESSO DO PLANO

| KPI | Atual | Meta (Fase 1) |
| :--- | :--- | :--- |
| **Cobertura de Testes** | 0% | 40% |
| **Interfaces Financeiras** | Placeholder | Funcional |
| **Risco de Colisão IDs** | Alto | Zero |
| **Dashboard** | Mockado | Real-Time |

---
**Instrução para Cursor/Outras IAs:** Ao atuar neste plano, SEMPRE valide a trilha de auditoria em `STATUS_PROJETO.md` para garantir que nenhuma regra do Decreto 12-A/94 seja violada.
