开发文档
系统架构
StudioX 当前业务系统的代码边界与运行链路说明。
仓库结构
当前仓库主要由四块组成：
app/：后端业务域、控制器、模型、仓储、任务与异常处理web/：Vue 3 前端业务页面、路由、状态管理和插件前端local-gateway/：本地文件网关与脚本拆解执行器docs/：已有业务说明、SQL 变更和专项设计文档
业务主链路
云端后台
负责：
- 业务记录增删改查
- 权限、数据范围和菜单控制
- 异步任务投递
- 回调结果入库
前端管理台
负责：
- 业务页面与表单交互
- 列表筛选与详情展示
- 调用后台接口并反馈状态
本地网关
负责：
- 共享盘附近的文件访问与落盘能力
- 视频预览、封面和上传受理
- 推送任务执行
- 脚本拆解任务派发和状态回写
一条典型业务链路怎么走
素材入库
- 前端上传页发起上传
- 后端记录业务元数据和上传任务
- 本地网关在共享盘附近完成落盘
- 成功后回写状态，素材在库中可见
成片审核
- 制作人员上传成片
- 后端推动审核状态流转
- 驳回时生成修改建议并进入待办
- 状态变更后异步触发飞书通知
脚本拆解
- 云端后台发起拆解任务
- 本地网关受理任务并派发给 Python worker
- Worker 执行场景检测和转写
- 结果通过回调接口回写云端
关键业务域
Library：资源、集合和共享相关能力Pending：待处理视频建议与待办能力Script：脚本拆解、脚本库和回调入库Task：成片协作、推送、通知和任务状态Tags：标签管理和资源绑定Ingest：资源注册、上传与目录相关能力