basicstack/ProofedMesh
SHA256
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: README points to V1.1 as active architecture, V1.0 archived

Browse source
This commit is contained in:
CTO Agent 2026-10-25 11:02:33 +00:00
parent 1d5950d32c
commit 7de9cbc6ec
1 changed files with 24 additions and 17 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

41
README.md
View file

@ -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.