Dashboard/CurioQuest/wiki/requirements.md
CurioQuest

wiki/requirements.md

Requirements — What the System Must Do

Source: Project-Objective.md §11 (+ §5–§7 for scope/audience/safety). Summary; raw doc is canonical.

MVP scope (locked)

  • Subject: Science only.
  • Grade band: Grade 1–2 (NGSS-aligned).
  • Market / language: US / English.
  • Catalog target: ~9 books/grade (~18 stories across G1–2 for the full NGSS catalog — see Business Model §Phase 3).
  • Primary buyer: the engaged parent, especially at the grade-transition / summer "summer slide" moment. Gifting (relatives) and homeschool are adjacent channels layered next; teacher/B2B is deferred.
  • Narrow wedge by design — one subject, one grade band, one use-case beats a broad launch.

Capability outline (the 11 things the system must do)

  1. Live, research-validated curriculum knowledge base — agents keep it current by topic/grade/country, structured as a multi-grade scope-and-sequence, not standalone topics.
  2. Collect the basics — child's name, age, class/grade (+ optional interests, friends, city, language; photo opt-in only).
  3. Guided onboarding — surface the validated grade/curriculum topics for the customer to pick from, so every book starts standards-aligned.
  4. Run safety gates — screen any uploaded photo before a job starts; QC every generated image (safety + identity) before it ships; no training on child data (see ADR-004).
  5. Build story + image prompts — background/landscape resolved first, feeding the prompts.
  6. Structure & generate the story + activity layer in the target language — quest wrapping STEM sub-concepts, with an in-narrative learning check + secret code/badge.
  7. Derive a safe, household-item experiment from the story's concept; draft printable step-by-step instructions.
  8. Generate the free preview (~20%), then unlock the full digital book on purchase; produce the physical edition via book-grade POD, traceable to the validated curriculum version used (content provenance / auditability) (see ADR-001).
  9. Account + progression (CORE) — remember the child / cast / chosen guide and re-engage at grade and season boundaries (school-year plan, season pass, Bridge packs).
  10. Capture anonymous learning outcomes from the learning check to improve content over time (selling point, not a moat).
  11. Sell + fulfill via Shopify (+ book-grade POD partner), with upsell/cross-sell flows (see ADR-006).

Accuracy, trust & safety (non-negotiable foundation)

  • Content is human-authored and educator-reviewed, not unverified AI output — a review step lives in the production pipeline. Curriculum credibility must be real, not a marketing claim.
  • Every generated image passes an automated safety + identity QC check before it ships.
  • COPPA-compliant by design: no-photo default, verifiable parental consent, user photos auto-delete after 30 days, no training on child data.
  • Content provenance: every book traceable to the exact validated curriculum (and localization/compliance) version that produced it — a credibility and liability asset.

Deferred past MVP (capture now, build later)

Full localization / multi-language; physical experiment kits + maker partnerships; sensory localization ("Sensory Codex"); organic/viral growth loop (book trailer + parent Share Kit); gifting flows/occasions/gift cards as an acquisition channel.

  • Product & pillars
  • Economics & phasing
  • What's still unresolved