desk-moloni/PLANO_CORRECAO_QUALIDADE.md

🎯 PLANO DE CORREÇÃO - QUALITY ASSURANCE

Projeto: desk-moloni
Data: 2025-09-13
Responsável: Master Orchestrator - Quality Assurance Team

📊 ANÁLISE DE PROBLEMAS IDENTIFICADOS

🚨 CRÍTICOS (P1) - BLOQUEIAM PRODUÇÃO

1. Erro Sintaxe PHP - ClientSyncService.php:450

   • Issue: Falta ponto e vírgula na linha 450
   • Impact: Fatal error que impede execução
   • Esforço: 5 min

2. Erro Sintaxe Switch - SyncWorkflowFeatureTest.php:262

   • Issue: Sintaxe incorreta no case statement
   • Impact: Testes não executam
   • Esforço: 10 min

⚠️ ALTOS (P2) - AFETAM FUNCIONALIDADE

3. Extensões PHP Faltantes

   • Issues: dom, mbstring, xml, xmlwriter
   • Impact: PHPUnit não executa, testes bloqueados
   • Esforço: 15 min (instalação sistema)

4. Problemas Namespace

   • Files: Encryption.php, EntityMappingService.php
   • Impact: Autoloading falha
   • Esforço: 20 min

📁 MÉDIOS (P3) - COMPLIANCE

5. Estrutura Diretório

   • Issue: Diretório assets/ em falta
   • Impact: Validação produção falha
   • Esforço: 5 min

6. Autoloading PSR-4

   • Issue: Classes de teste não seguem PSR-4
   • Impact: Performance de autoloading
   • Esforço: 15 min

🛠️ PLANO DE CORREÇÃO ESTRUTURADO

FASE 1: CORREÇÕES CRÍTICAS ⏱️ 15 min

# Prioridade absoluta - sem estas correções nada funciona
TASK_1.1: Corrigir sintaxe ClientSyncService.php:450
TASK_1.2: Corrigir sintaxe SyncWorkflowFeatureTest.php:262
TASK_1.3: Verificar outros erros de sintaxe PHPStan

FASE 2: AMBIENTE DE DESENVOLVIMENTO ⏱️ 30 min

# Preparar ambiente para execução de testes
TASK_2.1: Instalar extensões PHP (dom, mbstring, xml, xmlwriter)
TASK_2.2: Corrigir problemas de namespace
TASK_2.3: Ajustar configuração PHPStan
TASK_2.4: Validar ambiente com PHPUnit --version

FASE 3: ESTRUTURA E COMPLIANCE ⏱️ 20 min

# Garantir compliance com padrões
TASK_3.1: Criar diretório assets/ e estrutura mínima
TASK_3.2: Corrigir problemas PSR-4 autoloading
TASK_3.3: Re-executar validação de produção
TASK_3.4: Documentar mudanças

FASE 4: VALIDAÇÃO FINAL ⏱️ 15 min

# Confirmar todas as correções
TASK_4.1: PHPStan analyse --level=5 (0 erros)
TASK_4.2: PHPUnit --version (sem erros extensões)
TASK_4.3: Scripts/production_readiness_validator.sh (PASS)
TASK_4.4: Git commit estruturado

🎯 ESTRATÉGIA DE IMPLEMENTAÇÃO

ABORDAGEM: QUALITY-FIRST

1. Correções Sequenciais: Uma fase por vez, validação entre fases
2. Verificação Contínua: PHPStan + php -l após cada correção
3. Rollback Ready: Git commit por fase para fácil rollback
4. Zero Downtime: Correções não afetam funcionalidade existente

MÉTRICAS DE SUCESSO

• ✅ PHPStan: 0 erros de sintaxe
• ✅ PHPUnit: Executa sem erros de extensões
• ✅ Production Readiness: PASS em todas validações
• ✅ PSR-4: 100% compliance autoloading
• ✅ Estrutura: Todos diretórios obrigatórios existem

📋 EXECUÇÃO AUTOMATIZADA

SCRIPT DE CORREÇÃO MASTER

#!/bin/bash
# MASTER_QUALITY_FIX.sh - Correção automatizada

# FASE 1: Sintaxe Critical
echo "🚨 FASE 1: Corrigindo erros críticos de sintaxe..."
fix_clientsync_syntax()
fix_test_switch_syntax() 
validate_syntax_fixes()

# FASE 2: Ambiente
echo "⚙️ FASE 2: Configurando ambiente..."
install_php_extensions()
fix_namespace_issues()
configure_phpstan()

# FASE 3: Compliance
echo "📁 FASE 3: Estrutura e compliance..."
create_assets_directory()
fix_psr4_autoloading()

# FASE 4: Validação
echo "✅ FASE 4: Validação final..."
run_phpstan_validation()
run_phpunit_check()
run_production_validation()

echo "🏆 CORREÇÃO COMPLETA - PROJETO PRODUCTION-READY!"

DELEGAÇÃO DE AGENTES

• php-fullstack-engineer: Correções de sintaxe PHP
• system-development-agent: Instalação extensões sistema
• development-lead: Validação final e QA
• security-compliance-specialist: Compliance checks

⏰ TIMELINE ESTIMADO

• TOTAL: ~80 minutos
• Fase 1 (Crítica): 15 min
• Fase 2 (Ambiente): 30 min
• Fase 3 (Compliance): 20 min
• Fase 4 (Validação): 15 min

🎖️ GARANTIAS DE QUALIDADE

1. Backup automático antes de cada fase
2. Validação contínua com ferramentas de QA
3. Rollback plan para cada fase
4. Documentação completa de mudanças
5. Teste final integrado com todos componentes

---

STATUS: ✅ PLANO APROVADO - PRONTO PARA EXECUÇÃO NEXT ACTION: Iniciar FASE 1 com agente php-fullstack-engineer