Idrissa Banora
9.0 KiB
9.0 KiB
🚀 Guia Rápido de Testes - SIGEFP
Para testadores e desenvolvedores
Versão: 1.0
📋 Checklist de Testes por Módulo
Use este guia para verificar rapidamente se cada funcionalidade está funcionando corretamente.
✅ Módulo Administração
Utilizadores
- Criar utilizador com dados válidos
- Tentar criar com username duplicado (deve dar erro)
- Tentar criar com email inválido (deve dar erro)
- Editar utilizador existente
- Atribuir perfis a utilizador
- Desativar utilizador
Perfis
- Criar perfil com código único
- Tentar criar com código duplicado (deve dar erro)
- Atribuir permissões ao perfil
- Editar perfil existente
Auditoria
- Consultar todos os logs
- Filtrar por utilizador
- Filtrar por módulo
- Filtrar por período
- Exportar logs
✅ Módulo Organização
Ministérios
- Criar ministério
- Tentar criar com código duplicado (deve dar erro)
- Editar ministério
- Buscar ministério
Unidades Orgânicas
- Criar unidade de nível 1 (sem pai)
- Criar unidade de nível 2 (com pai)
- Verificar hierarquia
- Filtrar por ministério
Cargos
- Criar cargo
- Tentar criar com código duplicado (deve dar erro)
- Editar cargo
- Buscar cargo
✅ Módulo RH & Folha
Agentes
- Criar agente completo
- Tentar criar com matrícula duplicada (deve dar erro)
- Editar agente
- Visualizar detalhes completos
- Filtrar por status
- Filtrar por ministério
- Exportar lista (PDF/Excel)
Contratos
- Criar contrato permanente
- Criar contrato temporário
- Tentar criar dois contratos ativos (deve dar erro)
- Editar contrato
- Filtrar por agente
Contas Bancárias
- Criar conta bancária
- Marcar como primária
- Tentar criar segunda primária (deve desmarcar anterior)
- Editar conta
Grelha Salarial
- Visualizar estrutura completa
- Criar categoria
- Criar grau
- Criar escalão
- Definir valor para escalão
Períodos de Folha
- Criar período
- Abrir período (DRAFT → OPEN)
- Tentar abrir dois períodos (deve dar erro)
- Fechar período (OPEN → CLOSED)
Processamento
- Criar processamento
- Processar folha (calcular itens)
- Verificar cálculos:
- Vencimento base
- Proventos (abono)
- Descontos (INPS, IRPS, Selo)
- Gerar ordens de pagamento
- Exportar folha
Regras de Imposto
- Visualizar regras ativas
- Criar regra de INPS
- Criar regra de Selo
- Desativar regra antiga
Escalões IRPS
- Visualizar escalões
- Criar novo escalão
- Verificar que não há sobreposição
- Editar escalão
Avaliações
- Visualizar avaliações
- Finalizar avaliação DRAFT
- Verificar cálculo de menção
- Filtrar por agente
- Filtrar por ano
✅ Módulo Orçamento
Exercícios Fiscais
- Criar exercício
- Abrir exercício (DRAFT → OPEN)
- Tentar abrir dois exercícios (deve dar erro)
- Fechar exercício (OPEN → CLOSED)
Linhas Orçamentais
- Criar linha
- Verificar saldos iniciais
- Após processar folha, verificar comprometimento
- Após liquidação, verificar saldo liquidado
- Após pagamento, verificar saldo pago
Execução
- Visualizar todos os movimentos
- Filtrar por linha
- Filtrar por período
- Filtrar por tipo (COMMITMENT, LIQUIDATION, PAYMENT)
- Verificar sequência correta
✅ Módulo Tesouraria
Lotes de Pagamento
- Criar lote
- Atualizar status (CREATED → SENT_TO_BANK)
- Atualizar status (SENT_TO_BANK → CONFIRMED)
- Filtrar por período
- Filtrar por ministério
Ordens de Pagamento
- Visualizar ordens geradas
- Verificar valores (bruto vs líquido)
- Filtrar por lote
- Filtrar por status
- Visualizar detalhes
Confirmações
- Registrar confirmação
- Marcar como PAID
- Verificar criação de PAYMENT no orçamento
- Verificar atualização de saldo
- Filtrar por status
✅ Módulo Dados Comuns
Bancos
- Criar banco
- Tentar criar com código duplicado (deve dar erro)
- Editar banco
- Verificar uso em contas bancárias
🔄 Fluxo Integrado Completo
Teste End-to-End
Pré-requisitos:
- Banco criado
- Ministério criado
- Unidade orgânica criada
- Cargo criado
Passos:
- Criar exercício fiscal 2025 e abrir
- Criar linha orçamentária (valor: 10.000.000 XOF)
- Criar período de folha Janeiro 2025 e abrir
- Criar agente completo
- Criar contrato (salário: 600.000 XOF)
- Criar conta bancária primária
- Criar processamento de folha
- Processar folha
- Verificar:
- Itens calculados corretamente
- COMMITMENT criado
- Saldo disponível atualizado
- Gerar ordens de pagamento
- Criar lote de pagamento
- Enviar lote ao banco
- Registrar confirmação (PAID)
- Verificar:
- PAYMENT criado
- Saldo disponível atualizado
Resultado Esperado:
- ✅ Todos os passos executados sem erros
- ✅ Valores calculados corretamente
- ✅ Integração funcionando
- ✅ Saldos corretos
🧮 Teste de Cálculos
Cenário: Agente com Salário 600.000 XOF
Dados:
- Salário base: 600.000 XOF
- 2 dependentes (abono: 2.000 XOF cada)
- INPS: 7%
- Selo: 0.3%
- IRPS: conforme escalões
Cálculos Esperados:
- Vencimento Base: 600.000 XOF
- Abono de Família: 4.000 XOF (2 × 2.000)
- Total Bruto: 604.000 XOF
- INPS (7%): 42.280 XOF
- Selo (0.3%): 1.812 XOF
- Base IRPS: 561.720 XOF (604.000 - 42.280)
- IRPS: ~46.172 XOF (conforme escalão)
- Total Descontos: ~90.264 XOF
- Valor Líquido: ~513.736 XOF
Verificações:
- Vencimento base correto
- Abono calculado corretamente
- INPS calculado corretamente
- Selo calculado corretamente
- IRPS calculado corretamente
- Valor líquido correto
⚠️ Teste de Validações
Cenários de Erro Esperados
- Criar agente com matrícula duplicada → ERRO
- Criar contrato sem agente → ERRO
- Processar folha com período fechado → ERRO
- Criar linha com exercício fechado → ERRO
- Gerar ordens sem folha processada → ERRO
- Registrar pagamento sem ordem → ERRO
- Abrir dois períodos para mesmo mês → ERRO
- Abrir dois exercícios → ERRO
- Criar dois contratos ativos para mesmo agente → ERRO
- Criar duas contas primárias para mesmo agente → ERRO
Verificações:
- Mensagem de erro apropriada exibida
- Dados não foram salvos
- Sistema permanece em estado consistente
📊 Teste de Integração Orçamentária
Cenário: Folha de 800.000 XOF em linha com 1.000.000 XOF
Passos:
- Criar linha com saldo: 1.000.000 XOF
- Processar folha bruto: 800.000 XOF
- Verificar COMMITMENT: 800.000 XOF
- Verificar saldo disponível: 200.000 XOF
- Processar liquidação
- Verificar LIQUIDATION: 800.000 XOF
- Confirmar pagamento líquido: 700.000 XOF
- Verificar PAYMENT: 700.000 XOF
- Verificar saldo disponível: 200.000 XOF (mantido)
Verificações:
- COMMITMENT criado corretamente
- LIQUIDATION criado corretamente
- PAYMENT criado corretamente
- Saldos atualizados corretamente
- Sequência respeitada
🔍 Checklist de Coerência e Lógica
Validações de Negócio
- Período deve estar aberto para processar folha
- Exercício deve estar aberto para criar linhas
- Agente deve ter contrato ativo
- Agente deve ter conta bancária primária
- Linha deve ter saldo disponível
- Folha deve estar COMPLETED para gerar ordens
- Ordem deve estar em lote para enviar
- Status só pode avançar (não retroceder)
Integridade de Dados
- IDs referenciados existem
- Relacionamentos são válidos
- Valores não são negativos
- Datas são válidas (não futuras onde aplicável)
- Códigos são únicos
- Status são consistentes
Cálculos
- Vencimento = valor do escalão
- Proventos somados corretamente
- Descontos calculados corretamente
- Valor líquido = bruto - descontos
- Saldo disponível = alocado - comprometido
- Percentuais aplicados corretamente
📝 Notas para Testes
- Use dados de teste do banco (
insert_all_test_data.sqleinsert_functional_test_data.sql) - Teste em ordem recomendada (Dados Comuns → Organização → Orçamento → RH → Folha → Tesouraria)
- Verifique logs do backend para erros
- Compare valores com cálculos manuais
- Teste casos extremos (valores zero, valores muito altos, datas inválidas)
- Teste validações tentando ações inválidas
- Verifique integração entre módulos
Guia gerado em: 2025-01-XX
Versão: 1.0