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,33 @@
+# Import / Export
+
+## User Perspective
+The Import/Export page (`/io`) allows migrating video metadata in bulk.
+
+### CSV Import
+1. Upload a CSV file
+2. Map CSV columns to video fields (title, tags, description, etc.)
+3. Review the validation report — shows errors and warnings per row
+4. Commit to apply changes
+
+### JSON Workspace Import
+Import a full workspace export (blocks, templates, variables, collaborators) from another team or environment.
+
+### Export
+Export video metadata or workspace configuration as CSV or JSON.
+
+## Developer Perspective
+
+### Backend
+- **Imports module**: `backend/src/modules/imports/`
+  - `POST /imports/csv/preview` — validates CSV, creates `ImportJob` with `validationReport`
+  - `POST /imports/csv/commit` — applies the import
+  - `POST /imports/json/preview` — validates JSON workspace payload
+  - `POST /imports/json/commit` — applies the workspace import
+- **Exports module**: `backend/src/modules/exports/`
+
+### Data Models
+- `ImportJob` — tracks import with validation report and commit status
+- `ExportJob` — tracks export with file reference
+
+## Related
+- [[13 - Import Export API]]