Content-Agent-Lernapp

A learning app for German vocational training that turns a keyword such as a trade name into a course built from official sources, checks every question with an LLM judge, and publishes only what passes.

Live: content-agent-ashen-nu.vercel.app · sample data without an account: /lernpfad?demo=1

Why

Apprentices preparing for their exams need material that follows the official framework curriculum, and generic AI text invents facts without saying where they come from. This app runs a pipeline of research, plan, generate (Claude) and evaluate (an OpenAI judge), and a content guard blocks publishing when a unit lacks a source with retrieval date or the AI label. The repo builds itself: an agent loop picks Linear issues, opens pull requests and merges them only after lint, tests, build, axe and Lighthouse pass, observed from the separate Leitstand.

Architecture

Runtime and API details: docs/ARCHITECTURE.md. Pilot course: Maschinen- und Anlagenführer (MAF); a second course for Industriekaufleute is generated by the same pipeline.

Quick start

git clone https://github.com/siinanXD/Content-Agent-Lernapp && cd Content-Agent-Lernapp
npm ci
npm run dev        # http://127.0.0.1:43123, works without keys (in-memory mock store)

What I learned

1. A quality gate only holds if it sits in the publish path: the content guard rejects a course with HTTP 422 instead of logging a warning.
2. Generated content needs an undo: every change to units and questions is versioned by a database trigger (content_versions), so a bad run can be rolled back.
3. Accessibility checks belong in the merge gate (axe on every route, keyboard, Lighthouse a11y ≥ 0.9), not in a later audit.

License

No open-source license: all rights reserved (owner decision, SIN-752).

---

Lern-App, die aus einem Schlagwort (Pilot: Maschinen- und Anlagenführer) einen Kurs aus amtlichen Quellen erzeugt und aktuell hält. Die folgenden Abschnitte beschreiben Entwicklung und Betrieb.

Stack (current)

Layer	Choice
App	Next.js 16 + React 19 + TypeScript + Tailwind 4
Hosting	Vercel
Persistence	Supabase EU (AP-17) with in-memory mock fallback
Quality / tracing	Langfuse Cloud EU — JS/TS SDK v5 / platform v4 OTEL (SIN-197)
Ops scaffold	Hermes weekly source check + Telegram (AP-10/AP-16)
Models	Claude for generate (Batch); OpenAI mini as judge (D-06/D-07)

Docs

• docs/ops/SIN-438-grants.md — Tabellenrechte prüfen, transaktionaler Migrationstest und Rückkehrverfahren.

• Verbrauch von Bau-/Reparaturläufen wird privat in Linear gespeichert; öffentliche PR-Steckbriefe und Tages-Updates zeigen diese Beträge nicht. Der Wochenleser liest private Kommentare mit Seitenabruf und dedupliziert Laufkennungen; historische PR-Marker bleiben vorübergehend lesbar.

• docs/PRODUCT.md — Konzept und Bauplan AP-00–AP-12

• docs/DECISIONS.md — Architekturentscheidungen mit Links

• docs/ARCHITECTURE.md — Runtime- und API-Überblick

• AGENTS.md — Entscheidungs- und Stopp-Regeln

• docs/LANDKARTE.md — Repo-Landkarte: wo liegt was, Befehle, Konventionen (SIN-320)

• docs/autonomy/groessen.md — Größen der Issues, Modell und Runden je Größe, Bündeln, Verbrauch (SIN-320)

• docs/content/README.md — Curriculum-Maps (AP-13): MAF in allen fünf Schwerpunkten und Industriekaufleute 2024

• docs/content/DIDAKTIK.md — Didaktik-Vorgabe (AP-18): Schablone je Einheit, Fragestufen, Wiederholung, Prüfungsmodus, Bilder

• docs/content/MAF-CURRICULUM.md — Vorgängerversion v1 (nur Metall); runtime loader uses docs/content/maf-metall.json via AP-14 ()

Local development

npm install
npm run dev

Dev server: http://127.0.0.1:43123 (npm run dev → port 43123).

Learner UI (AP-08 + AP-18 Didaktik)

Playable path (Figma approved by Sinan 2026-10-02; Didaktik D-31):

0. / Startseite für Bildungsträger (Scroll-Story), /willkommen App-Einstieg
1. /start — Schlagwort + Lernvariante → Kurs erzeugen
2. /lernpfad — Module/Blöcke, Wiederholung, Prüfungsmodus
3. /einheit/unit-03 — sections + alle 5 Fragetypen (+ Bildfragen)
4. /wiederholung — Leitner 1/3/7/14
5. /pruefung — schriftliche Teile aus exam.gradedParts je Kurs (MAF PT/PP/WiSo, Industriekaufmann T1/T2A/T2C), Fragen nach Gewicht über die Gebiete, Lösung erst im Ergebnis (/pruefung/ergebnis: Ergebnis je Gebiet; Industriemechaniker ohne Prüfungsmodus)
6. /ergebnis — Punkte + Ampel je Gebiet
7. /profil — Fortschritt, Stapelgröße, Prüfungsreife

This is the beginning of the README. Read the rest at the original. Read the full README ↗