Initial commit: YouTube Studio Flow (backend, frontend, infrastructure, docs)

2026-08-11 12:27:44 +02:00
commit d5af006443
304 changed files with 74604 additions and 0 deletions
@@ -0,0 +1,84 @@
+# YouTube Studio Flow — Documentation
+
+Multi-tenant YouTube channel management tool. Teams connect channels, manage video metadata via a description block and template system, and push changes back to YouTube.
+
+---
+
+## For Claude — Start Here
+
+Read [[00 - Claude Guide]] before starting any task. It contains a task routing table (which docs to read for which task type) and a list of common mistakes to avoid in this codebase.
+
+---
+
+## Quick Navigation
+
+### Architecture
+
+- [[01 - System Overview]] — Tech stack, process architecture, key decisions
+- [[02 - Backend]] — NestJS modules, patterns, shared services
+- [[03 - Frontend]] — Next.js routing, state management, API layer
+- [[04 - Database Schema]] — Prisma models and relationships
+- [[05 - Queue System]] — BullMQ processors and queue constants
+- [[06 - Authentication]] — Google OAuth, JWT, role-based access
+- [[07 - Render Engine]] — Description rendering pipeline, token resolution
+
+### Features
+
+- [[01 - Video Management]] — Video list, editor, sync
+- [[02 - Description Engine]] — Blocks, templates, tokens, rendering
+- [[03 - Metadata Linting]] — Rules, execution, disabling rules
+- [[04 - Bulk Operations]] — Preview/confirm pattern, rollback
+- [[05 - Playlists]] — YouTube playlist sync
+- [[06 - Collaborators]] — Platform fields, token mapping
+- [[07 - Saved Views]] — Filter presets, pinned tabs
+- [[08 - Campaigns]] — Date-window promotional blocks
+- [[09 - Calendar]] — Scheduled video visualization
+- [[10 - Import Export]] — CSV and JSON workspace transfer
+- [[11 - Quota Management]] — YouTube API quota tracking
+- [[12 - Audit Log]] — Change history
+- [[13 - Team Settings]] — Render settings, lint rule disabling
+
+### API Reference
+
+- [[01 - Auth API]]
+- [[02 - Videos API]]
+- [[03 - Blocks API]]
+- [[04 - Templates API]]
+- [[05 - Collaborators API]]
+- [[06 - Linting API]]
+- [[07 - Playlists API]]
+- [[08 - Saved Views API]]
+- [[09 - Teams API]]
+- [[10 - Quota API]]
+- [[11 - Bulk Jobs API]]
+- [[12 - Calendar API]]
+- [[13 - Import Export API]]
+- [[14 - Team Variables API]]
+- [[15 - Campaigns API]]
+- [[16 - YouTube Sync API]]
+- [[17 - Video Configs API]]
+
+### Design Guidelines
+
+- [[01 - Visual Design]] — Colors, typography, spacing, shadows
+- [[02 - CSS Conventions]] — CSS Modules, variables, min-width rule
+- [[03 - Component Patterns]] — React patterns, TanStack Query, modals
+- [[04 - Backend Architecture Patterns]] — Module structure, scoping, audit
+- [[05 - Code Conventions]] — TypeScript, naming, comments
+
+### Development
+
+- [[01 - Local Setup]] — Prerequisites and step-by-step setup
+- [[02 - Environment Variables]] — All env vars with descriptions
+- [[03 - Recipes]] — How to add modules, rules, endpoints, nav items
+- [[04 - Gotchas]] — Non-obvious behaviors and known traps
+- [[05 - Deployment and Operations]] — Production stack, secrets, job failures, backups, key rotation
+- [[06 - Verifying Changes]] — Build, type-check, and lint commands
+
+### Backlog
+
+- [[01 - Technical Debt and Future Work]] — Dead code, missing features, deferred improvements
+
+### Daily Notes
+
+Chronological log of shipped work. Filename format: `YYYY-MM-DD NN Short title` (NN counts major tasks that day, ascending).