Dieses Dokument befindet sich in aktiver Entwicklung und ist noch nicht finalisiert.
Skip to content

9.2 Publikationsstrategie

9.2.1 Dual-Publication-Konzept

GRUNDSATZ

Single Source of Truth = Git-Repository des Produkts Öffentliche Darstellung = Zentrale Compliance-Website

Compliance-Daten werden an genau einer Stelle gepflegt — im Repository des jeweiligen Produkts. Von dort werden sie automatisiert auf eine zentrale Compliance-Website publiziert.

text
┌────────────────────┐                ┌──────────────────────────┐
│  Produkt-Repo      │     CI/CD      │  Generierte Artefakte    │
│                    │                │                          │
│  .compliance/      │  Validierung   │  ┌── Compliance-Portal   │
│    cra-statement.  │──────────────→│  │   (HTML/PDF)           │
│    json            │  + Generierung │  ├── CE-Kennzeichnung    │
│                    │                │  │   (About, README)      │
│  (einzige Quelle)  │                │  ├── Container-Labels    │
│                    │                │  │   (OCI-Annotations)    │
│                    │                │  ├── Vereinfachte DoC     │
│                    │                │  └── API-Endpunkt         │
└────────────────────┘                └──────────────────────────┘
        ↑                                       ↑
   Entwickler pflegen                  Kunden, Behörden,
   nur das JSON                        Öffentlichkeit

9.2.2 Vorteile

AspektVorteil
VersionierungStatement ist mit dem Produktcode versioniert
ReviewÄnderungen durchlaufen denselben Review-Prozess wie Code
AutomatisierungPublikation erfolgt automatisch bei Release
KonsistenzJSON-Schema erzwingt einheitliches Format über alle Produkte
Audit-TrailGit-History dokumentiert jede Änderung

9.2.3 Repository-Struktur

Jedes Produkt-Repository enthält ein .compliance/-Verzeichnis:

text
produkt-repo/
├── .compliance/
│   ├── cra-statement.json          # Maschinenlesbares CRA Statement
│   └── README.md                   # Kurzhinweis zur Compliance-Struktur
├── SECURITY.md                     # Vulnerability Disclosure Policy
├── docs/
│   └── compliance/
│       ├── eu-declaration.pdf      # EU-Konformitätserklärung (Annex V)
│       └── user-info.md            # Nutzerinformation (Annex II)
└── ...

Dateien im Detail

DateiPflichtBeschreibung
.compliance/cra-statement.json✅ JaMaschinenlesbares CRA Compliance Statement (→ 9.3)
.compliance/README.mdEmpfohlenErklärt die Compliance-Struktur für Entwickler
SECURITY.md✅ JaVulnerability Disclosure Policy (→ 4.2)
docs/compliance/eu-declaration.pdf✅ JaRechtsverbindliche EU-Konformitätserklärung
docs/compliance/user-info.md✅ JaNutzerinformation gemäß Annex II

9.2.4 Website-URL-Schema

Das zentrale Compliance-Portal folgt einer einheitlichen URL-Struktur:

text
https://cra.app.bauer-group.com/
├── /products/                      # Produktverzeichnis
│   ├── /products/{name}/           # Produkt-Compliance-Seite
│   │   ├── /cra                    # CRA Compliance Statement
│   │   ├── /doc                    # EU-Konformitätserklärung
│   │   └── /sbom                   # SBOM-Download
│   └── ...
└── /api/                           # (Optional) API-Zugang für Behörden
    └── /api/products/{name}.json   # Maschinenlesbarer Zugang

9.2.5 Zugänglichkeit

InformationÖffentlichInternCRA-Referenz
CRA Compliance StatementArt. 13
EU-KonformitätserklärungArt. 28
Vereinfachte DoCAnnex VI
Nutzerinformation (Annex II)Art. 13
SBOMAuf AnfrageAnnex I, Teil II
Technische Dokumentation (Annex VII)Art. 31
KonformitätsbewertungsunterlagenArt. 28

BEACHTEN

Die vollständige technische Dokumentation (Annex VII) ist nicht öffentlich bereitzustellen, muss aber auf Anfrage den Marktaufsichtsbehörden innerhalb von 10 Tagen vorgelegt werden (Art. 31 CRA).

9.2.6 CI/CD-Integration

Die Publikation wird in die bestehende CI/CD-Pipeline integriert:

text
Release-Tag erstellt

    ├── 1. JSON-Schema-Validierung (.compliance/cra-statement.json)
    │       → Fehler = Release blockiert

    ├── 2. Vollständigkeitsprüfung
    │       → Sind alle Pflichtfelder ausgefüllt?
    │       → Existieren referenzierte Dokumente (DoC, SBOM)?

    ├── 3. Publikation auf Compliance-Portal
    │       → HTML generieren
    │       → PDF generieren (optional)

    └── 4. Benachrichtigung
            → Slack/Teams: "Compliance Statement für {Produkt} v{Version} publiziert"

9.2.7 Querverweise

ThemaLink
JSON-Schema-Definition9.3 Maschinenlesbares Format
Aktualisierungsprozess9.4 Pflege & Aktualisierung
SBOM-Archivierung2.3 Archivierung & Retention
Ausfüllbare VorlageA.9 CRA Compliance Statement

Dokumentation lizenziert unter CC BY-NC 4.0 · Code lizenziert unter MIT