Files
xsl e511b6a66f 收尾两批并行开发的文档回写与任务包
- Sprint 执行计划 v1.1:§1.1 补第一批交付实据;T9 SPIKE 结论回写 Sprint 1 表
  (T-P0-16 通过 2.8ms;T-P0-12 有条件;T-P0-10 原型 6/6 + 真实照片重验前置);
  Sprint 2 表标注 T-P2-01~06 交付;新增 §9 两批交付记录
- 开发任务拆解 v1.5:交付回写 + 新风险登记(RTMPose 域差异、BiRefNet 异步化)
- 新增 开发任务包/:三批多 agent 并行的协作规程与 14 份任务契约
- 新增 前置开通清单-云资源与资质.md
- 清理已用毕的评审报告(文档评审 2026-08-13、项目整体评审 2026-08-14),
  README 中相应引用改为留痕表述
2026-08-14 21:07:20 +08:00

252 lines
21 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 「美搭」文档索引
> 智能穿搭美学助手 · 文档体系导航
> 最后更新:2026-08-14
---
## 0. 当前状态(先看这里)
### 0.1 已经定下来的关键前提
| 项 | 结论 | 影响 |
|---|------|------|
| **备案** | ✅ **已完成** | 原本 2~4 个月的上线瓶颈解除,**开发进度即上线进度** |
| **V1 商业化** | **完全不收费**,用配额限制控成本 | 无 IAP、无会员、无点数购买、无广告;billing 域降级为配额与计量 |
| 客户端 | 鸿蒙原生 ArkTS(V1 单端) | 可触达基数是 HarmonyOS NEXT+ 设备,非全部鸿蒙生态设备 |
| 单品素材 | **全部自采实拍** | 版权干净,但**成为项目新的关键路径** |
| 形象顾问 | **全职编制** | 规则库产能可控,但到岗时间决定 M2 排期 |
| 五行/命理模块 | **永久不做** | 诊断维度 **32 项**(原 34 项,移除五行分布与幸运色) |
| 成本封顶 | **全局日成本熔断**(四档自动降级) | ⚠️ **配额封不住总成本** —— 总成本 = MAU × 人均,MAU 无上限 |
| 天气数据 | **V1 不接天气 API** | Agent 反问用户或按城市月份推断,**不编造温度** |
| 登录通道 | 华为账号 + **手机号验证码**(两条互不依赖) | 一键登录推 V2(需企业资质) |
### 0.2 现在最该先做的三件事
按优先级,这三件都不产出代码,但决定后面全部节奏:
1. ⚠️ **核实备案登记覆盖的模型清单**(`T-P0-01`)—— 是否含 DeepSeek 与智谱 GLM 两家?若只含一家,双路由属超范围提供服务,需办变更备案或 V1 先单路由。**这是目前唯一可能影响 V1 上线合规性的未知项**
2. 🔴 **全职形象顾问招聘与入场**(`T-P0-20`)—— 规则库产能直接决定 M2 能否按期,且顾问到岗第一件事是评审本体 Schema,**必须在建表前完成**
3. 🔴 **单品自采流水线搭通并测出每周产能**(`T-P0-21`)—— 300 件 `tryon_ready` 的达成时间要靠实测产能倒排,不能靠估算
> **为什么是这三件**:备案完成后,项目的关键路径从"等外部审批"变成"内部内容产能"。第 2、3 项是唯一无法靠 AI 辅助开发压缩的工序 —— 招聘要时间、采购要物流、拍摄要棚时。**它们晚一周启动,上线就晚一周,没有任何技术手段可以追回。**
### 0.3 待业务输入的事项
**仅剩 1 项**:备案登记覆盖的模型清单(见上方第 1 条)。其余 **24 项**决策已全部收口,见产品方案 §11.1 与技术选型报告(`TD-00`~`TD-33`)。
---
## 1. 文档地图
文档分四层,每层解决不同的问题。**遇到冲突时,以下层为准**(下层更具体、更晚更新)。
```
第一层|为什么做
└─ 产品方案(总纲)──────── 定位、市场、商业模式、范围、路线图
鸿蒙美搭-智能穿搭美学助手-产品方案.md
第二层|做什么
├─ 需求规格说明 ★ ───────── 统一需求编号、优先级、验收标准(开发与测试的索引)
│ 需求规格说明.md
├─ 美学报告-需求文档 ─────── 报告分级、触发时机、诊断维度字典
├─ 穿搭Agent-需求文档 ────── 对话能力、意图、场景、输入输出规范
├─ 用户系统与记忆系统 ────── 账号体系、分层记忆模型、权益与配额
└─ 美学知识库-建设方案 ───── 知识分类、模态、构建流程、检索与推理
第三层|怎么做
├─ 技术架构文档 ★ ───────── 分层架构、模块划分、数据模型、关键链路、部署
│ 技术架构文档.md
├─ 技术选型与调研报告 ★ ──── 所有技术决策的结论、理由、备选与切换条件
│ 技术选型与调研报告.md
└─ 合规与安全方案 ★ ─────── 人脸/AI 标识/备案登记/内容审核/数据安全
合规与安全方案.md
第四层|谁来做、什么时候做
├─ 开发任务拆解 ★ ───────── WBS、依赖关系、里程碑、验收条件
│ 开发任务拆解.md
└─ Sprint 执行计划 ★ ────── 排期、轨道并行、已交付部分的验收状态
Sprint执行计划.md
```
★ = 本轮新增文档
**文档清单(可点击)**
| 层 | 文档 | 一句话 |
| --- | --- | --- |
| 1 | [产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md) | 总纲:定位、市场、商业模式、路线图 |
| 2 | [需求规格说明](./需求规格说明.md) ★ | 统一编号的需求与验收标准,开发测试的索引 |
| 2 | [美学报告-需求文档](./美学报告-需求文档.md) | 报告分级、触发时机、**32 项**诊断维度 |
| 2 | [穿搭 Agent-需求文档](./穿搭Agent-需求文档.md) | 对话能力、意图识别、能力联动 |
| 2 | [用户系统与记忆系统-需求文档](./用户系统与记忆系统-需求文档.md) | 账号与配额、L0~L5 分层记忆 |
| 2 | [美学知识库-建设方案](./美学知识库-建设方案.md) | 12 类知识、7 种模态、混合检索 |
| 3 | [技术架构文档](./技术架构文档.md) ★ | 分层架构、数据模型、关键链路、部署 |
| 3 | [技术选型与调研报告](./技术选型与调研报告.md) ★ | 31 项技术决策的结论、理由与切换条件 |
| 3 | [合规与安全方案](./合规与安全方案.md) ★ | 人脸、AI 标识、**备案后的持续义务**、审核、数据安全 |
| 4 | [开发任务拆解](./开发任务拆解.md) ★ | WBS、依赖图、六个里程碑、验收条件 |
| 4 | [Sprint 执行计划](./Sprint执行计划.md) ★ | 六个 Sprint 的排期与出口条件、四轨并行、**后端脚手架已交付部分的实测验收状态** |
---
## 2. 按角色的阅读路径
| 角色 | 阅读顺序 |
| --- | --- |
| **新加入的工程师** | 产品方案 §1~§2(了解产品)→ 技术架构文档(全文)→ 技术选型报告(查为什么这么选)→ 开发任务拆解(找自己的任务)→ 对应模块的需求文档 |
| **前端/客户端** | 技术架构文档 §7 关键链路、§9 API 规范 → 需求规格说明(自己模块)→ 各需求文档的交互章节 |
| **后端** | 技术架构文档 §4 模块、§6 数据模型、§7 链路、§8 AI 层 → 需求规格说明 |
| **算法** | 技术选型报告 TD-04~TD-07、TD-22 → 技术架构文档 §8 → 美学报告需求文档 §4 诊断维度 → 知识库方案 §6 |
| **产品/设计** | 产品方案 → 需求规格说明 → 各需求文档 → 合规方案 §3 内容伦理红线 |
| **运营/内容(含形象顾问)** | 美学知识库-建设方案(全文)→ 美学报告需求文档 §4 → 需求规格说明 FR-KB/FR-ADM |
| **法务/合规** | 合规与安全方案(全文)→ 需求规格说明 §3 合规需求 |
| **管理者/评审** | 产品方案 → 需求规格说明 §5 V1 范围矩阵 → 开发任务拆解 §1 里程碑 + §9 风险提醒 |
---
## 3. 快速查找
| 我想知道… | 去哪里 |
| --- | --- |
| **现在最该先做什么** | 本文 §0.2 |
| V1 到底做什么、不做什么 | 需求规格说明 §5 V1 范围矩阵 |
| V1 为什么不收费、怎么控成本 | 产品方案 §5.0 + §3.2 配额表;技术选型报告 `TD-28` |
| 备案完成后还要做什么 | 合规与安全方案 §2.2.0 四项持续义务 |
| 市场数据的出处 | 产品方案 §4.1(国家统计局 / CNNIC / 华为 HDC 2026) |
| 某个功能的验收标准 | 需求规格说明,按 `FR-xx` 查 |
| 为什么选 A 不选 B | 技术选型与调研报告,按 `TD-xx` 查 |
| 报告是怎么生成的 | 技术架构文档 §7.1 |
| Agent 怎么用知识库和画像 | 技术架构文档 §7.2、§8.3、§8.4 |
| 数据库有哪些表 | 技术架构文档 §6.2 |
| 接口规范与错误码 | 技术架构文档 §9 |
| 人脸数据怎么处理才合法 | 合规与安全方案 §2.1 |
| 上线前必须做完什么 | 合规与安全方案 §5 检查清单 |
| 我的任务依赖谁 | 开发任务拆解 §1 依赖图 + 各任务表的「依赖」列 |
| 现在该做哪个 Sprint、哪些已经做完了 | Sprint 执行计划 §1.1(已交付)+ §1.2(待补) |
| 后端代码在哪、怎么跑起来 | Sprint 执行计划 §1;仓库 `meida_backend` 的 `README.md` |
| 报告触发时机的完整规则 | 美学报告-需求文档 §3 |
| 记忆分层与冲突消解规则 | 用户系统与记忆系统-需求文档 §3 |
| 知识库有哪些类目和模态 | 美学知识库-建设方案 §3、§4 |
---
## 4. 编号体系
| 前缀 | 含义 | 定义位置 |
| --- | --- | --- |
| `FR-<模块>-<序号>` | 功能需求 | 需求规格说明 §2 |
| `NFR-<类别>-<序号>` | 非功能需求 | 需求规格说明 §4 |
| `CR-<序号>` | 合规需求(不可裁剪) | 需求规格说明 §3 |
| `TD-<序号>` | 技术决策 | 技术选型与调研报告 §1 |
| `ADR-<序号>` | 架构决策记录 | 技术架构文档 §18 |
| `T-P<阶段>-<序号>` | 开发任务 | 开发任务拆解 |
| `R-<域>-<序号>` | 知识库规则 ID | 美学知识库-建设方案 |
**引用纪律**:跨文档引用一律用编号,不要复制内容。同一事实只在一处定义,其他地方引用——这是这套文档能长期维护的前提。
### 4.1 单一事实源索引(🔒 修改前必查)
2026-08-13 的一致性评审发现,**几乎所有跨文档冲突都是"同一个数字被复制到多处"造成的**,而不是判断分歧。下表锁定每类关键数字的唯一定义位置。
**规则:要改这些数字,只改「唯一定义位置」那一列指向的地方;其余位置只允许写引用,不允许写数值。**
| 事实 | 🔒 唯一定义位置 | 引用方 |
| --- | --- | --- |
| 性能指标(延迟、可用性) | 需求规格说明 **§4.1** | 产品方案 §8.3.1、美学报告 §10.2、Agent §7.1/§8.3、架构 §12.1 |
| 换装/发型耗时 | 需求规格说明 **§4.1.1**(现状基线 → 目标值两段式) | 同上。**实测前不得引用 40s 作为验收线** |
| 配额数值(含游客) | 产品方案 **§3.2** | 用户系统 §2.4.1、`FR-ACC-02`、`FR-BILL-*`、`bl_quota_rule` 初始化数据 |
| Token 预算 | 技术架构文档 **§7.2**(嵌套表,合计 4200) | `FR-MEM-04`、`FR-AGT-03`、用户系统 §3.8、Agent §3.5.2、`T-P3-17`、`T-P4-03` |
| 成本口径(三档 + 熔断阈值) | 产品方案 **§5.2.1 / §5.3.1** | 架构 §13.1、§8.2.3、`NFR-COST-*` |
| 诊断维度字典与覆盖数 | 美学报告 **§4**(32 项;初级覆盖 21) | 架构 §6.2/§6.3、`FR-RPT-06`、README §5、产品方案 §2.2.1 |
| 诊断准确率门槛 | 美学报告 **§9.4**(验证档 / 上线档两档) | `FR-RPT-05`、`FR-AGT-02`、产品方案 §8.3.3、`T-P0-10/11` |
| 知识库规模 | 美学知识库 **§9.1**(V1 硬指标 / 长期目标两列) | 产品方案 §2.5.2/§2.8、`FR-KB-*`、`T-P2-*` |
| 黄金集规模 | 美学知识库 **§7**(四个子集共 330 例) | `FR-KB-11`、`FR-AGT-05`、`FR-RPT-07`、美学报告 §9.4 |
| 人脸原图保留期 | 合规与安全方案 **§2.1.2** / `CR-02`(2 小时) | 产品方案 §7.1.4、美学报告 §9.1、架构 §7.1/§11.2、`T-P1-27` |
| 记忆枚举与置信度初值 | 用户系统 **§3.3 / §3.5** | 架构 §6.2、§8.4 |
| 配额账本四表职责 | 技术架构文档 **§7.4** 开头 | `FR-BILL-*`、`T-P1-26` |
**流程建议**:每次大改版后专门做一次「同一数字全局搜索」(搜 `32`、`1400`、`4200`、`90s`、`300`、`99.5%`)。本轮的问题高度集中在数字上,人工通读很难发现。
---
## 5. 术语表
| 术语 | 含义 |
| --- | --- |
| **画像** | 由报告产出的结构化诊断结论(体型、色彩季型、脸型等 **32** 个维度) |
| **记忆系统** | 分层存储用户身份、画像、偏好、事件、衣橱的系统,L0~L5 |
| **初级报告 / 全面报告** | 免费版(V1)/ 付费版(V2)的美学报告 |
| **诊断维度** | 报告输出的单个结论项,含 value + confidence + evidence + rule_hits |
| **硬约束 / 禁忌** | 规则库中 `is_hard=true` 的规则,生成结果绝不允许违反 |
| **tryon_ready** | 单品素材已具备换装所需的白底图与规格,可用于试穿 |
| **混合检索** | 硬过滤 + 规则命中 + 向量召回 + 关键词召回 + 重排的检索链路 |
| **黄金集** | 固定输入与期望输出的测试样本集,用于质量回归 |
| **统一合规出口** | 所有 AI 生成物对外发布前必经的模块(审核 + 水印 + 元数据标识 + 编号登记) |
| **配额** | **V1 的资源限制单位**(次数),可通过任务奖励获得,**不可购买**。V1 唯一的成本控制手段 |
| **点数** | **V2 的消耗单位**,可通过任务获取或购买。与配额共用同一张账本表,仅 `tx_type` 不同 |
| **预扣三段式** | reserve(冻结)→ commit(确认)/ refund(退还),保证长耗时任务不会「扣了额度未交付」 |
| **任务中心** | 承载全部长耗时任务的统一视图与状态机 |
| **内容编号** | AI 生成内容的 27 位唯一标识,写入文件元数据用于隐式标识 |
| **大模型登记** | 调用已备案第三方模型对外提供服务时,向属地网信办办理的登记。**本项目已完成**,转为编号公示与变更备案等持续义务 |
| **量感 / 直曲** | 形象顾问领域术语,分别指身体线条的体量感与曲直特征。对用户展示时必须配白话释义 |
| **色彩季型** | 基于肤色、发色、瞳色的冷暖/明度/纯度特征划分的用色类型(自建体系,不使用外部商标名称) |
---
## 6. 文档维护规范
| 规则 | 说明 |
| --- | --- |
| 单一事实来源 | 同一信息只在一处定义,其余引用编号 |
| 变更留痕 | 修改需求或验收标准时,在文档末尾变更记录中登记日期与原因 |
| 版本号 | 结构性调整升主版本,内容补充升次版本 |
| 待确认事项 | 技术类结论统一收口在《技术选型与调研报告》§1 决策总表;仍需业务拍板的收口在该文 §7《待业务输入的事项》。各需求文档的「待确认事项」章节只保留结论摘要与编号引用,不再各自展开 |
| 冲突处理 | 发现文档间冲突时以「下层优先」原则处理,并同步修正上层文档 |
| 时效性标记 | 价格、厂商接口能力等易变信息标注 `⚠️ 时效性`,使用前复核 |
---
## 7. 文档状态
| 类别 | 状态 |
| --- | --- |
| 产品需求 | **待评审**(V1 范围已明确,见需求规格说明 §5;各需求文档页尾状态均为「待评审」,本表与之一致) |
| 技术选型 | 已定稿(**`TD-00`~`TD-33` 共 34 项决策全部收口**,待业务输入仅剩 1 项) |
| 业务决策 | ✅ **已全部收口**(素材自采、顾问全职、V1 不收费、命理不做、市场数据信源) |
| 备案 | ✅ **已完成**,转为持续义务 |
| 技术架构 | 待技术评审 |
| 合规方案 | 待法务复核 |
| 任务拆解 | 待评审后进入执行 |
| **文档一致性评审** | ✅ 已完成一轮(2026-08-13,评审报告用毕已清理),P0/P1/P2 全部修订完毕 |
**最紧急的三件事见 §0.2**(备案完成后已重排:模型清单核实 → 顾问到岗 → 自采流水线)。
---
## 8. 本轮(2026-08-13)文档更新摘要
**十份内容文档全部更新 + 新增《Sprint 执行计划》**(此前本表漏列《穿搭 Agent-需求文档》),分三批:
**第一批 —— 业务决策落地**:备案完成、V1 不收费、市场数据换官方信源、素材自采、顾问全职、命理不做。
**第二批 —— 文档一致性评审修订**(2026-08-13,评审报告用毕已清理):11 项 P0 事实冲突、9 项 P1 覆盖缺口、9 项 P2 一致性问题全部修订。
**第三批 —— 后端脚手架落地后的回写**:`meida_backend` 仓库跑通真实纵向切片后,两项文档未覆盖的问题被实测暴露并回写为
`T-P1-24a`(思考模式)与 `T-P1-25c`(峰谷计价);同时新增《Sprint 执行计划》承接排期与已交付部分的验收状态。
**第四批 —— 文档 ↔ 代码交叉评审**(2026-08-14,评审报告用毕已清理):以产品方案 §3.2 修正配额种子;`points_reserved` → `quota_reserved`、`bonus_value` → `bonus_granted`;用户系统表名与架构对齐;文档仓库补 `.gitignore` 挡住 `reference/*.txt`。
| 文档 | 版本 | 主要变更 |
| --- | :---: | --- |
| [产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md) | v6.1 | §5.0「V1 不收费只限量」;§3.2 配额表补入**游客列**并成为唯一事实源;§4.1 市场数据换官方信源并纠正鸿蒙可触达口径;§8.1.1 用户目标下调且**以季度回访率替代 DAU**;**§5.2.1/§5.3.1 成本口径重写为三档并推翻「配额封顶总成本」的错误论证**;§8.3.1 性能指标改为引用 `NFR-PERF-*`;§8.3.3 准确率拆为验证/上线两档;删除全部日历周期承诺 |
| [需求规格说明](./需求规格说明.md) | v1.2 | BILL 域改为「配额与计量」,V1 移除全部支付;**§4.1 成为性能指标唯一事实源**(修正 Agent 整轮 8s→15s、可用性 99.9%→99.5%,换装改两段式);`NFR-COST-02` 升级为**自动熔断**;新增 `FR-ACC-14` 短信防刷、`FR-ACC-15` 清空照片、`FR-RPT-19` 结论修正入口、`FR-RPT-20` 预约留资、`FR-BILL-12` 会员页留资 |
| [技术架构文档](./技术架构文档.md) | v1.4 | billing 域降级为配额与计量;**§7.4 新增四张表职责边界与 `task_bonus` 物化方案**(此前开发会卡在这里);**§7.2 token 预算改为嵌套表并修正合计 3700→4200**;**§13 成本模型重写为三口径 + §13.3 四档熔断降级**;`pf_memory`/`id_consent` 枚举与用户系统对齐;手机号存储位置明确;`points_reserved`→`quota_reserved`;v1.3 按脚手架实现回写五处:**§16.1 补全 11 个业务域包与三层判别标准**、**`ob_ai_call` 补 4 列**(Prompt 版本/思考 token/峰谷档位)、**§9.1 澄清 `/api/v1` 为规范写法**、**§13.2 新增峰谷计价约束**、**§13.3 补关键场景豁免** |
| [技术选型与调研报告](./技术选型与调研报告.md) | v1.2 | `TD-26`~`TD-31` 六项业务决策收口;`TD-19` 备案已办结;**补 `TD-00` 定义**(此前被引用却未定义);**新增 `TD-32` 短信通道**(此前 P0 需求无选型)、**`TD-33` 天气数据源**(V1 不接,给降级方案) |
| [合规与安全方案](./合规与安全方案.md) | v1.3 | §2.2.0 备案后四项持续义务;公示要求升为开发任务;**人脸原图保留期统一为 2 小时**(此前与产品方案的 24h 冲突);v1.3 补 prod 无 `dev-token` |
| [开发任务拆解](./开发任务拆解.md) | v1.4 | **关键路径转移**:内容与素材生产升为最优先;**M4 拆为 a/b 两块**消除依赖图歧义;新增 `T-P1-12b/12c` 短信、`T-P1-16b` 清空照片、`T-P1-25b` 熔断、`T-P3-21/22` 两个埋点、`T-P5-17/18/19`;v1.3 补 **`T-P1-24a` 思考模式显式配置**与 **`T-P1-25c` 峰谷计价**(均由后端实测暴露) |
| [Sprint 执行计划](./Sprint执行计划.md) | v1.0 | 新增。按依赖就绪切分六个 Sprint,标注 `meida_backend` 已交付任务的实测证据,并把「内容产能」明确为倒排上线时间的唯一依据 |
| [美学知识库-建设方案](./美学知识库-建设方案.md) | v1.2 | §4.2.1 素材自采流水线;§5.1.1 全职顾问工作流;**§9.1 成为规模唯一事实源**(V1 硬指标与长期目标分列);**§7 黄金集拆为四个子集共 330 例**;修正脸型 8→7、局部特征 12→13 |
| [美学报告-需求文档](./美学报告-需求文档.md) | v1.2 | 五行模块移除(维度 34→32);**§9.4 成为准确率门槛唯一事实源**(验证/上线两档);**清除全部价格残留**(¥29.9、预计价格、点击价格档位);**维度覆盖改为准确口径**(初级 21/32,原「40+ 项」不存在) |
| [用户系统与记忆系统-需求文档](./用户系统与记忆系统-需求文档.md) | v1.3 | §2.4 重构为 V1 配额 + V2 规划;一键登录降级;**§3.8 记忆注入分项被采纳为全局事实源**;配额数值改为引用产品方案 §3.2;v1.3 **表名与架构对齐**(`id_user` / `id_user_identity` / `id_consent` / `pf_memory_event`) |
| [穿搭 Agent-需求文档](./穿搭Agent-需求文档.md) | v1.2 | **语音输入由 P0 改为 P1/V2**(此前与 `FR-AGT-17` 冲突);§2.1 能力表补版本与编号列;token 预算与性能指标改为引用;**天气类问题明确不得编造数值**;意图识别准确率拆两档;删除无依据的「1000+ 并发」 |