# Módulo de Impresiones - Laravel

## 📋 Resumen

Se ha creado exitosamente el módulo de **Especialidades y Duplicados (Impresiones)** para Laravel, migrando el código PHP original al framework con las siguientes características:

## 📁 Archivos Creados

### 1. Controlador
**Ubicación:** `app/Http/Controllers/ImpresionesController.php`

**Métodos disponibles:**
- `index()` - Listado de impresiones con paginación (límite 100 registros)
- `buscar()` - Búsqueda por nombre, CURP, número de control, curso o unidad
- `cancelar()` - Cancelación de impresión con observaciones
- `eliminar()` - Eliminación de impresión y registros relacionados
- `consulta()` - Vista detallada de una impresión
- `controlEspecialidades()` - Control de especialidades (pendiente implementar)
- `controlImpresion()` - Control de duplicados (pendiente implementar)

### 2. Modelo
**Ubicación:** `app/Models/Impresion.php`

**Características:**
- Tabla: `impresiones`
- Primary Key: `imp_id`
- Sin timestamps automáticos
- Atributos calculados: `colorEstado`, `tipoDocumento`
- Métodos helper: `esEspecialidad()`, `puedeCancelarse()`

### 3. Vistas
**Ubicación:** `resources/views/application/Impresiones/`

**Archivos:**
- `impresiones_index.blade.php` - Listado principal con DataTables
- `consulta_impresiones.blade.php` - Vista detallada de una impresión

### 4. Rutas
**Ubicación:** `routes/web.php`

**Rutas agregadas:**
```php
// Listado y búsqueda
GET  /impresiones                    → impresiones.index
POST /impresiones/buscar             → impresiones.buscar

// Acciones
POST /impresiones/cancelar           → impresiones.cancelar
POST /impresiones/eliminar           → impresiones.eliminar
POST /impresiones/consulta           → impresiones.consulta

// Controles adicionales
GET  /control-especialidades         → control.especialidades
GET  /control-impresion              → control.impresion
```

## 🎨 Características Implementadas

### ✅ Diseño y UX
- Interfaz adaptada al diseño existente del proyecto Laravel
- DataTables con ordenamiento por ID descendente
- Sistema de colores según el estado de la impresión:
  - 🟡 **Amarillo (warning)**: Impresión en proceso
  - 🔵 **Azul (primary)**: Documentación completa sin entrega
  - 🟢 **Verde (success)**: Proceso completado con entrega
  - 🔴 **Rojo (danger)**: Impresión cancelada

### ✅ Funcionalidades
- **Búsqueda avanzada**: Por nombre, CURP, número de control, curso o unidad
- **Filtrado por rol**: 
  - Rol 3: Solo ve impresiones de su unidad
  - Otros roles: Ven todas las impresiones
- **Cancelación con motivo**: Modal para ingresar observaciones
- **Distintivo visual**: 
  - Filas azules para especialidades (tipo 'E')
  - Filas blancas para duplicados
- **Tooltips informativos**: Muestra observaciones en impresiones canceladas
- **Ocultar columna ID**: Primera columna oculta pero ordenable

### ✅ Seguridad
- Protección CSRF en todos los formularios
- Validación de permisos por rol
- Uso de consultas preparadas (Query Builder)
- Registro en bitácora de todas las operaciones

### ✅ Permisos por Rol
- **Rol 14, 5 o username 'jefe'**: Acceso a control de especialidades
- **Rol 5, 3, 14 o username 'jefe'**: Acceso a imprimir duplicados
- **Unidad 8**: Puede cancelar impresiones sin fecha de entrega
- **Username 'sonia_machorro' o 'jefe'**: Acceso al buscador avanzado

## 🔧 Requisitos de Base de Datos

### Tabla Principal: `impresiones`
```sql
Campos utilizados:
- imp_id (PK)
- imp_num_control
- imp_al_nombre
- imp_al_curp
- imp_nombre_curso
- imp_unidad_nombre
- imp_id_unidad
- imp_unidad_registra
- imp_tipo ('E' = Especialidad, 'D' = Duplicado)
- imp_folio
- imp_num_recibo
- imp_liga_comprobante
- imp_importe
- imp_fecha_documento
- imp_fecha_entrega
- imp_cancelado (0 = Activa, 1 = Cancelada)
- imp_observaciones
```

### Tabla Relacionada: `registro_cursos`
```sql
Campos utilizados:
- rg_id (PK)
- rg_imp_id (FK → impresiones.imp_id)
- rg_info
```

### Tabla Auxiliar: `dg_cat_unidades_capacitacion`
```sql
Campos utilizados:
- id_unidad_capacitacion (PK)
- nombre_unidad
```

## 🚀 Cómo Usar

### 1. Acceder al módulo
```
http://tu-dominio.com/impresiones
```

### 2. Buscar impresiones
- Usuarios autorizados verán el campo de búsqueda
- Ingresar: nombre, CURP, curso o unidad
- Hacer clic en "Buscar" o "Reset" para limpiar

### 3. Ver detalle de impresión
- Hacer clic en el botón de edición (amarillo/azul/verde)
- Se mostrará la información completa

### 4. Cancelar impresión
- Solo disponible si no tiene fecha de entrega y es unidad 8
- Hacer clic en el botón de cancelar (thumbs down)
- Ingresar el motivo de cancelación
- Confirmar

### 5. Estados de las impresiones
- **Amarillo**: Faltan datos por completar
- **Azul**: Datos completos, sin fecha de entrega
- **Verde**: Proceso terminado, documento entregado
- **Rojo**: Impresión cancelada

## 📝 Notas Importantes

1. **DataTables en Español**: El idioma está configurado en español usando el archivo de traducción de DataTables
2. **Límite de registros**: Por defecto muestra los últimos 100 registros ordenados por ID descendente
3. **Sesiones Laravel**: Usa `Session::get()` para obtener rol y unidad del usuario
4. **Bitácora**: Todas las operaciones se registran usando `BitacoraService`
5. **Validación**: Los formularios tienen validación tanto en cliente como en servidor

## 🔮 Pendiente de Implementar

Las siguientes funcionalidades están creadas pero requieren lógica adicional:

1. **Control de Especialidades** (`/control-especialidades`)
   - Vista y funcionalidad por definir

2. **Control de Impresión** (`/control-impresion`)
   - Vista y funcionalidad por definir

3. **Edición de Impresiones**
   - Formulario para modificar datos de impresión
   - Carga de comprobantes
   - Asignación de folios y recibos

## ✅ Verificación

Para verificar que todo funciona correctamente:

1. Cache limpiada ✅
2. Autoloader regenerado ✅
3. Rutas registradas ✅
4. Controlador creado ✅
5. Modelo creado ✅
6. Vistas creadas ✅

## 🎯 Próximos Pasos

1. Implementar la vista de edición de impresiones
2. Agregar formulario para control de especialidades
3. Agregar formulario para control de duplicados
4. Implementar sistema de carga de archivos para comprobantes
5. Agregar exportación a Excel/PDF del listado
6. Implementar paginación avanzada si se requiere más de 100 registros

---

**Fecha de creación:** 4 de diciembre de 2025  
**Framework:** Laravel 8+  
**Autor:** GitHub Copilot (Claude Sonnet 4.5)