feat: 采集插件需求和方案

This commit is contained in:
2026-09-01 23:14:38 +08:00
parent 5b77ba72b5
commit a3fe066a5f
4 changed files with 399 additions and 10 deletions
+8 -3
View File
@@ -22,8 +22,10 @@
| 尺寸图 | 必须逐 SKU 生成,任务保存 SKU ID 和实物规格快照。 |
| 定价 | SKU 上点“定价”打开弹窗,以有效包装数据计算;用户确认后回填 SKU 销售价和划线价。 |
| 编辑体验 | 新商品 AI 编辑页取代旧商品编辑页;旧试算页不再追加多 SKU 功能。 |
| 媒体 | 采集主图/详情图是商品候选池;只有来源有稳定关联时才把图片绑定 SKU。1688、淘宝、天猫暂不假设能可靠采集 SKU 图片。 |
| 发布 | 本期只设计“上架至平台”按钮与数据边界,不实现真正发布。 |
| 采集插件 | 采集 Ozon、1688、淘宝、天猫详情页;未登录只显示登录入口,已登录显示“编辑上架 / 采集商品 / 进入 ERP”。采集记录始终写入当前工作空间的默认店铺。详情见 [`requirements/collector-browser-extension.md`](../requirements/collector-browser-extension.md)。 |
| 采集 SKU | 只有来源给出稳定 SKU/组合证据时创建多个 SKU;不能把规格轴做笛卡尔积。没有专属 SKU 图时,真实 SKU 继承父商品默认图而不复制资产。 |
| 媒体 | 采集主图/详情图是商品候选池;来源明确给出 SKU、或可靠的规格轴值(如颜色)与图片关系时才自动绑定。其余素材由编辑页人工选择。 |
| 发布 | 商品采集、编辑、定价、AI 媒体和发布至 Ozon 后台并上线是核心闭环。正式发布使用官方 Seller API,按一 SKU 一 import item/offer 执行、轮询结果并设置库存。 |
## 3. Ozon 已核对结论
@@ -39,6 +41,7 @@
4. 本地素材使用 MinIO;共享测试和生产素材使用七牛 Kodo,不使用应用服务器本地目录作为持久存储。
5. AI、生图、导出、采集转存和发布使用 Redis + BullMQ 队列/Worker,任务可重试、可恢复且携带工作空间与 SKU 上下文。
6. 用户界面语言、采集源语言、商品编辑语言和发布目标语言相互独立;文案及属性值需要支持多语言版本。
7. Ozon Seller 网页内部接口可以在插件中作为显式开启的观察性实验采集;不得保存 Cookie、不得阻塞标准采集、不得替代官方 Seller API 发布或把未验证经营数据视为本店事实。
建议的核心层级:
@@ -51,13 +54,14 @@ User → Workspace → Membership / Role
## 5. 下一步建议
在开始前端或商品模块前,先形成以下文档并获得确认:
在开始实施前,以下内容需要继续细化并获得确认:
1. 云端多租户、认证、权限与门店模型;
2. PostgreSQL schema、迁移策略和租户隔离策略;
3. 平台适配器接口(先 Ozon,后续可接其他平台);
4. 多语言/市场/币种的数据模型;
5. 对象存储、任务队列、密钥加密和部署方案。
6. 浏览器采集载荷、采集箱页面、真实多 SKU 解析测试集,以及 Ozon Seller 网页观察实验的字段口径,见 [`requirements/collector-browser-extension.md`](../requirements/collector-browser-extension.md)。
之后再按 `docs/product/` 的商品编辑页、数据库和 API 契约实现产品功能。
@@ -67,4 +71,5 @@ User → Workspace → Membership / Role
- [编辑页交互设计](../product/product-ai-editor.md)
- [商品/SKU 数据模型](../product/data-model.md)
- [商品编辑 API 契约](../product/api.md)
- [浏览器采集插件需求与技术方案](../requirements/collector-browser-extension.md)
- [技术栈、异步任务与部署方案](../architecture/technology-and-deployment.md)