1Architektur

2Setzkasten folgt der Hexagonalen Architektur (Ports & Adapters). Das bedeutet: klare Grenzen, austauschbare Adapter, testbare Logik.

Packages3

5Schema-Definition, Feldtypen, Validation (Zod), Serialization, Commands, Events, Port-Interfaces.

React-UI: Provider, FormStore (Zustand), Field Renderers, EntryForm, Hooks, Proxy-Adapter.

7ContentRepository-Implementation via GitHub API. Octokit, TreeBuilder, atomic commits.

GitHub + Google OAuth via Arctic. Session-Management, Allowed-Emails-Filter.

Astro Integration: Admin SPA, Auth Routes, GitHub Proxy, Preview Handler.

555

9Alle externen Abhängigkeiten werden durch Ports abstrahiert. Die UI kennt nur die Interfaces – nie die konkrete Implementierung.

Port	Methoden	Adapter
10ContentRepository	listEntries, getEntry, saveEntry, deleteEntry, getTree	GitHubContentRepository, ProxyContentRepository, MockRepository
AuthProvider	11getSession, getLoginUrl, handleCallback, logout	GitHubAuth, GoogleAuth, MockAuth
AssetStore	upload, delete, list, getUrl	ProxyAssetStore, MockAssets
5455	55	55

Schema → FormStore → ContentRepository → GitHub API → Git Commit

Schema definiert Felder → FormStore verwaltet Zustand → Repository persistiert → GitHub committet

13UI hängt nur von Ports ab, nie von konkreten Implementierungen.

Alles leitet sich vom TypeScript-Schema ab – Typen, UI, Validierung.

Keine Exceptions. Alle Operationen geben Result<T> zurück.

Content + Assets werden als ein Git-Commit gespeichert.

Upload-Dateien behalten ihren Namen. Kein Hashing, kein Renaming.

15Content lebt im Git-Repo. Kein externer Service, keine Datenbank.