API Incidencias de Fichaje v2

Endpoints para gestionar incidencias de fichaje.

Descripción General

Las incidencias de fichaje se generan automáticamente cuando hay problemas con el registro de entrada/salida de un empleado.

Caché: Los datos se almacenan en caché Redis por 24 horas. La caché se invalida automáticamente cuando: - Se crea una nueva incidencia - El empleado responde a una incidencia - Se añade un mensaje al hilo - Se cierra o elimina una incidencia

Endpoints

Método	Endpoint	Descripción	Documentación
GET	/api/v2/incident/	Listado con filtros (admin)	GET_all.md
GET	/api/v2/incident/my	Listado del empleado	GET_my.md
GET	/api/v2/incident/:id	Detalle de una incidencia	GET_detail.md
GET	/api/v2/incident/:id/threads	Hilos de conversación	GET_threads.md
POST	/api/v2/incident/:id/thread	Enviar mensaje (empleado)	POST_thread.md
POST	/api/v2/incident/:id/admin-thread	Enviar mensaje (admin)	POST_admin_thread.md

Documentación Adicional

Archivo	Descripción
INCIDENT_TYPES.md	Tipos de incidencia y sus labels
SOCKET_NOTIFICATIONS.md	Eventos Socket.IO en tiempo real

Flujo recomendado para el cliente

1. Listado inicial: GET /api/v2/incident/my?status=open
2. Ver detalle: GET /api/v2/incident/:id (incluye archivos y mensajes)
3. Enviar mensaje: POST /api/v2/incident/:id/thread
4. Escuchar actualizaciones: Socket incident_notification

Notas de rendimiento

• Primera petición: ~1-2 segundos (consulta a base de datos)
• Peticiones siguientes: ~50-100ms (desde caché Redis)