# 内容组 · 项目制周期 / 成本 / 产出管理系统  
## AirLabs · Project  
### V1 产品需求文档（PRD）

---

## 1. 产品背景与使用场景

本系统服务于一家**以 AI 动画 / 视觉内容为核心产出的内容团队**（团队规模 30 人以内）。

### 团队真实工作方式

- 团队以**项目制**运作  
- 项目类型包括：
  - 原创动画项目（季播 / 单季）
  - 客户项目（TVC / 定制广告 / 内容委托）
- 每个项目在开始时即可明确：
  - 单集成片时长
  - 集数
  - 最终目标总时长
- 制作过程中：
  - 大量使用 AI 工具（动画、图像、视频）
  - 单日可能产出大量动画片段
  - 最终在剪辑软件中拼接为完整成片
- 项目过程中普遍存在：
  - 测试 / 试错
  - 重做
  - 内部制作 + 外包混合

### 内容组阶段分工

内容组按制作阶段分为三个小组，各组产出物与计量方式不同：

| 阶段组 | 主要产出物 | 能否用秒数衡量 |
|--------|-----------|:---:|
| 前期组 | 剧本、策划方案、角色/场景设定图 | ❌ |
| 制作组（中期） | 动画片段、部分图片 | ✅ |
| 后期组 | 剪辑成片、补拍修改镜头（≤10%） | 部分可以 |

---

## 2. 当前管理问题

现有日报 / 表格方式无法解决以下问题：

- 一个项目**到底投入了多少成本**
- 实际产出是否匹配项目目标
- 测试与损耗占比情况
- 项目是否超期
- 项目结束后是否盈利

---

## 3. 产品目标

构建一个：

> **以项目为核心，  
> 以内容提交为最小记录单位，  
> 自动汇总产出、进度、成本与损耗，  
> 支持项目完成后统一结算的内部系统。**

---

## 4. 使用范围（V1）

### 覆盖范围
- 内容组
- 内容类项目
- 动画 / 视觉内容生产
- PC 端 Web 应用（预留响应式结构，V2 适配移动端）

### 不包含
- 产品研发周期管理
- 精细工时系统
- 人事绩效考核
- 审批 / 验收流程（保持提交轻量化）
- 移动端专属适配（V2）

---

## 5. 核心设计原则

1. 项目是最高层级单位  
2. 内容提交是真实发生的工作记录  
3. 员工只填"发生了什么"，计算交给系统  
4. **提交过程尽量简单**，不给制作人员增加负担  
5. 项目完成前不展示财务结果  
6. 项目完成后统一结算  

---

## 6. 核心对象与逻辑结构

---

### 6.1 项目（Project）

项目在创建时即明确目标，用于后续一切对照与计算。

**项目字段：**

- 项目名称  
- 项目类型  
  - 客户正式项目（已签约，有合同金额）  
  - 客户测试项目（为甲方做测试/提案，未签约，无回款）  
  - 内部原创项目（自主立项的内容作品）  
  - 内部测试项目（技术测试、风格探索等）
- 项目状态
  - 制作中
  - 已完成（结算）
  - 废弃（中途停止，全部产出记为损耗）
- 项目负责人  
- 项目阶段结构  
  - 前期 / 制作 / 后期  
- 项目目标产出  
  - 单集正片时长（分钟）  
  - 集数  
  - 系统自动计算目标总时长 = 单集时长 × 集数（换算为秒）
- 项目预估完成时间（日期）  
  - 由管理层基于前期测试后填写
- 客户回款金额（仅客户正式项目）  
  - 项目创建时即填写  
  - 其他类型项目此字段不显示
- 项目创建日期（系统自动记录）

---

### 6.2 用户（User）

- 姓名  
- 所属团队（内容组）  
- 所属阶段组  
  - 前期 / 制作 / 后期  
  - 用于后台按组筛选和统计  
  - 不影响成本分摊逻辑（分摊由提交内容自动决定）
- 角色权限  
  - 成员 / 组长 / 主管 / Owner  
- 月度人力成本（工资）  
- 日成本（系统自动计算）  
  - **日成本 = 月薪 ÷ 22 个工作日**

---

### 6.3 内容提交（Submission）【系统核心】

**一条内容提交 = 一次真实发生的内容交付或试错**

> 设计原则：成员只需如实填写"做了什么、产出多少"，系统自动完成分类与计算。  
> MVP 阶段不设审批流程，提交即生效。

#### 提交字段：

- 提交人（自动关联当前用户）  
- 所属项目（下拉选择当前参与的项目）  
- 项目阶段  
  - 前期 / 制作 / 后期  
- 工作类型  
  - 制作 / 测试 / 方案  
- 内容制作类型（按阶段分组，共 11 种）
  - 前期：策划案 / 剧本 / 分镜 / 人设图 / 场景图
  - 制作：动画制作
  - 后期：配音 / 音效 / 修补镜头 / 剪辑
  - 其他
  - 选择内容类型时系统自动设置对应的项目阶段  
- 产出时长输入  
  - 分钟（可选）  
  - 秒（可选）  
  - 系统自动换算为总秒数  
  - 若无产出可填 0
- 投入时长（可选）  
  - 单位：小时  
  - 非必填，鼓励填写  
  - 用于后续效率分析
- 提交对象  
  - 组长 / 制片 / 内部 / 外部  
- 制作描述（简要说明）  
- 提交日期（默认当天，可修改为过去日期补填）
- 里程碑关联（系统自动）
  - 根据内容类型自动匹配同名里程碑
  - 如"策划案"提交自动关联"策划案"里程碑
- 延期原因
  - 当关联的里程碑已超期时，必须填写延期原因
  - 用于后续 AI 分析和管理复盘

---

### 6.4 项目里程碑（ProjectMilestone）

每个项目创建时自动生成一套默认里程碑，对应各阶段的工作环节。

**里程碑字段：**

- 所属项目
- 名称（如：策划案、剧本、分镜、配音等）
- 所属阶段（前期 / 后期）
- 是否完成（勾选）
- 完成日期（系统自动记录）
- 预估工作日（管理员填写）
- 开始日期（管理员填写）
- 实际工作日（系统自动计算 = 开始日期到完成日期的工作日数，排除周末）
- 是否超期（计算值 = 实际工作日 > 预估工作日）

**默认里程碑：**

| 阶段 | 里程碑 |
|------|--------|
| 前期 | 策划案、剧本、分镜、人设图、场景图 |
| 后期 | 配音、音效、修补镜头、剪辑、杂项 |

> 制作阶段不使用里程碑，以秒数进度为度量。

**操作：**
- 管理员可添加/删除里程碑
- 管理员可设置预估工作日和开始日期
- 勾选完成后系统记录完成日期

---

## 7. 成本结构设计

---

### 7.1 人力成本（自动计算）

#### 基础规则
- 日成本 = 月薪 ÷ 22  
- 项目人力成本 = 参与该项目的所有人员日成本按分摊规则累计

#### 分摊核心规则

> **系统根据提交的产出秒数自动判定分摊方式，成员无需额外操作。**

**规则一：有产出秒数 → 按秒数比例分摊**  
适用于：制作组动画产出、后期组补拍镜头等有秒数的提交

**示例：**  
小王（制作组）日成本 909 元，某天提交情况：
- A 项目：产出 60 秒  
- B 项目：产出 30 秒  

分摊结果：
- A 项目承担：909 × (60/90) = 606 元  
- B 项目承担：909 × (30/90) = 303 元  

**规则二：无产出秒数（秒数为 0） → 按提交条数比例分摊**  
适用于：前期组策划/剧本/设定、后期组剪辑等无秒数产出的提交

**示例：**  
小李（前期组）日成本 682 元，某天提交情况：
- A 项目：提交 2 条（剧本 + 角色设定）  
- B 项目：提交 1 条（策划方案）  

分摊结果：
- A 项目承担：682 × (2/3) = 455 元  
- B 项目承担：682 × (1/3) = 227 元  

**规则三：混合情况（同一天既有有秒数的提交，又有无秒数的提交）**  
- 有秒数的提交按秒数参与分摊  
- 无秒数的提交按 1 条 = 该日平均每秒对应的成本折算  
- 简化处理：全部按提交条数比例分摊  

**其他规则：**
- 若某天仅为一个项目提交 → 全部日成本归该项目  
- 管理员可在后台**手动修改**任意一天的分摊结果

#### 各阶段组成本分摊方式汇总

| 阶段组 | 典型提交 | 产出秒数 | 分摊方式 |
|--------|---------|:--------:|---------|
| 前期组 | 剧本、策划、设定图 | 0 | 按提交条数比例 |
| 制作组 | 动画片段 | 有 | 按产出秒数比例 |
| 后期组 — 剪辑 | 剪辑成片 | 0 | 按提交条数比例 |
| 后期组 — 补拍 | 修改镜头（≤10%） | 有 | 按产出秒数比例 |

---

### 7.2 AI 工具成本（订阅类，可扩展）

#### 设计要求
- 后台支持**自定义添加 AI 工具**
- 工具种类可随时扩展
- 由主管或组长录入，每月录入一次或每次购买时录入

#### 字段：
- 工具名称（自定义）
- 订阅周期（月 / 年）
- 费用金额
- 录入日期
- 录入人
- 成本归属方式  
  - 指定项目（100% 归属某项目）  
  - 内容组整体（按当月各项目产出秒数比例自动分摊）  
  - 手动分摊比例（自定义各项目占比）

---

### 7.3 外包成本（项目级）

#### 字段：
- 所属项目  
- 外包类型  
  - 动画 / 剪辑 / 整集  
- 外包范围  
  - 第 X–Y 集  
- 外包金额  
- 录入人
- 录入日期

---

### 7.4 内制 + 外包混合项目处理逻辑

- 项目目标仍按全集数计算  
- 外包部分：
  - 直接计入外包成本  
  - 不产生内部内容提交  
- 内制部分：
  - 通过内容提交产生动画时长  
  - 计入人力成本  

---

## 8. 损耗与亏损（核心概念区分）

---

### 8.0 概念定义

> **损耗（Waste）** 和 **亏损（Loss）** 是两个独立指标，必须区分。

| 概念 | 定义 | 性质 | 何时产生 |
|------|------|------|---------|
| **损耗** | 生产过程中的浪费（测试试错 + 超产废片） | 生产效率指标 | 制作过程中持续产生，盈利项目也有 |
| **亏损** | 项目总成本超过回款金额 | 财务结果指标 | 仅客户正式项目结算后才计算 |

**关系**：损耗大 → 成本上升 → 可能导致亏损。但盈利的项目也会有损耗。

---

### 8.1 三阶段损耗计算体系

不同阶段的工作性质不同，采用不同的损耗衡量方式：

| 阶段 | 计算方式 | 损耗指标 | 度量单位 |
|------|----------|----------|----------|
| **前期** | 工时制 | 里程碑超期工时 | 小时(h) |
| **制作** | 秒数制 | 测试损耗 + 超产损耗 | 秒(s) |
| **后期** | 工时制 | 里程碑超期工时 | 小时(h) |

#### 前期损耗（工时制）

前期工作（策划案、剧本、分镜、人设图、场景图）无法用秒数衡量，改为按里程碑工期计算：

- 遍历前期里程碑，对有 `预估工作日` 且已完成的里程碑
- **实际工作日** = `完成日期 − 开始日期` 的工作日数（排除周末）
- **超出天数** = max(0, 实际工作日 − 预估工作日)
- **损耗工时** = 超出天数 × 8 小时
- 未完成但已超期的里程碑也计入（用当前日期代替完成日期）

#### 制作损耗（秒数制，保持现有逻辑）

- **测试损耗** = 工作类型为"测试"且项目阶段为"制作"的提交总秒数
- **制作产出** = 项目阶段为"制作"的非测试总秒数 + 内容类型为"修补镜头"的总秒数
- **超产损耗** = max(0, 制作产出 − 目标秒数)
- **制作总损耗** = 测试损耗 + 超产损耗
- **秒数损耗率** = 制作总损耗 ÷ 目标秒数 × 100%

#### 后期损耗（工时制）

后期里程碑中：
- **剪辑**等有预估工期的里程碑：与前期同理，按工时计算超期损耗
- **修补镜头**：秒数已计入制作损耗（与目标对比）
- **配音 / 音效**：外包或 AI 生成，不计损耗

#### 项目总损耗

> **秒数类总损耗** = 测试损耗 + 超产损耗
> **工时类总损耗** = 前期超期工时 + 后期超期工时
> **秒数损耗率** = 秒数类总损耗 ÷ 目标秒数 × 100%

**注意**：损耗仅统计生产层面的浪费，**不含 AI 工具成本**。

**示例：**
项目目标：13 集 × 5 分钟 = 3,900 秒
前期：策划案预估 5 天 / 实际 8 天 → 超 3 天 = 24h 损耗
制作：测试 500 秒 + 制作产出 4,800 秒 → 超产 900 秒 → 秒数损耗 1,400 秒
后期：剪辑预估 3 天 / 实际 3 天 → 无超期
秒数损耗率：1,400 ÷ 3,900 = 35.9%
工时损耗：24h

---

### 8.2 亏损的计算（仅客户正式项目）

> **亏损 = 项目总成本 − 回款金额**（仅当总成本 > 回款时）

- 仅客户正式项目有回款，因此仅客户正式项目计算盈亏  
- 原创项目：只看成本和损耗，不算盈亏（未来回款未知）  
- 客户测试项目 / 内部测试项目：无回款，全部成本视为经营投入

---

### 8.3 各项目类型的损耗与亏损适用性

| 项目类型 | 计算损耗 | 计算盈亏 | 说明 |
|----------|:---:|:---:|------|
| 客户正式项目 | ✅ | ✅ | 损耗看效率，盈亏看财务结果 |
| 客户测试项目 | ✅ | ❌ | 无回款，损耗 = 全部产出（本身就是试错） |
| 内部原创项目 | ✅ | ❌ | 只看成本和损耗，未来回款未知 |
| 内部测试项目 | ✅ | ❌ | 无回款，损耗 = 全部产出 |

---

### 8.4 团队效率追踪（V1 粗暴方案）

> 核心问题：同样的工作量分下去，谁的废片率高？

V1 不做逐条通过率标记（太复杂），采用**人均基准对比法**：

#### 计算逻辑
- **人均基准** = 项目目标总秒数 ÷ 参与制作的人数  
- **超出基准** = 个人提交总秒数 − 人均基准  
- **超出比例** = 超出基准 ÷ 人均基准 × 100%  
- 超出多的人 → 产出的废片多 → 效率相对低

#### 示例

项目目标 3,900 秒，4 人参与制作：

| 成员 | 提交总秒数 | 人均基准 | 超出基准 | 超出比例 |
|------|----------:|--------:|--------:|--------:|
| 小王 | 1,300 | 975 | +325 | +33% |
| 小李 | 1,100 | 975 | +125 | +13% |
| 小张 | 950 | 975 | −25 | −3% |
| 小赵 | 850 | 975 | −125 | −13% |
| **合计** | **4,200** | **3,900** | **+300** | — |

> 此方案基于"工作量基本均分"的前提，无需额外标记，纯靠提交数据自动计算。

---

### 8.5 各阶段组损耗说明

| 阶段组 | 损耗方式 | 说明 |
|--------|----------|------|
| 前期组 | **工时制** | 按里程碑预估 vs 实际天数，超期部分 × 8h 计为损耗 |
| 制作组 | **秒数制** | 核心损耗来源：测试损耗 + 超出目标秒数的超产损耗 |
| 后期组 — 剪辑 | **工时制** | 按里程碑预估 vs 实际天数 |
| 后期组 — 补拍 | **秒数制** | 补拍秒数计入制作损耗（与目标对比） |
| 后期组 — 配音/音效 | ❌ | 外包或 AI 生成，不计损耗 |

---

## 9. 项目进度与时间管理

---

### 9.1 进度计算逻辑

- 完成百分比 = 当前累计提交秒数（有秒数的提交）÷ 项目目标总秒数 × 100%  
- 仅统计有产出秒数的提交（制作组 + 后期补拍）  
- 前期组和后期剪辑的工作不影响进度百分比（但其成本计入项目总成本）  
- 进度上限不封顶（可超过 100%，超出部分即为损耗）

> **说明**：前期全部完成但制作未开始时，进度仍为 0%。  
> 这是合理的——进度条反映的是"内容产出进度"，不是"项目整体工作量进度"。

---

### 9.2 进度条可视化

- 显示项目进度条
- 预估完成时间作为基准
- 当前时间位置实时标注

#### 颜色规则
- 进度 ≤100%：蓝色进度条
- 进度 >100%：**双色进度条** — 蓝色表示目标内占比，红色表示超出占比（如 258% 时蓝色占 38.8%，红色占 61.2%）
- 百分比数字超过 100% 时变为红色  

---

### 9.3 预估 vs 实际完成

- 项目完成后记录：
  - 实际完成日期  
  - 与预估完成日期的偏差（天）  

---

## 10. 项目完成与结算机制

### 规则

- 项目是否完成：
  - 仅由 Owner 或指定高权限角色**手动确认**
- 系统可提示但不自动结算：
  - 已达到目标产出  
  - 已超过预估完成时间  
- 在手动确认前：
  - 项目始终处于制作阶段  
  - 不触发任何结算逻辑  

---

## 11. 项目结算（仅项目完成后）

### 结算内容（仅 Owner 可见）

#### 所有项目类型均展示：
- 项目总人力成本  
- 项目 AI 工具成本  
- 项目外包成本  
- **项目总成本 = 人力 + AI 工具 + 外包**  
- 项目总损耗（秒数 + 损耗率）  
- 团队效率排行（人均基准对比）

#### 仅客户正式项目额外展示：
- 项目回款金额（创建时已填写）  
- **项目盈亏 = 回款金额 − 项目总成本**  
- 盈利 → 绿色标注  
- 亏损 → 红色标注

#### 其他项目类型：
- 客户测试项目：展示总成本 + 损耗，无盈亏  
- 内部原创项目：展示总成本 + 损耗，无盈亏  
- 内部测试项目：展示总成本 + 损耗，无盈亏

> 项目进行中不展示任何盈利或亏损信息。

---

## 12. 仪表盘（Dashboard）

### 全局总览（Owner 可见）

提供公司级一目了然的运营视图：

#### 项目概览
- 当前进行中项目数量（按类型分类统计）  
- 各项目进度条一览  
- 超期项目高亮提醒

#### 成本视角
- 本月总人力成本  
- 本月 AI 工具总成本  
- 各项目成本排行  
- 按项目类型汇总成本分布

#### 产出与效率视角
- 本月总产出秒数  
- 各项目产出对比  
- 团队人均日产出秒数

#### 损耗视角
- 总损耗率 + 总工时损耗卡片
- 各项目进度条下方显示损耗率与工时损耗
- 各项目损耗率排行（柱状图，tooltip 显示秒数损耗 + 工时损耗）
- 损耗不含工具成本，仅反映生产效率

#### 盈亏视角（仅客户正式项目）
- 已结算客户项目盈亏列表  
- 客户项目盈亏汇总  
- 亏损项目高亮标红

---

## 13. 权限与历史记录

### 权限层级

| 角色 | 可见范围 | 可操作 |
|------|----------|--------|
| Owner | 全量数据 + 结算 + 仪表盘 | 一切操作、确认结算、修改历史 |
| 主管 / 制片 | 所有项目进度与产出数据 | 录入 AI 工具成本、外包成本 |
| 组长 | 所负责项目 + 组内成员提交 | 查看组员提交、录入成本 |
| 成员 | 本人提交记录 + 所属项目公开信息 | 提交内容、查看项目进度 |

---

### 历史修改规则

- 普通成员不可修改已提交的历史记录  
- 高权限角色（组长及以上）修改时：
  - 必须填写修改原因  
  - 系统自动生成版本记录  
  - Owner 接收修改通知  
- 页面默认显示最新版本  
- 支持查看历史版本对比  

---

## 14. 技术架构（V1）

### 技术栈

| 层级 | 技术选型 | 说明 |
|------|----------|------|
| 前端 | Vue 3 + Element Plus + Vite | 成熟的后台管理 UI 组件库 |
| 后端 | Python FastAPI | 高性能 API 框架 |
| 数据库 | MySQL 8.0（阿里云 RDS） | 生产环境；本地开发可回退 SQLite |
| 图表 | ECharts | 仪表盘可视化 |
| 认证 | JWT Token | 登录鉴权与权限控制 |
| AI 模型 | 豆包（火山引擎 ARK） | 报告摘要生成 |
| 消息推送 | 飞书自建应用 | 报告卡片消息 |
| 定时任务 | APScheduler | 日报/周报/月报定时触发 |

### 部署方式

- **CI/CD**：Gitea Actions 自动构建，推代码即部署
- **镜像**：Docker 构建，推送到华为云 SWR
- **运行**：K3s 集群，通过 Ingress 暴露服务
- **前端**：静态构建后由后端统一托管（`/` 路径返回 index.html）
- **数据库**：阿里云 RDS MySQL，通过环境变量配置连接

### 后续扩展路径
- V3：移动端响应式适配
- V3：数据导出（Excel / PDF）
- V3：AI 智能问答助手（自然语言查询系统数据）

---

## 15. MVP 开发优先级

| 优先级 | 模块 | 内容 |
|--------|------|------|
| P0 | 登录与权限 | 4 级角色登录、鉴权、权限控制 |
| P0 | 项目管理 | 项目创建 / 编辑 / 状态管理 / 目标设定 |
| P0 | 内容提交 | 成员提交表单（核心功能） |
| P0 | 项目详情 | 进度条、提交记录列表、损耗统计 |
| P1 | 成本管理 | 人力成本自动计算、AI 工具成本录入、外包成本录入 |
| P1 | 仪表盘 | 全局总览：项目进度、成本、损耗、收益 |
| P1 | 项目结算 | Owner 手动结算、盈亏计算 |
| P2 | 历史修改记录 | 版本追溯、修改原因、通知 |
| P2 | 用户管理 | 新增 / 编辑成员、薪资设定 |

---

## 16. 系统最终产出价值

通过该系统，管理层可以清晰看到：

- 项目是否超期  
- 项目节奏是否失控  
- 各项目实际成本与损耗  
- 内容组真实生产能力  
- 客户项目是否盈利  
- 项目结束后是否值得继续投入  

---

## 17. AI 能力（V2）

### 17.1 概述

V2 接入 AI 大模型能力，为管理层提供自动化报告和智能分析：

- **AI 模型**：豆包（Doubao）— 字节跳动大语言模型，火山引擎 ARK 平台
- **报告推送**：飞书自建应用，私聊推送给指定管理人员
- **定时调度**：APScheduler 集成

### 17.2 自动报告

| 报告类型 | 推送时间 | 数据范围 |
|----------|----------|----------|
| 日报 | 每天 20:00 | 当天数据 |
| 周报 | 每周五 20:00 | 本周一至周五 |
| 月报 | 每月1日 10:00 | 上月完整数据 |

报告内容由系统汇总数据 + AI 生成自然语言摘要与建议。

### 17.3 项目风险预警

基于规则引擎自动识别风险项目，在仪表盘展示预警：

| 风险维度 | 判定规则 |
|----------|----------|
| 超期风险 | 距截止 ≤7天且进度 <80% |
| 进度风险 | 实际进度严重落后于时间线 |
| 损耗风险 | 损耗率 >50% |
| 产出停滞 | 近7天无提交 |

### 17.4 后续迭代（V3）

- AI 智能问答助手（自然语言查询系统数据）
- 按权限分级推送（不同角色看到不同内容）
- 团队效率 AI 深度分析

---

## 18. 飞书集成

### 接入方式
- 飞书自建应用（非 Webhook 群机器人）
- 私聊发送消息给指定管理人员

### 所需权限
- `im:message:send_as_bot` — 以应用身份发消息
- `contact:user.id:readonly` — 通过手机号获取用户 ID

### 消息格式
- 飞书交互式卡片（Interactive Card）
- 内容为 markdown 格式

---

## 最终定义

> **这是一个让内容生产过程保持自由，
> 但让项目进度、成本与结果无法模糊的系统。**