Create detailed creator platform PR planning stack and implementation requirements - PR_26169_001-creator-platform-foundation

Author: ToolboxAid

docs_build/dev/admin-notes/BusinessPlan.txt

@@ -0,0 +1,219 @@
+I'd increase all of them, because the biggest uncertainty before was **what GFS actually is**.
+
+We've now answered that.
+
+GFS is:
+
+> A creator platform where people build, play, share, and monetize games, assets, audio, worlds, templates, and other creator content.
+
+That single statement clarified a lot.
+
+---
+
+# Updated Assessment
+
+## Business Model
+
+**98% Defined**
+
+Before:
+
+```text id="ydmpt0"
+How do we make money?
+```
+
+Now:
+
+```text id="s7i5ly"
+Marketplace Revenue
+Memberships
+AI Credits
+Future Team Expansion
+Future Featured Listings
+```
+
+The core revenue engine is clear.
+
+Remaining 2%:
+
+* Payment provider
+* Tax handling
+* Marketplace payout process
+
+---
+
+## Membership Strategy
+
+**98% Defined**
+
+Before:
+
+```text id="g8w11x"
+Projects
+Publishing
+Storage
+```
+
+Now:
+
+```text id="d4j7kw"
+Free = Build
+Creator = Share / Sell
+Studio = Grow
+```
+
+Plus:
+
+* Founding Members
+* Beta Members
+* AI Credits
+* Team limits
+
+Almost completely defined.
+
+---
+
+## Marketplace Strategy
+
+**95% Defined**
+
+We now know:
+
+* Anyone can browse
+* Anyone can buy
+* Creator+ can sell
+* Creator receives 80% of Net Revenue
+* Free and paid assets supported
+* Marketplace is a primary revenue source
+
+Remaining questions:
+
+* Categories
+* Reviews
+* Refund workflow
+* Asset licensing language
+
+---
+
+## AI Strategy
+
+**95% Defined**
+
+Major decisions completed:
+
+* No AI for Free
+* Creator = 100 credits
+* Studio = 400 credits
+* Credit packs
+* Studio bonus
+* Database-driven pricing
+* Usage tracking
+
+Remaining questions:
+
+* Actual credit consumption costs
+* Provider implementation
+* Credit expiration rules for purchased packs
+
+Those are operational, not strategic.
+
+---
+
+## Database Design
+
+**92% Defined**
+
+We now know we need:
+
+```text id="w2ef6r"
+membership_plans
+membership_limits
+user_memberships
+invitations
+project_members
+ai_actions
+ai_credit_packs
+user_ai_credits
+ai_usage_log
+```
+
+Plus existing GFS entities.
+
+Remaining work:
+
+* Exact DDL
+* Indexes
+* Audit tables
+* Migration strategy
+
+---
+
+## Ownership & Permissions
+
+**95% Defined**
+
+This category didn't exist before.
+
+Now we have:
+
+| Role    | Purpose           |
+| ------- | ----------------- |
+| Creator | Platform user     |
+| Admin   | Operates platform |
+| Owner   | Runs business     |
+
+And we know:
+
+* Admin sees Health
+* Admin sees Infrastructure
+* Owner controls pricing and business settings
+
+---
+
+## Beta & Founding Programs
+
+**95% Defined**
+
+We now know:
+
+### Beta
+
+* Invitation only
+* Friends & family
+* Studio-level access
+* 400 AI credits
+
+### Founding
+
+* First 100 paid memberships
+* Locked pricing
+* Future badges
+* Separate from Beta
+
+---
+
+# Overall
+
+If I had to summarize where GFS is today:
+
+| Area                    | Confidence |
+| ----------------------- | ---------: |
+| Vision                  |        99% |
+| Business Model          |        98% |
+| Memberships             |        98% |
+| Marketplace             |        95% |
+| AI Strategy             |        95% |
+| Ownership & Permissions |        95% |
+| Database Design         |        92% |
+| Legal Requirements      |        85% |
+| Billing Implementation  |        60% |
+| Marketplace Operations  |        75% |
+
+The biggest remaining unknowns are no longer strategic. They're implementation details:
+
+1. Billing provider
+2. Marketplace payouts
+3. Legal documents
+4. Exact database schema
+
+That's a very different place than where we were when we started talking about "3 projects vs 10 projects." I think the foundation is now strong enough to start building without expecting major pivots.

docs_build/dev/reports/pr_stack_summary.md

@@ -0,0 +1,107 @@
+# PR Stack Summary: PR_26169 Creator Platform Foundation
+
+## Scope
+- This report summarizes the PLAN-only documentation stack for:
+  - `PR_26169_001-creator-platform-foundation`
+  - `PR_26169_002-auth-preview-signin-regression`
+  - `PR_26169_003-beta-invitations-admin`
+  - `PR_26169_004-membership-data-model`
+  - `PR_26169_005-membership-assignment`
+  - `PR_26169_006-memberships-page-v2`
+  - `PR_26169_007-ai-credit-foundation`
+  - `PR_26169_008-ai-credit-display`
+  - `PR_26169_009-marketplace-membership-rules`
+  - `PR_26169_010-marketplace-revenue-model`
+  - `PR_26169_011-marketplace-categories`
+  - `PR_26169_012-teams-foundation`
+  - `PR_26169_013-team-enforcement`
+  - `PR_26169_014-legal-foundation`
+  - `PR_26169_015-terms-of-service`
+  - `PR_26169_016-privacy-cookies-community-copyright-dmca`
+  - `PR_26169_017-owner-memberships`
+  - `PR_26169_018-owner-ai-credits`
+  - `PR_26169_019-admin-health-operations`
+
+## Approved Business Model Captured
+- Free: $0/month, 250 MB storage, 0 AI credits/month, publish 1 experience, no collaboration, browse marketplace, download free assets, buy marketplace assets, cannot sell.
+- Creator: $9/month, 1 GB storage, 100 AI credits/month, up to 3 team members, sell marketplace assets, Creator analytics, 80% Net Revenue.
+- Studio: $19/month, 4 GB storage, 400 AI credits/month, up to 10 team members, advanced analytics, 80% Net Revenue, 10% bonus purchased AI credits.
+- Beta: $0/month, 4 GB storage, 400 AI credits/month, up to 10 team members, invitation only, Studio-equivalent access.
+- Founding Creator: first 100 paid memberships, $5/month, locked while active.
+- Founding Studio: first 100 paid memberships, $10/month, locked while active.
+- Marketplace: everyone can browse, buy, and download free assets; Creator and higher can sell.
+- Marketplace categories: Games, Assets, Audio, Music, Worlds, Templates, Tutorials.
+- Revenue: creator receives 80% of Net Revenue.
+- Net Revenue: sale amount less processing fees, taxes, refunds, chargebacks, and required deductions.
+- AI credit packs:
+  - Small: 100 credits, $5.
+  - Medium: 500 credits, $20.
+  - Large: 3000 credits, $99.
+- Roles:
+  - Creator: platform user.
+  - Admin: health, infrastructure, operations, invitations, AI monitoring, support.
+  - Owner: membership pricing, marketplace percentages, AI pricing, AI action costs, founding programs, legal, revenue settings.
+
+## Required Database Tables Captured
+- `membership_plans`
+- `membership_limits`
+- `user_memberships`
+- `founding_members`
+- `invitations`
+- `project_members`
+- `ai_actions`
+- `ai_credit_packs`
+- `user_ai_credits`
+- `ai_usage_log`
+
+## Stack Dependency Order
+- PR 001 is the shared foundation for every later PR.
+- PR 002 stabilizes auth preview for Creator/Admin/Owner role context.
+- PR 003 adds Admin Beta invitation planning.
+- PR 004 defines membership tables and seed values.
+- PR 005 defines assignment of active memberships.
+- PR 006 renders Memberships page V2 from DB-backed data.
+- PR 007 defines AI credit costs, packs, balances, and ledger.
+- PR 008 displays AI credit balances and packs.
+- PR 009 enforces marketplace membership rules.
+- PR 010 defines Net Revenue and creator revenue share.
+- PR 011 defines marketplace categories.
+- PR 012 defines project team membership foundation.
+- PR 013 enforces team limits.
+- PR 014 defines legal content foundation.
+- PR 015 implements Terms planning from legal foundation.
+- PR 016 implements remaining legal page planning from legal foundation.
+- PR 017 adds Owner membership, marketplace, founding, and revenue settings planning.
+- PR 018 adds Owner AI pricing and action-cost planning.
+- PR 019 adds Admin health and operations planning across the stack.
+
+## Validation Report
+- Current branch: `main`.
+- Expected branch: `main`.
+- Local branches found: `main`.
+- Branch validation: PASS.
+- Runtime validation: SKIP, docs-only PLAN request.
+- Playwright validation: SKIP, no runtime or UI implementation.
+- ZIP packaging: SKIP, this request explicitly required planning documentation only and did not request BUILD execution.
+
+## Files Created
+- `docs_build/pr/PLAN_PR_26169_001-creator-platform-foundation.md`
+- `docs_build/pr/PLAN_PR_26169_002-auth-preview-signin-regression.md`
+- `docs_build/pr/PLAN_PR_26169_003-beta-invitations-admin.md`
+- `docs_build/pr/PLAN_PR_26169_004-membership-data-model.md`
+- `docs_build/pr/PLAN_PR_26169_005-membership-assignment.md`
+- `docs_build/pr/PLAN_PR_26169_006-memberships-page-v2.md`
+- `docs_build/pr/PLAN_PR_26169_007-ai-credit-foundation.md`
+- `docs_build/pr/PLAN_PR_26169_008-ai-credit-display.md`
+- `docs_build/pr/PLAN_PR_26169_009-marketplace-membership-rules.md`
+- `docs_build/pr/PLAN_PR_26169_010-marketplace-revenue-model.md`
+- `docs_build/pr/PLAN_PR_26169_011-marketplace-categories.md`
+- `docs_build/pr/PLAN_PR_26169_012-teams-foundation.md`
+- `docs_build/pr/PLAN_PR_26169_013-team-enforcement.md`
+- `docs_build/pr/PLAN_PR_26169_014-legal-foundation.md`
+- `docs_build/pr/PLAN_PR_26169_015-terms-of-service.md`
+- `docs_build/pr/PLAN_PR_26169_016-privacy-cookies-community-copyright-dmca.md`
+- `docs_build/pr/PLAN_PR_26169_017-owner-memberships.md`
+- `docs_build/pr/PLAN_PR_26169_018-owner-ai-credits.md`
+- `docs_build/pr/PLAN_PR_26169_019-admin-health-operations.md`
+- `docs_build/dev/reports/pr_stack_summary.md`