docs: crear manual de usuario

2026-09-09 14:50:08 -03:00
parent 294abc4cf3
commit 3a149691e2
1 changed files with 353 additions and 0 deletions
@@ -0,0 +1,353 @@
 # Manual de Usuario · DH Inspección V2
 **Versión funcional de referencia:** F6.1
 Este manual explica el uso cotidiano del sistema. Las opciones visibles dependen de los permisos asignados a cada usuario, por lo que un Inspector, Supervisor, Director o Administrador puede ver acciones distintas.
 ---
 ## 1. Conceptos principales
 DH Inspección V2 organiza el trabajo alrededor de cuatro elementos:
 1. **Inventario:** dónde se inspecciona.
 2. **Inspección:** la visita de trabajo.
 3. **Acta:** documento generado durante la Inspección; una Inspección puede tener varias Actas.
 4. **Hallazgo:** observación asociada a un elemento concreto del Inventario.
 Además, cada Acta puede continuar con su **Informe (INF)**, oficialización documental y seguimiento posterior.
 ---
 ## 2. Ingreso al sistema
 1. Abra la WEB de DH Inspección V2.
 2. Ingrese usuario y contraseña.
 3. El menú mostrará solamente los módulos habilitados por sus permisos.
 Si una opción no aparece o el sistema informa que no tiene autorización, consulte al Administrador antes de intentar resolverlo creando datos alternativos.
 ---
 ## 3. Cómo se organiza el Inventario
 La estructura física correcta es siempre:
 **Departamento → Área → Yacimiento → Instalación → Subinstalación**
 La **Empresa** no forma parte de esa cadena. Se administra por separado y se vincula al Área cuando actúa como Operadora.
 Ejemplo:
 - Departamento: Malargüe
  - Área: Área A
    - Yacimiento: Yacimiento Norte
      - Instalación: Planta de Tratamiento
        - Subinstalación: Separador 01
 Una Empresa puede cambiar con el tiempo sin modificar esta estructura física.
 ---
 ## 4. Carga manual de Inventario
 Para construir una estructura confiable desde cero, use este orden:
 1. Cree las **Empresas** necesarias.
 2. Cree el **Departamento**.
 3. Cree el **Área** dentro del Departamento.
 4. Registre la **Operadora vigente** del Área si corresponde.
 5. Cree el **Yacimiento** dentro del Área.
 6. Cree la **Instalación** dentro del Yacimiento.
 7. Seleccione la clasificación técnica de la Instalación.
 8. Cree la **Subinstalación** dentro de la Instalación.
 9. Seleccione una clasificación técnica compatible para la Subinstalación.
 El sistema no permite saltear niveles. Por ejemplo, una Instalación no puede depender directamente de un Área.
 ### Empresa y Operadora
 Cuando una Empresa opera un Área, registre la relación operativa correspondiente. Si cambia la Operadora:
 1. finalice la relación vigente anterior;
 2. registre la nueva Operadora;
 3. no mueva Yacimientos, Instalaciones ni Subinstalaciones.
 El historial queda conservado para consultas temporales.
 ---
 ## 5. Consultar Inventario
 Desde **Inventarios** puede navegar la estructura territorial y abrir el dossier de cada registro.
 Utilice el breadcrumb para volver hacia niveles superiores. El dossier concentra, según la información disponible:
 - datos actuales;
 - ubicación y clasificación;
 - fotografías;
 - historial de cambios;
 - Hallazgos;
 - verificaciones;
 - Actas e Informes relacionados.
 Cuando necesite saber cómo estaba un elemento en una fecha anterior, use la **Consulta temporal** en lugar de interpretar sólo sus datos actuales.
 ---
 ## 6. Crear una Inspección desde la WEB
 En **Inspecciones → Nueva Inspección**:
 1. seleccione el **Área**;
 2. seleccione una **Operadora vigente** para esa Área;
 3. seleccione el **Inspector responsable**;
 4. indique la fecha y hora prevista de inicio;
 5. confirme la creación.
 Al crearse la Inspección, el sistema genera su checklist de antecedentes. Antes de planificar, la información obligatoria debe estar completa.
 Una Inspección planificada se inicia operativamente desde la APK por un Inspector habilitado y asignado.
 ---
 ## 7. Abrir una Inspección directamente desde la APK
 La APK también permite comenzar una Inspección que no haya sido preparada previamente en la WEB.
 Desde la pantalla principal:
 1. pulse **Abrir inspección**;
 2. elija el **Área**;
 3. elija la **Operadora vigente**;
 4. pulse **Abrir inspección ahora**.
 El sistema:
 - crea la Inspección;
 - la asigna al Inspector que inició sesión;
 - genera su checklist;
 - la planifica;
 - la deja **En curso**.
 No elija una Empresa por aproximación: la APK muestra la relación operativa válida del Área.
 ---
 ## 8. Trabajar con Inventario durante una Inspección
 Dentro de una Inspección en curso puede seleccionar Inventario existente del Área y agregarlo al trabajo de campo/Acta correspondiente.
 Los niveles relevantes para Hallazgos son:
 - Yacimiento;
 - Instalación;
 - Subinstalación.
 ### Inventario encontrado en campo
 Si encuentra una Instalación o Subinstalación que todavía no existe, la APK puede darla de alta dentro de la jerarquía correspondiente.
 Antes de poder registrar Hallazgos sobre un elemento nuevo de campo, debe quedar como mínimo con:
 - GPS de creación;
 - al menos una fotografía;
 - clasificación técnica si es Instalación o Subinstalación.
 Esto evita que un Hallazgo quede asociado a un objeto sin identificación suficiente.
 ---
 ## 9. Actas: una Inspección puede tener varias
 Una misma Inspección puede generar **varias Actas**.
 La regla práctica es:
 - puede haber varias Actas históricas dentro de la Inspección;
 - sólo puede existir **un Acta en borrador al mismo tiempo**.
 Mientras un Acta está en borrador puede completar su contenido y agregar Hallazgos. Una vez finalizada/bloqueada deja de ser editable como un borrador normal.
 Para continuar con una nueva Acta dentro de la misma Inspección, finalice correctamente la actual antes de abrir la siguiente.
 ---
 ## 10. Registrar Hallazgos
 Los Hallazgos se asignan directamente a:
 - **Yacimiento**;
 - **Instalación**;
 - **Subinstalación**.
 No se crean Hallazgos directos sobre Departamento ni Área.
 ### Hallazgo de catálogo
 Si el sistema muestra un Hallazgo aplicable al elemento seleccionado:
 1. elija el Hallazgo del catálogo;
 2. complete la descripción y datos requeridos;
 3. guarde.
 ### OTROS / Agregar otro
 La opción **OTROS** debe estar siempre disponible.
 Úsela cuando el Hallazgo observado no exista en la lista disponible. Describa claramente qué se encontró para que luego pueda revisarse y normalizarse en oficina.
 Después de guardar un Hallazgo puede utilizar **Agregar otro** para continuar cargando Hallazgos sobre el mismo Inventario.
 ### En Yacimiento
 Un Yacimiento puede recibir Hallazgos aunque no tenga clasificación técnica. Cuando exista catálogo configurado para ese tipo, el sistema puede ofrecerlo; en todos los casos conserva la opción OTROS.
 ---
 ## 11. Finalizar y sellar un Acta
 Antes de finalizar un Acta revise especialmente:
 - Inventario incluido;
 - Hallazgos;
 - observaciones;
 - firmas y datos requeridos por el flujo.
 Al finalizar, el sistema bloquea el contenido y genera controles de integridad. Esto significa que **el Acta deja de ser editable como borrador**.
 No finalice un Acta para “probar” cómo queda. Primero revise todo su contenido.
 Cuando el flujo de firmas y sellado termina, el Acta queda `SELLADA` y preparada para continuar con su documentación posterior.
 ---
 ## 12. Cerrar una Inspección
 Para cerrar una Inspección en curso deben cumplirse las condiciones operativas, entre ellas:
 - existir al menos un Acta;
 - todas las Actas no canceladas deben estar selladas;
 - si la Inspección contiene verificaciones, sus resultados deben estar registrados.
 Si el sistema impide el cierre, revise el mensaje mostrado: normalmente identifica el Acta o la verificación pendiente.
 ---
 ## 13. Informes por Acta
 El Informe se genera y administra **por Acta**.
 Por eso, si una Inspección tuvo tres Actas, el seguimiento documental no debe tratarla como si existiera un único Informe global.
 Desde **Informes** puede consultar el estado del INF y continuar el flujo habilitado para su rol.
 ---
 ## 14. GEDO / IF y plazo No urgente
 Registrar el identificador y PDF oficial de GEDO/IF **oficializa el Informe**, pero por sí solo no significa que haya comenzado automáticamente el plazo administrativo de una Acta No urgente.
 El vencimiento debe activarse a partir del evento administrativo de notificación que corresponda al procedimiento vigente.
 Si ve un Informe oficializado sin fecha de vencimiento activa, no lo corrija cargando una fecha ficticia de GEDO como notificación.
 ---
 ## 15. Seguimiento de Hallazgos
 Después del trabajo de campo, un Hallazgo mantiene su historia. El seguimiento puede incluir:
 - respuesta de la Empresa;
 - documentos y evidencias;
 - fecha de control;
 - planificación de una verificación;
 - resultado de verificación;
 - nueva fecha si continúa pendiente;
 - cierre administrativo.
 No reescriba el Hallazgo original para reflejar novedades posteriores. Use los eventos de seguimiento para conservar la trazabilidad.
 ---
 ## 16. Verificaciones
 Cuando un Hallazgo requiere control posterior:
 1. defina la fecha de verificación cuando corresponda;
 2. planifique la visita de verificación;
 3. ejecute la verificación;
 4. registre el resultado y evidencia;
 5. si no está resuelto, reprograme según el flujo;
 6. si está resuelto y la visita quedó cerrada, continúe con el cierre administrativo del Hallazgo.
 El historial de verificaciones no debe borrarse para reemplazarlo por el último resultado.
 ---
 ## 17. Historial y Consulta temporal
 Use **Historial** para revisar cambios y eventos registrados.
 Use **Consulta temporal** cuando la pregunta sea, por ejemplo:
 - “¿qué Empresa operaba esta Área en esa fecha?”;
 - “¿dónde estaba ubicado este elemento?”;
 - “¿qué estado tenía el Inventario en ese momento?”.
 La vista actual y la vista histórica cumplen funciones distintas.
 ---
 ## 18. Revisión de Inventario nacido en campo
 Los registros creados por Inspectores en la APK pueden requerir revisión posterior en oficina.
 Al revisar:
 - confirme nombre/código;
 - confirme la ubicación jerárquica;
 - verifique clasificación técnica;
 - revise GPS/fotografías;
 - normalice información pendiente sin perder el origen de campo.
 No cree un duplicado sólo porque el nombre no coincide exactamente; primero confirme si se trata del mismo objeto.
 ---
 ## 19. Mensajes frecuentes
 ### “La Operadora seleccionada no tiene una relación operativa vigente con el Área”
 Revise la relación Empresa ⇄ Área y su vigencia. No cambie la jerarquía física para resolverlo.
 ### “La Instalación/Subinstalación debe tener una clasificación técnica”
 Complete la familia técnica del elemento antes de registrar el Hallazgo.
 ### “El Inventario creado en campo debe tener GPS y al menos una foto”
 Complete la captura de campo requerida y vuelva a intentar.
 ### “Todas las Actas deben estar SELLADAS antes de cerrar la Inspección”
 Abra la Inspección y revise cuáles Actas todavía están en borrador, bloqueadas o pendientes de sellado.
 ### “La inspección no tiene un Acta borrador abierta”
 Cree/abra un Acta borrador para esa Inspección antes de cargar nuevos Hallazgos.
 ---
 ## 20. Buenas prácticas
 - Cargue la estructura de Inventario en orden jerárquico.
 - No use Empresa como padre físico.
 - No duplique Inventario ante la primera diferencia de nombre.
 - Use OTROS cuando el Hallazgo no exista en catálogo.
 - Revise un Acta antes de finalizarla: luego queda inmutable.
 - Use seguimiento y verificaciones para agregar historia; no reescriba hechos anteriores.
 - Use Consulta temporal para preguntas históricas.
 - Respete los mensajes de integridad del sistema en lugar de forzar datos ficticios.
 Ante una duda funcional que pueda modificar jerarquía, Actas, Hallazgos o vencimientos, consulte antes de cargar datos masivamente.