Panel de Recursos

El Panel de Recursos permite monitorear el estado y disponibilidad de vehículos/equipos. También refleja la dotación vigente que viene desde Dotación Manual de Carros cuando existe una dotación abierta.

Propósito

• Visualizar estado de recursos por tenant/contrato permitido.
• Cambiar estados de disponibilidad según permisos.
• Registrar y revisar novedades o movimientos.
• Reflejar tripulación viva proveniente de Dotación Manual de Carros.
• Actualizarse en tiempo real mediante WebSocket.

Permisos Requeridos

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

Vista Principal

El panel muestra todos los recursos organizados por categoría:

Evidencia visual pendiente

Captura requerida: Panel de recursos.

Categorías de Recursos

Categoría	Descripción
Unidades de Combate	Carros bomba, escaleras
Unidades de Apoyo	Camionetas, ambulancias
R78	Recursos de apoyo específicos
Otros Recursos	Equipamiento adicional

Estados de Recursos

stateDiagram-v2
  [*] --> DISPONIBLE
  DISPONIBLE --> EN_RUTA: Despachar
  EN_RUTA --> EN_COMBATE: Llegar
  EN_COMBATE --> DISPONIBLE: Terminar
  DISPONIBLE --> FUERA_SERVICIO: Problema
  FUERA_SERVICIO --> DISPONIBLE: Reparar
  DISPONIBLE --> DESCANSO: Fin turno
  DESCANSO --> DISPONIBLE: Inicio turno

Estado	Color	Significado
DISPONIBLE	Verde	Listo para despacho
EN RUTA	Amarillo	En camino a destino
EN COMBATE	Rojo	Atendiendo emergencia
FUERA DE SERVICIO	Naranja	No disponible
DESCANSO	Gris	Fuera de turno

Operaciones Vigentes

Cambiar Estado de Recurso

1. Ubicar el recurso en el panel
2. Abrir el selector de estado o el menú de acciones de la tarjeta
3. Seleccionar nuevo estado
4. Confirmar cambio

Revisar Dotación Reflejada

La asignación de brigadistas a carros no se arma desde este módulo. La fuente operacional vigente es Dotación Manual de Carros.

Cuando hay dotación abierta:

1. El backend adjunta manualDotation a los recursos asociados a vehículos.
2. El panel escucha eventos manual-dotation:* y refresca recursos, movimientos, novedades y estadísticas.
3. Si necesita mover o liberar tripulación, hágalo desde Dotación Manual de Carros.

Estadísticas del Panel

El panel muestra un resumen:

• Total de recursos
• Disponibles
• En servicio
• Fuera de servicio
• Fuerza de combate (FC)

Flujos Comunes

Sacar Recurso de Servicio

flowchart LR
  A[Recurso DISPONIBLE] --> B[Problema detectado]
  B --> C[Cambiar a FUERA_SERVICIO]
  C --> D[Registrar motivo]
  D --> E[Notificar supervisor]

Habilitar Recurso

1. Buscar recurso en estado FUERA_SERVICIO
2. Cambiar estado a DISPONIBLE
3. Verificar que aparece en verde

Errores Comunes

Error	Causa	Solución
"No puede cambiar estado"	Recurso en emergencia activa	Esperar fin de emergencia
Estado no se actualiza	Problema de conexión	Refrescar página

FAQ

¿Cómo veo el historial de un recurso?

Use el botón Ver Historial del panel para abrir novedades y movimientos. Para un recurso específico, la API mantiene historial en /api/resource-panel/resources/:id/history, pero la ruta exacta de UI puede variar según la vista activa.

¿Puedo editar la información del recurso?

Solo usuarios con permiso de actualización en resource-panel pueden editar información de recursos. El rol por sí solo no basta si RBAC no trae el permiso en la sesión.

---

Evidencia visual pendiente

Checklist para el equipo:

• Captura: Panel principal con todos los recursos
• Captura: Modal de cambio de estado
• Captura: Dotación reflejada desde Dotación Manual
• Captura: Tarjeta de estadísticas