Files
breakpilot-compliance/ai-compliance-sdk/internal/iace/hazard_patterns_cobot.go
T
Benjamin Admin 77a497d930 feat(iace): Sprint 3A — Operational State Graph + fix(ucca) flaky keyword sort
State Graph:
- 9 Standard-Betriebszustaende (startup, homing, automatic_operation, manual_operation, teach_mode, maintenance, cleaning, emergency_stop, recovery_mode)
- 20 State-Transitions als gerichteter Graph
- OperationalStates + StateTransitions Felder in HazardPattern, MatchInput, PatternMatch
- patternMatches() filtert Patterns nach Betriebszustand (nil = feuert immer)
- Narrative-Parser extrahiert States aus Maschinenbeschreibung (22 Keywords + 4 Transition-Keywords)
- 27 bestehende Patterns mit State-Einschraenkungen annotiert (10 operational, 15 maintenance, 2 cobot)
- MatchReason um operational_state + state_transition Typen erweitert (Explainability)
- 6 neue Tests: NilFiresAlways, MaintenanceFilter, StateTransition, MatchReasons, Count, TransitionValid

UCCA fix:
- Stabiler Tiebreaker (Pattern-ID aufsteigend) bei gleichem Keyword-Score in MatchByKeywords
- Behebt flaky TestControlPatternIndex_MatchByKeywords (1/10 Failure-Rate durch Go map iteration order)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-05-10 08:05:02 +02:00

129 lines
7.9 KiB
Go

package iace
// GetCobotHazardPatterns returns patterns specific to collaborative robots,
// press-specific expert hints, and the afterrun/SIL calculation domain.
// These extend the builtin patterns (HP045-HP058 for press, HP059+ for cobot).
func GetCobotHazardPatterns() []HazardPattern {
return []HazardPattern{
// ================================================================
// Collaborative Robot (Cobot) Patterns (HP059-HP065)
// ================================================================
{
ID: "HP059", NameDE: "Kollision Mensch-Roboter (Kraft/Geschwindigkeit)", NameEN: "Human-robot collision (force/speed)",
RequiredComponentTags: []string{"collaborative_operation", "moving_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M054"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 98,
RequiresExpertCalculation: true,
ExpertHintDE: "Sicherheitsabstaende und maximal zulaessige Kraefte/Geschwindigkeiten muessen berechnet werden.",
ExpertHintEN: "Safety distances and maximum permissible forces/speeds must be calculated.",
ScenarioDE: "Bediener arbeitet im gemeinsamen Arbeitsraum mit dem Cobot. Roboterarm bewegt sich mit Werkstueck/Werkzeug in Richtung Bediener.",
TriggerDE: "Roboterarm trifft Bediener am Oberkoerper, Kopf oder Haenden. Kraft oder Geschwindigkeit ueberschreitet biomechanische Grenzwerte.",
HarmDE: "Prellungen, Quetschungen, Knochenbrueche. Bei Kopfkontakt: Gehirnerschuetterung.",
AffectedDE: "Bedienpersonal, Einrichter, Wartungspersonal",
ZoneDE: "Kollaborativer Arbeitsraum des Roboters",
DefaultSeverity: 5, DefaultExposure: 4,
},
{
ID: "HP060", NameDE: "Quetschen durch Werkzeug am Cobot", NameEN: "Crushing by tool on cobot",
RequiredComponentTags: []string{"tool_at_robot", "collaborative_operation"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M054", "M141"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 95,
RequiresExpertCalculation: true,
ExpertHintDE: "Werkzeug-/Werkstueckgeometrie bestimmt das Quetschrisiko. Separate Beurteilung pro Werkzeug erforderlich.",
ExpertHintEN: "Tool/workpiece geometry determines crushing risk. Separate assessment per tool required.",
ScenarioDE: "Cobot fuehrt Werkzeug (Greifer, Schrauber, Schweisszange) nah am Bediener. Quetschstelle zwischen Werkzeug und festem Gegenstand (Tisch, Werkstueck).",
TriggerDE: "Werkzeug klemmt Koerperteil des Bedieners gegen feste Flaeche ein.",
HarmDE: "Quetschung Finger/Hand, Schnittverletzung bei scharfkantigem Werkzeug.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Werkzeugspitze / Greifbereich des Cobots",
DefaultSeverity: 4, DefaultExposure: 4,
},
{
ID: "HP061", NameDE: "Nachlauf nach Stopp (Reaktionszeit)", NameEN: "Afterrun after stop (reaction time)",
RequiredComponentTags: []string{"afterrun_risk", "moving_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M054"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 90,
RequiresExpertCalculation: true,
ExpertHintDE: "Nachlaufwegberechnung erforderlich. Sicherheitsfeld muss entsprechend dimensioniert werden.",
ExpertHintEN: "Afterrun distance calculation required. Safety field must be dimensioned accordingly.",
ScenarioDE: "Schutzeinrichtung (Lichtvorhang, Scanner) loest aus, aber Roboter stoppt nicht sofort. Nachlaufweg fuehrt Roboterarm ueber den Schutzfeld-Rand hinaus.",
TriggerDE: "Person betritt Schutzfeld, Roboter bewegt sich waehrend des Bremswegs weiter und trifft die Person.",
HarmDE: "Prellungen, Quetschungen durch verzoegerten Stopp.",
AffectedDE: "Bedienpersonal, Besucher",
ZoneDE: "Uebergangsbereich Schutzfeld / Arbeitsraum",
DefaultSeverity: 4, DefaultExposure: 3,
},
{
ID: "HP062", OperationalStates: []string{"teach_mode"}, NameDE: "Fehlprogrammierung Kraft-/Geschwindigkeitsgrenzwerte", NameEN: "Misprogramming of force/speed limits",
RequiredComponentTags: []string{"programmable", "force_limited"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"safety_function_failure"},
SuggestedMeasureIDs: []string{"M106"},
SuggestedEvidenceIDs: []string{"E01"},
Priority: 88,
ExpertHintDE: "Grenzwerte duerfen nur nach Risikobeurteilung veraendert werden. Zugriffsschutz erforderlich.",
ScenarioDE: "Programmierer setzt Kraft- oder Geschwindigkeitsgrenzwerte zu hoch ein. Sicherheitsfunktion greift nicht oder zu spaet.",
TriggerDE: "Falsch parametrierte Grenzwerte werden in Produktion uebernommen. Roboter ueberschreitet biomechanische Limits.",
HarmDE: "Verletzungen durch zu hohe Kontaktkraft. Schwere abhaengig von Ueberschreitung.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Gesamter kollaborativer Arbeitsraum",
DefaultSeverity: 4, DefaultExposure: 3,
},
{
ID: "HP063", NameDE: "Werkstueck-Herabfallen vom Roboter", NameEN: "Workpiece drop from robot",
RequiredComponentTags: []string{"variable_workpiece", "gravity_risk"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M051"},
SuggestedEvidenceIDs: []string{"E08"},
Priority: 82,
ScenarioDE: "Roboter transportiert Werkstueck. Greifer verliert Halt (Druckverlust, falsches Werkstueck, oelige Oberflaeche).",
TriggerDE: "Werkstueck faellt herab und trifft Person oder Koerperteil unterhalb des Roboterarms.",
HarmDE: "Prellungen, Knochenbrueche (abhaengig von Werkstueckgewicht und Fallhoehe).",
AffectedDE: "Bedienpersonal, Personen im Umfeld",
ZoneDE: "Bereich unterhalb des Roboterarms / Transportweg",
DefaultSeverity: 3, DefaultExposure: 3,
},
{
ID: "HP064", OperationalStates: []string{"automatic_operation"}, NameDE: "Quetschen im Roboter-Arbeitsraum (nicht-kollaborierend)", NameEN: "Crushing in robot workspace (non-collaborative)",
RequiredComponentTags: []string{"moving_part", "high_force", "sensor_part"},
RequiredEnergyTags: []string{},
ExcludedComponentTags: []string{"collaborative_operation"},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001", "M005", "M051"},
SuggestedEvidenceIDs: []string{"E01", "E08"},
Priority: 94,
ScenarioDE: "Person betritt abgesicherten Arbeitsraum eines nicht-kollaborierenden Roboters (z.B. bei Stoerungsbeseitigung, Umgehung der Schutzeinrichtung).",
TriggerDE: "Roboter bewegt sich unkontrolliert oder startet unerwartet. Quetschen zwischen Roboterarm und Zelle/Werkstueck.",
HarmDE: "Schwere Quetschungen, Amputationen, lebensbedrohliche Verletzungen.",
AffectedDE: "Wartungspersonal, Einrichter",
ZoneDE: "Abgesicherter Roboter-Arbeitsraum",
DefaultSeverity: 5, DefaultExposure: 2,
},
{
ID: "HP065", NameDE: "Einklemmen am Arbeitstisch (Cobot-Zelle)", NameEN: "Trapping at work table (cobot cell)",
RequiredComponentTags: []string{"pinch_point", "structural_part"},
RequiredEnergyTags: []string{},
GeneratedHazardCats: []string{"mechanical_hazard"},
SuggestedMeasureIDs: []string{"M001"},
SuggestedEvidenceIDs: []string{"E08"},
Priority: 70,
ScenarioDE: "Bediener arbeitet am Arbeitstisch neben dem Cobot. Klemmstelle zwischen Roboterarm/Werkzeug und Tischkante oder Vorrichtung.",
TriggerDE: "Roboterarm drueckt Koerperteil gegen Tischkante. Klemmkraft uebersteigt biomechanische Grenzwerte.",
HarmDE: "Quetschung Finger, Handgelenk.",
AffectedDE: "Bedienpersonal",
ZoneDE: "Tischkanten, Vorrichtungen im Arbeitsbereich",
DefaultSeverity: 3, DefaultExposure: 3,
},
}
}