Read-only PRD for a coding agent
Studierende müssen Schritt für Schritt lernen, mehrstufige Mathe- und Physikaufgaben zu…
1. Problem, goal & success metric
Problem: Studierende müssen Schritt für Schritt lernen, mehrstufige Mathe- und Physikaufgaben zu lösen, und brauchen den Weg, nicht nur das Ergebnis.
Ziel: Ein GPT, der Hausaufgaben entgegennimmt, sie in Teilaufgaben zerlegt und jede Teilaufgabe als Pyramide von der ersten Rechnung bis zur Endlösung durchgehen lässt.
Erfolgsmessung: Studierende bearbeiten mindestens 80 % der geöffneten Schritte, und sie berichten in einer Umfrage (5-Punkte-Skala, Ziel 4+), dass sie danach eine ähnliche Aufgabe lösen können.
2. Users & roles
Nutzer: Studierende, die ihre Hausaufgaben selbst durcharbeiten möchten.
Rollen: Nur die Rolle Studierende. Kein Konto, kein Login; der Verlauf gilt nur für das laufende Gespräch.
3. Core workflows
Ablauf
- Der Studierende lädt eine Datei hoch: JPG, PNG oder PDF mit höchstens 10 Seiten.
- Der GPT teilt die Datei automatisch in Aufgaben und Teilaufgaben (a, b, c) auf.
- Pro Teilaufgabe klettert der Studierende die Pyramide von unten (Rechenschritt) nach oben (Endlösung).
- Hinweise sind unbegrenzt möglich; der Studierende markiert jede eigene Antwort als richtig oder falsch, mit einem Wiederholungsversuch.
- Ist eine Teilaufgabe abgeschlossen, führt der GPT direkt zur nächsten Teilaufgabe weiter, ohne Rückfrage.
- Erst wenn alle Teilaufgaben eines Uploads abgeschlossen sind, erstellt der GPT die Zusammenfassung pro Teilaufgabe im Chat: Lösungsweg, häufiger Fehler, Übungsaufgabe.
4. Features & requirements
Lösung bei übersprungenen Schritten
- Die Lösung eines übersprungenen Pyramidenschritts bleibt verborgen.
- Sie erscheint nur auf Wunsch des Studierenden als ausklappbarer Abschnitt, im Kontext der Zusammenfassung.
- Der GPT löst nicht automatisch auf.
Web-Quellen-Fallback
- Greift nur, wenn eine Figur auf dem Upload nicht lesbar ist und der GPT-Rahmen eine Websuche unterstützt.
- Der GPT sucht passende Quellen im Web und zeigt sie mit Titel und Link an.
- Die Quellen erscheinen bei der betroffenen Teilaufgabe, nicht im Gesamtergebnis.
- Bietet der GPT-Rahmen keine Websuche, entfällt die Suche komplett; der GPT zeigt direkt den Hinweis „Figur nicht lesbar – bitte Aufgabe selbst prüfen“.
- Ohne Treffer gilt dieselbe Regel: nur der Hinweis, ohne erfundene Erklärung und ohne Button.
5. Scope: must / later / never
Must
- Upload von JPG, PNG oder PDF (max. 10 Seiten) mit automatischer Aufteilung in Aufgaben und Teilaufgaben
- Schrittweises Hochklettern der Pyramide pro Teilaufgabe mit unbegrenzten Hinweisen
- Selbstkontrolle richtig/falsch mit einem Wiederholungsversuch
- Abschlusszusammenfassung als Text im Chat, erst nach Abschluss aller Teilaufgaben, mit Lösungsweg, häufigem Fehler und Übungsaufgabe
- Web-Quellen-Suche bei nicht lesbaren Figuren mit Titel und Link, sofern der GPT-Rahmen das unterstützt; ohne Treffer nur der Hinweis „Figur nicht lesbar – bitte Aufgabe selbst prüfen“
Later
- Export der Zusammenfassung als PDF oder JPG, nur falls der GPT-Rahmen das anbietet
- Dark Mode, nur falls der GPT-Rahmen es anbietet
Never
- Konten, Login, Anmeldung
- Lehrer- oder Tutor-Rollen
- Bezahlfunktion
- Eigene Speicherung von Uploads oder Fortschritt außerhalb des laufenden Gesprächs
- Eigene API-Route, Vercel-Hosting oder Datenbank
6. Screens & UI
Abschlussausgabe im Chat
- Die Zusammenfassung erscheint erst, wenn alle Teilaufgaben eines Uploads abgeschlossen sind, mit einem Abschnitt pro Teilaufgabe.
- Jeder Abschnitt zeigt Lösungsweg, häufigen Fehler und Übungsaufgabe als Text im Chat.
- Bei übersprungenen Schritten bleibt die Lösung verborgen und erscheint nur auf Wunsch als ausklappbarer Abschnitt.
- Ein Download als PDF oder JPG wird nur angeboten, wenn der GPT-Rahmen das unterstützt; sonst entfällt er ohne Ersatz.
- Bis alle Teilaufgaben abgeschlossen sind, steht bei der Zusammenfassung „noch offen“.
7. Design system & visual style
Verbindlich in v1
- Komponentenbibliothek: React Native Paper, angepasst auf den lila Akzent.
- Akzent #B681DA (Lila) für Primärbuttons, ausgewählte Zustände, aktiven Pyramidenschritt, Links und Häkchen bei abgeschlossenen Teilaufgaben.
- Löschaktionen (Button „Endgültig löschen“) in Rot #DC2626.
- Sekundärfarbe #7C3AED nur für den Hinweis „vorgeschlagen, bitte prüfen“.
- Neutrale Graus: Hintergrund #F9FAFB, Karten #FFFFFF, Text #111827, Sekundärtext #6B7280.
- Eckenradius 12 px für Karten und Buttons; Abstände 4, 8, 16, 24 px.
- Nur helles Layout in v1; Dark Mode ist später.
- Schrift: Systemstandard.
- Tonalität: freundlich, ermutigend, knapp; keine Fachsprache in UI-Texten.
8. Data model
Speicherung: Nur im laufenden Gespräch. Keine dauerhafte Speicherung von Uploads, Pyramidenschritten, Hinweisen, Fortschritt oder Zusammenfassung außerhalb des Chats.
| Feld | Typ | Pflicht |
|---|---|---|
| upload | Datei (JPG, PNG oder PDF, max. 10 Seiten) | ja |
| aufgaben | Liste von Aufgaben mit Teilaufgaben (a, b, c) | ja |
| fortschritt | Status pro Pyramidenschritt im Gespräch | ja |
| zusammenfassung | Text, KI-generiert, pro Teilaufgabe: Lösungsweg, häufiger Fehler, Übungsaufgabe | nein (leer = „noch offen“) |
Regel: Die Zusammenfassung wird erst erzeugt, wenn alle Teilaufgaben des Uploads abgeschlossen sind, und danach einmal im Gespräch angezeigt.
9. APIs & integrations
Nicht nötig als eigene Anbindung: Die KI-Anfragen laufen über den GPT-Rahmen des KI-Dienstes. Ein Gemini-Schlüssel des Nutzers ist nicht erforderlich, und es gibt keine eigene API-Route.
10. Auth, permissions & security
Kein Konto, kein Login. Der GPT kennt nur das laufende Gespräch. Es gibt keine Rollen außer Studierende und keinen eigenen Schlüssel; die KI-Anbindung übernimmt der GPT-Rahmen des KI-Dienstes.
11. Performance, privacy & accessibility
Datenschutz (v1)
- Keine Datenschutzerklärung im GPT.
- Uploads und Fortschritt gelten nur für das laufende Gespräch und werden nicht dauerhaft gespeichert.
- Ein kurzer Hinweis zu Beginn, dass Dateien nur im Gespräch verarbeitet werden.
12. Edge cases & errors
Dateiprüfung
- Dateien über 10 Seiten oder in einem anderen Format als JPG, PNG oder PDF werden nicht verarbeitet.
- Der GPT zeigt dann nur den Hinweis „Bitte lade eine JPG-, PNG- oder PDF-Datei mit höchstens 10 Seiten hoch“.
Nicht lesbare Figuren
- Ist der GPT-Rahmen mit Websuche ausgestattet, sucht der GPT Quellen zur Figur. Liefert die Suche Quellen, zeigt der GPT Titel und Link bei der betroffenen Teilaufgabe.
- Ist keine Websuche verfügbar oder liefert sie keine Quellen, zeigt der GPT nur den Text „Figur nicht lesbar – bitte Aufgabe selbst prüfen“, ohne Button und ohne erfundene Erklärung.
13. Stack & constraints
GPT-Vorlage
- Ausführung als GPT in einem KI-Chat-Dienst; der GPT bringt die KI-Anbindung selbst mit, es gibt keinen eigenen Server.
- Keine eigene Datenbank, keine IndexedDB, kein localStorage.
- Kosten: abhängig vom KI-Dienst, in der Regel über dessen Abo; hier nicht festgelegt.
- Pflege: GPT-Anweisungen aktuell halten, wenn sich der KI-Dienst ändert.
14. Existing code & do-not-change
Neues Projekt ohne vorhandenen Code. Es gibt keinen bestehenden Code, der geändert oder geschützt werden müsste.
15. Build order
Build order (vertical slices)
- Backend + Uploads + Oberfläche: Upload JPG/PNG/PDF (max. 10 Seiten), Speicherung in IndexedDB im Browser, Liste der Uploads pro Sitzungs-ID, Löschen mit Bestätigungsdialog. Lauffähig im Browser, damit der Nutzer die Grundfunktion früh testen kann.
- Aufteilung + Pyramidenerzeugung: KI teilt den Upload in Aufgaben und Teilaufgaben auf; Pyramidenschritte pro Teilaufgabe werden erzeugt und in IndexedDB gespeichert; lauffähig mit einer Teilaufgabe.
- Klettern + Hinweise + Selbstkontrolle: Schrittweises Hochklettern, unbegrenzte Hinweise, Markierung richtig/falsch mit einem Wiederholungsversuch; Fortschritt wird gespeichert und kann fortgesetzt werden.
- Web-Quellen-Fallback: Bei nicht lesbaren Figuren werden Quellen mit Titel und Link angezeigt.
- Abschlusszusammenfassung: Erzeugung erst nach Abschluss aller Teilaufgaben eines Uploads; pro Teilaufgabe Lösungsweg, häufiger Fehler und Übungsaufgabe mit versteckter Lösung bei übersprungenen Schritten; Fußzeile mit getrennten Gruppen; PDF/JPG-Download.
- Feinschliff: Fehlerzustände, responsives Layout für Web.
16. Acceptance criteria & tests
- 5 must-haves but only 4 acceptance checks
- Dateigrenze: Eine Datei mit mehr als 10 Seiten oder einem anderen Format wird nicht verarbeitet; der GPT zeigt genau den Hinweis „Bitte lade eine JPG-, PNG- oder PDF-Datei mit höchstens 10 Seiten hoch“.
- Keine Speicherung: Nach Ende des Gesprächs sind Uploads und Fortschritt nicht mehr abrufbar, da sie nicht außerhalb des Chats gespeichert werden.
- Zusammenfassung im Chat: Die Abschlusszusammenfassung erscheint immer als Text im Chat; ein PDF- oder JPG-Download wird nur angeboten, wenn der GPT-Rahmen das unterstützt.
- Keine erfundene Erklärung: Ist eine Figur nicht lesbar und liefert die Suche keine Quellen oder gibt es keine Websuche, erscheint nur der Hinweis „Figur nicht lesbar – bitte Aufgabe selbst prüfen“ ohne Button.
17. Deployment, environments & secrets
Nicht nötig: Der GPT wird im KI-Dienst veröffentlicht und über dessen Link genutzt. Es gibt kein eigenes Deployment, keine Vercel-Adresse und keine Umgebungsvariablen.
18. Open questions & assumptions
Default: Stack (a) ohne Supabase, anonyme Sitzung im localStorage, Speicherung nur in IndexedDB; Konten und Login sind nicht Teil von v1.