From 7de9cbc6ecaf730f0bef06e5af92d61564d61ea928e0d6a1b4e529a0b2eb09e0 Mon Sep 17 00:00:00 2001 From: CTO Agent Date: Sun, 25 Oct 2026 11:02:33 +0000 Subject: [PATCH] docs: README points to V1.1 as active architecture, V1.0 archived --- README.md | 41 ++++++++++++++++++++++++----------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 0dd4798..eab8ff4 100644 --- a/README.md +++ b/README.md @@ -12,35 +12,42 @@ Identität, Berechtigung, Verarbeitung und Nachrichtentransport werden strikt ge ## Status -Dieses Repository bildet die **Basis für die Architekturentwicklung**. Die Komponentenentwicklung hat noch nicht begonnen. Siehe [`docs/architecture/v1.0.md`](docs/architecture/v1.0.md) für den aktuellen Architekturvorschlag (V1.0). +Dieses Repository bildet die **Basis für die Architekturentwicklung**. Die Komponentenentwicklung hat noch nicht begonnen. + +- **Aktive Architektur:** [`docs/architecture/v1.1.md`](docs/architecture/v1.1.md) — V1.1 mit umgesetzten Review-Entscheidungen (Pocket ID als alleiniger IdP, PII-Trennung, Trillian für Transparency Log, Content Binding mit WebAuthn, Replay-Schutz, Retention 1 Jahr) +- **Historisch:** [`docs/architecture/v1.0.md`](docs/architecture/v1.0.md) — ursprünglicher Entwurf, archiviert ## Architekturprinzipien -1. **Unveränderliche Benutzerfreigabe** — ein vertrauenswürdiger Dienst bestätigt den konkret autorisierten Geschäftsinhalt. +1. **Unveränderliche Benutzerfreigabe** — ein vertrauenswürdiger Dienst bestätigt den konkret autorisierten Geschäftsinhalt (per WebAuthn Content Binding). 2. **Eigene Identität jedes Agenten** — jeder Agent besitzt eine separate kryptografische Identität. 3. **Verkettete Attestierungen** — jeder Verarbeitungsschritt referenziert exakte Eingabe- und Ausgabe-Hashes. -4. **Unabhängige Autorisierung** — eine Signatur allein erteilt keine Berechtigung; eine Policy Engine kontrolliert erlaubte Transformationen und ERP-Aktionen. -5. **Transportneutralität** — die Nachweise funktionieren über Matrix, HTTP, NATS oder eine Queue, ohne dass die kryptografische Vertrauenskette verloren geht. +4. **Unabhängige Autorisierung** — eine Signatur allein erteilt keine Berechtigung; OPA kontrolliert erlaubte Transformationen und ERP-Aktionen. +5. **Transportneutralität** — Nachweise funktionieren über HTTP, NATS oder Matrix, ohne dass die kryptografische Vertrauenskette verloren geht. -## Zielkernstack +## Zielkernstack (V1.1) -| Bereich | Technologie | -| ------------- | ------------------------------- | -| Identität | OIDC / Keycloak (oder Pocket ID) | -| Signaturen | Ed25519 / DSSE | -| Provenienz | in-toto v1 | -| Autorisierung | OPA + Approval Service | -| Kommunikation | Matrix E2EE | -| Agenten | Paperclip | -| ERP | SAP S/4HANA / ABAP REST | -| Archiv | PostgreSQL + verschlüsseltes S3 | +| Bereich | Technologie | +| ------------- | ------------------------------------------------------------------ | +| Identität | Pocket ID (Menschen und Agent-Clients) | +| Workload-ID | Kubernetes projected ServiceAccount Token + TokenReview | +| Signaturen | Ed25519 / DSSE, OpenBao Transit | +| Provenienz | in-toto v1 (`basicstack.de/attestations/*/*`) | +| Autorisierung | OPA + Approval Service | +| Transparency | Trillian + PostgreSQL | +| Transport | HTTPS/mTLS + NATS JetStream; Matrix optional für Mensch-Chat | +| Agenten | Paperclip | +| ERP | SAP S/4HANA / ABAP REST + Validierungs-Webservice | +| Evidence | PostgreSQL + S3 (Retention 1 Jahr) | +| PII | Separater verschlüsselter S3-Bucket, redaktionierbar | ## Repository-Layout ``` docs/ architecture/ - v1.0.md # Aktueller Architekturvorschlag + v1.0.md # Ursprünglicher Entwurf (archiviert) + v1.1.md # Aktive Architektur ``` -Weitere Verzeichnisse (Services, Policies, Deployment-Manifeste) folgen im Zuge der Architekturentwicklung. +Weitere Verzeichnisse (ADRs, Services, Policies, Deployment-Manifeste, Schemas) folgen im Zuge der Architekturentwicklung.