209 lines
14 KiB
Markdown
209 lines
14 KiB
Markdown
# 「美搭」文档索引
|
||
|
||
> 智能穿搭美学助手 · 文档体系导航
|
||
> 最后更新：2026-08-13
|
||
|
||
---
|
||
|
||
## 0. 当前状态（先看这里）
|
||
|
||
### 0.1 已经定下来的关键前提
|
||
|
||
| 项 | 结论 | 影响 |
|
||
|---|------|------|
|
||
| **备案** | ✅ **已完成** | 原本 2~4 个月的上线瓶颈解除，**开发进度即上线进度** |
|
||
| **V1 商业化** | **完全不收费**，用配额限制控成本 | 无 IAP、无会员、无点数购买、无广告；billing 域降级为配额与计量 |
|
||
| 客户端 | 鸿蒙原生 ArkTS（V1 单端） | 可触达基数是 HarmonyOS NEXT+ 设备，非全部鸿蒙生态设备 |
|
||
| 单品素材 | **全部自采实拍** | 版权干净，但**成为项目新的关键路径** |
|
||
| 形象顾问 | **全职编制** | 规则库产能可控，但到岗时间决定 M2 排期 |
|
||
| 五行/命理模块 | **永久不做** | 诊断维度 34 → **32 项** |
|
||
|
||
### 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 条）。其余 20 项决策已全部收口，见产品方案 §11 与技术选型报告 §7。
|
||
|
||
---
|
||
|
||
## 1. 文档地图
|
||
|
||
文档分四层，每层解决不同的问题。**遇到冲突时，以下层为准**（下层更具体、更晚更新）。
|
||
|
||
```
|
||
第一层｜为什么做
|
||
└─ 产品方案（总纲）──────── 定位、市场、商业模式、范围、路线图
|
||
鸿蒙美搭-智能穿搭美学助手-产品方案.md
|
||
|
||
第二层｜做什么
|
||
├─ 需求规格说明 ★ ───────── 统一需求编号、优先级、验收标准（开发与测试的索引）
|
||
│ 需求规格说明.md
|
||
├─ 美学报告-需求文档 ─────── 报告分级、触发时机、诊断维度字典
|
||
├─ 穿搭Agent-需求文档 ────── 对话能力、意图、场景、输入输出规范
|
||
├─ 用户系统与记忆系统 ────── 账号体系、分层记忆模型、权益与配额
|
||
└─ 美学知识库-建设方案 ───── 知识分类、模态、构建流程、检索与推理
|
||
|
||
第三层｜怎么做
|
||
├─ 技术架构文档 ★ ───────── 分层架构、模块划分、数据模型、关键链路、部署
|
||
│ 技术架构文档.md
|
||
├─ 技术选型与调研报告 ★ ──── 所有技术决策的结论、理由、备选与切换条件
|
||
│ 技术选型与调研报告.md
|
||
└─ 合规与安全方案 ★ ─────── 人脸/AI 标识/备案登记/内容审核/数据安全
|
||
合规与安全方案.md
|
||
|
||
第四层｜谁来做、什么时候做
|
||
└─ 开发任务拆解 ★ ───────── WBS、依赖关系、里程碑、验收条件
|
||
开发任务拆解.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、依赖图、六个里程碑、验收条件 |
|
||
|
||
---
|
||
|
||
## 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 依赖图 + 各任务表的「依赖」列 |
|
||
| 报告触发时机的完整规则 | 美学报告-需求文档 §3 |
|
||
| 记忆分层与冲突消解规则 | 用户系统与记忆系统-需求文档 §3 |
|
||
| 知识库有哪些类目和模态 | 美学知识库-建设方案 §3、§4 |
|
||
|
||
---
|
||
|
||
## 4. 编号体系
|
||
|
||
| 前缀 | 含义 | 定义位置 |
|
||
| --- | --- | --- |
|
||
| `FR-<模块>-<序号>` | 功能需求 | 需求规格说明 §2 |
|
||
| `NFR-<类别>-<序号>` | 非功能需求 | 需求规格说明 §4 |
|
||
| `CR-<序号>` | 合规需求（不可裁剪） | 需求规格说明 §3 |
|
||
| `TD-<序号>` | 技术决策 | 技术选型与调研报告 §1 |
|
||
| `ADR-<序号>` | 架构决策记录 | 技术架构文档 §18 |
|
||
| `T-P<阶段>-<序号>` | 开发任务 | 开发任务拆解 |
|
||
| `R-<域>-<序号>` | 知识库规则 ID | 美学知识库-建设方案 |
|
||
|
||
**引用纪律**：跨文档引用一律用编号，不要复制内容。同一事实只在一处定义，其他地方引用——这是这套文档能长期维护的前提。
|
||
|
||
---
|
||
|
||
## 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） |
|
||
| 技术选型 | 已定稿（**31 项决策全部收口**，待业务输入仅剩 1 项） |
|
||
| 业务决策 | ✅ **已全部收口**（素材自采、顾问全职、V1 不收费、命理不做、市场数据信源） |
|
||
| 备案 | ✅ **已完成**，转为持续义务 |
|
||
| 技术架构 | 待技术评审 |
|
||
| 合规方案 | 待法务复核 |
|
||
| 任务拆解 | 待评审后进入执行 |
|
||
|
||
**最紧急的三件事见 §0.2**（备案完成后已重排：模型清单核实 → 顾问到岗 → 自采流水线）。
|
||
|
||
---
|
||
|
||
## 8. 本轮（2026-08-13）文档更新摘要
|
||
|
||
九份文档全部更新，核心是三件事：**备案完成**、**V1 不收费**、**市场数据换成官方信源**。
|
||
|
||
| 文档 | 版本 | 主要变更 |
|
||
| --- | :---: | --- |
|
||
| [产品方案](./鸿蒙美搭-智能穿搭美学助手-产品方案.md) | v6.0 | §5.0 新增「V1 不收费只限量」；§3 权益拆为 V1 配额与 V2 规划；§4.1 市场数据全部换官方信源并纠正鸿蒙可触达口径；§8.1.1 用户目标下调且**以季度回访率替代 DAU**；§5.3 财务预期重写；备案风险关闭 |
|
||
| [需求规格说明](./需求规格说明.md) | v1.1 | BILL 域由「权益与计费」改为「配额与计量」，V1 移除全部支付；一键登录降级 V2；五行模块标记永久不做；§5.3 前置阻塞项状态重排 |
|
||
| [技术架构文档](./技术架构文档.md) | v1.1 | billing 域降级为配额与计量，`bl_point_tx`→`bl_ledger` 且新增 `tx_type` 使 V2 免迁移；§7.4 拆为 V1 配额与 V2 支付；成本模型补 V1 上限公式；风险登记重排 |
|
||
| [技术选型与调研报告](./技术选型与调研报告.md) | v1.1 | §7 由「待业务输入」改为「决策收口」，`TD-26`~`TD-31` 六项全部给出结论与理由；`TD-19` 备案已办结 |
|
||
| [合规与安全方案](./合规与安全方案.md) | v1.1 | 新增 §2.2.0 备案后四项持续义务；公示要求升为开发任务并加三条实现要求；检查清单标记已完成项 |
|
||
| [开发任务拆解](./开发任务拆解.md) | v1.1 | **关键路径转移**：备案申报任务关闭，内容与素材生产升为最优先；`T-P0-20`/`21` 要求输出每周产能用于倒排 |
|
||
| [美学知识库-建设方案](./美学知识库-建设方案.md) | v1.2 | 新增 §4.2.1 素材自采流水线（五工序 + 拍摄规范 + 降级路径）、§5.1.1 全职顾问工作流（四项职责按投入顺序） |
|
||
| [美学报告-需求文档](./美学报告-需求文档.md) | v1.2 | 五行模块整体移除（维度 34→32）；预约卡片不得展示价格，价格敏感度改用访谈采集 |
|
||
| [用户系统与记忆系统-需求文档](./用户系统与记忆系统-需求文档.md) | v1.2 | §2.4 重构为 V1 配额表 + V2 规划；一键登录降级；主表移除 `points_balance`；强化计量要求 |
|