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

checking

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.

connected

Server routes already isolate OpenAI usage for analysis, writing, embeddings, structured outputs, safety, and future tool calls.

Supabase persistence

Supabase persistence is configured.

connected

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.

deferred

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.

connected

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.

optional

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

connected

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.

SUPABASE_URL or NEXT_PUBLIC_SUPABASE_URLNEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEYSUPABASE_SECRET_KEYDATABASE_URLPlotcandy Supabase project access to apply supabase/schema.sqlRun supabase/setup-check.sql after schema setup

Live accounts, project persistence, private files, retrieval memory, and billing records.

Second

Stripe

deferred

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.

STRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_ANALYZERSTRIPE_PRICE_FULL_ACCESS

Live checkout, portal sessions, subscription state, and entitlement updates through /api/billing/webhook.

Third

Vercel or Railway

connected

Production URL is configured.

Hosted URLs are required for Supabase magic links, Stripe redirects, webhook endpoints, and production smoke checks.

Plotcandy Vercel project or Plotcandy Railway serviceNEXT_PUBLIC_APP_URLEnvironment variables copied into the host

Hosted app verification, auth redirects, Stripe webhooks, and production readiness checks.

Helpful

GitHub

optional

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.

Plotcandy repository accessTarget production branchDeployment integration access

Preview deployments, automated readiness checks, review flow, and release history.

Later

Optional providers

optional

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.

TMDB_API_KEYOMDB_API_KEYTHETVDB_API_KEYWATCHMODE_API_KEYPINECONE_API_KEY or QDRANT credentialsCOHERE_API_KEYLLAMAPARSE_API_KEY or UNSTRUCTURED_API_KEY

Richer comps, external retrieval providers, optional reranking, and advanced parsing.

Last

OpenAI

connected

OpenAI live AI is configured.

OpenAI activates live analysis, writing, embeddings, structured outputs, safety routing, and tool calls through server routes only.

OPENAI_API_KEYOPENAI_MODEL_ANALYSISOPENAI_MODEL_WRITINGOPENAI_MODEL_FASTOPENAI_EMBEDDING_MODEL

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

ready

The App Router shell, layout, navigation, and premium interface foundation are present.

3 evidence paths

2. Project-centered navigation

ready

Primary Analyze and Write navigation resolves through the active project and falls back to Projects.

2 evidence paths

3. Projects dashboard

ready

Project list, dashboard, detail, and project intake flows are implemented with runtime project state.

3 evidence paths

4. New project intake

ready

The intake screen accepts story material, files, plan context, parsing, and usage gating.

3 evidence paths

5. Project home page

ready

Project command centers expose files, memory, story bible, workflow runs, skill runs, and improvement state.

2 evidence paths

6. Analyze dashboard with visualizers

ready

Analyze pages render validated score, report, diagnostic, comp, and improvement visualizers.

3 evidence paths

7. Script Intelligence scoring engine

ready

Score inputs are validated, normalized, weighted, banded, and separated from AI generation.

3 evidence paths

8. Write workspace

ready

The three-panel Write workspace supports guided workflows, power tools, draft saves, exports, and Library capture.

3 evidence paths

9. Library system

ready

Library listing, detail, edit, duplication, export, comparison, and route handoffs are implemented.

4 evidence paths

10. Versioning foundation

ready

Draft versions and Library artifact versions support save, compare, duplicate, and new-version flows.

3 evidence paths

11. Improvement engine foundation

ready

Score history, recommendation decisions, draft comparison, and projected/actual improvement are wired.

3 evidence paths

12. OpenAI API route foundation

ready

Server-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

ready

OpenAI is primary, with Anthropic, Gemini, and Mistral adapter boundaries for future model roles.

3 evidence paths

14. LangGraph workflow foundation

ready

Six 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

ready

Auth, Postgres, Storage, RLS, pgvector, database types, and private buckets are prepared.

4 evidence paths

16. Stripe billing foundation

deferred

Checkout, 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

ready

Supabase pgvector, local deterministic embeddings, Pinecone/Qdrant adapters, chunking, and project-memory search are present.

4 evidence paths

18. Document parsing foundation

ready

TXT, Fountain, PDF, DOCX, FDX-style, LlamaParse, and Unstructured adapter paths are present.

4 evidence paths

19. Market and comp data foundation

live-ready

Curated 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

ready

Route contracts, AI outputs, project data, billing usage, workflow, and domain types are represented.

4 evidence paths

21. Mock project data

ready

The Last Take sample project includes realistic project, analysis, Library, score, and rewrite state.

1 evidence path

22. Motion graphics foundation

ready

Framer Motion and custom visualizers drive score reveals, dashboard transitions, and report surfaces.

3 evidence paths

23. README architecture guide

ready

The README explains product vision, stack, APIs, systems, scoring, environment variables, access order, and provider strategy.

1 evidence path

Core systems

Runtime project workspaces

ready

Project intake creates session workspaces with treatment, logline, outline, bibles, artifacts, assets, score history, memory, and usage events.

Project-aware navigation

ready

Dashboard plus primary Analyze and Write links follow the current or latest project and fall back cleanly.

AI route foundation

ready

Server-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

ready

Project-specific reports, score dials, proprietary metrics, First Ten Pull, character diagnostics, scene health, market comps, score history, and improvement panels are visible.

Scoring engine

ready

Script Intelligence Score is calculated server-side from validated rubric inputs.

Document parsing

ready

TXT, 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

ready

Project-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

ready

PDF, 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

ready

Deterministic 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

ready

Project-grounded responses use plan-aware usage gates, safety checks, memory retrieval, and mock/live-ready AI routing.

Story bible

ready

Character 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

ready

Normalized 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

ready

TMDb is normalized through the existing metadata client; OMDb, TheTVDB, and Watchmode have deferred adapters ready for live calls in the next phase.

Market intelligence

ready

Market 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

ready

Generated 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

ready

Write 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

ready

Re-analysis appends score records for actual improvement tracking and switches to Supabase analysis_reports for authenticated UUID-backed projects.

Improvement overview

ready

Projected 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

ready

Project-specific writing tool history records usage-ready skill runs and switches to Supabase skill_runs for authenticated UUID-backed projects.

Usage event ledger

ready

Billing 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

ready

Account can show browser session state and request magic-link sign-in when Supabase public credentials are configured.

Supabase schema verifier

ready

A local no-credential verifier checks schema tables, RLS, grants, storage buckets, vector memory, and setup-check coverage before applying SQL.

Supabase apply helper

ready

An explicit DATABASE_URL-only helper can apply supabase/schema.sql through psql and parse supabase/setup-check.sql without printing credentials.

Supabase setup check

ready

A read-only SQL check can verify extensions, tables, RLS, grants, buckets, storage policy, and project memory RPC after schema setup.

Stripe setup handoff

ready

Stripe setup metadata lists Checkout, portal, webhook, recurring Price env names, event types, and missing setup names without exposing secrets.

Stripe Price setup helper

ready

An 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

ready

A local no-credential verifier checks billing plans, recurring Price env names, Checkout, portal, webhook events, lifecycle persistence, CI, and docs.

Hosting environment helper

ready

A 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

ready

A local no-credential verifier checks Vercel config, Railway config, health endpoint, smoke checks, CI wiring, hosted URL setup, and docs.

Recommendation decisions

ready

Rewrite priorities can be accepted or rejected with projected improvement tracking and Supabase recommendation_decisions persistence.

Workflow runs

ready

Project-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

ready

Project-specific background queues cover plan-gated large analysis, document indexing, comp research, report generation, and memory rebuilds.

Safety guardrails

ready

Versioned deterministic policy checks run before AI and writing-tool execution, with rule IDs, context, review path, and mitigation guidance.

Secret boundaries

ready

OpenAI, Stripe, server Supabase, model routing, and provider adapters are marked server-only; browser Supabase auth uses a separate public client.

Production audit

ready

The 23 requested deliverables are mapped to current implementation evidence, with external access needs separated from code readiness.

External access helper

ready

A single no-secret command prints the ordered Supabase, Stripe, hosting, GitHub, optional provider, and OpenAI-last handoff without exposing credential values.

Access handoff packet

ready

A focused setup endpoint lists needed credentials, optional integrations, hosting state, schema file, and the OpenAI-last step.

Health check

ready

A deployment-safe system health endpoint summarizes audit, access, hosted URL, and key setup order without exposing secrets.

Live service connection verifier

ready

A no-OpenAI command checks Supabase table, Storage, and pgvector RPC access, Stripe recurring Prices, and hosted health once those credentials are configured.

Production preflight

ready

A 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

ready

A non-mutating checklist command checks local git state, origin remote readiness, GitHub CLI availability, and the production readiness workflow.

GitHub CI verifier

ready

A 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

ready

A 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

ready

The 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

ready

Stripe billing is intentionally deferred; entitlement gates and safe mock checkout behavior remain active until live billing is added.

Supabase

ready

Database, storage, RLS, and repository layers are ready; mock mode is active without Supabase credentials.

Optional providers

TMDb metadata

missing

Film and TV index metadata provider.

OMDb metadata

missing

Film and TV index metadata provider.

TheTVDB metadata

missing

Film and TV index metadata provider.

Watchmode metadata

missing

Film and TV index metadata provider.

Pinecone vector store

missing

Future external vector memory provider.

Qdrant vector store

missing

Future external vector memory provider.

Cohere rerank

missing

Optional project-memory reranking.

LlamaParse

missing

Optional advanced document parsing.

Unstructured

missing

Optional advanced document parsing.

AI providers

OpenAI

Structured output ready

Anthropic

Adapter Ready

Gemini

Adapter Ready

Mistral

Adapter Ready

Model roles

Analysis

live

gpt-4.1 via OpenAI

OpenAI is configured for analysis structured output.

Writing

live

gpt-4.1 via OpenAI

OpenAI is configured for writing structured output.

Fast

live

gpt-4.1-mini via OpenAI

OpenAI is configured for fast structured output.

Embedding

live

text-embedding-3-small via OpenAI

OpenAI is configured for embedding structured output.

Second Reader

live

not-configured via OpenAI

OpenAI is configured for secondReader structured output.

Safety

live

gpt-4.1-mini via OpenAI

OpenAI is configured for safety structured output.

Supabase

URL
Browser key
Request key
Server key
Database URL
Legacy anon
Legacy service

Stripe

Secret key
analyzer price
full-access price

Usage

Usage status

Credits, project slots, exports, and storage are evaluated before premium actions run.

Loading usage.

Ledger

Usage activity

Tracked analysis, writing, export, project, and storage events for the current billing cycle.

Loading usage activity.