requinator

Ein KI-gestütztes Interview-Tool, das mit potenziellen Beratungskunden ein strukturiertes Gespräch führt und daraus automatisch ein Product Requirements Document generiert.

Statt eines statischen Briefing-Formulars führt requinator ein echtes Gespräch: Die KI stellt nacheinander gezielte Fragen zu Problem, Zielgruppe, Zielen, Scope und Kontext — maximal 20, so wenige wie nötig. Am Ende fasst sie alles zu einem strukturierten PRD zusammen, das der Berater sofort nutzen kann.

Das PRD dient primär als Briefing für den Berater und sekundär als Bestätigung für den Kunden, dass seine Anforderungen richtig verstanden wurden.

Features

• Dialogisches Interview — gezielte Fragen in sechs Kategorien, adaptiv je nach Antworten
• Referenz-URLs — Kunden können URLs als Inspiration beifügen; das Backend lädt, extrahiert und gibt den Inhalt als KI-Kontext weiter
• Echtzeit-Streaming — KI-Antworten erscheinen token-weise im Browser via Server-Sent Events
• Share-Link — jede Session hat einen persistenten Link; Browser schließen und wieder öffnen stellt den Stand vollständig wieder her
• PRD-Download — fertiges Dokument als Markdown, inklusive Referenz-Sektion mit KI-Einschätzung
• Admin-Bereich — geschützte Übersicht aller Sessions mit Transkript, Referenzen und editierbarem PRD

Architektur

Frontend ohne Build-Step — HTMX übernimmt alle dynamischen Interaktionen (Streaming, Refs-Liste, PRD-Anzeige) direkt im HTML. Kein JavaScript-Framework, kein Bundler.

Schlankes Backend — Express mit klar getrennten Schichten: Routes für HTTP-Handling, Services für Geschäftslogik (LLM, Interviewer, Generator, Refs, SSRF, Rate Limiting). SQLite als einzige Datenbankdatei — Backup ist eine einzelne cp-Zeile.

KI-Integration via OpenRouter — Modell austauschbar per Umgebungsvariable. Die Interviewer-Logik steuert den Gesprächsverlauf über strukturiertes JSON im System-Prompt; der Generator produziert das finale PRD in einem separaten Call.

Sicherheit — Referenz-URLs werden vor jedem Fetch gegen private IP-Ranges geprüft (auch nach Redirects), um SSRF zu verhindern. Rate Limiting auf Session-Erstellung, Antworten und Ref-Fetches. User-Antworten und Referenzinhalte werden nicht geloggt.

Tech-Stack

Komponente	Technologie
Runtime	Node.js 22 LTS
Server	Express
Datenbank	SQLite via better-sqlite3
Frontend	HTMX + Vanilla-JS
Styling	Pico.css
Templates	EJS
AI-Provider	OpenRouter / Claude Sonnet
Streaming	Server-Sent Events
Deployment	PM2 + Nginx
CI/CD	GitLab Pipelines

Deployment

GitLab-Pipeline mit zwei Stages: Tests auf jedem Push, automatisches Deployment auf main. Der Server läuft hinter einem Nginx-Reverse-Proxy mit deaktiviertem Buffering — notwendig für SSE-Streaming. PM2 übernimmt Process Management und Neustart nach Server-Reboot.

---

Proprietär — alle Rechte vorbehalten.