CurioQuest Requirements

Current Backend Requirements

• Convert the useful n8n prototype logic into app-side backend services.
• Persist versioned book artifacts through Supabase book_artifact.
• Generate and persist:
• book_context
• story_quality_gate
• story_manuscript
• page_plan
• dialogue_pass
• activity
• visual_brief
• image_prompts
• Keep text generation provider-swappable so local/sample generation can avoid unnecessary OpenAI text API spend.
• Keep OpenAI available for image generation, especially GPT Image / image-quality paths.

Implemented Backend Spine

• App-side generation orchestration exists in the website app.
• OpenAI Responses API provider exists for text generation.
• Claude Code OAuth provider exists for local/sample text generation.
• Story manuscript deterministic quality gate exists with one bounded revision attempt.
• Downstream page/dialogue/activity/visual/image-prompt artifacts are generated and persisted after an accepted story.

Pending Product Build

• Add quality gates and bounded correction loops for page plan, dialogue, activity, visual brief, and image prompts.
• Wire real image generation app-side.
• Add image/visual QC for character drift, clutter, low contrast, unsafe props, and weak science visibility.
• Wire PDF/book assembly from persisted artifact versions.
• Build a human-friendly review surface over Supabase book_artifact.
• Run controlled real sample generation and evaluate whole books.
• Produce print/KDP-ready sample books.