Manual de Usuario — v1.1

SofIA PdM Report es la plataforma de análisis y reportes de monitoreo de condición de SCM Predictivo. Este manual cubre todos los módulos y todos los roles. Para imprimirlo: Ctrl+P → Guardar como PDF.

1. Acceso y jerarquía de roles

Entra desde cualquier navegador con tu correo y contraseña personales. "Olvidé mi contraseña" en el login envía el enlace de recuperación.

2. La pantalla principal

Izquierda: árbol de activos — clic en áreas/secciones para plegar/desplegar, ⊞/⊟ para todo, filtro por tecnología, y cada activo con su última condición en color. La columna queda fija con su propio scroll mientras trabajas en el editor. Centro: el editor de evaluaciones dentro de un informe/OT. Derecha: el historial completo del activo seleccionado.

3. Plantas: crear y editar

Roles: admin y técnico SCM.

• ＋ Planta — crea: empresa/cliente + nombre (obligatorios), contacto, ubicación, correos electrónicos y notas.
• ✎ (junto a ＋ Planta) — edita la planta seleccionada: contacto, ubicación, correos y notas/observaciones. El nombre es invariable (empresa y planta aparecen bloqueados) — así el histórico jamás queda huérfano por un renombre.

4. Planos de planta y pines

Ver: todos · Editar: admin y técnico SCM · Archivar plano: solo admin. Botón 🗺 Plano de planta.

• Varios planos por planta (uno por área) — selector para cambiar entre ellos; acepta imagen o PDF (usa la primera página).
• Ubicar: elige el activo y clic en el plano. Mover: clic al pin (lo selecciona) y clic en la nueva posición. Quitar pin: botón dedicado.
• ♻ Reemplazar imagen conserva los pines (para versiones actualizadas del mismo plano). 🗑 Archivar (admin) lo retira sin borrar nada.
• Pin morado = activo sin evaluaciones aún. Para clientes el plano es de consulta: clic al pin navega al activo.

5. Activos y ficha técnica

Crear/editar: admin y técnico SCM · Archivar: solo admin · Consultar: todos.

• Datos técnicos: marca, modelo, potencia, RPM, rodamientos DE/NDE, transmisión/poleas, engranajes, notas, y v1.1 lubricación: fabricante de aceite, modelo/tipo y viscosidad ISO — el analista los contrasta contra lo que reporta el laboratorio.
• Tecnologías aplicables: marca las que corresponden al equipo. Efectos: el activo solo aparece en informes y filtros de esas tecnologías, y las estadísticas por tecnología usan la base correcta (51 equipos de termografía, no los 156 de la planta). Sin marcar = aparece en todo.
• Fotos del equipo con Ctrl+V o archivo. ↕ Ordenar acomoda los activos dentro de su sección con flechas ▲▼.
• 🗂 Archivar (solo admin): el activo sale de listas y planos pero todo su historial se conserva; restaurable.

6. Carga masiva por CSV

Roles: admin y técnico SCM. Botón ⬆ CSV.

1. ⬇ Descargar plantilla — abre en Excel en columnas y con tildes correctas en cualquier idioma.
2. Columnas: area, seccion, codigo, descripcion, clase, criticidad, marca, modelo, potencia, rpm, rodamientos, transmision, engranajes, notas, tecnologias (estas últimas separadas por |, ej. Termografía Infrarroja|Ultrasonido Aéreo). Solo codigo es indispensable. Acepta también inventarios de rutas de vibraciones y la plantilla de SofIA PdM Field.
3. 📂 Elegir archivo → previsualización (cuántos y a qué planta) → Importar.

7. 🧪 Importador ALS360 — análisis de aceites v1.1

Roles: admin y técnico SCM. Convierte el export de ALS360 en evaluaciones con todos los valores del laboratorio — cero digitación, cero errores de transcripción.

1. En ALS360 exporta los resultados de muestras (.xlsx) — idealmente filtrado por la planta.
2. En SofIA, con la planta correcta seleccionada: 🧪 ALS → elige la OT destino (pendiente) → elige el archivo.
3. La previsualización cruza cada muestra por Tag/fleet contra el código o descripción del activo. Verde = encontrado; morado = se creará (con código = tag, modelo y serie del export, y "Análisis de Aceites" como tecnología aplicable); gris = ya importada antes (nunca duplica).
4. Importar: cada muestra se vuelve una evaluación de Análisis de Aceites con la fecha real de muestreo, la condición mapeada del lab (Normal→ACEPTABLE, Caution→OBSERVACIÓN, Severe→ADVERTENCIA), la evaluación y acciones del laboratorio como texto, y todos los analitos (Fe, Cu, Si, PQI, viscosidad, agua…).

8. Informes (OT) y peer review

Todo trabajo vive dentro de un informe ligado a una orden de trabajo — el hilo hacia cotización y facturación. Crean: admin y técnico SCM.

1. + Nuevo informe: 1) número de OT (único por planta), 2) descripción/ruta, 3) tecnología, fecha.
2. Los chips bajo la barra muestran los activos aplicables con ✓ y el color de su condición asignada — la fila se convierte en el mapa del avance de la ruta.
3. Peer review: el analista no puede liberar sus propios informes — los libera otro analista, un técnico SCM o el admin (pueden ✎ editar mientras esté PENDIENTE; queda "editado por"). Técnico SCM y admin sí autoliberan, aceptando la advertencia de liberación sin revisión cruzada. La etiqueta muestra quién liberó.
4. ↩ Reabrir (solo admin): revierte una liberación hecha por error — el informe vuelve a PENDIENTE y es editable de nuevo.

9. Evaluaciones

1. Selecciona informe (OT) y activo — su historial queda a la derecha para comparar.
2. Asigna la condición:

3. v1.1 Autollenado ACEPTABLE: al pulsar el botón verde, los campos vacíos se llenan solos ("Sin hallazgos importantes…", "Mantener monitoreo periódico…", "Sin acción requerida"…). Nunca pisa texto tuyo, y si cambias de condición los textos automáticos se retiran solos. Un equipo sano se documenta en dos clics.
4. 📋 Catálogos: cada campo inserta frases predefinidas — filtradas por la tecnología del informe (el técnico de ultrasonido no ve las frases de vibraciones; "ver todas" para excepciones).
5. Imágenes: pega con Ctrl+V (espectros, termogramas), arrastra o elige archivos.
6. Una evaluación por equipo por OT. Si guardas una segunda, la app pregunta si es SEGUIMIENTO — el caso legítimo de verificación post-reparación en la misma visita (antes/después queda marcado en historial e informe). Para corregir usa ✎ Editar; para deshacer un error, 🗑 Anular.

10. Historial y tendencia

• Filtro por tecnología: "Global (todas)" o una específica — tendencia, timeline y lista se recalculan.
• Línea de tendencia de severidad + timeline de colores (los estados sin medición aparecen en el timeline pero no en la línea).
• Mini-tabla de laboratorio en evaluaciones de aceites (valores clicables para corregir mientras el informe esté pendiente).
• Miniaturas de evidencia — clic abre el visor emergente sobre la misma pantalla (clic fuera para volver).
• Observaciones de campo de SofIA PdM Field aparecen automáticamente como "Inspección Visual (campo)".
• Acciones por evaluación (según rol y estado del informe): ⤺ Usar como base · ✎ Editar · 🗑 Anular · 📚 Caso · 💬 Retroalimentación.

11. Retroalimentación

Todos excepto visualizador — es LA función del rol cliente. En cualquier evaluación → 💬 Retroalimentación: comentario de lo ejecutado (obligatorio), fotos del trabajo, y opcionalmente actualizar la "acción tomada". El hilo queda bajo la evaluación con autor y fecha — cierra el ciclo recomendación → ejecución → verificación, y puede incluirse en el informe impreso.

12. Entregables e impresión

Todos los roles. Botón 📊 Entregables — el configurador completo del documento:

• Filtros combinables: estados (¡el informe de "solo críticos"!), áreas, secciones, tecnologías, criticidades y qué croquis incluir. Todo marcado por defecto.
• Resumen ejecutivo: texto libre de esa edición, sale como sección tras la portada.
• Secciones: leyenda de condición, resumen estadístico, v1.1 tendencias por activo (gráficas en rejilla), vista rápida (peor→mejor), croquis con pines, matriz histórica por mes (con rango de fechas), e informe completo del OT ordenado de lo más severo a lo más leve, con o sin imágenes (versión compacta para correo) y con o sin retroalimentación.
• Imprimir/PDF genera el documento final con doble marca SCM+SofIA y pie de contacto corporativo.

13. Plantillas de informes

Administrar: admin y técnico SCM. En Entregables → ✎ Administrar plantillas. Cada plantilla guarda: dirigido a (personas y cargos), texto de presentación, normas de referencia (ISO 20816, ISO 18434…), firma de portada, notas legales y las secciones por defecto. Alcance por planta o general. Con plantilla, el documento sale con portada profesional — franja de marca, título, cliente, OT, destinatarios, presentación, normas y firma — más la leyenda y el descargo legal. El informe mensual de cada cliente: plantilla → OT → generar.

14. Calendario de monitoreos

Configurar: admin y técnico SCM · Consultar: todos. Botón 📅 Calendario (con globo rojo/naranja de pendientes).

Define tecnología + frecuencia en días + primera fecha + responsable. Al liberar el informe de esa tecnología, el programa registra la ejecución y reprograma solo — el calendario se mantiene con el flujo de trabajo, sin marcar casillas. Al entrar a una planta con vencidos, la app avisa.

15. 🌐 Reporte global multi-planta v1.1

Personal SCM (admin, técnico, analista). Botón 🌐 Global → eliges el período → documento de gestión con todas tus plantas:

Incluye además el detalle de todos los monitoreos del período (OT, tecnología, estado) y la agenda de vencidos y próximos 30 días con responsables. Es el reporte de planificación semanal y el de cierre de mes — imprimible como todo.

16. Dashboard — tres vistas

Todos los roles. Botón 📈 Dashboard:

1. Condición: KPIs de estado, distribución global en barra, por tecnología, y activos en riesgo con su falla.
2. Problemática por tecnología: donas de cobertura, problemas activos por tecnología y composición de fallas dentro de cada una (% buen estado, % desalineamiento, % falso contacto…) — el Pareto que orienta dónde actuar. La base de cada tecnología son sus activos aplicables (sección 5), no toda la planta.
3. KPIs de mantenimiento: MTTR, MTBF por activo, tipos de falla, eficiencia de detección por tecnología, y costos/retorno del programa — se alimentan del cierre de casos (sección 17). Los costos muestran "—" hasta que existan datos.

17. Historiales de caso

Crear/cerrar: admin, técnico SCM y analista. Un caso agrupa las evaluaciones de un mismo problema (detección → progresión → corrección → verificación) por tipo de falla. Desde el historial: 📚 Caso → nuevo o agregar a uno abierto del activo. Biblioteca con 📚 Casos: filtro por falla/estado y línea de tiempo en colores. El cierre pide fecha de reparación, horas de intervención, costo de reparación y daño evitado (alimentan los KPIs) más las lecciones aprendidas — ahí el caso se vuelve conocimiento y argumento comercial.

18. Catálogos

Agregar: admin y técnico SCM · Quitar entradas: solo admin · Usar: todos los que capturan. Botón ⚙ Catálogos.

Seis catálogos: Tecnologías, Hallazgos, Recomendaciones, Acciones requeridas, Acciones tomadas y Tipos de falla. v1.1 Cada entrada puede llevar tecnología asociada (o "General"): al capturar, el picker muestra solo las de la tecnología del informe + generales, con chips de color por disciplina para escaneo visual. Al agregar una frase, la tecnología del informe activo viene preseleccionada.

19. Gestión de usuarios

Admin: todos · Técnico SCM: usuarios de rango inferior (analista, cliente, visualizador). Botón 👥 Usuarios.

1. Crear el acceso: Supabase → Authentication → "Invite user" con el correo. El perfil nace como visualizador (rol mínimo, seguro por defecto).
2. Asignar: en la app → ✎ Editar → nombre, rol y plantas con acceso (obligatorio para cliente/visualizador; el personal SCM ve todas). El técnico SCM solo puede asignar roles inferiores al suyo.
3. Suspender/Reactivar — sin borrado: la autoría del historial se conserva siempre. Nadie se suspende a sí mismo.

20. Preguntas frecuentes

SofIA PdM Report · Manual de Usuario v1.1 · agosto 2026 · SCM Predictivo S.A.
Hotel Crowne Plaza Corobicí, oficinas 5 y 6 · San José, Costa Rica · Tel: +506 7207-0078/79 · pcn@predictivo.net · scmpredictivo.com
Dudas o sugerencias: repórtalas a Pedro Cortez — el sistema evoluciona con tu retroalimentación.