{"$defs":{"EngineeringUnit":{"description":"Constrained engineering units for water/wastewater treatment.\n\nCodes follow QUDT / UN/CEFACT Rec 20 conventions with Python-safe\nidentifiers (underscores for slashes).  JSON values match the Python\nname except where noted (e.g. ``min_`` → ``\"min\"``).","enum":["m3_per_d","m3_per_h","L_per_s","L_per_min","MGD","gpm","mg_per_L","g_per_m3","ug_per_L","percent","mg_per_kg","kg_per_d","kg_per_h","t_per_d","degC","K","kPa","bar","psi","mH2O","kW","W","hp","kWh","MJ","m","mm","cm","m2","m3","L","kg","g","mg","s","min","h","d","m_per_s","m_per_min","kg_per_m3_per_d","kg_per_m2_per_d","PH","NTU","SVI_mL_per_g","V","A","ohm","Hz","mS_per_cm","uS_per_cm","meq_per_L","CFU_per_100mL","MPN_per_100mL","SU","L_per_m2_per_h","gpd_per_ft2","ppmv","BTU_per_scf","MJ_per_Nm3","mg_per_Nm3","percent_vol","mg_per_kg_dry","CFU_per_g","MPN_per_g","ug_per_m3","kg_per_yr","percent_VS_reduction","MPN_per_4g","Pt_Co"],"title":"EngineeringUnit","type":"string"},"FailureEvent":{"description":"Single equipment failure per ISO 14224 taxonomy.\n\nCaptured during maintenance events and aggregated into reliability\nKPIs. The failure_mode / failure_cause / failure_mechanism triad\nfollows ISO 14224 structure.","properties":{"event_id":{"format":"uuid","title":"Event Id","type":"string"},"equipment_uid":{"format":"uuid","title":"Equipment Uid","type":"string"},"failure_date":{"format":"date-time","title":"Failure Date","type":"string"},"detected_by":{"anyOf":[{"enum":["OPERATOR","SCADA_ALARM","INSPECTION","PM","OTHER"],"type":"string"},{"type":"null"}],"default":null,"title":"Detected By"},"downtime_h":{"minimum":0,"title":"Downtime H","type":"number"},"failure_mode":{"description":"ISO 14224 failure mode (e.g., 'Leakage - external')","title":"Failure Mode","type":"string"},"failure_cause":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 14224 failure cause (e.g., 'Corrosion')","title":"Failure Cause"},"failure_mechanism":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO 14224 failure mechanism (e.g., 'Erosion-corrosion')","title":"Failure Mechanism"},"severity":{"anyOf":[{"enum":["CRITICAL","DEGRADED","INCIPIENT"],"type":"string"},{"type":"null"}],"default":null,"title":"Severity"},"cmms_work_order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Cmms Work Order Id"},"corrective_action":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Corrective Action"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"}},"required":["equipment_uid","failure_date","downtime_h","failure_mode"],"title":"FailureEvent","type":"object"},"GuaranteeComparison":{"description":"Actual vs. guaranteed performance for a single metric.\n\nProduced by comparing VendorGuarantee records against\nEquipmentPerformanceFeedback data from operations.","properties":{"comparison_id":{"format":"uuid","title":"Comparison Id","type":"string"},"equipment_uid":{"format":"uuid","title":"Equipment Uid","type":"string"},"guarantee_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"default":null,"description":"FK to VendorGuarantee","title":"Guarantee Id"},"metric":{"title":"Metric","type":"string"},"guaranteed_value":{"title":"Guaranteed Value","type":"number"},"actual_value":{"title":"Actual Value","type":"number"},"pct_of_guarantee":{"description":"actual / guaranteed * 100","title":"Pct Of Guarantee","type":"number"},"unit":{"anyOf":[{"$ref":"#/$defs/EngineeringUnit"},{"type":"null"}],"default":null},"period_start":{"format":"date","title":"Period Start","type":"string"},"period_end":{"format":"date","title":"Period End","type":"string"},"within_guarantee":{"description":"True if actual meets or exceeds guarantee","title":"Within Guarantee","type":"boolean"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Notes"}},"required":["equipment_uid","metric","guaranteed_value","actual_value","pct_of_guarantee","period_start","period_end","within_guarantee"],"title":"GuaranteeComparison","type":"object"},"SpareConsumption":{"description":"Spare part consumed during maintenance.","properties":{"inventree_part_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Inventree Part Id"},"part_description":{"title":"Part Description","type":"string"},"quantity":{"minimum":0,"title":"Quantity","type":"number"},"unit_cost_usd":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Unit Cost Usd"},"total_cost_usd":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Total Cost Usd"}},"required":["part_description","quantity"],"title":"SpareConsumption","type":"object"}},"description":"Periodic reliability metrics for a single equipment position.\n\nAggregated from CMMS work orders, SCADA uptime data, and\ncost_observation records. Stored as time-series for trending.","properties":{"snapshot_id":{"format":"uuid","title":"Snapshot Id","type":"string"},"equipment_uid":{"format":"uuid","title":"Equipment Uid","type":"string"},"project_ref":{"title":"Project Ref","type":"string"},"period_start":{"format":"date","title":"Period Start","type":"string"},"period_end":{"format":"date","title":"Period End","type":"string"},"mtbf_h":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Mean time between failures","title":"Mtbf H"},"mttr_h":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Mean time to repair","title":"Mttr H"},"availability_pct":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Availability Pct"},"failure_count":{"default":0,"minimum":0,"title":"Failure Count","type":"integer"},"pm_compliance_pct":{"anyOf":[{"maximum":100,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Percentage of scheduled PMs completed on time","title":"Pm Compliance Pct"},"total_maintenance_cost_usd":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Total Maintenance Cost Usd"},"energy_kwh_per_m3":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Energy Kwh Per M3"},"chemical_kg_per_m3":{"anyOf":[{"minimum":0,"type":"number"},{"type":"null"}],"default":null,"title":"Chemical Kg Per M3"},"failure_events":{"items":{"$ref":"#/$defs/FailureEvent"},"title":"Failure Events","type":"array"},"spare_consumption":{"items":{"$ref":"#/$defs/SpareConsumption"},"title":"Spare Consumption","type":"array"},"guarantee_comparisons":{"items":{"$ref":"#/$defs/GuaranteeComparison"},"title":"Guarantee Comparisons","type":"array"},"computed_at":{"format":"date-time","title":"Computed At","type":"string"}},"required":["equipment_uid","project_ref","period_start","period_end"],"title":"ReliabilityKpiSnapshot","type":"object","$id":"https://puranwater.com/schemas/reliability-kpi-snapshot.schema.json"}