Saltar a contenido

Construcción → Captura de horas hombre (/construccion/horas_hombre_captura)

  • Permisos mínimos: AccessConstruccion.HORAS_HOMBRE_CAPTURA. Para cancelar reportes se requiere además AccessConstruccion.HORAS_HOMBRE_CANCELACION.
  • APIs: GET/POST/DELETE /api/construccion/horas_hombre/reporte, GET /api/construccion/horas_hombre/partidas.

Objetivo

Gestionar la captura diaria de horas: revisar partidas registradas, crear nuevos reportes y cancelar/rehabilitar reportes existentes.

  • Captura de horas hombre: vista de datos y acciones para gestionar la captura diaria de horas.
  • [id]: vista de reportes de horas hombre.

Estructura de la pantalla

  1. Selector de centros de costos: Igual que en otras vistas, define el universo de datos consultable.
  2. Acciones rápidas (barra superior):
  3. “Nueva captura” (Plus): redirige a /construccion/horas_hombre_captura/captura para registrar un nuevo reporte.
  4. Pestañas:
  5. Partidas:
    • Tabla con cada partida capturada (fecha, soporte, trabajador, horas normales/extra).
      • Al hacer doble clic o elegir “Abrir” se navega al detalle del reporte (/construccion/horas_hombre_captura/[id]).
        • Ejemplo de URL de detalle: /construccion/horas_hombre_captura/123e4567-e89b-12d3-a456-426614174000 (reemplaza el valor por el id real del reporte).
        • Nota: el id mostrado en la tabla puede copiarse y usarse para enlazar directamente desde otras aplicaciones.
  6. Reportes:
    • Listado de reportes agregados (fecha, turno, supervisor, totales).
    • Menú contextual con opciones “Abrir”, “Cancelar/Descancelar” y “Ver JSON”.
    • La cancelación llama DELETE /reporte/{id}; el backend decide si debe cancelar o restaurar según el estado actual.

Flujo típico

  1. Revisa las partidas recientes para confirmar que fueron capturadas correctamente.
  2. Si necesitas ajustar un reporte:
  3. Abre la pestaña “Reportes”.
  4. Ingresa al detalle o usa “Cancelar” si hubo un error (se puede revertir).
  5. Para capturar un nuevo reporte usa el botón “Nueva captura”, llena el formulario y vuelve aquí para confirmarlo.

Rutas y referencias rápidas

  • Captura (nueva entrada): /construccion/horas_hombre_captura/captura
  • Abre el formulario para crear un nuevo reporte (encabezado + partidas).
  • Detalle de reporte por id: /construccion/horas_hombre_captura/[id]
  • Reemplaza [id] con el UUID del reporte para ver o editar su contenido. Ejemplo: /construccion/horas_hombre_captura/123e4567-e89b-12d3-a456-426614174000.
  • También disponible vía API: GET /api/construccion/horas_hombre/reporte/{id} devuelve las partidas y el encabezado.

Consejos

  • El estado cancelado se refleja en la columna correspondiente; úsalo como referencia antes de ejecutar otro borrado.
  • Aprovecha las exportaciones para enviar resúmenes diarios a supervisores.
  • Si la cancelación falla, revisa el mensaje brindado por handleErrorResponse (por ejemplo, puede indicar que el reporte ya estaba cancelado o careces de permisos).