🚀 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.

3.2 KiB Raw Blame History