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 ## 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 ## 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. 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. 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. 4. **Unabhängige Autorisierung** — eine Signatur allein erteilt keine Berechtigung; OPA 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. 5. **Transportneutralität** — Nachweise funktionieren über HTTP, NATS oder Matrix, ohne dass die kryptografische Vertrauenskette verloren geht.
## Zielkernstack ## Zielkernstack (V1.1)
| Bereich | Technologie | | Bereich | Technologie |
| ------------- | ------------------------------- | | ------------- | ------------------------------------------------------------------ |
| Identität | OIDC / Keycloak (oder Pocket ID) | | Identität | Pocket ID (Menschen und Agent-Clients) |
| Signaturen | Ed25519 / DSSE | | Workload-ID | Kubernetes projected ServiceAccount Token + TokenReview |
| Provenienz | in-toto v1 | | Signaturen | Ed25519 / DSSE, OpenBao Transit |
| Autorisierung | OPA + Approval Service | | Provenienz | in-toto v1 (`basicstack.de/attestations/*/*`) |
| Kommunikation | Matrix E2EE | | Autorisierung | OPA + Approval Service |
| Agenten | Paperclip | | Transparency | Trillian + PostgreSQL |
| ERP | SAP S/4HANA / ABAP REST | | Transport | HTTPS/mTLS + NATS JetStream; Matrix optional für Mensch-Chat |
| Archiv | PostgreSQL + verschlüsseltes S3 | | 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 ## Repository-Layout
``` ```
docs/ docs/
architecture/ 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.