Files

wurenzhi eafa1bbe94 feat: 添加货币和汇率管理功能

refactor: 重构前端路由和登录逻辑

docs: 更新业务闭环、任务和架构文档

style: 调整代码格式和文件结构

chore: 更新依赖项和配置文件

2026-03-19 19:08:15 +08:00

01 商品域业务闭环

本文档包含与商品相关的业务闭环：数据采集、商品刊登、素材管理、商品主数据、SKU变体

1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）

💰 钱流：
- 采集成本：API调用费用、代理IP费用、云服务费用
- 利润评估：采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
🔄 状态变化：
- RAW_DATA → CLEANED → ANALYZED → READY_FOR_LISTING
🔥 触发条件：
- 定时任务：按配置的采集频率自动触发
- 手动触发：用户手动发起采集任务
- 事件触发：商品价格变动、库存变动等事件触发重新采集

目标：将可售商品同步到各平台，建立销售基础（TOC）或生成报价单（TOB）。
流程：
1. 商品准备：
  - ERP 商品信息完善
  - 平台规则适配：标题、描述、图片、批量折扣（TOB）
  - 价格策略设置：基于套利分析或阶梯价策略
2. 刊登执行：
  - 批量或单条刊登，支持失败重试和全链路追踪
  - API 平台：走 Connector Bus
  - 无 API 平台：No-API Bridge + PENDING_REVIEW
3. 刊登后管理：
  - 库存同步、价格更新、商品状态监控
决策点：
- 必须通过前置套利/利润分析
- TOB 需遵循阶梯价审批策略
输入：清洗后的可售商品数据
输出：已刊登商品列表 + 平台状态 + 链接
💰 钱流：
- 刊登成本：平台费用、图片处理费用、人工费用
- 定价策略：成本价 → 平台费用 → 物流费用 → 预期利润 → 最终售价
🔄 状态变化：
- READY_FOR_LISTING → LISTING_IN_PROGRESS → LISTED → MONITORING → NEED_UPDATE → UPDATED
🔥 触发条件：
- 手动触发：用户手动发起刊登任务
- 事件触发：商品信息更新、价格变动、库存变动
- 定时任务：定期检查商品状态，更新价格和库存

目标：统一管理商品、广告、营销所需素材，支持 TOC 广告投放和 TOB 企业报价资料。
流程：
- 素材采集、处理、审核、分发
- TOC：图片/视频用于广告和商品展示
- TOB：商品资料、合同模板、报价单模板
决策点：
- 版权合规、平台规则、素材质量
输出：素材库 + 元数据 + 使用统计
状态机：UPLOADED → PROCESSING → PENDING_REVIEW → APPROVED → IN_USE → ARCHIVED/REJECTED