Architecture Overview

Mandaitor is designed as a modular, cloud-native system that separates concerns to ensure security, scalability, and maintainability. The architecture consists of several key components that work together.

graph TD
    subgraph User / Developer
        A[React App] --> B{SDK}
        C[Backend Service] --> B
    end

    subgraph Mandaitor Platform
        B --> D[API Gateway]
        D --> E{Lambda Functions}
        E --> F[Mandates Table]
        E --> G[Events Table]
        E --> H[KMS]
        E --> I[Taxonomy Registry]
    end

    subgraph Community
        J[Taxonomy Contributor] --> K{mandaitor-taxonomies Repo}
        K --> I
    end

    A -- "Embeds UI Components" --> A
    B -- "Wraps REST API" --> D
    C -- "Direct API Calls" --> D
    E -- "Verify & Sign" --> H
    I -- "Loads Definitions" --> E

    classDef platform fill:#0f1d32,stroke:#f5a623,stroke-width:2px,color:#fff;
    classDef userdev fill:#1a3358,stroke:#fff,stroke-width:1px,color:#fff;
    classDef community fill:#1a3358,stroke:#fff,stroke-width:1px,color:#fff;

    class D,E,F,G,H,I platform
    class A,B,C userdev
    class J,K community

Komponentenschlüssel

Komponente	Beschreibung
React App	Eine beliebige Frontend-Anwendung, die die `@mandaitor/react`-Komponenten zur Verwaltung von Mandaten verwendet.
Backend Service	Ein beliebiger Server, der das `@mandaitor/sdk` oder direkte API-Aufrufe verwendet, um Mandate zu erstellen oder Aktionen zu überprüfen.
SDK (`@mandaitor/sdk`)	Ein TypeScript-Client, der die Komplexität der direkten Interaktion mit der REST-API abstrahiert.
API Gateway	Der zentrale Eingangspunkt für alle API-Anfragen. Leitet Anfragen an die entsprechenden Lambda-Funktionen weiter und verwaltet die Authentifizierung.
Lambda Functions	Serverlose Funktionen, die die Kernlogik für die Erstellung, Verwaltung und Überprüfung von Mandaten enthalten.
Mandates Table	Eine DynamoDB-Tabelle, die den aktuellen Zustand aller Mandate speichert.
Events Table	Eine DynamoDB-Tabelle, die den unveränderlichen, hash-verketteten Audit-Trail aller Ereignisse speichert.
KMS (Key Management Service)	AWS KMS wird verwendet, um die kryptografischen Schlüssel zu verwalten, die zum Signieren von Audit-Ereignissen und Proof-of-Mandate-VCs verwendet werden.
Taxonomy Registry	Ein In-Memory-Dienst, der alle verfügbaren Industrie-Taxonomien lädt und zur Validierung von Mandatsbereichen verwendet wird.
`mandaitor-taxonomies` Repo	Das von der Community betriebene Repository, in dem neue Taxonomien entwickelt und zur Veröffentlichung eingereicht werden.

Komponentenschlüssel​

Komponentenschlüssel