Datos Maestros

El módulo de Datos Maestros permite configurar los datos base usados por los módulos operativos. En producción, las pestañas vigentes son Faenas, Posturas, Vehículos y Especialidades.

Propósito

• Gestionar faenas/áreas de trabajo por contrato.
• Crear y mantener posturas asociadas a faenas.
• Asociar vehículos a posturas.
• Administrar especialidades operativas.
• Mantener coherencia entre Master Data, Emergency Log, Resource Panel, Shift Handover, Communication Test y Manual Dotation.

Permisos Requeridos

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

Acceso restringido

Este módulo está restringido por RBAC. Los cambios aquí afectan de inmediato a los módulos operativos del tenant/contrato correspondiente.

Pestañas Vigentes

Faenas

Las faenas, también llamadas áreas de trabajo en el código, pertenecen a un contrato. Las posturas nuevas deben seleccionar una faena activa.

Campo	Descripción
Nombre	Nombre operativo de la faena
Contrato	Contrato al que pertenece
Estado	Activa o inactiva

Posturas

Las posturas se asocian a una faena y a uno o más vehículos. El formulario separa los tipos Brigada y Policlínicos.

Campo	Descripción
Contrato	Contexto usado para cargar faenas disponibles
Tipo de postura	BRIGADA o POLICLINICOS
Nombre	Nombre de la postura
Faena	Área de trabajo asociada
Vehículos asignados	Vehículos vinculados a la postura
Override horario diurno	Opcional; permite usar corte Día/Noche propio de la postura
Estado	Activa o inactiva

Unificación Faena-Postura

Desde la unificación WorkArea-Position, la postura guarda workAreaId numérico. Los módulos operativos deben filtrar por faenas activas para evitar mostrar posturas de áreas inactivas.

Vehículos

Campo	Descripción
Código	Identificador operativo, por ejemplo B-1
Nombre	Nombre descriptivo
Capacidad	Plazas usadas por Dotación Manual de Carros
Posturas	Posturas asociadas al vehículo
Estado	Activo o inactivo

Los vehículos son usados por Panel de Recursos, Bitácoras y Dotación Manual.

Especialidades

Catálogo simple de especialidades asociables al personal operativo.

Horario Día/Noche

El sistema usa corte Día/Noche para resolver tripulación en Dotación Manual y prellenado de Bitácoras:

• El contrato tiene rango diurno por defecto en backend (08:00 a 20:00).
• La postura puede definir un override de rango diurno.
• Si la postura hereda del contrato, el override queda vacío.
• Si se configura override, deben existir inicio y fin; no se acepta solo uno.

Flujo de Configuración de Postura

flowchart TD
  A[Seleccionar contrato] --> B[Crear o elegir faena]
  B --> C[Crear postura]
  C --> D[Elegir tipo: Brigada o Policlínicos]
  D --> E[Asignar vehículos]
  E --> F{¿Requiere corte Día/Noche propio?}
  F -->|Sí| G[Configurar override]
  F -->|No| H[Heredar contrato]
  G --> I[Guardar]
  H --> I[Guardar]

Consideraciones Importantes

Precaución

• Los cambios en datos maestros afectan inmediatamente al sistema
• Desactivar un registro no elimina el historial asociado
• Siempre verifique los cambios antes de guardar
• Un vehículo ya asociado a otra postura se muestra bloqueado para evitar doble asignación accidental

Errores Comunes

Error	Causa	Solución
"Código duplicado"	Ya existe registro con ese código	Usar código diferente
"No puede eliminar"	Registro tiene dependencias o validación de backend	Desactivar en lugar de eliminar
"Campo requerido"	Falta información obligatoria	Completar todos los campos marcados
"Debes definir AMBOS campos"	Override Día/Noche incompleto	Completar inicio y fin o heredar del contrato

FAQ

¿Datos Maestros administra brigadistas?

No. La gestión de usuarios y perfiles de brigadista vive en Gestión de Usuarios/Brigadistas. Datos Maestros administra faenas, posturas, vehículos y especialidades.

¿Cómo agrego una nueva postura?

1. Ir a Datos Maestros → Posturas.
2. Seleccionar contrato si tiene más de uno.
3. Clic en Nueva Postura.
4. Seleccionar tipo, faena y vehículos.
5. Guardar.

¿Los cambios aplican inmediatamente?

Sí. Los cambios en datos maestros son inmediatos y afectan a todos los usuarios del sistema.

---

Evidencia visual pendiente

Checklist para el equipo:

• Captura: Menú de datos maestros
• Captura: Listado de faenas
• Captura: Formulario de postura con faena y vehículos
• Captura: Listado de vehículos
• Captura: Override de horario diurno por postura