Manual de Usuario & Guía Técnica HVAC
Guía integral que explica para qué y cómo utilizar cada una de las 10 secciones del software HVAC Diagnostic Studio.
1. Live Diagnostic (Diagnóstico Puntual y Continuo)
Análisis termodinámico instantáneo del circuito frigorífico frente a reglas y modelos físicos.
1. Modos de Uso de la Interfaz
Interfaz gráfica guiada dividida en bloques conceptuales (Contexto, Lecturas Obligatorias, Temperatura de Líquido, Componentes y Circuito de Agua/Aire). Ideal para pruebas de campo manuales.
Editor de código nativo con sintaxis destacada y formateador automático (`Format JSON`). Permite pegar directamente payloads JSON provenientes de logs de telemetría o APIs externas.
2. Entradas y Configuración de Datos (Inputs)
A. Contexto de Diagnóstico (`DiagnosticContext`)
- refrigerant: Gas del circuito (R32, R410a, R454c, R290, R407c). Esencial para tabular la curva P/T y calcular saturaciones.
- regulationMode: 3 = Enfriamiento (Cooling) | 4 = Calefacción (Heating). Selecciona el conjunto de reglas del ciclo de 4 vías.
- equipmentType: air-air (Aire-Aire) o air-water (Bomba de calor Aire-Agua / Chiller).
- sessionId: (Opcional) ID de sesión persistente en memoria para seguimiento de tendencias entre peticiones.
- persistenceThreshold: Mínimo de lecturas consecutivas requeridas para confirmar una avería (default 1).
B. Lecturas Mínimas Obligatorias (`RawReadings`)
- externalTemp: Temperatura ambiente exterior (°C). Referencia de disipación/absorción.
- suctionPressure: Presión en la línea de aspiración (bar manométricos).
- dischargePressure: Presión en la línea de descarga (bar manométricos).
- suctionTemp: Temperatura medida en el tubo de succión a la entrada del compresor (°C).
- dischargeTemp: Temperatura medida a la salida de la cabeza del compresor (°C).
¿Qué implica introducir o NO introducir el campo Liquid Temp?
Dual Simulation EngineEl sistema utiliza la medición física leída directamente por la sonda instalada en la línea de líquido (a la entrada de la EEV). Permite calcular de manera exacta el Subenfriamiento Real (Subcooling):Subcooling = T_sat(dischargePressure) - liquidTemp
Dado que la sonda de líquido falta con frecuencia en instalaciones comerciales, el backend activa el Modo de Simulación Dual (Dual Scenario Simulation), ejecutando dos modelos en paralelo:
- Escenario Optimista: Asume un subenfriamiento saludable estimando liquidTemp = T_sat - 10°C (Subenfriamiento SC = 10 K).
- Escenario Pesimista: Asume un subenfriamiento escaso estimando liquidTemp = T_sat - 2°C (Subenfriamiento SC = 2 K).
➔ Uso en la UI: La pantalla muestra un banner azul con el botón "View Alternative" que permite al frigorista conmutar al instante entre ambos escenarios y verificar si la avería persiste en ambas condiciones o si depende críticamente de la temperatura de líquido.
3. Resultados del Diagnóstico (Outputs)
Estado Global (`systemStatus`)
Avería Principal y Secundarias (`primaryFault` / `secondaryFaults`)
Identifica la avería de mayor probabilidad (0% a 100% Match), detallando los síntomas evidencia que la respaldan, su severidad, causa física y la Acción Recomendada para el técnico en campo. La lista secundaria muestra candidatos alternativos ordenados por probabilidad.
¿Qué es la Desviación (Deviations) y cuál es su significado?
Gemelo Digital DeltaLa Desviación (Deviation) es la diferencia matemática exacta entre el valor real medido/calculado en el equipo y el valor teórico ideal simulado por el Gemelo Digital (Digital Twin) para ese punto de operación preciso:Desviación = Valor Real - Valor Ideal del Gemelo Digital
- • Positivo (+): Compresor sobrecalentado, falta de lubricación, compresión ineficiente o fugas internas en platos de válvulas.
- • Negativo (-): Descarga demasiado fría; riesgo de aspiración de mezcla húmeda o retorno de refrigerante líquido.
- • Positivo (+): Recalentamiento excesivo ➔ Fuga de refrigerante, falta de carga o válvula EEV atascada en cierre.
- • Negativo (-): Evaporador sobre-alimentado ➔ Riesgo de golpe de líquido en compresor.
- • Positivo (+): Subenfriamiento alto ➔ Acumulación de líquido en condensador por sobrecarga o presencia de gases incondensables.
- • Negativo (-): Subenfriamiento insuficiente ➔ Falta de carga o riesgo de flash gas en la EEV.
- • Positivo (+): Salto térmico deficiente ➔ Condensador sucio, obstrucción de aire o fallo en el ventilador exterior.
2. Batch Diagnostic (Diagnóstico por Lotes)
Endpoint: /api/diagnose/batchDiseñado para procesar lotes de datos históricos o secuencias temporales de hasta 1,000 lecturas o 5 MB por solicitud.
Entradas (Inputs)
- • Contexto Común: Refrigerante, modo y tipo de equipo aplicable a la serie.
- • Arreglo de Lecturas: Estructura JSON con matriz de RawReadings o formato { timestamp, data: RawReadings }.
Salidas (Outputs)
- • Resumen Ejecutivo (summary): Lista de averías detectadas (faultsDetected) y fallos persistentes (persistentFaults).
- • Gráficas Temporales: Evolución gráfica de presiones, temperaturas y síntomas.
3. Trends Tracking & Streaming (Monitoreo de Tendencias)
Modulo: TrendTrackerEl módulo Trends Tracking realiza un seguimiento continuo de la evolución temporal de las presiones y temperaturas del circuito mientras el compresor está en marcha. Permite detectar síntomas de deriva como subidas progresivas de presión de descarga o caídas del salto térmico.
Reglas Clave de Funcionamiento (TrendTracker Rules)
- • Compresores On/Off Fixos: Diseñado para compresores de velocidad fija (no Inverter, sin RPS o con compressorStatus1: 1).
- • Operación Total: Requiere que TODOS los compresores del circuito estén ENCENDIDOS.
- • Lecturas Consecutivas Mínimas: Exige al menos 3 lecturas consecutivas enviadas bajo el mismo sessionId.
- • Expiración por Inactividad: El búfer en memoria backend expira tras 30 minutos sin recibir paquetes.
- • Reset por Parada: Al apagar el compresor (compressorStatus1 = 0), el búfer de tendencias se limpia inmediatamente para evitar lecturas transitorias falsas.
4. Fault Catalog (Catálogo de Reglas y Averías)
69 Reglas MatrizBiblioteca centralizada de definiciones de fallos del sistema (faultDefinitions.ts). Cada regla mapea síntomas requeridos con severidad y acciones correctivas.
Estructura Interna de una Regla de Fallo (FaultDefinition)
5. Symptoms Catalog (Catálogo de Síntomas)
Motor de EvaluaciónAbstracciones termodinámicas calculadas a partir de lecturas físicas. Divididas en síntomas estáticos (SH, SC, Presiones) y de tendencia temporal (variación de variables en el tiempo).
6. Signature Map (Mapa de Firma Termodinámica)
Plano SH vs SCVisualización 2D basada en las coordenadas de Recalentamiento vs. Subenfriamiento. Clasifica la firma en regiones como LOW_CHARGE, OVERCHARGE, RESTRICTION, DIRTY_CONDENSER y FLOODBACK.
7. Gemelo Digital y Machine Learning (ML)
Análisis PredictivoGemelo Digital (Digital Twin)
Calcula el comportamiento teórico óptimo del ciclo frigorífico para cuantificar la pérdida de eficiencia energética (COP/EER).
Módulos ML (Classifier, Training, Evaluate, Feedback)
Permite clasificar patrones complejos con redes neuronales, visualizar muestras de datos (ML Samples), evaluar la matriz de confusión y recopilar retroalimentación de técnicos frigoristas (Technician Feedback).
8. Error Simulator (Simulador de Errores y Validaciones)
Pruebas de ResilienciaEl Error Simulator permite probar la robustez del backend frente a solicitudes malformadas o lecturas corruptas de sensores antes de ir a producción.
Escenarios de Error Predefinidos
- • Missing Core Fields: Omisión de campos obligatorios (externalTemp, suctionPressure).
- • Null Fields: Envío explícito de valores nulos en temperaturas clave.
- • Negative Pressure: Presión de succión negativa (-5.0 bar), violando restricciones físicas.
- • Pressure Out of Range: Presiones superiores al límite máximo seguro (ej. > 40 bar).
Resultados Esperados (ValidationIssue)
El backend responde con la estructura de issue local y código HTTP correspondiente:
- • 400 Bad Request: Errores de sintaxis o tipos de datos.
- • 422 Unprocessable Entity: Violación de reglas de validación físicas.
9. Acceptance Fixtures (Suite de Pruebas de Aceptación)
Regression SuiteLa suite Acceptance Fixtures contiene un catálogo reproducible de casos de prueba pregrabados que cubren todas las capacidades del backend.
Métricas de Ejecución de la Suite
ⓘ Nota: Los valores esperados son comprobaciones de regresión revisadas para auditar que cambios en los umbrales del backend no rompan diagnósticos conocidos.
10. PDF Report Generator (Generador de Informes)
Endpoint: /api/v1/reportPermite generar informes profesionales en formato PDF con la hoja de diagnóstico técnico para entregar al cliente final o guardar en el expediente de mantenimiento.
Entradas (Inputs)
- • Datos de Diagnóstico: Objeto DiagnosticContext y lecturas del circuito.
- • Metadatos del Cliente: Identificador de equipo, técnico responsable y notas de inspección.
Salidas (Outputs)
- • Stream Binario PDF: El backend retorna un buffer binario (Content-Type: application/pdf).
- • Visor Integrado & Descarga: Renderizado inmediato en visor interactivo <object> y botón de descarga directa del documento.