Wie diese Website funktioniert

Diese Website ist zugleich unser Proof of Concept: Sie wird von derselben Art von Systemen betrieben, die wir für Kunden bauen. Jede redaktionelle Entscheidung dieser Website ist ein Git-Commit.

Die Konsole: suchen, fragen, navigieren

Die Wortmarke kontrollfeld_ im Seitenkopf ist zugleich eine Eingabezeile: Tippen Sie los oder drücken Sie ⌘K bzw. / — die Konsole schlägt Seiten, Leistungen, Referenzen, Artikel und FAQ vor. Der Index dahinter entsteht beim Build aus den echten Inhalten der Website und wird vollständig im Browser durchsucht, ohne Server-Anfrage.

Freitext-Fragen beantwortet in der nächsten Phase eine Retrieval-Augmented Generation (RAG) auf einer self-hosted Typesense-Instanz: Typesense liefert zur Frage die passenden Textstellen aus demselben Inhaltsindex, ein Sprachmodell formuliert daraus die Antwort — mit Verweisen auf die Quellen. Bis dahin sagt die Konsole bei Fragen ohne Seitentreffer ehrlich, dass diese Stufe noch aussteht.

Die Content-Pipeline in Kürze

1. Ein wöchentlicher, versionierter Pipeline-Lauf scannt unsere Arbeit (Repos, freigegebene Dokumente) und schlägt Themen vor — noch keine Texte.
2. Ein Mensch entscheidet pro Thema per Datei-Änderung im Repo:status: approved oder dismissed.
3. Nur freigegebene Themen werden zu Entwürfen — mehrstufig sanitisiert (Secrets-Scanner, PII-Erkennung, Pseudonymisierung), von einem zweiten Modell kritisiert und als Merge Request zur menschlichen Review gestellt.
4. KI-generierte Inhalte tragen ein sichtbares Provenienz-Badge und verweisen auf ihre Quellen-Referenzen.

Stack

Astro (SSG) · TypeScript-Pipeline · GitLab CI/CD · Coolify (self-hosted) · MCP-Server