Idrissa Banora
72 lines
3.2 KiB
Markdown
72 lines
3.2 KiB
Markdown
# 🚀 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.
|