desk-moloni/PRODUCTION_DEPLOYMENT_ISSUES_REPORT.md

# 🚨 RELATÓRIO DE PROBLEMAS - DEPLOY PRODUÇÃO
**Módulo:** desk-moloni
**Target:** https://desk.descomplicar.pt/admin/desk_moloni/dashboard
**Data:** 2025-09-13 23:35
**Status:** ❌ CRÍTICO - Múltiplos problemas identificados

---

## 📋 RESUMO EXECUTIVO

### ✅ **Sucessos do Deploy**
- Módulo carregado com sucesso para `/home/ealmeida/desk.descomplicar.pt/modules/desk_moloni/`
- Permissões configuradas: `ealmeida:ealmeida` + `755`/`644`
- Módulo registado na BD: `tblmodules` (ID: 120, version: 3.0.1, active: 1)
- Debug mode ativado: `APP_DEBUG = true`
- Estrutura completa do módulo presente (controllers, models, views, libraries)

### 🚨 **Problemas Críticos Identificados**

---

## 🔍 PROBLEMAS DETALHADOS

### **1. HEADERS PHP DUPLICADOS - CRÍTICO** 🚨
**Sintoma:** Output múltiplo de headers de comentário no browser
```
/**
 * Descomplicar® Crescimento Digital
 * https://descomplicar.pt
 */
```

**Análise:**
- Header aparece **repetido 10+ vezes** no output HTTP
- Presente em **TODOS os ficheiros PHP** do módulo
- Está sendo **outputado** em vez de permanecer como comentário

**Ficheiros Afetados:**
```
./models/Desk_moloni_invoice_model.php
./models/Desk_moloni_sync_queue_model.php
./models/Desk_moloni_mapping_model.php
./models/Desk_moloni_model.php
./models/Desk_moloni_config_model.php
./config/client_portal_routes.php
./config/routes.php
./config/bootstrap.php
./controllers/Admin.php
./controllers/Dashboard.php
./views/admin/dashboard.php
./views/admin/config.php
[... +50 ficheiros]
```

**Causa Raiz:**
- Headers PHP malformados ou com problemas de encoding
- Possível conflito entre múltiplos `<?php` tags
- Headers sendo interpretados como output em vez de comentários

---

### **2. PATH INCORRETO NO CONTROLLER - CRÍTICO** 🚨
**Sintoma:** `Unable to load the requested file: admin/modules/desk_moloni/dashboard.php`

**Localização:** `modules/desk_moloni/controllers/Dashboard.php` linha ~74

**Código Problemático:**
```php
// ❌ ERRADO:
$this->load->view('admin/modules/desk_moloni/dashboard', $data);

// ✅ DEVERIA SER:
$this->load->view('admin/dashboard', $data);
```

**Análise:**
- Controller está a procurar view no path **absoluto** em vez do **relativo ao módulo**
- PerfexCRM espera: `modules/desk_moloni/views/admin/dashboard.php`
- Controller está a procurar: `application/views/admin/modules/desk_moloni/dashboard.php`

---

### **3. POSSÍVEL CONFLITO DE INCLUDES - MÉDIO** ⚠️
**Sintoma:** Headers duplicados sugerem múltiplos includes

**Ficheiros com includes identificados:**
```
./controllers/Mapping.php
./controllers/Queue.php
./controllers/Logs.php
./controllers/OAuthController.php
./controllers/Dashboard.php
./controllers/WebhookController.php
```

**Análise:**
- Cada controller pode estar a incluir headers adicionais
- Possível circular inclusion de ficheiros
- Headers sendo incluídos múltiplas vezes durante o load

---

### **4. ESTRUTURA DE VIEWS CORRETA MAS PATH ERRADO - BAIXO** ✅
**Status:** Estrutura verificada e correta

**Estrutura Atual (CORRETA):**
```
modules/desk_moloni/views/admin/dashboard.php ✅ (29.613 bytes)
modules/desk_moloni/views/admin/config.php ✅
modules/desk_moloni/views/admin/mapping_management.php ✅
modules/desk_moloni/views/client_portal/index.php ✅
```

**Problema:** Apenas o path no controller que está errado.

---

### **5. DEBUG LOGS E ERROS DO SERVIDOR - INFO** 📋
**Nginx Error Logs:** 53 ficheiros de erro encontrados em `/var/log/nginx/`
**Application Logs:** Sem erros aparentes em `/application/logs/`
**Permissões:** Todas corretas (`ealmeida:ealmeida`)

---

## 🎯 PLANO DE CORREÇÃO PRIORITÁRIO

### **Prioridade 1 - CRÍTICO** 🚨
1. **Limpar headers duplicados**
   - Remover headers de comentário de TODOS os ficheiros de view
   - Manter apenas nos controllers/models (onde devem estar)
   - Verificar encoding UTF-8 sem BOM

2. **Corrigir path do controller Dashboard**
   - Alterar `admin/modules/desk_moloni/dashboard` → `admin/dashboard`
   - Verificar outros controllers com o mesmo problema

### **Prioridade 2 - IMPORTANTE** ⚠️
3. **Verificar includes circulares**
   - Auditar todos os controllers para includes desnecessários
   - Remover headers duplicados de ficheiros incluídos

### **Prioridade 3 - MANUTENÇÃO** 📋
4. **Validar outros paths**
   - Verificar todos os controllers do módulo
   - Confirmar que todas as views estão com paths relativos corretos

---

## 🔧 COMANDOS PARA CORREÇÃO LOCAL

### **1. Limpar Headers (Executar localmente)**
```bash
# Remover headers de views (manter nos controllers/models)
find modules/desk_moloni/views -name "*.php" -exec sed -i '/\/\*\*/,/\*\//d' {} \;
```

### **2. Corrigir Path do Dashboard**
```bash
# Corrigir path no controller Dashboard
sed -i 's|admin/modules/desk_moloni/dashboard|admin/dashboard|g' modules/desk_moloni/controllers/Dashboard.php
```

### **3. Verificar Outros Controllers**
```bash
# Procurar outros paths incorretos
grep -r "admin/modules/desk_moloni" modules/desk_moloni/controllers/
```

---

## 📊 ESTATÍSTICAS DO PROBLEMA

| **Métrica** | **Valor** |
|-------------|-----------|
| Ficheiros afetados | 50+ |
| Headers duplicados | 10+ por request |
| Controllers com path errado | 1 confirmado (Dashboard) |
| Tempo para correção estimado | 30 minutos |
| Severidade | CRÍTICA |

---

## ✅ VALIDAÇÃO PÓS-CORREÇÃO

### **Testes Obrigatórios:**
1. ✅ Dashboard carrega sem headers duplicados
2. ✅ Não há erros "Unable to load requested file"
3. ✅ Views renderizam corretamente
4. ✅ Funcionalidade básica do módulo operacional

### **URLs para Testar:**
- https://desk.descomplicar.pt/admin/desk_moloni/dashboard
- https://desk.descomplicar.pt/admin/desk_moloni/config
- https://desk.descomplicar.pt/admin/modules (verificar módulo listado)

---

## 📝 NOTAS TÉCNICAS

### **Ambiente de Produção:**
- **Server:** server.descomplicar.pt:9443
- **Path:** /home/ealmeida/desk.descomplicar.pt/modules/desk_moloni/
- **PerfexCRM:** Versão compatível com módulos
- **PHP:** Versão suportada
- **MySQL:** Base de dados `ealmeida_desk24`

### **Estado do Módulo:**
- **Registado:** ✅ tblmodules (ID: 120, active: 1)
- **Ficheiros:** ✅ Estrutura completa
- **Permissões:** ✅ Corretas
- **Debug:** ✅ Ativo

---

**🎯 CONCLUSÃO:** Problemas identificados são **corrigíveis localmente** e requerem **redeploy limpo** após correção.

**⏱️ ETA Correção:** 30 minutos + 10 minutos redeploy = **40 minutos total**