# Jointo 项目功能结构大纲（MVP 版本）

> **项目名称**：Jointo（jointo）  
> **项目定位**：AI 驱动的视频制作工作台  
> **项目域名**：https://www.jointo.ai  
> **文档版本**：v1.0  
> **创建日期**：2026-01-29

---

## 📋 目录

1. [用户系统](#1-用户系统)
2. [项目管理](#2-项目管理)
3. [剧本管理](#3-剧本管理)
4. [分镜管理](#4-分镜管理)
5. [资源管理](#5-资源管理)
6. [视频管理](#6-视频管理)
7. [时间轴管理](#7-时间轴管理)
8. [音效管理](#8-音效管理)
9. [字幕管理](#9-字幕管理)
10. [配音管理](#10-配音管理)
11. [AI 功能](#11-ai-功能)
13. [导出功能](#13-导出功能)
15. [系统设置](#15-系统设置)

---

## 1. 用户系统

### 1.1 认证与授权
- 手机号登录（短信验证码）
- JWT Token 认证
- 会话管理

### 1.2 用户管理
- 用户资料管理
  - 头像上传
  - 昵称修改
  - 手机号绑定

### 1.3 积分系统
- 积分消费
- 积分查询
- 积分消费记录

---

## 2. 项目管理

### 2.1 文件夹系统
- 文件夹创建
- 文件夹编辑
  - 名称修改
  - 颜色设置
  - 图标设置
- 文件夹删除
- 文件夹移动
- 文件夹树形结构（最多10层）
- 文件夹权限管理
  - 所有者权限
  - 编辑者权限
  - 查看者权限
- 文件夹成员管理
  - 成员添加
  - 成员移除
  - 角色变更
- 文件夹搜索
- 文件夹排序

### 2.2 项目管理
- 项目创建
- 项目编辑
- 项目删除
- 项目移动到文件夹
- 项目克隆
- 项目类型
  - 我的项目
  - 协同项目
- 项目设置
  - 
  - 画幅比例
  - 视频帧率
  - 项目时长
  - 导出格式
  - 导出质量
- 项目状态管理
  - 活跃状态
  - 归档状态
  - 删除状态（回收站）
- 项目搜索
- 项目筛选
  - 按类型筛选
  - 按状态筛选
  - 按时间筛选
- 项目排序
  - 按创建时间
  - 按更新时间
  - 按名称

---

## 3. 剧本管理

### 3.1 剧本编辑
- 剧本文件上传解析
  - TXT 格式
  - DOC 格式
  - DOCX 格式
  - PDF 格式
  - RTF 格式
  - Markdown 格式
- 剧本名称重命名
- 剧本删除

### 3.3 剧本资源标签系统
- 资源标签创建
- 资源标签编辑
- 资源标签删除
- 标签关联到剧本元素

---

## 4. 分镜管理

### 4.1 分镜编辑
- 分镜创建
- 分镜编辑
  - 分镜标题
  - 分镜描述
  - 分镜缩略图
- 分镜删除
- 分镜复制
- 分镜顺序调整
  - 拖拽排序
  - 手动排序
- 分镜时间范围设置
  - 开始时间
  - 结束时间
  - 时长计算

### 4.2 分镜资源
- 分镜关联角色
  - 角色添加
  - 角色移除
  - 角色排序
  - 角色对白
- 分镜关联场景
  - 场景添加
  - 场景移除
- 分镜关联道具
  - 道具添加
  - 道具移除
  - 道具排序
- 分镜生成视频
  - 视频添加
  - 视频移除
  - 视频排序
- 资源显示顺序管理

### 4.3 分镜操作
- 分镜插入
  - 在指定位置插入
  - 在末尾插入
- 分镜搜索

---

## 5. 资源管理

### 5.1 项目资源
- 资源上传
  - 图片上传
  - 视频上传
  - 音频上传
- 资源类型
  - 角色资源
  - 场景资源
  - 道具资源
  - 实拍资源
- 资源预览
  - 图片预览
  - 视频预览
  - 音频预览
- 资源元数据
  - 文件尺寸
  - 文件格式
  - 文件大小
  - 上传时间
- 资源标签
  - 标签添加
  - 标签移除
- 资源搜索
- 资源筛选
  - 按类型筛选
  - 按标签筛选
  - 按时间筛选
- 资源排序
- 资源删除

### 5.2 资源素材库
- 素材库类型
  - 角色素材
  - 场景素材
  - 道具素材
  - 实拍素材
- 素材库搜索
- 素材库预览
- 素材添加到项目
- 素材跨项目复用
- 素材标签管理

### 5.3 文件存储
- MinIO 对象存储集成
- 文件上传
  - 分片上传
  - 断点续传
- 文件下载
- 文件校验（SHA256）
- 文件去重
- 缩略图生成
  - 图片缩略图
  - 视频缩略图
- 文件压缩
- 文件格式转换

---

## 6. 视频管理

### 6.1 视频素材
- 视频上传
- 视频类型
  - 图生视频
  - 文生视频
  - 首尾帧视频
  - 融合生视频
  - 实拍替换
  - 实视频
- 视频预览
- 视频元数据
  - 视频时长
  - 视频分辨率
  - 视频帧率
  - 视频格式
  - 视频大小
- 视频状态
  - 待处理
  - 处理中
  - 已完成
  - 失败

### 6.2 视频编辑
- 视频裁剪
- 视频时间范围调整
  - 开始时间
  - 结束时间
- 视频缩略图设置
- 视频删除
- 视频复制
- 视频导出

---

## 7. 时间轴管理

### 7.1 时间轴结构
- 时间轴轨道
  - 分镜轨道
  - 资源轨道
  - 视频轨道
  - 音效轨道
  - 字幕轨道
  - 配音轨道
- 时间轴项（时间块）
  - 时间块创建
  - 时间块编辑
  - 时间块删除
- 时间轴缩放
  - 放大
  - 缩小
  - 适应窗口
- 时间轴滚动
  - 水平滚动
  - 垂直滚动

### 7.2 时间轴操作
- 时间块拖拽移动
- 时间块长度调整
  - 拖拽调整
  - 手动输入
- 时间块删除
- 时间块复制
- 时间块分割
- 轨道添加
- 轨道删除
- 轨道显示/隐藏
- 轨道锁定/解锁
- 轨道重命名
- 轨道排序

### 7.3 播放控制
- 播放
- 暂停
- 停止
- 上一帧
- 下一帧
- 快进
- 快退
- 时间码显示
  - HH:MM:SS:FF 格式
- 播放位置跳转
- 播放速度调整
- 循环播放

---

## 8. 音效管理

### 8.1 音效素材
- 音效上传
- 音效预览
- 音效元数据
  - 音效时长
  - 音效格式
  - 音效大小
- 音效状态
  - 待处理
  - 处理中
  - 已完成
  - 失败

### 8.2 音效编辑
- 音效时间范围调整
  - 开始时间
  - 结束时间
- 音效音量调整
- 音效淡入淡出
  - 淡入时长
  - 淡出时长
- 音效删除
- 音效复制
- 音效导出

---

## 9. 字幕管理

### 9.1 字幕编辑
- 字幕创建
- 字幕编辑
  - 字幕文本
  - 字幕时间范围
- 字幕删除
- 字幕样式
  - 字体设置
  - 字体大小
  - 字体颜色
  - 字幕位置（上/中/下）
  - 背景颜色
  - 背景透明度

### 9.2 字幕操作
- 字幕批量导入
  - SRT 格式
  - ASS 格式
  - VTT 格式
- 字幕导出
  - SRT 格式
  - ASS 格式
  - VTT 格式
- 字幕时间轴同步
- 字幕自动对齐
- 字幕搜索
- 字幕替换

---

## 10. 配音管理

### 10.1 配音编辑
- 配音创建
- 配音编辑
  - 配音文本
  - 配音时间范围
- 配音删除
- 配音语音类型
  - 男声
  - 女声
  - 童声
  - 老年声
- 配音语速调整
- 配音音量调整
- 配音音调调整

### 10.2 配音生成
- AI 配音生成
  - 文本输入
  - 语音类型选择
  - 语速设置
  - 音调设置
- 配音预览
- 配音状态
  - 待生成
  - 生成中
  - 已完成
  - 失败
- 配音重新生成
- 配音导出

---

## 11. AI 功能

### 11.1 AI 图片生成
- 文本生成图片
  - 提示词输入
  - 负面提示词
  - 图片尺寸设置
  - 图片风格选择
- 图片提示词优化
- 图片批量生成
- 图片预览
- 图片保存到项目

### 11.2 AI 视频生成
- 图片生成视频
  - 图片上传
  - 运动描述
  - 视频时长设置
- 文本生成视频
  - 文本描述
  - 视频风格
  - 视频时长
- 首尾帧生成视频
  - 首帧上传
  - 尾帧上传
  - 过渡效果
- 视频融合生成
  - 视频1上传
  - 视频2上传
  - 融合比例
- 实拍替换
  - 原视频上传
  - 替换描述
  - 保留区域设置

### 11.3 AI 角度变换
- 图片角度转换
  - 正面视角
  - 侧面视角
  - 背面视角
  - 俯视视角
  - 仰视视角
- 角度变换模型选择
- 角度变换预览

### 11.4 AI 镜头调整
- 镜头类型
  - 特写（Close-up）
  - 近景（Medium Close-up）
  - 中景（Medium Shot）
  - 远景（Long Shot）
  - 全景（Extreme Long Shot）
- 镜头运动
  - 推镜头（Push In）
  - 拉镜头（Pull Out）
  - 摇镜头（Pan）
  - 移镜头（Track）
  - 跟镜头（Follow）
- 镜头调整预览

### 11.5 AI 任务管理
- AI 任务创建
- AI 任务状态跟踪
  - 待处理
  - 处理中
  - 已完成
  - 失败
- AI 任务结果查询
- AI 任务失败重试
- AI 任务取消
- AI 积分消耗记录
- AI 任务历史记录

---

## 13. 导出功能

### 13.1 视频导出
- 导出格式选择
  - MP4 格式
  - MOV 格式
  - AVI 格式
  - WebM 格式
- 导出质量选择
  - 高质量
  - 中质量
  - 低质量
  - 自定义质量
- 导出分辨率设置
  - 1920x1080
  - 1280x720
  - 3840x2160
  - 自定义分辨率
- 导出帧率设置
  - 24 fps
  - 30 fps
  - 60 fps
  - 自定义帧率
- 水印设置
  - 水印图片
  - 水印位置
  - 水印透明度

### 13.2 导出任务
- 导出任务创建
- 导出任务状态跟踪
  - 待处理
  - 处理中
  - 已完成
  - 失败
- 导出任务进度显示
- 导出任务结果下载
- 导出任务失败重试
- 导出任务取消
- 导出任务历史记录

---

## 15. 系统设置

### 15.1 项目设置
- 项目基本信息
  - 项目名称
  - 项目描述
  - 项目封面
- 视频设置
  - 默认分辨率
  - 默认帧率
  - 默认时长
- 导出设置
  - 默认导出格式
  - 默认导出质量
  - 默认水印设置

### 15.2 用户设置
- 个人资料
  - 头像
  - 昵称
  - 邮箱
  - 手机号
- 语言设置
  - 简体中文
  - 繁体中文
  - 英文
- 主题设置
  - 深色主题
  - 亮色主题
  - 跟随系统

---

## 📝 备注

- 本文档仅列出功能点，不包含详细的技术实现
- 详细的功能需求请参考 [产品需求文档](./requirements/prd-daoyanzu-requirements.md)
- 技术实现细节请参考 [技术栈文档](./architecture/tech-stack.md)

---

**维护者**：开发团队  
**最后更新**：2026-01-29