Fase D1 — Planificación y apertura de visitas

Versión: 0.15.0

Objetivo

Iniciar el dominio de inspecciones con la regla funcional acordada: una inspección representa una visita. D1 planifica y abre esa visita; no incorpora todavía actas, hallazgos ni el informe consolidado.

Modelo

inspection_visits conserva identidad, título, objetivo, estado, fechas, ubicación o alcance principal, responsable, instrucciones y trazabilidad.

La visita utiliza el Maestro de Activos de dos maneras:

scope_asset_id referencia cualquier activo que represente su ubicación o alcance principal;
inspection_visit_assets vincula los activos concretos a inspeccionar.

No se copian nombres, ubicaciones ni atributos. Todos los vínculos apuntan a los activos originales y respetan la jerarquía dinámica: si se define un alcance, los activos seleccionados deben pertenecer a esa rama.

inspection_visit_members vincula usuarios activos con permiso de ejecución. Un integrante se designa como inspector responsable y debe pertenecer al equipo.

Flujo controlado

DRAFT: admite cambios generales, activos y equipo;
PLANNED: el plan está confirmado, pero aún puede volver a borrador;
IN_PROGRESS: la visita fue iniciada y su planificación queda congelada;
CANCELLED: estado terminal con motivo obligatorio;
CLOSED: reservado para la futura operación de cierre e informe consolidado.

Antes de confirmar o iniciar se exige ubicación, fecha de inicio, al menos un activo, un equipo válido y un responsable incluido. Sólo un integrante asignado o un usuario con gestión puede iniciar la visita.

Permisos

inspections.read: admin, director, supervisor, inspector y auditor;
inspections.manage: admin y supervisor;
inspections.assign: admin y supervisor;
inspections.execute: admin, supervisor e inspector.

Las tres tablas conceden al usuario runtime lectura, inserción y actualización, pero revocan borrado físico.

API e interfaz

Rutas principales:

GET|POST /api/v3/inspection-visits;
GET|PATCH /api/v3/inspection-visits/:id;
PUT /api/v3/inspection-visits/:id/assets;
PUT /api/v3/inspection-visits/:id/team;
PUT /api/v3/inspection-visits/:id/status;
POST /api/v3/inspection-visits/:id/start.

La sección Inspecciones reemplaza el placeholder por un listado y un editor completo de visita.

Continuidad

La próxima subfase agregará el acta única de cada visita. Después se incorporarán hallazgos y evidencias, y finalmente firmas, rectificativas y el informe técnico que incorporará el acta y sus hallazgos.

2.6 KiB Raw Blame History