docs/v1.0/requirements/backend/04-services/project

项目相关服务

最后更新：2025-01-14

---

服务列表

1. 项目管理服务

职责：项目的创建、查询、更新、删除等核心管理功能。

核心功能：

• 项目 CRUD 操作
• 项目列表查询
• 项目权限管理
• 项目状态管理

---

2. 项目资源服务

职责：管理项目中的各类资源（图片、视频、音频等）。

核心功能：

• 资源上传
• 资源管理
• 资源关联
• 资源搜索

---

3. 文件夹管理服务

职责：项目内的文件夹组织和管理。

核心功能：

• 文件夹 CRUD
• 文件夹树形结构
• 文件夹移动
• 文件夹权限

---

4. 剧本管理服务

职责：视频剧本的编写、编辑、版本管理。

核心功能：

• 剧本 CRUD
• 剧本版本控制
• 剧本协作编辑
• AI 辅助生成

---

4.1 剧本标签管理服务

职责：管理剧本元素（角色、场景、道具）的多版本标签。

核心功能：

• 标签 CRUD
• AI 智能识别标签
• 标签模板管理
• 标签与素材关联

---

5. 分镜管理服务

职责：分镜头设计和管理。

核心功能：

• 分镜 CRUD
• 分镜排序
• 分镜预览
• 分镜导出

---

6. 分镜看板管理服务

职责：视频分镜看板编辑和管理。

核心功能：

• 分镜看板 CRUD
• 轨道管理
• 素材排列
• 分镜看板预览

---

7. 评论管理服务

职责：项目协作评论功能。

核心功能：

• 评论 CRUD
• 评论回复
• 评论通知
• 评论权限

---

8. 导出服务

职责：项目导出为视频文件。

核心功能：

• 视频合成
• 导出队列
• 导出进度
• 导出历史

---

服务依赖关系

project-service (核心)
    ├── project-resource-service (资源管理)
    ├── folder-service (文件夹)
    ├── screenplay-service (剧本)
    │       └── storyboard-service (分镜)
    ├── storyboard-board-service (分镜看板)
    ├── comment-service (评论)
    └── export-service (导出)

---

业务流程

项目创建流程

用户创建项目 (project-service) → 初始化项目结构
→ 创建默认文件夹 (folder-service)
→ 创建空白剧本 (screenplay-service)
→ 返回项目信息

视频制作流程

编写剧本 (screenplay-service) → 设计分镜 (storyboard-service)
→ 上传/生成素材 (project-resource-service)
→ 编辑分镜看板 (storyboard-board-service)
→ 导出视频 (export-service)

协作流程

团队成员查看项目 → 添加评论 (comment-service)
→ 通知项目所有者 → 回复评论
→ 协作完成项目

---

相关文档

• API 设计规范
• 数据库设计