Bitácoras de Emergencias

El módulo de Bitácoras es el registro central de todas las emergencias y eventos del sistema.

Propósito

• Crear y gestionar emergencias
• Registrar cronología de eventos
• Mantener comunicaciones del incidente
• Generar reportes post-incidente
• Prellenar asistentes desde Dotación Manual de Carros cuando se despacha un vehículo con tripulación armada

Permisos Requeridos

Rol	Acceso
owner	Completo
gerencia	Completo
admin	Completo
cecom	Completo
supervisor	Sin acceso base
brigadista	Sin acceso
lider_maquinista	Sin acceso
viewer	Sin acceso

Flujos Principales

Ciclo de Vida de Emergencia

stateDiagram-v2
  [*] --> Creada: Nueva emergencia
  Creada --> Activa: Activar
  Activa --> EnCurso: Despachar recursos
  EnCurso --> Controlada: Situación controlada
  Controlada --> Cerrada: Cerrar emergencia
  Cerrada --> [*]

  Activa --> Cancelada: Falsa alarma
  Cancelada --> [*]

Crear Nueva Emergencia

1. Clic en "+ Nueva Emergencia"
2. Completar formulario inicial:
   • Fecha y hora
   • Datos del solicitante
   • Tipo de emergencia
   • Faena y lugar específico
   • Descripción de lo ocurrido
3. Clic en "Activar Emergencia"

Evidencia visual pendiente

Captura requerida: Nueva emergencia.

Agregar Mensaje a Bitácora

1. Abrir emergencia activa
2. En el panel de chat/bitácora:
   • Escribir mensaje
   • Adjuntar archivo (opcional)
3. Clic en "Enviar" o presionar Enter

El mensaje se registra con:

• Timestamp exacto
• Usuario que envía
• Contenido del mensaje

Cerrar Emergencia

1. En emergencia activa, clic en "Cerrar Emergencia"
2. Completar formulario de cierre:
   • Resumen final
   • Recursos utilizados
   • Tiempo total
3. Confirmar cierre

Importante

Una vez cerrada, la emergencia deja de estar activa y se libera el estado operativo de los recursos asociados. Las correcciones posteriores deben manejarse con criterio de auditoría y permisos, no como edición normal del incidente.

Tipos de Emergencia

El formulario productivo usa las opciones:

• CODIGO-1
• CODIGO-2
• CODIGO-3
• CODIGO-4
• CODIGO-5
• ACTIVACION DE ALARMA

Vista de Emergencia Activa

La pantalla de emergencia activa muestra:

Sección	Contenido
Header	Código, tipo, ubicación, tiempo transcurrido
Bitácora	Cronología de mensajes y eventos
Recursos	Unidades asignadas, tiempos operativos y estado
Asistentes	Brigadistas seleccionados o prellenados desde Dotación Manual
Mapa	Ubicación y unidades en tiempo real

Prellenado desde Dotación Manual

Cuando CECOM despacha un vehículo por primera vez dentro de la emergencia, el sistema consulta la dotación manual abierta para ese carro.

1. Se resuelve el slot Día o Noche con la hora de la emergencia.
2. Se agregan los brigadistas configurados para ese carro/slot.
3. No se duplican asistentes ya agregados.
4. Si el carro no tiene tripulación cargada, aparece una alerta no bloqueante para que CECOM complete manualmente.

El prellenado no recalcula emergencias antiguas ni reemplaza ediciones manuales ya hechas por CECOM.

Historial de Emergencias

1. Ir a Bitácoras → Historial
2. Usar filtros:
   • Rango de fechas
   • Tipo de emergencia
   • Estado
3. Clic en una emergencia para ver detalle completo

Exportar Reporte

1. Abrir emergencia (activa o histórica)
2. Clic en "Exportar PDF"
3. El reporte incluye toda la cronología

Errores Comunes

Error	Causa	Solución
Mensaje no se envía	Conexión perdida	Verificar internet
No puedo cerrar	Sin permisos o error de servidor	Verificar permisos de emergency-log y reintentar

FAQ

¿Puedo editar un mensaje ya enviado?

No. Los mensajes de bitácora son inmutables por razones de auditoría. Puede enviar un mensaje de corrección.

¿Cuántas emergencias pueden estar activas?

El sistema lista emergencias activas por tenant/contrato y no documenta una regla de "solo una emergencia activa". Lo que sí valida el backend es que recursos y brigadistas no queden duplicados indebidamente en una emergencia activa.

¿Cómo adjunto fotos?

1. En el campo de mensaje, clic en el ícono de 📎
2. Seleccionar imagen (JPG, PNG, WebP)
3. Máximo 5MB por archivo
4. Enviar mensaje

---

Evidencia visual pendiente

Checklist para el equipo:

• Captura: Formulario nueva emergencia
• Captura: Vista de emergencia activa
• Captura: Chat/bitácora
• Captura: Modal de cierre
• Captura: Historial con filtros
• Captura: Reporte PDF exportado