Manual detallado de plataforma

Guia completa para usar Risk Register

Este sitio explica todas las pantallas, opciones, roles, modulos y flujos clave de la plataforma. El objetivo es que cualquier usuario pueda operar el sistema, cargar informacion, evaluar riesgos y aprovechar las capacidades de diagnostico y seguimiento.

Portada de Risk Register
Que cubre este manual
  • Acceso por perfiles y credenciales demo.
  • Uso completo de modulos principales y subtabs de evaluacion.
  • Carga de Excel, persistencia en BD y diagnostico sobre la carga activa.
  • Administracion del repositorio experto para diagnostico especializado.

1. Vision general

Que es la plataforma

Proposito

Risk Register centraliza informacion de riesgos operativos, degradaciones, barreras, acciones, diagnosticos y notificaciones. La plataforma combina capa visual ejecutiva, motor local de analisis y opcion de motor IA cuando se desea comparar o ampliar resultados.

Componentes principales

  • Frontend visual con login, panel, tabs y graficos.
  • Backend API con control de roles y autenticacion por token.
  • MySQL para usuarios, riesgos, acciones, subidas y conocimiento experto.
  • Flujo de evaluacion basado en carga activa de Excel.

2. Roles y accesos

Perfiles disponibles y ejemplos de uso

Roles del sistema

  • operator: consultas operativas y alertas.
  • engineer_process: evaluaciones de proceso y carga de informacion.
  • engineer_hse: evaluacion de riesgos, salud del registro y seguimiento.
  • manager: vision ejecutiva, alertas y trazabilidad.
  • admin: acceso total, configuracion y repositorio experto.

Usuarios demo

  • operador@galp.local / Operador123!
  • procesos@galp.local / Procesos123!
  • hse@galp.local / HSE12345!
  • manager@galp.local / Manager123!
  • admin@galp.local / Admin12345!

Permisos clave

  • El menu principal muestra solo modulos operativos centrales.
  • Las evaluaciones dependientes de la carga viven dentro de M6.
  • El tab Repo. Experto solo aparece para admin.

3. Pantalla de acceso

Como ingresar y recuperar la cuenta

Elementos visibles

  • Logo de marca y portada visual.
  • Campo de correo.
  • Campo de contrasena con boton de ver/ocultar.
  • Accion Conectar.
  • Enlace He olvidado mi contrasena.
  • Boton de cambio de tema claro/oscuro.

Recuperacion de contrasena

  1. Pulse He olvidado mi contrasena.
  2. Ingrese el correo asociado a su usuario.
  3. Solicite el token de reseteo.
  4. Ingrese token, nueva contrasena y confirmacion.
  5. Regrese al login y acceda con la nueva clave.

4. Pantalla principal

Como leer el panel al iniciar sesion

Barra superior

  • Nombre de la plataforma.
  • Chips de usuario, rol y estado de carga activa.
  • Selector visual del motor de trabajo cuando el rol lo permite.
  • Boton de cierre de sesion.

Area central

  • Tarjetas de contexto y secciones explicativas del framework.
  • Tabs de modulos principales.
  • Panel operativo a la derecha con formulario, resultados y graficos.
  • Resultados en formato ejecutivo, sin JSON crudo para el usuario final.

5. Modulo M2

M2 · Enriquecimiento de Riesgos

Para que sirve

Permite enriquecer un escenario de riesgo con base en evento iniciador, TAG y unidad. El sistema devuelve causas sugeridas, consecuencias, barreras, estimacion de riesgo inherente y una lectura experta adicional.

Campos

  • Evento iniciador: descripcion corta del evento o falla.
  • TAG: identificador del equipo.
  • Unidad: unidad o area operacional.
  • Sugerir riesgo: ejecuta el analisis.

6. Modulo M3

M3 · Analisis de Degradaciones

Uso principal

Evalua el efecto de una barrera degradada sobre el riesgo residual. Es util para salvaguardas instrumentadas, PSV, controles operacionales y otros elementos cuya perdida de efectividad afecta la exposicion.

Campos

  • TAG
  • Unidad
  • Salvaguarda
  • PFD de salvaguarda
  • Analizar degradacion

7. Modulo M5

M5 · OnePage Inteligente

Objetivo

Genera una sintesis ejecutiva orientada a un receptor especifico. Es ideal para reportes rapidos, reuniones de seguimiento y comunicacion con liderazgo o personal tecnico.

Opciones

  • ID de degradacion a resumir.
  • Rol receptor: manager, engineer u operator.
  • Idioma: es, en o pt.

8. Modulo M6

M6 · Importacion Excel IA

Funcion central

M6 es el corazon operativo de la plataforma para el trabajo con archivos Excel. Desde aqui se sube el archivo, se diagnostica su calidad, se persiste la informacion en base de datos y se habilitan las evaluaciones sobre la carga activa.

Tabs internos

  • Gestion De Carga
  • Eval. Riesgos
  • Repo. Experto (solo admin)
  • Eval. Chatbot
  • Eval. Briefing
  • Eval. Alertas
  • Eval. Health Check

8.1 Subtab M6

Gestion De Carga

Opciones disponibles

  • Archivo template real (.xlsx): selecciona el archivo a trabajar.
  • Diagnosticar template real: revisa si el archivo se ajusta al formato esperado.
  • Cargar datos a BD: guarda la informacion en MySQL y crea una subida persistente.
  • Mapear columnas: ayuda a revisar headers del archivo.

Subidas Persistidas

  • Muestra el historial de cargas.
  • Indica hoja, score de template, filas procesadas y volumen de riesgos/acciones.
  • Permite Activar esta carga para que los tabs de evaluacion trabajen sobre ella.

8.2 Subtab M6

Eval. Riesgos

Ejecuta el diagnostico experto de los riesgos de la carga activa. Esta vista utiliza el repositorio experto almacenado en MySQL para clasificar escenarios, revisar barreras esperadas, aceptar o condicionar riesgos y sugerir acciones.

  • Use Evaluar riesgos cargados.
  • Revise semaforos, resumen ejecutivo, aceptabilidad y acciones prioritarias.
  • Si no existe carga activa, el sistema bloquea la evaluacion.

8.3 Subtab M6

Repo. Experto

Quien lo usa

Solo el perfil admin puede acceder a esta consola. Sirve para administrar el conocimiento experto que alimenta el diagnostico de riesgos.

Que se puede hacer

  • Listar entradas del repositorio.
  • Filtrar por categoria, disciplina, estado y texto.
  • Editar o eliminar entradas.
  • Crear nuevas entradas con atributos JSON.

Tipos de entrada

  • severity_scale
  • frequency_scale
  • discipline_profile
  • hazard_scenario
  • action_quality_rule
  • status_rule

8.4 Subtab M6

Eval. Chatbot

Permite consultar la carga activa en lenguaje natural. Es util para operadores, ingenieria y liderazgo cuando necesitan responder preguntas como que riesgos aplican a un equipo, unidad o escenario.

8.5 Subtab M6

Eval. Briefing

Genera una lectura ejecutiva de la carga activa para revisiones de turno, reuniones de seguimiento y presentaciones de estado general.

8.6 Subtab M6

Eval. Alertas

Revisa la carga activa para generar alertas predictivas o condiciones de prioridad, segun el motor seleccionado y las reglas del sistema.

8.7 Subtab M6

Eval. Health Check

Ejecuta una revision general del estado del registro de riesgos cargado. Ayuda a detectar cobertura, consistencia y oportunidades de mejora del dataset activo.

9. Modulo M8

M8 · Mitigacion SMART

Genera o mejora una accion de mitigacion sobre un riesgo existente. La plataforma orienta a que la accion tenga mejor redaccion, responsable, plazo y trazabilidad.

  • Ingrese Risk ID.
  • Escriba Texto parcial.
  • Pulse Sugerir accion.

10. Modulo M10

M10 · Notificaciones Contextuales

Crea notificaciones operativas o ejecutivas asociadas a un riesgo y su severidad. Es util para escalamiento, respuesta rapida y comunicacion entre roles.

  • Ingrese Risk ID.
  • Seleccione severidad: LOW, MEDIUM, HIGH o CRITICAL.
  • Pulse Generar notificacion.

11. Flujo sugerido

Secuencia recomendada para una operacion completa

1

Ingresar a la plataforma

Acceda con el rol adecuado y confirme el motor de trabajo.

2

Ir a M6

Suba el archivo Excel, diagnostique el template y cargue datos a BD.

3

Activar la subida correcta

Seleccione la carga que se utilizara como base de evaluacion.

4

Evaluar riesgos

Use Eval. Riesgos, Chatbot, Briefing, Alertas y Health Check segun el caso.

5

Tomar acciones

Use M8 para mejorar acciones y M10 para generar notificaciones y escalamiento.

12. Buenas practicas

Recomendaciones para uso diario

Calidad del Excel

Antes de cargar, confirme headers claros, severidad y frecuencia completas, y acciones entendibles.

Uso de la carga activa

Verifique siempre que la subida activa corresponda al periodo o estudio que desea evaluar.

Repositorio experto

Edite el conocimiento experto solo cuando exista criterio tecnico validado por responsables competentes.

13. FAQ

Preguntas frecuentes de los usuarios

Que pasa si subo un Excel y no aparece evaluacion?

Revise si la carga fue activada. Sin una carga activa, los tabs de evaluacion dentro de M6 no trabajan.

La plataforma solo guarda el archivo o tambien lo evalua?

Hace ambas cosas: valida estructura del Excel, persiste la informacion y luego evalua riesgos sobre la carga activa.

Quien puede modificar el repositorio experto?

Solo el rol admin, desde el tab Repo. Experto dentro de M6.

Puedo comparar resultados entre motor local e IA?

Si, cuando su rol lo permite puede cambiar el motor y ejecutar los modulos para comparar respuesta.

Que hago si olvido mi contrasena?

Use el enlace de recuperacion en login y complete el flujo de reseteo con token.