01
Ein Backend, jede Chat-Oberfläche
Die zentrale Architekturentscheidung war eine strikte Trennung zwischen dem Gehirn und den Gesichtern. Ein Python-FastAPI-Backend (apps/retriever) stellt drei Endpunkte bereit: einen Health-Check, einen Retrieve-only-Endpunkt für die Vektorsuche und einen Chat-Endpunkt, der die komplette RAG-Pipeline ausführt.
Jede Chat-Oberfläche, heute die Next.js-Web-App, später der geplante WhatsApp-Bot und die mobile App, kommuniziert mit dieser einen API über ein standardisiertes Messages-Payload. Eine neue Oberfläche hinzuzufügen bedeutet, einen dünnen Client zu bauen, nicht ein neues Gehirn.
Das Web-Frontend ist eine aufgeräumte Chat-Oberfläche mit Next.js und TypeScript, inklusive Konversationsverlauf, Streaming-typischen Tippzuständen und Quellen-Metadaten neben jeder Antwort.