From f6fe592164e400c5c80c08820d12faa3db00e68f Mon Sep 17 00:00:00 2001 From: Benjamin Admin Date: Tue, 16 Jun 2026 06:24:48 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20Schnittstellen-Notiz=20um=20Controls-Se?= =?UTF-8?q?ssion-Abh=C3=A4ngigkeit=20erg=C3=A4nzt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Ergänzt nach Rückmeldung der Controls-Session: ID-Stabilität schützt auch deren atom_classification (~161k) + addressee (control_uuid-gebunden); deren Step-1/2 ist additiv (tier/source_type/core_count/addressee, bricht Verträge nicht); eine Wahrheit — Muster-Schicht aus atom_classification speisen, nicht neu ableiten. Co-Authored-By: Claude Opus 4.7 --- .../controls-measures-interface.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs-src/development/controls-measures-interface.md b/docs-src/development/controls-measures-interface.md index 571fa6ab..362b1c11 100644 --- a/docs-src/development/controls-measures-interface.md +++ b/docs-src/development/controls-measures-interface.md @@ -55,6 +55,32 @@ CRA-Maßnahmen laufen parallel weiter. - `control_parent_links` (`source_regulation`, **`source_article`**) - die Response-Form von `UseCaseControlsService.controls_for_use_case` (atom-grain) +> Bestätigt von der Controls-Session: deren laufende Step-1/2-Änderungen sind rein +> **additiv** (neue Felder `tier` / `source_type` / `core_count`, neue Spalte +> `addressee`) — diese Verträge bleiben also unverletzt. + +## Gemeinsame ID-Stabilitäts-Abhängigkeit (beide Sessions) + +Die geforderte stabile Muster-ID + `control_uuid → pattern`-Garantie schützt +**nicht nur die Maßnahmen-Schicht**, sondern genauso die laufende +Klassifikations-Arbeit der Controls-Session: + +- `atom_classification` (≈161k Zeilen) + die neuen `addressee`-Tags + Provenance + hängen an `control_uuid → canonical_controls.id`. +- Wird bei einer Control-Neuerzeugung die `control_uuid` neu vergeben, sind diese + Klassifikationen **verwaist** — exakt das „chunk_hash"-Problem. +- **Anforderung an die Re-Generierung:** `control_uuid` erhalten **oder** einen + stabilen natürlichen Schlüssel mitliefern, an den sich beide Schichten neu + binden können. + +## Eine Wahrheit, nicht zwei + +`atom_classification` **IST** die Breite-Schicht (`use_case` / `sub_topic` / +`canonical_obligation`), auf die diese Notiz sich beruft. Die Controls-/ +Muster-Schicht sollte daraus **gespeist** werden, nicht parallel neu ableiten — +sonst entsteht doppelte Wahrheit. Muster-Bildung und Klassifikation müssen auf +demselben kanonischen `sub_topic`/`canonical_obligation` aufsetzen. + ## Aufgabenteilung - **Controls-Session (core/control-pipeline):** MC-/Control-Neuerzeugung +