feat: 复用颜色映射生成完整采购规格 (#295)

docs/admin/01-requirements.md

@@ -265,6 +265,13 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
   而不是显示一个空列表让人困惑。
 - 规则引擎只对可购买候选做 A/B/C/冲突分层和稳定排序；只有唯一、无额外维度歧义的 A 级才预选。
 - 预选不会自动保存或创建采购任务。页面必须显示推荐理由，采购员点击保存后才写映射和只追加的决策审计。
+- 商品级颜色映射是完整规格解析的一个确定性输入，不是采购旁路。顺运宝规格能可靠解析出
+  颜色和尺码时，系统用当前商品颜色映射先限定 PDD 颜色，再确定尺码和其他维度；只有最终
+  剩余一个当前可购买完整组合才以规则来源写入 `spec_mappings`。零命中、多命中、额外维度
+  不明确或颜色目标失效都保持待匹配，不自动创建采购任务。
+- 颜色映射保存、顺运宝明细写入和 PDD 采集结果更新都在各自事务中调用同一个幂等派生服务。
+  人工完整映射永远保留；其他来源仍有效的完整映射不被颜色规则替换。规则自己的依据失效时
+  清除当前派生结果，使现有处理阶段自然回到待匹配。
 
 **创建采购任务：** 只有映射仍有效且没有进行中采购任务的行可勾选。确认弹窗列出
 当前账号可见的全部客户端都可选择，暂时离线或尚未就绪也可提前指派并等待其就绪后领取。

docs/admin/03-data-model.md

@@ -1183,3 +1183,12 @@ CREATE TABLE purchase_spec_resolutions (
 
 `product_color_mapping_audits` 是只追加审计表，记录 `upsert/clear` 的旧值、新值、操作账号、
 上下文版本和时间。清除操作只删除当前态，不删除审计；两张表都不保存提示词、模型响应或凭据。
+
+颜色映射辅助完整规格时不新增第三张派生表。唯一结果继续写入既有 `spec_mappings`：
+`source='rule'`、`source_version='color-spec-v1'`，`source_reason` 记录颜色映射依据，
+`context_version` 覆盖顺运宝规格、当前 PDD 快照、颜色目标和规则版本；同时向既有
+`spec_mapping_decisions` 追加成功决策。重复处理同一上下文不重复更新或追加审计。
+
+只有本规则自己生成的映射会在颜色依据缺失、目标失效或剩余维度不唯一时被移除；人工映射
+和其他来源的有效完整映射不覆盖、不删除。处理阶段和采购创建仍只认当前 PDD 商品下存在且
+选项仍可购买的完整 `spec_mappings`，颜色表本身不提供可采购状态。