63 lines
5.0 KiB
Markdown
63 lines
5.0 KiB
Markdown
# 产品档案与词云归档：需求确认稿
|
||
|
||
## 问题与目标
|
||
|
||
当前词云位置库按生成任务保存，设计试验、废弃样例与实际产品没有明确边界，既会累积无用数据，也无法把已加工产品的名字位置稳定地归档。系统需要在设计环节将“画布实际使用的词云”归入产品档案，并让未归档的临时数据可被安全清理。
|
||
|
||
## 已确认的业务规则
|
||
|
||
- **长期保留依据**：产品已加入产品列表；这是设计端可执行的保留动作。实体产品已加工是其业务背景，但不依赖系统自动推断加工结果。
|
||
- **归档对象**：加入产品时，扫描当前画布中实际插入、且可追溯至词云生成任务的素材；默认归档全部命中的词云。
|
||
- **不归档对象**：仅生成但从未插入画布的词云、中间样例/废品、已从当前画布移除的词云、普通图片与不可追溯来源的 SVG。
|
||
- **隐藏图层**：不视为当前成品内容，不归档其中的词云。
|
||
- **去重**：同一来源词云在画布中出现多次时，只保存一份词云位置库快照。
|
||
- **产品身份**：接口导入产品使用稳定的外部产品 ID；网页创建产品使用内部产品 ID。ID 是系统关联键，不是默认展示内容。
|
||
- **人类识别**：默认展示产品名称；可辅以规格、SKU/款号与封面，不显示完整产品 ID。
|
||
- **产品图片**：产品从一开始支持图片集合和当前封面；首期仅保存当前完整设计的预览快照，后续可添加实景图和产品接口图。
|
||
- **归档介质**：产品档案保存词云位置库的独立快照，同时保留来源任务 ID 供追溯；不能只依赖可能被清理的原始任务目录。
|
||
|
||
## 范围
|
||
|
||
1. 在画布中提供“加入产品列表”动作。
|
||
2. 支持选择接口同步的产品或在网页创建产品。
|
||
3. 创建/更新产品档案、设计预览图和关联词云位置库快照。
|
||
4. 在产品列表与设计界面显示归档状态及可读提示。
|
||
5. 为临时设计数据提供自动清理候选、延期和人工清理能力。
|
||
6. 为产品档案提供后续多图、外部产品接口与实体加工状态接入的扩展位。
|
||
|
||
## 非目标（首期）
|
||
|
||
- 不自动根据 WCD 合成任务成功推断“实体已加工”或“已上市”。
|
||
- 不在首期接入实景图上传或外部产品图片；只保留可扩展的数据结构与封面选择入口。
|
||
- 不以产品名称作为接口同步和去重依据。
|
||
- 不删除已归档产品的词云位置库，除非用户显式删除产品档案或解除关联。
|
||
|
||
## 用户故事
|
||
|
||
1. 作为设计人员，我希望把当前设计加入产品列表，使成品使用的词云数据被长期保存。
|
||
2. 作为设计人员，我希望系统自动识别当前画布中使用的词云，而不必逐项查找生成任务。
|
||
3. 作为生产/运营人员，我希望通过产品名称、规格与预览图识别档案，而不是记住内部 ID。
|
||
4. 作为管理人员，我希望未用于产品的临时设计数据能被定期清理，同时可在清理前人工保留或延后。
|
||
5. 作为未来接口维护者，我希望外部产品能按稳定 ID 合并进同一个产品档案。
|
||
|
||
## 验收标准（EARS）
|
||
|
||
1. 当用户在画布中选择“加入产品列表”时，系统应扫描当前可见画布元素并识别可追溯的词云来源。
|
||
2. 当扫描到多个可追溯词云时，系统应默认选择全部唯一来源并在确认界面显示数量和来源摘要。
|
||
3. 当同一词云来源被多个画布元素引用时，系统应只创建一份位置库归档快照。
|
||
4. 当词云仅存在于隐藏图层、未插入画布或已从当前画布删除时，系统不应将其归档为该产品的词云数据。
|
||
5. 当用户确认加入已有产品或创建新产品时，系统应创建产品与词云归档版本的关联，并保存当前完整设计预览图。
|
||
6. 当产品来自外部接口时，系统应使用外部产品 ID 作为幂等关联键；页面应默认显示产品名称而非该 ID。
|
||
7. 当产品在网页内创建时，系统应生成内部产品 ID，并允许用户填写用于展示的产品名称及可选规格/SKU。
|
||
8. 当归档成功时，系统应提示“已归档至产品”，并显示产品名称和已归档词云数量。
|
||
9. 当设计数据尚未归档至产品时，系统应明确标记其为临时数据并显示清理策略或预计清理时间。
|
||
10. 当产品档案仍关联某词云位置库时，自动清理流程不得删除该归档位置库。
|
||
11. 当用户解除产品关联或删除产品档案时，系统应先进入可恢复的待清理状态，而非立即不可逆删除词云数据。
|
||
12. 当后续加入实景图或外部产品图时，系统应能把它们作为产品图片候选，并允许选择当前封面而不丢失设计预览快照。
|
||
|
||
## 尚待确认的策略参数
|
||
|
||
- 临时设计数据的默认保留天数及清理前提醒时点。
|
||
- 产品被删除、外部接口下架或解除关联后的宽限期。
|
||
- 产品接口可提供的最小字段（稳定 ID、名称；建议另含 SKU/规格/封面 URL）。
|