diff --git a/docs/MANUAL_USUARIO.md b/docs/MANUAL_USUARIO.md new file mode 100644 index 0000000..69434c4 --- /dev/null +++ b/docs/MANUAL_USUARIO.md @@ -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.