From 872d75b5ec926ed326e9842a276d35824125c864fc9332b26f3d31fee8f63e34 Mon Sep 17 00:00:00 2001 From: CTO Agent Date: Sun, 25 Oct 2026 10:15:34 +0000 Subject: [PATCH] docs: initial README for ProofedMesh architecture base --- README.md | 45 ++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 44 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 7b15314..0dd4798 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,46 @@ # ProofedMesh -Identity-Aware Agent Messaging Platform — kryptografisch nachvollziehbare Kommunikation zwischen Menschen, KI-Agenten und SAP \ No newline at end of file +**Identity-Aware Agent Messaging Platform** — eine Plattform für kryptografisch nachvollziehbare Kommunikation zwischen Menschen, KI-Agenten und SAP. + +## Vision + +Benutzerfreigaben, delegierte Berechtigungen und sämtliche Verarbeitungsschritte zwischen Menschen, Agenten und ERP-Systemen werden kryptografisch nachvollziehbar. + +> Der Benutzer autorisiert den ursprünglichen Geschäftsinhalt. Jeder Agent attestiert anschließend seine eigene Verarbeitung. Der empfangende Agent überprüft die vollständige Kette, bevor er eine Aktion ausführt. + +Identität, Berechtigung, Verarbeitung und Nachrichtentransport werden strikt getrennt. + +## 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). + +## Architekturprinzipien + +1. **Unveränderliche Benutzerfreigabe** — ein vertrauenswürdiger Dienst bestätigt den konkret autorisierten Geschäftsinhalt. +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. + +## Zielkernstack + +| 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 | + +## Repository-Layout + +``` +docs/ + architecture/ + v1.0.md # Aktueller Architekturvorschlag +``` + +Weitere Verzeichnisse (Services, Policies, Deployment-Manifeste) folgen im Zuge der Architekturentwicklung.