# ProblemRadar — Lastenheft & Phasen-Decomposition

**Datum:** 2026-06-21 · **Auftraggeber:** Arthur Hardy Kotsch / Kotsch.Tech
**Arbeitsname:** ProblemRadar · **Art:** Umfrage-, Marktforschungs- & Ideenanalyse-Plattform
**Hauptziel:** Reale Probleme/unerfüllte Bedürfnisse erkennen, statistisch auswerten, daraus App-Ideen ableiten.

> Das vollständige Lastenheft des Auftraggebers liegt im Chatverlauf (2026-06-21).
> Dieses Dokument hält die **buildbare Essenz + die Zerlegung in Phasen** fest.

---

## Architektur-Entscheidungen (festzulegen)
- **Integration:** als Subdomain `umfrage` IN der bestehenden kotsch.tech-Laravel-App (nutzt Subdomain-Registry, das frisch gehärtete Mail-System, Admin-Auth/OTP, das Bilingual-Host-System, Security-Header). Spec erlaubt das ("Framework an vorhandene Infrastruktur anpassbar").
- **DB:** bestehende relationale DB der App (SQLite Dev / MySQL Prod) statt eigenem PostgreSQL — Schema ist DB-agnostisch.
- **Subdomain (zweisprachig):** DE `umfrage.kotsch.tech` ↔ EN `survey.kotsch.tech` (via host_en-Mechanik aus Commit e656e2c).
- **Mail:** vorhandenes Versandsystem (Mail-Fassade) — keine neue Mailserver-Konfig.

## Kernprinzipien (nicht verhandelbar)
Problemorientiert (nicht App-zentriert); Teilnahme & alle Personenangaben freiwillig; Name optional (nie in Statistik/Standard-CSV); E-Mail getrennt erfasst & verschlüsselt, nur nach expliziter Einwilligung; keine unnötigen PII (keine Adresse/Geburtsdatum/Telefon/Standort/Fingerprinting); transparente Auswertung (Zeitraum, n, Filter, Konfidenz). App-Empfehlung ist NEBENziel, max. 3 Apps, nur bei hohem Match, nie im Fragebogen, nie als Werbung.

## Konkrete Bau-Artefakte
**Fragebogen (20 Hauptfragen)** — Felder: optional_name, age_group, user_contexts, devices, problem_areas, primary_problem_area, problem_types, current_workarounds, task_description, problem_description, current_solution_description, problem_frequency, severity_score(0–10), time_loss_value+time_loss_period, problem_consequences, current_solution_satisfaction(1–5), desired_features+top_feature_1..3, payment_preference, testing_interest, additional_notes. + max. 3 dynamische Zusatzfragen je Kontext.

**4 Einstiege:** große Umfrage · konkretes Problem schildern (Kurzformular) · 2-Minuten-Kurzumfrage · App-Ideen bewerten.

**24 DB-Tabellen:** survey_versions, questions, question_options, survey_sessions, survey_participant_details, answers, problem_submissions, tags, tag_synonyms, entity_tags, apps, app_platforms, recommendation_runs, recommendation_items, recommendation_events, problem_clusters, email_contacts, email_consents, response_contact_links, campaigns, report_definitions, report_runs, admin_users, audit_log.

**Scoring:** Match-Score (App-Empfehlung, Gewichte 30/20/15/10/10/8/4/3, Schwellen 80/70); Opportunity Score (0–100, Gewichte 18/12/12/12/15/8/8/5/5/5); Konfidenzstufen nach n (1–4 / 5–19 / 20–49 / 50–199 / 200+).

**Tag-System:** Kategorien (Zielgruppe/Lebensbereich/Problemtyp/Notlösung/Funktion/Häufigkeit/Stärke/Geschäftsmodell); Status (Entwurf/aktiv/veraltet/zusammengeführt/gesperrt); Herkunft + Konfidenz je Zuordnung; nie löschen wenn benutzt.

**E-Mail-Berichte:** Sofort-Mail/Sammelbericht, Tagesbericht, Wochenanalyse, Monats-Strategiebericht, Sofortwarnungen.

**API:** öffentlich (surveys/start, current, answers, complete; problems/direct; recommendations/calculate+feedback; contact-consents; unsubscribe) + Admin-API.

**KI (optional, nur Vorschläge):** Freitext-Zusammenfassung, Tag-/Cluster-Vorschläge, Berichtszusammenfassungen — Admin bestätigt strategische Entscheidungen.

---

## Phasen-Decomposition (jede Phase eigener Spec→Plan→Build)

- **Phase 0 — Fundament:** Subdomain `umfrage`/`survey` (DE/EN) in Registry + Routing; DB-Migrationen Kern (survey_versions, questions, question_options, survey_sessions, survey_participant_details, answers, problem_submissions, campaigns); Models; bilinguale Startseite mit 4 Einstiegen.
- **Phase 1 — Fragebogen-Engine:** datengetriebener Fragebogen (eine Frage/Screen, Fortschritt, Zurück, Zwischenspeicherung, serverseitige Validierung, Honeypot/Rate-Limit), große Umfrage + Kurzformular + Kurzumfrage; neutrale Abschlussseite + Zusammenfassung; Quality Score.
- **Phase 2 — Admin:** geschütztes Dashboard (Kennzahlen), Problemübersicht + Filter, Fragebogen-Editor (Versionierung), CSV-Export, Audit-Log.
- **Phase 3 — Kontakt & Einwilligung:** email_contacts (verschlüsselt) + email_consents + response_contact_links; Abschluss-Opt-ins; Unsubscribe.
- **Phase 4 — Tags & Cluster:** tags/tag_synonyms/entity_tags; regelbasierte + Freitext-Tag-Zuordnung; Problemcluster + Opportunity Score + Konfidenz; Cluster-Admin.
- **Phase 5 — App-Katalog & Empfehlung:** apps/app_platforms; Match-Logik (harte Ausschlüsse + Score); Abschluss-Empfehlung (max 3, begründet) + Feedback-Events.
- **Phase 6 — Berichte & Hintergrundprozesse:** report_definitions/report_runs; Tages-/Wochen-/Monatsbericht + Warnungen über das vorhandene Mailsystem; Scheduler-Jobs; PDF/CSV.
- **Phase 7 — KI-Assist (optional):** Freitext-Zusammenfassung, Tag-/Cluster-Vorschläge, Berichtstexte — alles als bestätigungspflichtige Vorschläge.

**Reihenfolge-Logik:** Phase 0+1 liefern sofort nutzbare, datensammelnde Umfrage (der eigentliche Kernwert). Auswertung/Empfehlung/Berichte/KI bauen darauf auf.