34 lines
1.1 KiB
Markdown
34 lines
1.1 KiB
Markdown
# 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]]
|