Account
Workspace account
Supabase Auth, workspace membership, profile, and usage ownership are prepared for connection.
Creative Team Workspace
Owner
Story Lead
Auth provider
Supabase Auth
Storage buckets
project-uploads, library-artifacts, exports, avatars
Security posture
Server-only keys stay server-only. Browser clients use publishable or legacy anon keys, database writes go through server routes, and Supabase RLS is included in the schema foundation.
Supabase sign-in
Checking session
API stack
System readiness
Credential state is shown as safe metadata only. Missing keys keep the app in mock or live-ready mode.
Public URL
https://plotcandy.vercel.app
Connection plan
OpenAI live AI
Live OpenAI generation is configured.
Server routes already isolate OpenAI usage for analysis, writing, embeddings, structured outputs, safety, and future tool calls.
Supabase persistence
Supabase persistence is configured.
User profiles, project, project asset, Library, draft, story bible, parsed-document memory, Storage uploads, Library artifact files, generated exports, pgvector RPC retrieval, score history, recommendation decisions, workflow runs, skill runs, usage ledger, subscription lifecycle, Auth, and RLS foundations are ready; ledger, project, asset, document parse, Library, export, retrieval, and market routes switch to Supabase-backed behavior when authenticated request or service credentials are available.
Stripe billing
Deferred by request: Stripe billing will be added later.
Analyzer and Full Access entitlements, Write workspace plan gates, usage checks, usage events, and subscription lifecycle records are active now; checkout and webhook lifecycle updates can persist to Supabase before Stripe customer portal self-service is enabled.
Deployment
Production URL is configured.
The Next.js 16 app builds with npm run build and can run with npm run start on Node hosts. Vercel is the natural App Router target; Railway is optional if you prefer a Node server host.
Optional providers
Optional providers can remain disconnected.
TMDB, OMDb, TheTVDB, Watchmode, Pinecone, Qdrant, Cohere, LlamaParse, Unstructured, Anthropic, Gemini, and Mistral are adapter-ready but not required for the first production connection.
Access handoff
First
Supabase
Supabase credentials are configured.
This turns Auth, RLS, Storage buckets, pgvector memory, project data, Library files, usage records, and subscription rows from local runtime state into persistent data.
Live accounts, project persistence, private files, retrieval memory, and billing records.
Second
Stripe
Stripe is intentionally deferred. Add STRIPE_SECRET_KEY and run npm run setup:stripe when you are ready to turn on live billing.
This turns the plan gates, checkout flow, portal route, webhook lifecycle, and usage ledger into real subscription operations.
Live checkout, portal sessions, subscription state, and entitlement updates through /api/billing/webhook.
Third
Vercel or Railway
Production URL is configured.
Hosted URLs are required for Supabase magic links, Stripe redirects, webhook endpoints, and production smoke checks.
Hosted app verification, auth redirects, Stripe webhooks, and production readiness checks.
Helpful
GitHub
Connect the Plotcandy GitHub repository when you want branch previews, pull-request checks, and deployment history.
The app can keep moving locally without GitHub, but connected source control makes Vercel previews, review checks, and release history cleaner.
Preview deployments, automated readiness checks, review flow, and release history.
Later
Optional providers
Add these only when you want live market data, external vectors, reranking, advanced parsing, or second-reader models.
The adapters are ready, but the first production connection does not depend on them.
Richer comps, external retrieval providers, optional reranking, and advanced parsing.
Last
OpenAI
OpenAI live AI is configured.
OpenAI activates live analysis, writing, embeddings, structured outputs, safety routing, and tool calls through server routes only.
Live AI generation, live embeddings, and OpenAI-backed tool execution.
Production audit
Requested deliverables
Code readiness is separated from external access so OpenAI can stay last.
Ready
21
Live Ready
1
Needs Access
0
Optional
0
Deferred
1
1. Production app shell
readyThe App Router shell, layout, navigation, and premium interface foundation are present.
3 evidence paths
2. Project-centered navigation
readyPrimary Analyze and Write navigation resolves through the active project and falls back to Projects.
2 evidence paths
3. Projects dashboard
readyProject list, dashboard, detail, and project intake flows are implemented with runtime project state.
3 evidence paths
4. New project intake
readyThe intake screen accepts story material, files, plan context, parsing, and usage gating.
3 evidence paths
5. Project home page
readyProject command centers expose files, memory, story bible, workflow runs, skill runs, and improvement state.
2 evidence paths
6. Analyze dashboard with visualizers
readyAnalyze pages render validated score, report, diagnostic, comp, and improvement visualizers.
3 evidence paths
7. Script Intelligence scoring engine
readyScore inputs are validated, normalized, weighted, banded, and separated from AI generation.
3 evidence paths
8. Write workspace
readyThe three-panel Write workspace supports guided workflows, power tools, draft saves, exports, and Library capture.
3 evidence paths
9. Library system
readyLibrary listing, detail, edit, duplication, export, comparison, and route handoffs are implemented.
4 evidence paths
10. Versioning foundation
readyDraft versions and Library artifact versions support save, compare, duplicate, and new-version flows.
3 evidence paths
11. Improvement engine foundation
readyScore history, recommendation decisions, draft comparison, and projected/actual improvement are wired.
3 evidence paths
12. OpenAI API route foundation
readyServer-side AI routes, provider routing, structured output contracts, safety, and tool calls are prepared while the OpenAI key waits for the final setup step.
4 evidence paths
13. AI provider abstraction
readyOpenAI is primary, with Anthropic, Gemini, and Mistral adapter boundaries for future model roles.
3 evidence paths
14. LangGraph workflow foundation
readySix workflow graphs resolve through typed state and reusable nodes with Library, scoring, and draft-save outputs.
4 evidence paths
15. Supabase schema and type foundation
readyAuth, Postgres, Storage, RLS, pgvector, database types, and private buckets are prepared.
4 evidence paths
16. Stripe billing foundation
deferredCheckout, portal, webhook lifecycle, plan entitlements, and usage records are implemented; live Stripe billing is intentionally deferred.
4 evidence paths
17. Vector memory and retrieval foundation
readySupabase pgvector, local deterministic embeddings, Pinecone/Qdrant adapters, chunking, and project-memory search are present.
4 evidence paths
18. Document parsing foundation
readyTXT, Fountain, PDF, DOCX, FDX-style, LlamaParse, and Unstructured adapter paths are present.
4 evidence paths
19. Market and comp data foundation
live-readyCurated comp signals work without keys; TMDb can activate when its API key is added, while the Film and TV Intelligence Index models normalized title metadata, provider IDs, and similarity results for the next phases.
6 evidence paths
Add film and TV provider keys when live metadata is needed.
20. Zod schemas and TypeScript types
readyRoute contracts, AI outputs, project data, billing usage, workflow, and domain types are represented.
4 evidence paths
21. Mock project data
readyThe Last Take sample project includes realistic project, analysis, Library, score, and rewrite state.
1 evidence path
22. Motion graphics foundation
readyFramer Motion and custom visualizers drive score reveals, dashboard transitions, and report surfaces.
3 evidence paths
23. README architecture guide
readyThe README explains product vision, stack, APIs, systems, scoring, environment variables, access order, and provider strategy.
1 evidence path
Core systems
Runtime project workspaces
readyProject intake creates session workspaces with treatment, logline, outline, bibles, artifacts, assets, score history, memory, and usage events.
Project-aware navigation
readyDashboard plus primary Analyze and Write links follow the current or latest project and fall back cleanly.
AI route foundation
readyServer-side AI, Write, and plan-gated tool-calling routes settle usage before Library persistence and return project-specific local artifacts until OpenAI is connected.
Analyze dashboard
readyProject-specific reports, score dials, proprietary metrics, First Ten Pull, character diagnostics, scene health, market comps, score history, and improvement panels are visible.
Scoring engine
readyScript Intelligence Score is calculated server-side from validated rubric inputs.
Document parsing
readyTXT, Fountain, PDF, DOCX, and FDX-style intake can parse, chunk, plan-gate storage, upload parsed source files to Supabase Storage, and persist indexed memory for authenticated UUID-backed projects.
Project assets
readyProject-specific file manifests track uploads, parsing, plan-gated storage, Storage object paths, and memory indexing state, then persist through project_assets for authenticated UUID-backed projects.
Export system
readyPDF, Fountain, and FDX-style exports run server-side, save project-attached export artifacts to Library, and upload generated payloads to private Supabase Storage for authenticated UUID-backed projects.
Project memory
readyDeterministic memory search indexes project sources and uploaded chunks locally, then switches /api/retrieval/search to Supabase project_memory_chunks plus pgvector RPC search for authenticated UUID-backed projects.
Workspace intelligence
readyProject-grounded responses use plan-aware usage gates, safety checks, memory retrieval, and mock/live-ready AI routing.
Story bible
readyCharacter and world bible entries can be viewed and safely updated, then persisted through Supabase story_bibles for authenticated UUID-backed projects.
Film and TV index foundation
readyNormalized title metadata, provider IDs, Story DNA profiles, availability snapshots, provider sync jobs, similarity runs, matches, and score audit logs are modeled in Supabase with RLS and explicit grants.
Film and TV provider registry
readyTMDb is normalized through the existing metadata client; OMDb, TheTVDB, and Watchmode have deferred adapters ready for live calls in the next phase.
Market intelligence
readyMarket Heat and comp signals run from curated data without keys, then use TMDB search, details, genre, and keyword metadata with safe fallback when TMDB_API_KEY is configured.
Artifact versioning
readyGenerated and fallback Library documents use project-specific bodies with version history, plan-aware edits, duplicate saves, private Library Storage copies, and storage usage events.
Draft versioning
readyWrite workspace draft history is project-specific, plan-gated draft saves record storage usage, local saves remain available for session comparison, and Writer's Room compare shows draft deltas.
Score history
readyRe-analysis appends score records for actual improvement tracking and switches to Supabase analysis_reports for authenticated UUID-backed projects.
Improvement overview
readyProjected lift, actual lift, before/after reports, report body deltas, and rewrite history are unified across runtime and Supabase-backed score/decision state.
Skill run ledger
readyProject-specific writing tool history records usage-ready skill runs and switches to Supabase skill_runs for authenticated UUID-backed projects.
Usage event ledger
readyBilling usage records analysis, writing, export, project, and storage events with project-filtered activity; authenticated Supabase requests read and write the live usage_records table.
Account auth
readyAccount can show browser session state and request magic-link sign-in when Supabase public credentials are configured.
Supabase schema verifier
readyA local no-credential verifier checks schema tables, RLS, grants, storage buckets, vector memory, and setup-check coverage before applying SQL.
Supabase apply helper
readyAn explicit DATABASE_URL-only helper can apply supabase/schema.sql through psql and parse supabase/setup-check.sql without printing credentials.
Supabase setup check
readyA read-only SQL check can verify extensions, tables, RLS, grants, buckets, storage policy, and project memory RPC after schema setup.
Stripe setup handoff
readyStripe setup metadata lists Checkout, portal, webhook, recurring Price env names, event types, and missing setup names without exposing secrets.
Stripe Price setup helper
readyAn explicit STRIPE_SECRET_KEY-only helper can reuse or create the Analyzer and Full Access recurring monthly Prices and print only Price IDs for environment setup.
Stripe setup verifier
readyA local no-credential verifier checks billing plans, recurring Price env names, Checkout, portal, webhook events, lifecycle persistence, CI, and docs.
Hosting environment helper
readyA no-secret checklist command shows which non-OpenAI values are ready to copy into Vercel or Railway and keeps OpenAI separated as the last setup group.
Hosting setup verifier
readyA local no-credential verifier checks Vercel config, Railway config, health endpoint, smoke checks, CI wiring, hosted URL setup, and docs.
Recommendation decisions
readyRewrite priorities can be accepted or rejected with projected improvement tracking and Supabase recommendation_decisions persistence.
Workflow runs
readyProject-specific graph nodes, run history, locally started plan-aware runs, step status, and Supabase workflow_runs persistence are wired for authenticated UUID-backed projects.
Batch processing
readyProject-specific background queues cover plan-gated large analysis, document indexing, comp research, report generation, and memory rebuilds.
Safety guardrails
readyVersioned deterministic policy checks run before AI and writing-tool execution, with rule IDs, context, review path, and mitigation guidance.
Secret boundaries
readyOpenAI, Stripe, server Supabase, model routing, and provider adapters are marked server-only; browser Supabase auth uses a separate public client.
Production audit
readyThe 23 requested deliverables are mapped to current implementation evidence, with external access needs separated from code readiness.
External access helper
readyA single no-secret command prints the ordered Supabase, Stripe, hosting, GitHub, optional provider, and OpenAI-last handoff without exposing credential values.
Access handoff packet
readyA focused setup endpoint lists needed credentials, optional integrations, hosting state, schema file, and the OpenAI-last step.
Health check
readyA deployment-safe system health endpoint summarizes audit, access, hosted URL, and key setup order without exposing secrets.
Live service connection verifier
readyA no-OpenAI command checks Supabase table, Storage, and pgvector RPC access, Stripe recurring Prices, and hosted health once those credentials are configured.
Production preflight
readyA single no-key local command runs setup status, external setup verifiers, lint, production build, dependency audit, scope scans, and runtime smoke checks.
GitHub setup helper
readyA non-mutating checklist command checks local git state, origin remote readiness, GitHub CLI availability, and the production readiness workflow.
GitHub CI verifier
readyA local no-credential verifier checks workflow triggers, read-only permissions, Node setup, all readiness gates, smoke checks, product scope scan, and secret-shape scan.
GitHub CI readiness
readyA repository workflow is ready to run install, lint, setup status, Supabase schema verification, Stripe setup verification, hosting setup verification, GitHub CI verification, build, system smoke, dependency audit, product scope, and secret-shape checks before hosted deploys.
Deployment readiness
readyThe Next.js production build passes locally and host config files plus hosting verification are present for Vercel and Railway once environment variables are set.
Billing
readyStripe billing is intentionally deferred; entitlement gates and safe mock checkout behavior remain active until live billing is added.
Supabase
readyDatabase, storage, RLS, and repository layers are ready; mock mode is active without Supabase credentials.
Optional providers
TMDb metadata
missingFilm and TV index metadata provider.
OMDb metadata
missingFilm and TV index metadata provider.
TheTVDB metadata
missingFilm and TV index metadata provider.
Watchmode metadata
missingFilm and TV index metadata provider.
Pinecone vector store
missingFuture external vector memory provider.
Qdrant vector store
missingFuture external vector memory provider.
Cohere rerank
missingOptional project-memory reranking.
LlamaParse
missingOptional advanced document parsing.
Unstructured
missingOptional advanced document parsing.
AI providers
Structured output ready
Adapter Ready
Adapter Ready
Adapter Ready
Model roles
Analysis
livegpt-4.1 via OpenAI
OpenAI is configured for analysis structured output.
Writing
livegpt-4.1 via OpenAI
OpenAI is configured for writing structured output.
Fast
livegpt-4.1-mini via OpenAI
OpenAI is configured for fast structured output.
Embedding
livetext-embedding-3-small via OpenAI
OpenAI is configured for embedding structured output.
Second Reader
livenot-configured via OpenAI
OpenAI is configured for secondReader structured output.
Safety
livegpt-4.1-mini via OpenAI
OpenAI is configured for safety structured output.
Supabase
Stripe
Usage
Usage status
Credits, project slots, exports, and storage are evaluated before premium actions run.
Ledger
Usage activity
Tracked analysis, writing, export, project, and storage events for the current billing cycle.