# Verificación y Estandarización de Módulos

Este documento resume el estado actual de cada módulo y las acciones necesarias para estandarizarlos.

## 📊 Estado Actual de Módulos

### ✅ Products - COMPLETO Y FUNCIONAL

**Configuración:**
- ✅ Registrado en `cd-system.php` con `active: true`
- ✅ Permisos implementados correctamente
- ✅ Middleware configurado (show sin middleware)

**Controlador:**
- ✅ `manager()` implementado
- ✅ `getStats()` implementado
- ✅ `getProducts()` implementado con manejo correcto de imágenes y slug
- ✅ `show($id)` implementado:
  - ✅ Sin middleware de permisos
  - ✅ Con try-catch para manejo de errores
  - ✅ Convierte colecciones a arrays (`->toArray()`)
  - ✅ Retorna JSON con estructura estándar

**Rutas:**
- ✅ Estructura correcta (rutas específicas antes de `{id}`)
- ✅ Ruta `show` al final

**JavaScript:**
- ✅ Peticiones AJAX con `withCredentials: true`
- ✅ Headers correctos
- ✅ Manejo de errores implementado

**Acciones Pendientes:**
- ⚠️ Cambiar `active` a `enabled` en `cd-system.php` para consistencia

---

### ⚠️ Services - PARCIALMENTE COMPLETO

**Configuración:**
- ✅ Registrado en `cd-system.php` con `active: true`
- ❌ Permisos NO implementados en el constructor

**Controlador:**
- ✅ `index()` implementado (equivale a `manager()`)
- ✅ `getStats()` implementado
- ✅ `getServicesData()` implementado
- ⚠️ `show($id)` implementado pero:
  - ❌ No tiene manejo de errores (try-catch)
  - ⚠️ Retorna `service` en lugar de `data` (inconsistente)
  - ⚠️ No convierte colecciones a arrays si las hay

**Rutas:**
- ✅ Estructura correcta
- ✅ Ruta `show` correctamente posicionada

**JavaScript:**
- ⚠️ Verificar que las peticiones AJAX incluyan `withCredentials: true`

**Acciones Necesarias:**
1. Agregar middleware de permisos en el constructor
2. Estandarizar método `show()`:
   - Agregar try-catch
   - Cambiar `service` a `data` en la respuesta
   - Convertir colecciones a arrays si aplica
3. Verificar JavaScript para peticiones AJAX

---

### ⚠️ Blog - PARCIALMENTE COMPLETO

**Configuración:**
- ✅ Registrado en `cd-system.php` con `active: true`
- ⚠️ Permisos comentados en el constructor

**Controlador:**
- ✅ `index()` redirige a `blog-settings.index`
- ✅ `getData()` y `getPosts()` implementados
- ⚠️ `show(Post $post)` implementado pero:
  - ❌ Retorna una vista, no JSON (diferente a otros módulos)
  - ❌ No se usa para cargar datos para edición vía AJAX
  - ⚠️ Usa route model binding en lugar de `$id`

**Rutas:**
- ✅ Estructura correcta
- ⚠️ No tiene ruta `show` para AJAX (usa `edit` directamente)

**JavaScript:**
- ⚠️ Verificar implementación de edición

**Acciones Necesarias:**
1. Decidir si Blog necesita método `show()` para AJAX o si `edit()` es suficiente
2. Si se necesita `show()` para AJAX:
   - Crear método que retorne JSON
   - Agregar ruta correspondiente
   - Sin middleware de permisos
3. Activar permisos en el constructor (descomentar)
4. Verificar JavaScript para consistencia

---

## 🔧 Acciones de Estandarización Recomendadas

### Prioridad Alta

1. **Products:**
   - Cambiar `active` a `enabled` en `cd-system.php`

2. **Services:**
   - Agregar middleware de permisos
   - Estandarizar método `show()` con try-catch y estructura correcta
   - Verificar JavaScript

3. **Blog:**
   - Decidir si necesita método `show()` para AJAX
   - Activar permisos en constructor
   - Verificar JavaScript

### Prioridad Media

4. **Estandarizar configuración:**
   - Todos los módulos deben usar `enabled` en lugar de `active`
   - Actualizar verificaciones en constructores

5. **Documentar excepciones:**
   - Si algún módulo tiene un comportamiento diferente (como Blog con `show()` que retorna vista), documentarlo claramente

---

## 📝 Checklist de Verificación por Módulo

Para cada módulo, verificar:

### Configuración
- [ ] Registrado en `cd-system.php`
- [ ] Usa `enabled` (no `active`)
- [ ] Permisos definidos en base de datos

### Controlador
- [ ] Constructor verifica módulo habilitado
- [ ] Middleware de permisos configurado
- [ ] Método `show` sin middleware (si se usa para AJAX)
- [ ] Métodos estándar implementados
- [ ] Manejo de errores con try-catch

### Rutas
- [ ] Estructura correcta (específicas antes de `{id}`)
- [ ] Ruta `show` al final (si aplica)

### JavaScript
- [ ] Peticiones AJAX con `withCredentials: true`
- [ ] Headers correctos
- [ ] Manejo de errores

---

## 🎯 Objetivo Final

Todos los módulos deben seguir el estándar definido en `MODULE_STANDARDS.md`, con excepciones documentadas cuando sea necesario.

**Última actualización**: 2025-11-19