ProofedMesh/README.md

# ProofedMesh

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

- **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 (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; 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 (V1.1)

| 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       # Ursprünglicher Entwurf (archiviert)
    v1.1.md       # Aktive Architektur
```

Weitere Verzeichnisse (ADRs, Services, Policies, Deployment-Manifeste, Schemas) folgen im Zuge der Architekturentwicklung.