feat(edit): 定价试算开发、SKU 样式功能修改

docs/project/HANDOFF.md

@@ -1,6 +1,6 @@
 # Atlas Seller Kit 交接说明
 
-> 更新：2026-09-28。此文是新 AI 对话、架构讨论与开发工作的首读入口。开始开发前，必须先阅读并遵守 [`development-collaboration-contract.md`](./development-collaboration-contract.md) 和仓库 `AGENTS.md`。下方按日期记录的旧方案仅供追溯；当前状态以本节及最新的 1.47 节为准。
+> 更新：2026-09-29。此文是新 AI 对话、架构讨论与开发工作的首读入口。开始开发前，必须先阅读并遵守 [`development-collaboration-contract.md`](./development-collaboration-contract.md) 和仓库 `AGENTS.md`。下方按日期记录的旧方案仅供追溯；当前状态以本节、2026-09-29 类目佣金记录及最新的 1.47 节为准。
 
 ## 1. 项目定位
 
@@ -20,6 +20,23 @@ SKU 定价已打通试算、表单应用与原子保存确认，在线商品同
 
 接手前请先阅读 `git status --short`，确认当前工作区状态；本轮图片选择的 Web、API、contracts、迁移、测试和文档随本报告一起提交。不要用 `git reset --hard` 或批量清理未跟踪文件。共享 contracts 类型需先构建，再执行 Web/API/Worker 检查。开发验证需要时可按 `AGENTS.md` 先确认进程与端口，再启动或重启 API/Worker；下方旧章节中的“不可重启”说法已失效。
 
+### 2026-09-29：类目佣金 JSON 导入与定价接入
+
+- 已先编写[实施方案](../product/category-commission-import-plan.md)，并完成[API 契约](../api/category-commissions.md)、迁移 `052`、导入解析器、原子启用、管理页面及试算展示。影响 Web、API、contracts、database；未涉及 Worker 和扩展。
+- 入口为「系统管理 → 类目佣金」（`/system/commissions`）：上传 JSON/TXT 或粘贴 JSON，填写版本、来源、采集日期，预览差异与异常，确认适用范围后启用。支持搜索、只看异常、查看历史版本；百分比显示两位小数。
+- 当前限定 Ozon RU / rFBS / RUB 三档佣金；通过已同步平台目录核对二级 `cate_id` 和父类目，映射到 Atlas 商品类型 UUID。查询接口支持内部 UUID 或外部 `description_category_id`，正式报价按最终售价及汇率命中分档，结果展示佣金类目、档位和版本。
+- 原始附件共 542 类 / 1,626 档。最初预览错误地排除了两个全档 0% 类目。维护者确认 0% 可能是有效优惠佣金后，已修正为可导入；新版浏览器实测 542 类全部可用，覆盖 7,365 个商品类型。**仅预览，尚未把用户附件启用为正式费率**；管理员需核对 RU/rFBS 适用范围并在页面确认。
+- 迁移 `052` 已在本地数据库应用，再次运行迁移无变化。修正后 38 项相关测试通过：解析、数据库真实角色权限、启用/幂等/旧预览、目录异常提示、授权撤销、跨工作空间、后半程写入失败回滚、历史不可变，以及 1500/1500.01/5000/5000.01 ₽ 边界与 CNY 换算。API/Web 类型检查及构建、contracts/database 构建通过；Web 仍有大 bundle 提示。
+- 浏览器验证了实际附件上传、预览、异常筛选、确认项使按钮可用、修改来源后预览失效；未在浏览器提交真实费率。启用及历史查询由事务回滚集成测试验证；未做多连接并发压力测试。没有手动启动/停止维护者的 API/Web/Worker，使用现有 8100/8200 服务；浏览器验证窗口已关闭。
+- 首版每次启用完整替换上一导入版本，不支持增量或定时发布；同 JSON 内容和同平台版本名称禁止重复导入。映射是启用时目录的快照，后续新增商品类型的映射刷新仍需完善，不能承诺目录同步自动扩展佣金覆盖。正式使用仍须核对附件适用范围及其他物流/结算费用。
+
+### 2026-09-29：草稿物流费率用于报价与发布预检
+
+- 维护者取消“草稿物流费率报价不能首次上架”的业务限制。开发和生产环境默认允许草稿卡参与方案、试算与 SKU 确认，`PRICING_ALLOW_DRAFT_RATES=false` 可限制新报价；测试环境仍默认关闭。既有 `development_only` 字段继续标记费率尚未审核。
+- 首次发布预检不再因草稿卡报价产生 `PRICING_RATE_REVIEW_REQUIRED`；已确认报价、售价、包装、素材与平台属性等校验保持有效。定价工具移除误导性告警，SKU 显示定价自身状态，费率选择仍标明“待审核费率”。
+- 系统管理「物流费率审核」仍可用真实账单样本复核 Ozon CEL 费率；草稿卡不会因可试算而自动变为 active。商品编辑页的“选择 SKU 并首次上架”按钮仍为占位，真正 Ozon 首次发布 job 尚未接入。
+- 验证：草稿费率配置、定价 HTTP/PostgreSQL 和商品编辑 HTTP/PostgreSQL 共 26 项通过；contracts/API/Web 类型检查和构建通过，`git diff --check` 通过。隔离浏览器打开现有门店的定价方案页，确认旧“当前使用开发草稿费率”提示已消失。未重启维护者服务，未进行真实上架。
+
 ### 2026-09-28：SKU 定价试算与确认
 
 - SKU 采购价失焦/回车自动计算、手动算价、批量计算和保留手动售价；明细弹窗比较运输方案、调整参数并应用当前 SKU。