# 项目相关服务

> **最后更新**：2025-01-14

---

## 服务列表

### 1. [项目管理服务](./project-service.md)

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

**核心功能**：

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

---

### 2. [项目资源服务](./project-resource-service.md)

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

**核心功能**：

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

---

### 3. [文件夹管理服务](./folder-service.md)

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

**核心功能**：

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

---

### 4. [剧本管理服务](./screenplay-service.md)

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

**核心功能**：

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

---

### 4.1 [剧本标签管理服务](./screenplay-tag-service.md)

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

**核心功能**：

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

---

### 5. [分镜管理服务](./storyboard-service.md)

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

**核心功能**：

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

---

### 6. [分镜看板管理服务](./storyboard-board-service.md)

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

**核心功能**：

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

---

### 7. [评论管理服务](./comment-service.md)

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

**核心功能**：

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

---

### 8. [导出服务](./export-service.md)

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

**核心功能**：

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

---

## 服务依赖关系

```
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 设计规范](../../05-api-design.md)
- [数据库设计](../../04-database-design.md)