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