Files
breakpilot-compliance/ai-compliance-sdk/internal/iace/hazard_patterns_environment.go
T
Benjamin Admin 6a3e96d54c fix(iace): set-based measure-category filter + 235 pattern-author fixes
Two-part nachhaltiger fix replacing the previous "fill to 5 mitigations
no matter what" behavior that the GT-Bremse benchmark proved
unfaithful (e.g. HP1625 "scharfe Kanten" returning M005 "Rotations-
bewegung vermeiden" via category fallback; HP1651 "Wiederanlauf
Roboter" returning M054 "Sichere thermische Auslegung" via
mismatched pattern reference).

PART A — Set-based category filter (handlers package):
- acceptableMeasureCategories: replaces 1:1 patternCatToMeasureCat
  with a curated set per pattern category, so e.g.
  safety_function_failure now accepts software_control measures
  (watchdogs, plausibility checks) and emc_hazard accepts both
  electrical and software_control measures
- isCategoryCompatible: gate every measure id against the accepted
  set before creating a mitigation; mismatches log MEASURE-SKIP
- The old category fallback is REMOVED. A hazard whose pattern has
  no category-compatible measure is now created with zero mitigations
  and logged as COVERAGE-GAP — the operator must consult an expert.
  No more silent invention of generic defaults.

PART B — 235 pattern author-error fixes across 26 files:
- HP040-HP044 (AI): M101/M102/M103 (Auffangwanne/Absauganlage) ->
  M133 Anomalieerkennung + M214 Plausibilitaet + M213 Sensor-Redundanz
  + M044 Zweikanalige Steuerung + others
- HP011-HP015, HP104-HP109, HP1085-HP1095, HP1281-HP1334 (electrical):
  M001-M005/M054/M061 placeholders -> M481/M482 Isolation +
  M511-M522 PE/Schutzleiter/RCD/Hauptschalter
- HP110-HP1331 (material_environmental): M101-M103 -> M384-M395
  Brandschutz/Laserschutz + M533/M408 SDB/PSA
- HP800-HP858, HP1178-HP1264 (software/sensor/hmi):
  M101/M104 -> M105/M106/M107/M214 SPS/Watchdog/Plausibilitaet
- HP026, HP611-HP1690 (ergonomic): M001/M082 -> M353-M360 +
  M530-M532 Hebehilfe/ergonomische Hoehe
- HP201-HP1697 (mechanical): M054/M051 -> M002/M008/M061/M141 +
  M487/M488 Tueroeffnung-Stillsetzung/Wiederanlauf
- Plus EMF/Strahlung/Brand/Lärm/Vibration/Kommunikation/Cyber

Coverage shift (Pattern-Author-Fehler bei aktiviertem Set-Filter):
   start:         237 patterns with zero category-compatible measures
   after Stufe 1A:   5 (AI)
   after Stufe 1B:  20 (mechanical Bestand)
   after Stufe 1C:  35 (electrical Bestand)
   after Stufe 1D:  29 (material_environmental)
   after Stufe 1E:  29 (software/sensor/hmi)
   after Stufe 1F:  20 (ergonomic)
   after Stufe 1G:  80 (thermal/comm/radiation/fire/safety)
   final:           0  (28 extended.go/extended2.go duplicates fixed)

New regression tests:
- TestEveryPattern_HasCategoryCompatibleMeasure: every pattern in
  collectAllPatterns() must reference at least one category-compatible
  measure; gaps must be explicitly listed in AllowlistKnownGaps
  (currently empty). Fails CI for any new pattern that drifts.
- TestAcceptableMeasureCategories: pins the set-mapping for the
  7 most-bug-prone pattern categories.
- TestIsCategoryCompatible_EmptyMeasureCat: protects legacy entries.

A separate task #11 tracks 58 HP-ID duplicates between
extended.go/extended2.go and cobot.go/press.go/operational.go —
patterns are semantically different and TestGetBuiltinHazardPatterns_-
UniqueIDs misses them because it only checks HP001-HP044.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 21:11:02 +02:00

100 lines
5.6 KiB
Go

package iace
// builtinEnvironmentPatterns returns HP023-HP028: noise, vibration, and ergonomic patterns.
func builtinEnvironmentPatterns() []HazardPattern {
return []HazardPattern{
// Noise / Vibration
{
ID: "HP023", NameDE: "Laermgefahr", NameEN: "Noise hazard",
RequiredComponentTags: []string{"noise_source"},
RequiredEnergyTags: []string{"acoustic"},
GeneratedHazardCats: []string{"noise_vibration"},
SuggestedMeasureIDs: []string{"M091", "M131"},
SuggestedEvidenceIDs: []string{"E01", "E12"},
Priority: 70,
ScenarioDE: "Bediener ist waehrend der Schicht dem Maschinenlaerm ausgesetzt.",
TriggerDE: "Dauerhafte Laermexposition ueber 85 dB(A) ohne Gehoerschutz.",
HarmDE: "Laermschwerhoerigkeit (BK 2301), Tinnitus, Konzentrationsstoerung.",
AffectedDE: "Bedienpersonal, Personen im Umfeld",
ZoneDE: "Gesamter Arbeitsbereich um die Maschine, insbesondere Auslassseite",
DefaultSeverity: 3, DefaultExposure: 4,
},
{
ID: "HP024", NameDE: "Vibrationsgefahr", NameEN: "Vibration hazard",
RequiredComponentTags: []string{"vibration_source"},
RequiredEnergyTags: []string{"vibration"},
GeneratedHazardCats: []string{"noise_vibration"},
SuggestedMeasureIDs: []string{"M092", "M131"},
SuggestedEvidenceIDs: []string{"E01", "E13"},
Priority: 65,
ScenarioDE: "Bediener haelt vibrierende Werkzeuge oder arbeitet auf vibrierendem Untergrund ueber laengere Zeit.",
TriggerDE: "Langzeit-Vibrationsexposition ueber Tagesgrenzwert (Hand-Arm 5 m/s2, Ganzkoerper 1.15 m/s2).",
HarmDE: "Hand-Arm-Vibrationssyndrom (BK 2104), Durchblutungsstoerung, Gelenkschaeden.",
AffectedDE: "Bedienpersonal, Maschinenfuehrer",
ZoneDE: "Griffe, Bedienelemente, Standfussbereich, Fahrersitz",
DefaultSeverity: 3, DefaultExposure: 4,
},
{
ID: "HP025", NameDE: "Laerm durch rotierende Hochgeschwindigkeitsteile", NameEN: "Noise from high-speed rotating parts",
RequiredComponentTags: []string{"rotating_part", "high_speed"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"noise_vibration"},
SuggestedMeasureIDs: []string{"M091", "M092", "M131"},
SuggestedEvidenceIDs: []string{"E01", "E12", "E13"},
Priority: 70,
ScenarioDE: "Schnelllaufende Spindeln, Luefter oder Schleifscheiben erzeugen hohen Schallpegel und Vibrationen.",
TriggerDE: "Betrieb bei hoher Drehzahl ohne Schallschutzkapselung oder Entkopplung.",
HarmDE: "Gehoerschaedigung, Tinnitus, erhoehtes Unfallrisiko durch Konzentrationsverlust.",
AffectedDE: "Bedienpersonal, Personen im Hallenbereich",
ZoneDE: "Umgebung der Spindel/Schleifscheibe, Maschinengehaeuse, offene Bearbeitungszone",
DefaultSeverity: 3, DefaultExposure: 4,
},
// Ergonomic
{
ID: "HP026", NameDE: "Ergonomische Belastung an Bedienstationen", NameEN: "Ergonomic risk at operator stations",
RequiredComponentTags: []string{"user_interface"},
RequiredEnergyTags: []string{"ergonomic"},
GeneratedHazardCats: []string{"ergonomic"},
SuggestedMeasureIDs: []string{"M029", "M030", "M032", "M033", "M141"},
SuggestedEvidenceIDs: []string{"E01", "E24"},
Priority: 50,
ScenarioDE: "Bediener arbeitet in unguenstiger Koerperhaltung (stehend, gebeugt, verdreht) ueber laengere Schichtdauer.",
TriggerDE: "Wiederholte Taetigkeit in Zwangshaltung ohne ausreichende Erholungspausen.",
HarmDE: "Muskel-Skelett-Erkrankung, Rueckenbeschwerden (BK 2108), Sehnenscheidenentzuendung.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Bedienpult, Materialzufuhr, Teileentnahme, Sichtfenster",
DefaultSeverity: 2, DefaultExposure: 5,
},
{
ID: "HP027", NameDE: "Ergonomische Belastung in der Hoehe", NameEN: "Ergonomic risk for work at height",
RequiredComponentTags: []string{"structural_part", "gravity_risk"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"ergonomic", "mechanical_hazard"},
SuggestedMeasureIDs: []string{"M121", "M131"},
SuggestedEvidenceIDs: []string{"E01", "E20"},
Priority: 60,
ScenarioDE: "Wartungsarbeiten erfordern Zugang zu hoch gelegenen Bauteilen ueber Leitern oder Geruestkonstruktionen.",
TriggerDE: "Abrutschen von Leiter, Fehltritt auf Wartungsplattform, fehlende Absturzsicherung.",
HarmDE: "Sturzverletzung, Fraktur, Kopfverletzung, in schweren Faellen Todesfolge.",
AffectedDE: "Wartungspersonal, Servicetechniker",
ZoneDE: "Wartungsplattformen, Leitern, Kranbahnen, obere Maschinenabdeckungen",
DefaultSeverity: 4, DefaultExposure: 2,
},
{
ID: "HP028", NameDE: "Fehlbedienungsgefahr", NameEN: "Mode confusion / misoperation risk",
RequiredComponentTags: []string{"user_interface", "programmable"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"hmi_error", "mode_confusion"},
SuggestedMeasureIDs: []string{"M204", "M205", "M206", "M141"},
SuggestedEvidenceIDs: []string{"E01", "E14", "E24"},
Priority: 70,
ScenarioDE: "Bediener verwechselt Betriebsarten oder aktiviert falsche Funktion durch unklare HMI-Gestaltung.",
TriggerDE: "Betriebsartenwahlschalter nicht eindeutig, missverstaendliche Symbole oder fehlende Rueckmeldung.",
HarmDE: "Unerwartete Maschinenbewegung, Anlauf im falschen Modus, Verletzung durch ungesicherten Betrieb.",
AffectedDE: "Bedienpersonal, Einrichter",
ZoneDE: "Bedienpanel, Touchscreen, Betriebsartenwahlschalter, Freigabetaster",
DefaultSeverity: 3, DefaultExposure: 3,
},
}
}