Architektur#
Die Plattform trennt öffentlichen Auftritt, Anwendungslogik und Agenten-Betrieb.
Komponenten#
- Website (
apps/website) — Next.js 16, React 19, Tailwind v4, DE/NL. - Backend (
backend) — FastAPI für Ops, CRM, Angebote und Health. - Hermes App (
apps/hermes) — Agenten-WebUI (Workstation-Basis). - Paperclip (
apps/paperclip) — Factory und Skills-Quelle. - Brain-Dienste — AgentMemory, LightRAG, 9Router und Hermes Runtime laufen extern auf dem VPS; ihr Quellcode liegt nicht im Monorepo.
Datenfluss#
- Besucher und Kunden erreichen den Auftritt unter
www.nexifyai.cloud. - API-Aufrufe (
/api/*) werden an die Website bzw. das Backend weitergeleitet. - Agenten greifen über die Agenten-Zentrale und MCP-Schnittstellen auf Brain-Dienste zu.
- Persistenz und Suche laufen über Postgres, Vektor-Suche und Objektspeicher.
Grundsätze#
- GitLab ist die primäre Source of Truth; Schreibzugriffe werden gespiegelt.
- Änderungen erfolgen sicher und reversibel, mit Rollback-Punkt.
- Least Privilege und strikte Trennung von Projekt- und Kundendaten.