wurenzhi/makemd
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

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

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

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

chore: 更新依赖项和配置文件
This commit is contained in:
wurenzhi
2026-03-19 19:08:15 +08:00
parent 8de9ea0aaa
commit eafa1bbe94
203 changed files with 20240 additions and 39580 deletions
Download Patch File Download Diff File Expand all files Collapse all files

146
docs/00_Business/Business_ClosedLoops/01_Product.md Normal file
View File

@@ -0,0 +1,146 @@
# 01 商品域业务闭环
> 本文档包含与商品相关的业务闭环：数据采集、商品刊登、素材管理、商品主数据、SKU变体
---
## 1️⃣ 数据采集与清洗闭环（Product Data Collection & Cleansing）
- **💰 钱流**：
- 采集成本：API调用费用、代理IP费用、云服务费用
- 利润评估：采购成本 → 平台费用 → 物流费用 → 税费 → 广告费用 → 净利润
- **🔄 状态变化**：
- `RAW_DATA` → `CLEANED` → `ANALYZED` → `READY_FOR_LISTING`
- **🔥 触发条件**：
- 定时任务：按配置的采集频率自动触发
- 手动触发：用户手动发起采集任务
- 事件触发：商品价格变动、库存变动等事件触发重新采集
***
## 2️⃣ 商品刊登闭环（Product Listing Loop）
- **目标**：将可售商品同步到各平台，建立销售基础（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`
- **🔥 触发条件**：
- 手动触发：用户手动发起刊登任务
- 事件触发：商品信息更新、价格变动、库存变动
- 定时任务：定期检查商品状态，更新价格和库存
***
## 3️⃣ 素材管理闭环（Media & Asset Management Loop）
- **目标**：统一管理商品、广告、营销所需素材，支持 TOC 广告投放和 TOB 企业报价资料。
- **流程**：
- 素材采集、处理、审核、分发
- TOC：图片/视频用于广告和商品展示
- TOB：商品资料、合同模板、报价单模板
- **决策点**：
- 版权合规、平台规则、素材质量
- **输出**：素材库 + 元数据 + 使用统计
- **状态机**：`UPLOADED` → `PROCESSING` → `PENDING_REVIEW` → `APPROVED` → `IN_USE` → `ARCHIVED`/`REJECTED`
***
## 2️⃣3️⃣ 商品主数据闭环（Product Master Data Loop / MDM）
- **目标**：建立统一的商品主数据管理体系，确保数据一致性。
- **流程**：
- 数据采集 → 标准化处理 → 主数据维护 → 数据分发
- **决策点**：
- 数据标准制定
- 数据质量评估
- 数据同步策略
- **输入**：来自采集、供应链、刊登等闭环的商品数据
- **输出**：
- 统一 SPU/SKU 体系
- 标准化类目和属性结构
- 多语言支持
- 多平台映射关系
***
## 2️⃣4️⃣ SKU变体与结构闭环（SKU Variant & Structure Loop）
- **目标**：管理商品的变体和多平台SKU映射，确保库存和订单的一致性。
- **流程**：
- SPU创建 → SKU生成 → 平台SKU映射 → 同步管理
- **决策点**：
- 变体属性定义
- 多平台SKU规则适配
- 库存同步策略
- **输入**：商品主数据、平台SKU规则
- **输出**：
- 多SKU结构（颜色/尺寸/套装）
- 各平台SKU映射
- 统一库存管理
***
## 相关KPI
### 数据采集与清洗闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 采集覆盖率 | 目标平台商品覆盖率 | TOC + TOB |
| 数据准确率 | 清洗后数据的准确性 | TOC + TOB |
| 套利分析准确率 | 前置套利计算的准确性 | TOC + TOB |
### 商品刊登闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 刊登成功率 | 成功刊登的商品比例 | TOC + TOB |
| 刊登时效 | 从准备到刊登完成的时间 | TOC + TOB |
| 平台审核通过率 | 平台审核通过的商品比例 | TOC + TOB |
### 素材管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 素材处理时效 | 从上传到可用的平均时间 | TOC + TOB |
| 素材审核通过率 | 通过审核的素材比例 | TOC + TOB |
| 素材转化率 | 使用素材带来的订单转化率 | TOC + TOB |
| 素材复用率 | 被多次使用的素材比例 | TOC + TOB |
| 版权合规率 | 无版权风险的素材比例 | TOC + TOB |
### 商品主数据闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------ | --------- |
| 数据标准化率 | 标准化处理的商品数据比例 | TOC + TOB |
| 数据一致性 | 多平台数据一致性程度 | TOC + TOB |
| 主数据准确率 | 商品主数据的准确性 | TOC + TOB |
| 数据同步时效 | 数据从采集到同步的时间 | TOC + TOB |
| 数据质量评分 | 商品数据质量综合评分 | TOC + TOB |
### SKU变体与结构闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ------------ | --------- |
| SKU映射准确率 | 多平台SKU映射的准确性 | TOC + TOB |
| SKU生成时效 | SKU生成的平均时间 | TOC + TOB |
| 变体管理效率 | 变体属性管理的效率 | TOC + TOB |
| 库存同步准确率 | 多SKU库存同步的准确性 | TOC + TOB |

130
docs/00_Business/Business_ClosedLoops/02_Order.md Normal file
View File

@@ -0,0 +1,130 @@
# 02 订单域业务闭环
> 本文档包含与订单处理相关的业务闭环：订单履约、售后逆向、订单集中管理、订单拆分合并、异常订单处理
---
## 5️⃣ 订单履约闭环（Order Fulfillment Loop / OMS）
- **目标**：保证订单从生成到妥投的全链路履约。
- **流程**：
- **公共流程**：订单获取与审核 → 分仓 → 占库 → 扣库 → 发货 → 物流追踪
- **TOC**：标准订单处理流程
- **TOB**：大额企业订单可分批发货、合同条款优先
- **状态机**：`PULLED` → `PENDING_REVIEW` → `CONFIRMED` → `ALLOCATED` → `READY_TO_SHIP` → `SHIPPED` → `DELIVERED` → `CLOSED`
- **输入**：平台订单数据
- **输出**：已发货订单，包含物流跟踪信息
***
## 6️⃣ 售后逆向闭环（Returns & Refunds Loop）
- **目标**：处理退货/退款，保持库存和财务一致。
- **流程**：
- **公共流程**：售后请求处理 → 退货处理 → 退款处理
- **TOC**：标准退货流程
- **TOB**：按合同条款、批量退货、预付款冲抵
- **输入**：售后请求数据
- **输出**：处理完成的售后记录，包含库存和财务调整
***
## 1️⃣8️⃣ 订单集中管理闭环（Order Centralized Management Loop）
- **目标**：跨平台订单统一抓取、集中展示和管理，支持 TOC/TOB 订单流转。
- **流程**：
1. **多平台订单采集**
- 支持 TikTok、Shopee、Temu 等平台订单抓取
- 通过 API 或自动化脚本采集
2. **订单集中展示**
- 产品信息：名称、数量、实收价格、订单时间、状态
- 支持平台/客户/品类/订单状态筛选
- 可选漏斗分析：订单流转、发货完成率
3. **订单状态管理**
- 状态流转：`available → requested → shipped → completed`
- 订单分配与跟踪
- **决策点**：
- 订单抓取频率
- 订单优先级设置
- 异常订单处理策略
- **输入**：
- 多平台订单数据
- 店铺信息
- 客户/商家信息
- **输出**：
- 集中管理的订单数据
- 订单状态报告
- 异常订单标记
***
## 2️⃣5️⃣ 订单拆分与合并闭环（Order Split & Merge Loop）
- **目标**：处理多仓发货、多订单合并、部分缺货等场景，优化物流成本和时效。
- **流程**：
- 订单分析 → 拆分/合并决策 → 子订单生成 → 履约执行
- **决策点**：
- 拆分类型（仓/SKU/库存）
- 合并条件
- 优先级策略
- **输入**：订单数据、库存状态、物流成本
- **输出**：
- 子订单
- 合并订单
- 物流方案
***
## 2️⃣6️⃣ 异常订单处理闭环（Exception Order Handling Loop）
- **目标**：处理地址错误、海关卡单、物流丢件、无法发货等履约异常。
- **流程**：
- 异常检测 → 分类处理 → 解决方案执行 → 结果反馈
- **决策点**：
- 异常类型识别
- 处理优先级
- 人工介入条件
- **输入**：订单数据、物流状态、异常事件
- **输出**：
- 异常处理结果
- 售后触发
- 风控预警
***
## 相关KPI
### 订单履约闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 订单处理时效 | 从订单生成到发货的时间 | TOC + TOB |
| 发货准确率 | 正确发货的订单比例 | TOC + TOB |
| 妥投率 | 成功送达的订单比例 | TOC + TOB |
| 分批处理率 | 大额订单分批处理的比例 | TOB |
### 售后逆向闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 售后处理时效 | 从售后请求到处理完成的时间 | TOC + TOB |
| 退款成功率 | 成功退款的比例 | TOC + TOB |
| 退货率 | 退货订单占总订单的比例 | TOC + TOB |
### 订单拆分与合并闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | -------------- | --------- |
| 拆分/合并准确率 | 订单拆分/合并的准确性 | TOC + TOB |
| 拆分/合并时效 | 订单拆分/合并的处理时间 | TOC + TOB |
| 物流成本优化率 | 拆分/合并带来的物流成本节约 | TOC + TOB |
| 客户满意度 | 拆分/合并订单的客户满意度 | TOC + TOB |
### 异常订单处理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------ | --------- |
| 异常处理率 | 成功处理的异常订单比例 | TOC + TOB |
| 异常处理时效 | 异常订单处理的平均时间 | TOC + TOB |
| 异常解决率 | 成功解决的异常订单比例 | TOC + TOB |
| 客户满意度 | 异常订单处理的客户满意度 | TOC + TOB |

57
docs/00_Business/Business_ClosedLoops/03_Marketing.md Normal file
View File

@@ -0,0 +1,57 @@
# 03 营销域业务闭环
> 本文档包含与营销推广相关的业务闭环：广告计划与营销、A/B测试与策略优化
---
## 4️⃣ 广告计划与营销闭环（Marketing & Ad Management Loop）
- **目标**：提升销量和 ROI（TOC）或企业促销效率（TOB）。
- **流程**：
- 广告计划制定、跨平台投放、效果分析与优化
- TOB：批量报价、促销方案、邮件/企业营销
- **决策点**：
- 广告 ROI < 1 停止投放
- 企业营销需基于信用等级和合同审批
- **输入**：已刊登商品列表、素材
- **输出**：广告报告、优化建议
***
## 3️⃣0️⃣ A/B测试与策略优化闭环（A/B Testing & Strategy Optimization Loop）
- **目标**：通过实验验证和数据驱动，持续优化业务策略。
- **流程**：
- 测试设计 → 实验执行 → 数据收集 → 结果分析 → 策略调整
- **决策点**：
- 测试假设设定
- 样本量确定
- 显著性水平设定
- **输入**：广告策略、商品定价、页面设计、营销文案
- **输出**：
- 测试结果分析
- 策略优化建议
- 最优方案推荐
***
## 相关KPI
### 广告计划与营销闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | -------------- | ------ |
| 广告 ROI | 广告投入产出比 | TOC |
| 点击率（CTR） | 广告点击次数与展示次数的比率 | TOC |
| 转化率（CVR） | 点击广告后产生订单的比例 | TOC |
| 企业营销效果 | 企业营销活动的转化率 | TOB |
### A/B测试与策略优化闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 测试执行效率 | 测试从设计到完成的时间 | TOC + TOB |
| 测试结果显著性 | 测试结果的统计显著性 | TOC + TOB |
| 策略优化效果 | 优化后业务指标的改善程度 | TOC + TOB |
| 测试覆盖率 | 覆盖的业务策略比例 | TOC + TOB |
| 决策支持准确率 | 测试结果对决策的支持程度 | TOC + TOB |

96
docs/00_Business/Business_ClosedLoops/04_Finance.md Normal file
View File

@@ -0,0 +1,96 @@
# 04 财务域业务闭环
> 本文档包含与财务相关的业务闭环：资金对账、回款与财务、利润核算、支付与结算
---
## 7️⃣ 资金对账闭环（Finance Reconciliation Loop）
- **目标**：财务闭环，兼顾 TOC/TOB。
- **流程**：
- 数据汇总 → 财务处理（多币种、VAT、汇率） → 差异分析与处理
- **决策点**：
- 异常需人工复核
- TOB 账期和信用额度影响结算
- **输出**：对账报告 + 差异处理记录
***
## 2️⃣1️⃣ 回款与财务闭环（Payment & Financial Reconciliation Loop）
- **目标**：管理客户付款、押金抵扣、回款记录和提现，确保财务透明。
- **流程**：
1. **收款管理**
- 客户付款到店铺账户或系统自动扣押金/余额
2. **财务流水记录**
- 类型（押金/回款/提现）、金额、订单ID、状态
- 状态流转：`pending → approved → completed`
3. **财务对账**
- 店铺收入 ↔ 客户账户余额
- 异常订单/回款标记 → 自动或人工处理
- **决策点**：
- 回款确认机制
- 对账频率
- 异常处理流程
- **输入**：
- 客户付款信息
- 订单数据
- 押金/余额状态
- **输出**：
- 财务流水记录
- 对账结果
- 提现处理结果
***
## 2️⃣8️⃣ 利润核算闭环（Profit Calculation Loop）
- **目标**：精确计算真实利润，支持定价和决策优化。
- **流程**：
- 成本汇总 → 收入匹配 → 利润计算 → 分析报告
- **决策点**：
- 成本分摊规则
- 汇率处理
- 利润阈值设定
- **输入**：商品成本、运费、广告费、平台佣金、税费、汇率数据
- **输出**：
- 订单级利润
- 商品级利润
- 店铺级利润
- 利润分析报告
***
## 6️⃣3️⃣ 支付与结算系统闭环（Payment & Settlement System Loop）
- **目标**：管理支付流程和商户结算，确保财务透明。
- **流程**：
1. **支付管理**：支付网关集成、支付流程、退款处理
2. **账单与结算**：账单生成、结算周期、结算流程、税务处理
- **决策点**：
- 支付方式选择
- 结算周期设置
- **输入**：订单数据、支付信息、商户信息
- **输出**：支付记录、账单、结算结果
***
## 相关KPI
### 资金对账闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 对账准确率 | 对账差异率 | TOC + TOB |
| 对账时效 | 从数据汇总到对账完成的时间 | TOC + TOB |
| 异常处理率 | 需要人工处理的异常比例 | TOC + TOB |
| 账期遵守率 | 按合同约定账期结算的比例 | TOB |
### 利润核算闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 利润计算准确率 | 利润计算的准确性 | TOC + TOB |
| 利润核算时效 | 利润核算的平均时间 | TOC + TOB |
| 成本分摊准确性 | 成本分摊的准确性 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的订单比例 | TOC + TOB |

58
docs/00_Business/Business_ClosedLoops/05_Inventory.md Normal file
View File

@@ -0,0 +1,58 @@
# 05 库存域业务闭环
> 本文档包含与库存仓储相关的业务闭环：库存与仓储管理、海外仓/本土仓
---
## 8️⃣ 库存与仓储管理闭环（Inventory & Warehouse Management Loop / WMS）
- **目标**：确保库存准确、仓储高效，支持全球供应链运作。
- **流程**：
- **公共流程**：多仓库存管理 → 进出库管理 → 物流模式管理
- **TOC**：按店铺和平台库存管理
- **TOB**：按企业订单、批量调拨、FCL/3PL 管理
- **决策点**：
- 库存不足时触发补货建议
- 跨仓调拨决策：基于成本和时效
- 安全库存预警阈值设置
- **输入**：订单数据、采购数据、物流数据
- **输出**：实时库存状态、仓储操作记录、库存预警
***
## 2️⃣2️⃣ 海外仓/本土仓 & 多品类支持闭环（Overseas/Local Warehouse & Multi-Category Support Loop）
- **目标**：统一管理海外仓和本土仓库存，支持多品类分配和上下游分析。
- **流程**：
1. **库存管理**
- 海外仓和本土仓库存统一管理
- 可按品类、仓库位置、时效性分配发货
2. **上下游分析**
- 供应商价格对比
- 成本/利润/ROI 分析
- 同行发货/库存策略参考
- **决策点**：
- 仓库选择策略
- 品类分配规则
- 供应链优化策略
- **输入**：
- 仓库库存数据
- 供应商信息
- 订单数据
- **输出**：
- 库存分配方案
- 供应链分析报告
- 成本优化建议
***
## 相关KPI
### 库存与仓储管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 库存准确率 | 系统库存与实际库存的差异率 | TOC + TOB |
| 库存周转率 | 库存周转次数 | TOC + TOB |
| 仓储操作效率 | 每单处理时间 | TOC + TOB |
| 跨仓调拨时效 | 调拨完成时间 | TOC + TOB |

58
docs/00_Business/Business_ClosedLoops/06_SupplyChain.md Normal file
View File

@@ -0,0 +1,58 @@
# 06 供应链域业务闭环
> 本文档包含与供应链相关的业务闭环：供应链与供应商管理、物流策略与渠道选择
---
## 9️⃣ 供应链与供应商管理闭环（Supply Chain & Supplier Management Loop）
- **目标**：优化供应链流程，降低采购成本，确保供应稳定。
- **流程**：
- **公共流程**：供应商管理 → 采购管理 → 补货建议
- **TOC**：基于零售需求的采购计划
- **TOB**：基于大宗订单生成采购计划
- **决策点**：
- 供应商选择：基于综合评分
- 采购价格：低于成本价预警
- 补货时机：库存周转率优化
- **输入**：销售数据、库存数据、供应商数据
- **输出**：采购计划、供应商评估报告、成本节省分析
***
## 2️⃣7️⃣ 物流策略与渠道选择闭环（Logistics Strategy & Channel Selection Loop）
- **目标**：基于成本、时效和可靠性，选择最优物流方案。
- **流程**：
- 订单分析 → 物流渠道评估 → 方案选择 → 执行监控
- **决策点**：
- 仓选择
- 物流方式（空运/海运/快递）
- 渠道选择
- **输入**：订单数据、库存分布、物流成本、时效要求
- **输出**：
- 物流渠道选择
- 成本估算
- 时效承诺
***
## 相关KPI
### 供应链与供应商管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | --------- | --------- |
| 供应商准时交付率 | 按时交付的订单比例 | TOC + TOB |
| 采购成本降低率 | 采购成本下降百分比 | TOC + TOB |
| 供应商评分 | 供应商综合评估分数 | TOC + TOB |
| 补货准确率 | 补货计划的准确性 | TOC + TOB |
### 物流策略与渠道选择闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 物流成本节约率 | 物流成本节约的比例 | TOC + TOB |
| 物流时效达标率 | 按时送达的订单比例 | TOC + TOB |
| 渠道选择准确率 | 物流渠道选择的准确性 | TOC + TOB |
| 物流跟踪覆盖率 | 可跟踪的物流订单比例 | TOC + TOB |

29
docs/00_Business/Business_ClosedLoops/07_B2BTrade.md Normal file
View File

@@ -0,0 +1,29 @@
# 07 B2B贸易域业务闭环
> 本文档包含B2B/TOB特有的业务闭环：B2B贸易管理
---
## 🔟 B2B / TOB 贸易管理闭环（B2B / TOB Trade Management Loop）
- **目标**：企业间交易管理
- **流程**：
- 报价管理、信用管理、询盘转订单
- **决策点**：
- 利润率 < 15% 禁止报价
- 大额订单多级审批
- 低信用等级客户需预付款
- **输出**：报价单、B2B 订单、信用评估报告
***
## 相关KPI
### B2B / TOB 贸易管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | ------ |
| B2B 利润率 | B2B 业务的利润率 | TOB |
| 报价通过率 | 报价被客户接受的比例 | TOB |
| 信用违约率 | 客户信用违约的比例 | TOB |
| 询盘转化率 | 询盘转化为订单的比例 | TOB |

169
docs/00_Business/Business_ClosedLoops/08_Merchant.md Normal file
View File

@@ -0,0 +1,169 @@
# 08 商户域业务闭环
> 本文档包含与多商户管理相关的业务闭环：多商户入驻、商户店铺、多商户订单、多商户库存、多商户结算、商户权限、商户数据
---
## 3️⃣1️⃣ 多商户入驻与认证闭环（Merchant Registration & Authentication Loop）
- **目标**：支持多商户入驻、资质认证、店铺创建，实现平台化运营。
- **流程**：
1. **商户注册**：
- 商户自助注册（邮箱/手机/企业信息）
- 资质文件上传（营业执照、法人身份证等）
- 账户类型选择（企业/个人）
- 初始密码设置和安全验证
2. **资质认证**：
- 自动审核 + 人工复核
- 企业信息验证、信用检查
- 行业资质合规检查
- 审核进度实时更新
3. **店铺创建**：
- 店铺基础信息配置（名称、LOGO、描述）
- 绑定平台店铺（Amazon、Shopee等）
- 支付账户配置（收款方式、结算周期）
- 店铺运营设置（退换货政策、客服信息）
4. **权限分配**：
- 初始角色设置（管理员、运营、财务）
- 权限范围配置（可访问模块、操作权限）
- 数据隔离设置（商户级数据隔离）
- **决策点**：
- 资质审核标准（行业合规、信用评级）
- 商户等级划分（普通/优质/战略）
- 入驻门槛设置（不同等级商户的要求）
- 审核通过/拒绝的条件和流程
- **输入**：商户注册信息、资质文件、企业证明
- **输出**：商户ID、认证状态、店铺ID、权限配置
- **状态机**：`SUBMITTED` → `PENDING_REVIEW` → `APPROVED`/`REJECTED` → `ACTIVE`
***
## 3️⃣2️⃣ 商户店铺管理闭环（Merchant Store Management Loop）
- **目标**：支持商户管理自己的商品、库存、促销活动。
- **流程**：
1. 商户创建店铺或子店铺。
2. 前端提供商品管理界面（新增、编辑、上下架）。
3. 后端管理库存、价格、SKU、分类。
4. 支持商户自定义促销规则（折扣、满减、优惠券）。
- **决策点**：
- 库存不足 → 阻止下架或自动提醒。
- 促销策略冲突 → 系统自动合并或提示调整。
- **输入**：商户店铺信息、商品信息
- **输出**：管理的店铺和商品数据
- **状态机**：`CREATED` → `CONFIGURING` → `ACTIVE` → `INACTIVE`
***
## 3️⃣3️⃣ 多商户订单闭环（Multi-Merchant Order Loop）
- **目标**：支持多个商户订单独立处理，同时平台统一监控。
- **流程**：
1. 客户下单 → 系统拆分订单至各商户。
2. 前端商户端显示新订单 → 可确认、拒单、修改发货信息。
3. 后端记录订单状态（待处理、已发货、完成、异常）。
4. 平台监控整体订单履约情况。
- **决策点**：
- 商户拒单 → 系统可触发退款或自动分配给其他商户。
- 超时未处理 → 系统提醒或自动处理。
- **输入**：客户订单数据
- **输出**：拆分后的商户子订单，包含状态更新
- **状态机**：`PENDING` → `ACCEPTED` → `SHIPPED` → `COMPLETED` → `REFUNDED`
***
## 3️⃣4️⃣ 多商户库存同步闭环（Multi-Merchant Inventory Sync Loop）
- **目标**：确保平台和商户端库存实时同步。
- **流程**：
1. 商户上传库存信息（API/手动）。
2. 平台统一汇总并分发给前端展示。
3. 当客户下单 → 自动扣减对应商户库存。
- **决策点**：
- 库存不足 → 阻止下单或显示缺货。
- 库存异常 → 系统报警。
- **输入**：商户库存数据、订单数据
- **输出**：实时同步的库存状态
- **状态机**：`SYNCED` → `UPDATING` → `SYNCED` → `ERROR`
***
## 3️⃣5️⃣ 多商户结算与财务闭环（Multi-Merchant Settlement & Finance Loop）
- **目标**：自动计算商户收入、平台佣金、手续费及结算周期。
- **流程**：
1. 后端计算订单收入、退款、佣金分成。
2. 系统生成结算账单 → 商户可查询。
3. 支持多结算方式（银行、电子钱包）。
4. 自动发起付款（周期结算或即时结算）。
- **决策点**：
- 异常订单 → 暂停结算并标记。
- 多币种结算 → 汇率实时更新。
- **输入**：订单数据、支付数据
- **输出**：结算账单、付款记录
- **状态机**：`PENDING` → `CALCULATED` → `APPROVED` → `PAID`
***
## 3️⃣6️⃣ 商户权限与角色闭环（Merchant Roles & Permissions Loop）
- **目标**：控制商户内部操作权限，支持多角色管理。
- **流程**：
1. 商户创建角色（管理员、仓库、客服等）。
2. 后端配置每个角色的访问权限。
3. 前端动态显示可操作模块。
- **决策点**：
- 权限冲突 → 系统提示。
- 异常操作 → 记录日志和告警。
- **输入**：商户角色配置
- **输出**：权限配置，访问控制
***
## 3️⃣7️⃣ 商户数据与分析闭环（Merchant Analytics & Reporting Loop）
- **目标**：提供独立商户数据分析，同时平台可汇总整体业务指标。
- **流程**：
1. 后端收集订单、流量、库存、评价数据。
2. 生成商户专属数据报表和趋势分析。
3. 平台可生成多商户对比分析。
- **决策点**：
- 数据异常 → 自动报警。
- 需要合规报表 → 自动生成符合财务/税务规范的报表。
- **输入**：商户业务数据
- **输出**：商户报表、平台分析报告
- **状态机**：`RAW` → `PROCESSED` → `GENERATED` → `DISTRIBUTED`
***
## 相关KPI
### 多商户入驻与认证闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 入驻转化率 | 注册到入驻成功的比例 | TOC + TOB |
| 资质审核时效 | 资质审核的平均时间 | TOC + TOB |
| 认证通过率 | 通过认证的商户比例 | TOC + TOB |
| 店铺绑定成功率 | 成功绑定平台店铺的比例 | TOC + TOB |
| 商户活跃度 | 商户月活跃比例 | TOC + TOB |
### 多商户结算与财务闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | --------- | --------- |
| 结算准确率 | 结算金额的准确性 | TOC + TOB |
| 结算时效 | 从交易到结算的时间 | TOC + TOB |
| 分润准确率 | 分润计算的准确性 | TOC + TOB |
| 提现成功率 | 提现申请成功的比例 | TOC + TOB |
| 对账差异率 | 财务对账的差异比例 | TOC + TOB |
### 功能模块化与权限控制闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ---------- | --------- |
| 模块使用率 | 各功能模块的使用比例 | TOC + TOB |
| 权限配置准确率 | 权限配置的准确性 | TOC + TOB |
| 数据隔离有效性 | 数据隔离的成功率 | TOC + TOB |
| 功能开关响应时效 | 功能开关生效的时间 | TOC + TOB |
| 配额利用率 | 商户使用配额的比例 | TOC + TOB |

223
docs/00_Business/Business_ClosedLoops/09_Platform.md Normal file
View File

@@ -0,0 +1,223 @@
# 09 平台基础域业务闭环
> 本文档包含平台基础功能相关的业务闭环：治理与审批、功能模块化、功能开通、用户/客户资产、客户服务、货币管理、Operation-Agent
---
## 1️⃣1️⃣ 治理与审批中心闭环（Governance & Approval Center Loop）
- **目标**：敏感操作审批
- **适用**：
- TOC：大额订单、价格变动、退款
- TOB：大额企业订单、阶梯价审批、信用审批
- **输出**：审批结果、审计日志
***
## 3️⃣9️⃣ 功能模块化与权限控制闭环（Feature Modularization & Permission Control Loop）
- **目标**：将系统功能模块化，支持按商户收费，精细化权限控制。
- **流程**：
1. **功能模块定义**：
- 基础功能（商品管理、订单管理）
- 增值功能（广告投放、数据分析）
- 高级功能（API对接、定制化开发）
2. **模块配置**：
- 功能开关控制
- 使用配额限制
- 计费规则配置
3. **权限体系**：
- 角色定义（管理员、运营、财务等）
- 细粒度权限分配
- 数据隔离（租户/商户/店铺）
- **决策点**：
- 模块定价策略
- 权限继承规则
- 数据隔离级别
- **输入**：商户ID、功能需求、角色配置
- **输出**：功能模块列表、权限配置、数据隔离规则
***
## 4️⃣0️⃣ 功能开通与支付闭环（Feature Activation & Payment Loop）
- **目标**：商户选购功能模块、支付费用、开通服务。
- **流程**：
1. **功能选购**：
- 展示功能模块和价格
- 选择订阅周期（月/季/年）
- 选择配套服务（培训、技术支持）
2. **费用计算**：
- 基础费用 + 增值服务费用
- 使用量计费（订单数、商品数等）
- 优惠活动计算
3. **支付流程**：
- 在线支付（支付宝、微信、银行卡）
- 账户余额扣款
- 发票开具
4. **服务开通**：
- 支付成功后自动开通
- 配置生效通知
- 服务期开始计时
- **决策点**：
- 支付方式选择
- 发票类型（普通/增值税）
- 续费提醒策略
- **输入**：商户ID、选购功能、支付方式
- **输出**：开通记录、支付凭证、服务状态
***
## 2️⃣9️⃣ 用户/客户资产闭环（User/Customer Asset Loop）
- **目标**：沉淀和管理用户资产，支持精准营销和客户价值提升。
- **流程**：
- 数据采集 → 用户画像构建 → 行为分析 → 资产运营
- **决策点**：
- 用户分层策略
- 营销触达规则
- 客户价值评估
- **输入**：订单数据、浏览行为、购买历史、售后记录
- **输出**：
- 用户画像
- 复购行为分析
- 国家偏好分析
- 客户价值评估
- 营销建议
***
## 4️⃣7️⃣ 客户服务闭环（Customer Service Loop）
- **目标**：提供高效、专业的客户服务，解决客户问题，提升客户满意度。
- **流程**：
1. **客户咨询处理**：
- 咨询接收与分类
- 智能客服响应
- 人工客服介入
2. **争议与投诉处理**：
- 争议接收与评估
- 证据收集与分析
- 解决方案制定与执行
3. **售后服务**：
- 退货退款处理
- 产品质量问题处理
- 售后跟踪与反馈
4. **客户反馈管理**：
- 反馈收集与分析
- 改进建议生成
- 服务质量评估
- **决策点**：
- 争议类型识别与处理策略
- 退款审批与执行
- 服务质量评估与改进
- **输入**：客户咨询、争议信息、售后请求、客户反馈
- **输出**：服务响应、争议解决方案、售后处理结果、客户满意度报告
***
## 7️⃣0️⃣ 货币管理与多币种支持闭环（Currency Management & Multi-Currency Support Loop）
- **目标**：构建完整的多币种支持体系，实现全球业务的货币管理、汇率转换和本地化显示。
- **支持货币**：
- 主流货币：USD、CNY、EUR、GBP、JPY、KRW、CAD、AUD、SGD
- 区域货币：RUB、BRL、INR、TRY、THB、MYR、IDR等
- **流程**：
1. **货币管理**：
- 货币信息维护：货币代码、名称、符号、小数位数
- 汇率管理：汇率获取、更新、缓存、历史记录
- 货币设置：默认货币、显示偏好、转换规则
2. **货币转换**：
- 实时转换：基于最新汇率
- 历史转换：基于特定日期汇率
- 批量转换：支持多笔金额同时转换
3. **货币显示**：
- 本地化显示：根据地区习惯显示货币
- 多格式支持：货币符号位置、千位分隔符、小数位数
4. **多场景应用**：
- 报表场景：多货币切换、汇率选择
- 定价场景：平台本地货币、目标市场货币
- 分析场景：基准货币、多货币对比
- **决策点**：
- 货币支持范围和优先级
- 汇率更新频率和数据源选择
- 货币显示格式和本地化策略
- **输入**：货币基础信息、汇率数据、用户货币偏好、业务数据
- **输出**：多货币显示数据、货币转换结果、汇率历史记录
- **状态机**：`CURRENCY_CREATED` → `EXCHANGE_RATE_UPDATED` → `CONVERSION_PERFORMED` → `DISPLAY_FORMATTED`
***
## 7️⃣1️⃣ Operation-Agent 管理闭环（Operation-Agent Management Loop）
- **目标**：统一管理多平台跨境店铺，实现数据聚合、订单管理、商品同步、价格控制和报表分析闭环。
- **流程**：
1. **店铺绑定**：
- 选择平台 → 提交认证信息 → 平台授权 → 店铺信息同步 → 校验与状态更新 → 测试同步
2. **商品管理**：
- 商品抓取：自动或手动同步平台商品信息
- 上架/下架：可选择单个平台操作或全平台同步
- 商品信息修改：价格、库存、标题、描述、图片统一管理
3. **订单管理**：
- 订单抓取：按时间/状态抓取多平台订单
- 订单处理：统一查看、标记发货、取消、退款
- 订单回写：状态更新自动同步至各平台
4. **库存与价格管理**：
- 库存同步：实时或定时同步各平台库存
- 价格管理：支持统一定价、浮动定价、AI推荐价格
5. **报表与分析**：
- 商品报表：库存、销量、价格变动历史
- 订单报表：各平台销售汇总、退货率、利润计算
- AI分析：定价建议、套利机会、热销商品推荐
- **决策点**：
- 平台选择：根据业务需求选择合适的跨境电商平台
- 绑定策略：API、插件或Node-Agent接入方式
- 定价策略：基于成本、市场和竞争情况
- **输入**：平台认证信息、商品数据、订单数据、库存数据、成本数据
- **输出**：聚合店铺管理界面、统一的商品/订单/库存数据、分析报表和AI决策建议
- **状态变化**：
- 店铺绑定：`PENDING` → `AUTHORIZING` → `SYNCHRONIZING` → `ACTIVE` / `FAILED`
- 商品管理：`RAW` → `SYNCHRONIZED` → `UPDATED`
- 订单管理：`PULLED` → `PROCESSED` → `SHIPPED` → `COMPLETED`
***
## 相关KPI
### 治理与审批中心闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 审批时效 | 从申请到审批完成的时间 | TOC + TOB |
| 审批准确率 | 审批结果的准确性 | TOC + TOB |
| 待办处理率 | 待办事项的处理比例 | TOC + TOB |
### 功能开通与支付闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 支付成功率 | 支付成功的比例 | TOC + TOB |
| 开通时效 | 从支付到开通的时间 | TOC + TOB |
| 续费率 | 功能到期后续费的比例 | TOC + TOB |
| 退款率 | 申请退款的比例 | TOC + TOB |
| 发票开具及时率 | 发票按时开具的比例 | TOC + TOB |
### 用户/客户资产闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------- | --------- |
| 用户画像准确率 | 用户画像与实际行为的匹配度 | TOC + TOB |
| 客户价值提升率 | 客户平均价值增长比例 | TOC + TOB |
| 复购率 | 客户重复购买比例 | TOC + TOB |
| 客户留存率 | 客户持续活跃的比例 | TOC + TOB |
| 营销转化率 | 营销活动的转化效果 | TOC + TOB |
### Operation-Agent 管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ------------- | --------- |
| 店铺绑定成功率 | 成功绑定的店铺比例 | TOC + TOB |
| 数据同步时效 | 数据同步完成的平均时间 | TOC + TOB |
| 平台覆盖度 | 已绑定平台占目标平台的比例 | TOC + TOB |
| 操作成功率 | 成功执行的操作比例 | TOC + TOB |
| 异常处理率 | 自动处理的异常比例 | TOC + TOB |

322
docs/00_Business/Business_ClosedLoops/10_AI_Automation.md Normal file
View File

@@ -0,0 +1,322 @@
# 10 AI与自动化域业务闭环
> 本文档包含AI驱动和自动化相关的业务闭环：AI驱动智能决策、自动选品+上架、AI店铺托管、AI动态定价、跨平台套利、策略市场
---
## 4️⃣9️⃣ AI驱动智能决策闭环（AI-Driven Smart Decision Loop）
- **目标**：利用AI技术提升运营效率和决策准确性，实现"AI主导决策 + 人类验证 + 操作执行 + 日志记录"的智能化运营。
- **核心理念**：
- **AI建议为主**：AI生成策略、推荐操作、人类只作为参考或最终确认
- **人类介入可控**：前期可高干预，AI越强介入越低，最后趋近于完全自动
- **操作可追踪**：每次AI建议、用户操作和系统执行都要有LOG，保证可审计性
- **节点化设计**：每个决策动作是一个节点，节点间用逻辑流连接，自动推进
- **数据驱动**：每个节点依赖历史数据 + 实时数据来生成建议
### 节点类型定义
| 节点类型 | 功能 | 输入数据 | 输出数据 |
| --------------------------------- | ---------------- | ---------------------- | --------------------- |
| **决策节点（Decision Node）** | AI 根据数据生成建议或选择动作 | 历史数据、实时数据、外部数据 | JSON动作方案 + 置信度 + 风险等级 |
| **条件节点（Condition Node）** | 根据规则或状态判断执行路径 | 决策节点输出 + 实时数据 | 执行路径（自动执行/人工确认/阻止执行） |
| **执行节点（Action Node）** | 调用 API、脚本或系统操作 | 确认后的动作方案 | 执行状态（成功/失败） |
| **人工确认节点（Human Approval Node）** | 人类对 AI 建议进行修改或确认 | 决策节点输出 + 条件判断结果 + 数据参考 | 最终动作方案 |
| **日志节点（Log Node）** | 记录整个节点数据、结果 | 所有节点输入输出 | 日志记录（唯一ID，全链路追踪） |
### 完整节点流程
```
[输入数据] → [AI决策节点] → [条件判断节点] → [人工确认节点] → [执行节点]
↓
[日志节点] → [历史数据更新节点] → [报表分析节点] → [优化反馈节点] → 回到 [AI决策节点]
```
### 自动化程度演进
| 阶段 | AI角色 | 人类角色 | 说明 |
| ------ | ---------- | ----- | ----------------- |
| **初期** | 建议生成 | 审核确认 | 人工操作占主导 |
| **中期** | 自动执行（高置信度） | 异常处理 | 对置信度高、低风险的操作可自动执行 |
| **后期** | 全链路决策 | 仅异常介入 | AI全链路决策 + 自动执行 |
- **决策点**：
- 模型选择（监督学习vs无监督学习）
- 预测结果置信度阈值
- 人工干预时机
- 模型更新频率
- 自动执行阈值设定
- **输入**：业务数据、市场数据、用户行为数据
- **输出**：智能决策建议、预测结果、优化方案、执行日志
- **状态机**：`DATA_COLLECTION` → `AI_SUGGESTION` → `HUMAN_REVIEW` → `EXECUTION` → `LOGGING` → `FEEDBACK`
***
## 5️⃣2️⃣ 策略市场（Strategy Marketplace Loop）
- **目标**：AI赚钱能力商品化，实现功能收费闭环
- **流程**：
1. **策略创建**：
- 策略类型定义（广告/定价/选品）
- 策略配置schema
- 策略定价模式
- 策略ROI预估
2. **策略发布**：
- 策略审核
- 策略上架
- 策略分类
3. **策略推荐**：
- 基于商户数据推荐
- 基于ROI推荐
- 基于使用场景推荐
4. **策略激活**：
- 商户选择策略
- 权限验证
- 费用扣除
- 策略激活
5. **策略使用**：
- 策略执行
- 使用记录
- 效果追踪
- ROI计算
6. **策略优化**：
- 使用次数统计
- ROI统计
- 策略调整
- **决策点**：
- 策略定价策略
- 策略推荐算法
- 策略使用权限
- **输入**：策略配置、商户数据、使用记录
- **输出**：策略列表、推荐策略、激活状态、使用统计
- **状态机**：`STRATEGY_CREATION` → `STRATEGY_PUBLISH` → `STRATEGY_RECOMMENDATION` → `STRATEGY_ACTIVATION` → `STRATEGY_USAGE` → `STRATEGY_OPTIMIZATION`
***
## 5️⃣3️⃣ 自动选品+自动上架系统（增长引擎）（Auto Product Selection & Listing Loop）
- **目标**：自动找到赚钱商品 → 自动卖，实现自动化增长
- **流程**：
1. **商品采集**：
- 多平台商品采集（1688/Amazon/TikTok）
- 商品数据清洗
- 商品数据标准化
2. **商品池管理**：
- 商品入库
- 商品分类
- 商品去重
3. **AI选品**：
- 商品评分计算
- ROI预估
- 市场需求分析
- 竞争度分析
4. **选品决策**：
- ROI阈值判断
- 评分阈值判断
- 预算范围判断
5. **自动上架**：
- 创建商品任务
- 商品定价
- 平台同步
6. **效果追踪**：
- 销售数据追踪
- ROI计算
- 选品效果评估
- **决策点**：
- 选品算法参数
- ROI阈值设定
- 预算范围设定
- 自动上架策略
- **输入**：平台商品数据、选品配置、预算范围
- **输出**：选中商品、上架商品、效果报告
- **状态机**：`PRODUCT_COLLECTION` → `PRODUCT_POOL_MANAGEMENT` → `AI_SELECTION` → `SELECTION_DECISION` → `AUTO_LISTING` → `EFFECT_TRACKING`
***
## 5️⃣4️⃣ AI店铺托管（AutoPilot Loop）
- **目标**：替用户运营店铺，实现全自动运营
- **流程**：
1. **托管配置**：
- 策略选择（选品/定价/广告）
- 预算设置
- 风险控制
- 托管范围设定
2. **托管启动**：
- 权限验证
- 资源分配
- 托管服务启动
3. **自动运营**：
- 自动选品
- 自动定价
- 自动广告
- 自动库存管理
4. **实时监控**：
- 销售数据监控
- ROI监控
- 风险监控
- 异常检测
5. **智能决策**：
- 策略调整
- 预算调整
- 风险控制
- 紧急停止
6. **报告生成**：
- 运营报告
- ROI报告
- 决策日志
- **决策点**：
- 托管策略选择
- 预算分配策略
- 风险控制策略
- 紧急停止条件
- **输入**：托管配置、商户数据、市场数据
- **输出**：运营报告、ROI报告、决策日志
- **状态机**：`AUTOPILOT_CONFIG` → `AUTOPILOT_START` → `AUTO_OPERATION` → `REAL_TIME_MONITORING` → `SMART_DECISION` → `REPORT_GENERATION`
***
## 5️⃣5️⃣ 跨平台套利系统（Cross-Platform Arbitrage Loop）
- **目标**：低买高卖，实现跨平台套利
- **流程**：
1. **价格监控**：
- 多平台价格采集
- 价格对比分析
- 价格趋势分析
2. **套利机会识别**：
- 价格差计算
- ROI计算
- 利润计算
- 风险评估
3. **套利决策**：
- 利润阈值判断
- ROI阈值判断
- 风险评估
4. **自动执行**：
- 采购下单
- 平台上架
- 库存同步
5. **套利监控**：
- 订单状态监控
- 利润追踪
- 风险监控
6. **套利结算**：
- 利润核算
- 费用扣除
- 收益分配
- **决策点**：
- 套利阈值设定
- 风险控制策略
- 执行策略（自动/手动）
- 结算策略
- **输入**：多平台价格数据、套利配置、风险参数
- **输出**：套利机会、套利订单、利润报告
- **状态机**：`PRICE_MONITORING` → `ARBITRAGE_OPPORTUNITY` → `ARBITRAGE_DECISION` → `AUTO_EXECUTION` → `ARBITRAGE_MONITORING` → `ARBITRAGE_SETTLEMENT`
***
## 5️⃣6️⃣ AI动态定价系统（AI Dynamic Pricing Loop）
- **目标**：在竞争中最大化利润，实现博弈级定价
- **流程**：
1. **市场监控**：
- 竞争对手价格监控
- 市场需求分析
- 库存水平监控
- 转化率监控
2. **定价模型**：
- 需求预测
- 竞争分析
- 价格弹性计算
- 最优价格计算
3. **定价决策**：
- 提价策略
- 降价策略
- 保持策略
- A/B测试定价
4. **价格执行**：
- 价格更新
- 平台同步
- 库存调整
5. **效果追踪**：
- 销售数据追踪
- 利润追踪
- 转化率追踪
- ROI计算
6. **模型优化**：
- 效果分析
- 模型调整
- 策略优化
- **决策点**：
- 定价策略选择
- 提价/降价阈值
- A/B测试策略
- 模型更新频率
- **输入**：市场数据、竞争对手价格、销售数据
- **输出**：最优价格、定价决策、效果报告
- **状态机**：`MARKET_MONITORING` → `PRICING_MODEL` → `PRICING_DECISION` → `PRICE_EXECUTION` → `EFFECT_TRACKING` → `MODEL_OPTIMIZATION`
***
## 相关KPI
### AI驱动智能决策闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| AI建议采纳率 | AI建议被采纳的比例 | TOC + TOB |
| 自动执行比例 | 自动执行的操作比例 | TOC + TOB |
| 人工干预次数 | 需要人工干预的次数 | TOC + TOB |
| 决策准确率 | AI决策的准确率 | TOC + TOB |
| 执行成功率 | 系统执行的成功率 | TOC + TOB |
### 策略市场
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | --------- | --------- |
| 策略总数 | 上架策略总数 | TOC + TOB |
| 活跃策略数 | 被使用的策略数量 | TOC + TOB |
| 策略使用次数 | 策略被使用总次数 | TOC + TOB |
| 平均ROI | 策略平均ROI | TOC + TOB |
| 策略收益 | 策略带来的总收益 | TOC + TOB |
### 自动选品+自动上架系统
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 商品池大小 | 采集商品总数 | TOC + TOB |
| 选品成功率 | 成功选品的比例 | TOC + TOB |
| 平均ROI | 选中商品平均ROI | TOC + TOB |
| 上架成功率 | 成功上架的比例 | TOC + TOB |
| 自动化率 | 全自动操作的比例 | TOC + TOB |
### AI店铺托管
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ----------- | --------- |
| 托管商户数 | 使用托管服务的商户数 | TOC + TOB |
| 自动化运营率 | 自动运营操作比例 | TOC + TOB |
| 平均ROI | 托管店铺平均ROI | TOC + TOB |
| 风险事件数 | 发生的风险事件数量 | TOC + TOB |
| 紧急停止次数 | 触发紧急停止的次数 | TOC + TOB |
### 跨平台套利系统
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 套利机会数 | 发现的套利机会数量 | TOC + TOB |
| 套利成功率 | 成功套利的比例 | TOC + TOB |
| 平均利润 | 每笔套利平均利润 | TOC + TOB |
| 平均ROI | 套利平均ROI | TOC + TOB |
| 风险事件数 | 发生的风险事件数量 | TOC + TOB |
### AI动态定价系统
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 价格调整次数 | 价格调整总次数 | TOC + TOB |
| 平均利润率 | 定价后的平均利润率 | TOC + TOB |
| 转化率 | 价格调整后的转化率 | TOC + TOB |
| ROI | 定价策略的ROI | TOC + TOB |
| 定价准确率 | 定价决策的准确率 | TOC + TOB |

135
docs/00_Business/Business_ClosedLoops/11_Governance.md Normal file
View File

@@ -0,0 +1,135 @@
# 11 治理与合规域业务闭环
> 本文档包含治理、合规、风控相关的业务闭环：合规与证书、合规与风控、异常处理、恶意买家黑名单、高退货率SKU
---
## 1️⃣2️⃣ 合规与证书管理闭环（Compliance & Certificate Management Loop）
- **目标**：确保业务合规，自动生成所需证书。
- **流程**：
- **公共流程**：自动化合规 → 信用分级 → 合规审计
- **TOC**：商品合规检查和证书生成
- **TOB**：出口合规、合同合规检查和证书生成
- **决策点**：
- 不合规商品禁止销售
- 信用等级低的合作伙伴需要额外审核
- **输入**：订单数据、商品数据、合作伙伴数据
- **输出**：电子证书、合规报告、信用评估
***
## 1️⃣3️⃣ 合规与风控闭环（Compliance & Risk Control Loop）
- **目标**：统一风控
- **输入**：全流程数据（TOC + TOB）
- **输出**：风险处理记录、规则优化
***
## 3️⃣8️⃣ 异常处理闭环（Exception & Dispute Loop）
- **目标**：处理商户异常、客户投诉、退款退货。
- **流程**：
1. 客户发起投诉/退货 → 系统分配给对应商户。
2. 商户处理 → 平台监控处理时效。
3. 处理结果同步前端和财务结算。
- **决策点**：
- 超时未处理 → 系统自动介入。
- 争议订单 → 暂停结算，人工复核。
- **输入**：投诉/退货请求
- **输出**：处理结果，财务调整
- **状态机**：`SUBMITTED` → `PROCESSING` → `RESOLVED` → `ESCALATED`
***
## 4️⃣2️⃣ 恶意买家黑名单闭环（Malicious Buyer Blacklist Loop）
- **目标**：识别、管理和共享恶意买家信息，降低交易风险。
- **流程**：
1. **黑名单管理**
- 手动添加恶意买家（欺诈、拒付、滥用等）
- 自动识别高风险买家（基于行为模式）
- 黑名单等级划分（低/中/高风险）
2. **风险评估**
- 基于买家行为的综合风险评分
- 多维度风险因素分析（退货率、投诉率、拒付率等）
- 实时风险预警
3. **黑名单共享**
- 跨租户黑名单共享机制
- 共享规则配置（自动接受/人工审核）
- 共享状态同步
- **决策点**：
- 黑名单阈值设定
- 共享范围控制
- 风险等级判定标准
- **输入**：买家信息、交易记录、行为数据
- **输出**：黑名单记录、风险评分、共享结果
- **状态机**：`SUGGESTED` → `PENDING_REVIEW` → `ACTIVE` / `REJECTED` → `EXPIRED`
***
## 4️⃣3️⃣ 高退货率SKU自动下架/改进建议闭环（High Return Rate SKU Auto-Delist & Improvement Loop）
- **目标**：监控高退货率SKU，自动下架风险商品并提供改进建议。
- **流程**：
1. **退货率监控**
- 实时计算SKU退货率
- 多维度分析（按平台/店铺/类目）
- 趋势监控和预警
2. **自动下架**
- 阈值触发自动下架
- 多平台下架支持（Amazon/Shopee/Lazada/TikTok）
- 自动重新上架功能
3. **改进建议**
- 基于退货原因的智能分析
- 分类建议生成（质量/描述/图片/包装/物流等）
- 实施步骤指导和ROI预估
- **决策点**：
- 退货率阈值设定
- 自动下架规则配置
- 改进优先级排序
- **输入**：订单数据、退货记录、SKU信息
- **输出**：高风险SKU列表、下架结果、改进建议
- **状态机**：`MONITORED` → `HIGH_RISK` → `AUTO_DELISTED` → `IMPROVEMENT_SUGGESTED` → `RE_LISTED`
***
## 相关KPI
### 合规与证书管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | --------- | --------- |
| 证书生成及时率 | 按时生成证书的比例 | TOC + TOB |
| 合规检查通过率 | 通过合规检查的比例 | TOC + TOB |
| 信用评级准确率 | 信用评级的准确性 | TOC + TOB |
### 合规与风控闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 风险识别准确率 | 风险识别的准确性 | TOC + TOB |
| 风控处理时效 | 风险处理的时间 | TOC + TOB |
| 合规违规率 | 违规事件的比例 | TOC + TOB |
| 误报率 | 误判为风险的事件比例 | TOC + TOB |
### 恶意买家黑名单闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ------------ | --------- |
| 黑名单识别准确率 | 正确识别恶意买家的比例 | TOC + TOB |
| 风险评估准确率 | 风险等级评估的准确性 | TOC + TOB |
| 黑名单共享有效率 | 共享黑名单的有效利用比例 | TOC + TOB |
| 风险预警及时率 | 及时发出风险预警的比例 | TOC + TOB |
| 误报率 | 误判为恶意买家的比例 | TOC + TOB |
### 高退货率SKU自动下架/改进建议闭环
| KPI 指标 | 描述 | 适用业务类型 |
| -------- | ------------- | --------- |
| 退货率监控准确率 | 退货率计算的准确性 | TOC + TOB |
| 自动下架准确率 | 正确下架高风险SKU的比例 | TOC + TOB |
| 改进建议有效性 | 改进建议被采纳并实施的比例 | TOC + TOB |
| 重新上架成功率 | 改进后重新上架的成功比例 | TOC + TOB |
| 退货率改善率 | 改进后退货率下降的比例 | TOC + TOB |

204
docs/00_Business/Business_ClosedLoops/12_Growth.md Normal file
View File

@@ -0,0 +1,204 @@
# 12 增长与商业化域业务闭环
> 本文档包含增长和商业变现相关的业务闭环：商业化与增长、增长飞轮、多商户收益排行榜、首页商业化
---
## 4️⃣4️⃣ 商业化与增长闭环（Monetization & Growth Loop）
- **目标**：实现系统持续盈利与收入增长（非SaaS模式）
### 收费模型
#### 1. 功能收费（Feature-based）
- 高级分析
- 自动化能力
- API调用
#### 2. 交易抽成（Transaction-based）
- TOC：订单抽佣（3~10%）
- TOB：大单服务费
#### 3. 服务收费（Service-based）
- 代发货
- 仓储服务
- 数据服务
#### 4. 资金沉淀（Deposit Float）
- 押金沉淀收益
- 账期资金
### 收费触发点
- 功能调用
- 订单完成
- 商家使用服务
- API请求
### 收入放大机制
- ROI分析 → 推荐开功能
- 利润分析 → 推荐加广告
- 订单增长 → 引导升级套餐
### 决策点
- 免费 vs 付费边界
- 抽成比例
- 功能定价策略
### 输入
- 用户行为
- 订单数据
- 利润数据
### 输出
- 收入增长
- 用户付费转化
***
## 4️⃣5️⃣ 增长飞轮闭环（Growth Flywheel Loop）
- **目标**：让系统自动变强、自动赚钱
### 飞轮逻辑
数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据
### 核心路径
1. 商品数据 → 利润分析
2. 利润高 → 推广广告
3. 广告带订单
4. 订单产生数据
5. 数据优化策略
### TOB路径
询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单
### 决策点
- 推荐策略
- 自动化程度
- AI参与程度
### 输出
- GMV增长
- ROI提升
- 用户粘性
***
## 5️⃣1️⃣ 多商户收益排行榜系统（信任引擎）（Merchant Leaderboard Loop）
- **目标**：让用户看到"别人赚钱了" → 促进付费，建立信任和转化
- **流程**：
1. **数据采集**：
- 收集商户订单数据
- 收集广告数据
- 收集ROI数据
- 收集利润数据
2. **数据汇总**：
- 计算总收入
- 计算总成本
- 计算净利润
- 计算ROI
3. **排行计算**：
- 收益榜排序
- ROI榜排序
- 增长榜排序
4. **防作弊处理**：
- 过滤异常订单
- ROI上限限制
- 新用户单独榜单
5. **榜单展示**：
- TOP 10 商户展示
- ROI展示
- 使用策略标签
- **决策点**：
- 排行计算频率（每10分钟）
- 防作弊阈值设定
- 榜单展示策略
- **输入**：商户订单数据、广告数据、ROI数据
- **输出**：排行榜数据、TOP 10 商户、榜单类型
- **状态机**：`DATA_COLLECTION` → `DATA_AGGREGATION` → `RANKING_CALCULATION` → `ANTI_CHEAT` → `LEADERBOARD_DISPLAY`
***
## 5️⃣9️⃣ 首页商业化闭环（Homepage Monetization Loop）
- **目标**：通过登录前的首页展示，引导访客注册并转化为付费用户，实现商业化目标
- **流程**：
1. **访客访问**：
- 首页展示核心价值
- 功能模块介绍
- 成功案例展示
- 定价方案对比
2. **了解产品**：
- 核心功能浏览
- 价值主张理解
- 成功案例学习
- 定价方案评估
3. **注册试用**：
- 免费注册流程
- 邮箱验证
- 基础信息完善
- 试用权限开通
4. **体验功能**：
- 核心功能体验
- 数据导入/演示
- 系统操作熟悉
- 价值感知建立
5. **升级付费**：
- 付费方案选择
- 支付流程
- 权限升级
- 服务开通
- **决策点**：
- 访客是否注册
- 注册用户是否试用
- 试用用户是否付费
- 付费用户是否续费
- **输入**：访客流量、营销内容、产品信息、定价方案
- **输出**：
- 注册用户
- 试用用户
- 付费用户
- 转化率数据
- **状态机**：
- 访客状态：`VISITOR` → `REGISTERED` → `TRIALING` → `PAID`
- 转化状态：`VISIT` → `REGISTER` → `TRIAL` → `PAY`
***
## 相关KPI
### 多商户收益排行榜系统
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 商户总数 | 参与排行的商户总数 | TOC + TOB |
| 活跃商户数 | 活跃商户数量 | TOC + TOB |
| 平均ROI | 商户平均ROI | TOC + TOB |
| 最高ROI | 最高ROI记录 | TOC + TOB |
| 榜单更新频率 | 榜单数据更新频率 | TOC + TOB |
### 首页商业化闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 访问量 | 首页访问总量 | TOC + TOB |
| 注册转化率 | 访客注册的比例 | TOC + TOB |
| 试用转化率 | 注册用户试用的比例 | TOC + TOB |
| 付费转化率 | 试用用户付费的比例 | TOC + TOB |
| 客单价 | 平均每个付费用户金额 | TOC + TOB |
| 复购率 | 付费用户续费的比例 | TOC + TOB |

172
docs/00_Business/Business_ClosedLoops/13_Technical.md Normal file
View File

@@ -0,0 +1,172 @@
# 13 技术基础设施域业务闭环
> 本文档包含技术基础设施相关的业务闭环：技术基础设施、报表与分析、API文档、系统监控、技术债务、用户教育
---
## 4️⃣6️⃣ 技术基础设施闭环（Technical Infrastructure Loop）
- **目标**：提供稳定、高效、可扩展的技术基础设施，支撑核心业务流程的运行。
- **流程**：
1. **服务管理**：
- 服务注册与发现
- 服务健康检查与监控
- 服务版本管理与部署
2. **数据管理**：
- 缓存策略与优化
- 数据库性能优化
- 数据备份与恢复
3. **消息处理**：
- 消息队列管理
- 异步操作处理
- 事件总线管理
4. **安全与合规**：
- 数据传输加密
- 访问控制与权限管理
- 日志审计与追踪
- **决策点**：
- 服务健康状态评估
- 性能瓶颈识别与优化
- 安全风险评估与应对
- **输入**：系统配置、服务状态数据、性能指标
- **输出**：技术基础设施状态报告、优化建议、安全审计报告
***
## 1️⃣4️⃣ 报表与分析闭环（Reporting & Analytics Loop）
- **目标**：数据可视化 + KPI 支撑 TOC/TOB 决策
- **流程**：
- 数据汇总 → 指标计算 → 报表生成 → 数据大屏 → 闭环反馈
- **输出**：管理报表、异常预警、优化建议
- **状态机**：`RAW_DATA` → `PROCESSED` → `GENERATED` → `DISTRIBUTED` → `FEEDBACK_APPLIED`
***
## 6️⃣4️⃣ API文档与开发者工具闭环（API Documentation & Developer Tools Loop）
- **目标**：提供标准化的API接口和开发者工具，支持第三方集成。
- **流程**：
1. **API管理**：RESTful API设计、API文档、版本控制
2. **开发者工具**：SDK、开发者门户、Webhook
- **决策点**：
- API版本管理
- 开发者权限控制
- **输入**：API需求、开发者信息
- **输出**：API文档、SDK、开发者工具
***
## 6️⃣5️⃣ 系统监控与运维闭环（System Monitoring & Operation Loop）
- **目标**：监控系统健康状态，确保系统稳定运行。
- **流程**：
1. **监控体系**：系统健康、性能监控、异常监控
2. **日志管理**：集中化日志、日志分析、告警机制
3. **运维工具**：自动化部署、配置管理、灾备方案
- **决策点**：
- 监控阈值设置
- 告警策略配置
- **输入**：系统数据、日志数据、监控指标
- **输出**：监控报告、告警通知、运维操作记录
***
## 6️⃣8️⃣ 技术债务管理闭环（Technical Debt Management Loop）
- **目标**：管理技术债务，确保代码质量和系统可维护性，支持系统长期演进。
- **流程**：
1. **代码质量管理**：
- 代码规范制定和执行
- 代码审查流程
- 单元测试和集成测试
- 代码覆盖率监控
2. **技术栈管理**：
- 依赖管理和版本控制
- 技术选型评估
- 技术栈更新规划
3. **架构演进**：
- 架构评估和优化
- 技术债务识别与分类
- 技术债务优先级排序
- 技术债务偿还计划
- **决策点**：
- 技术栈更新策略和时机
- 代码质量标准和指标
- 技术债务优先级排序
- 架构优化方向
- **输入**：代码库、依赖信息、架构文档、代码质量报告、系统性能数据
- **输出**：代码质量报告、技术债务评估、架构优化建议、技术栈更新计划
- **状态机**：`DEBT_IDENTIFIED` → `PRIORITY_ASSIGNED` → `PLAN_CREATED` → `DEBT_REPAID` → `VERIFICATION`
***
## 6️⃣9️⃣ 用户教育与支持闭环（User Education & Support Loop）
- **目标**：提供全面的用户教育和支持，提高用户体验和系统使用效率，促进用户成功。
- **流程**：
1. **文档与培训**：
- 用户文档：系统操作指南、最佳实践
- 培训课程：线上/线下培训、认证课程
- 视频教程：操作演示、功能讲解
- 知识库：常见问题、故障排除
2. **支持系统**：
- 客服工单：问题提交、跟踪和解决
- 在线支持：实时聊天、邮件支持
- 社区论坛：用户交流、经验分享
- 自助服务：常见问题解答、自助工具
3. **反馈机制**：
- 用户反馈：问题报告、功能建议
- 功能投票：用户需求优先级排序
- 用户满意度调查：服务质量评估
- 产品改进：基于反馈的功能迭代
- **决策点**：
- 培训内容设计和优先级
- 支持请求优先级设置
- 反馈处理流程和响应时间
- 知识库内容更新策略
- **输入**：用户需求、系统功能、反馈信息、支持请求
- **输出**：用户文档、培训材料、支持记录、反馈处理结果
- **状态机**：
- `SUPPORT_REQUESTED` → `TRIAGED` → `IN_PROGRESS` → `RESOLVED` → `CLOSED`
- `FEEDBACK_SUBMITTED` → `REVIEWED` → `PRIORITIZED` → `IMPLEMENTED` → `VERIFIED`
***
## 相关KPI
### 报表与分析闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | --------------- | --------- |
| 报表生成及时率 | 按时生成报表的比例 | TOC + TOB |
| 数据准确率 | 报表数据的准确性 | TOC + TOB |
| 分析洞察价值 | 分析结果对业务决策的价值 | TOC + TOB |
| 异常预警准确率 | 异常预警的准确性 | TOC + TOB |
| 报表生成时效 | 从数据汇总到报表完成的时间 | TOC + TOB |
| 数据完整率 | 报表覆盖业务闭环输出数据的比例 | TOC + TOB |
| KPI 准确率 | 计算指标与实际数据偏差率 | TOC + TOB |
| 异常响应率 | 异常报表触发优化措施的比例 | TOC + TOB |
| 大屏实时性 | 数据大屏数据更新延迟时间 | TOC + TOB |
| 决策支持率 | 报表建议被采纳并执行的比例 | TOC + TOB |
### 技术债务管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 代码质量评分 | 代码质量综合评分 | TOC + TOB |
| 测试覆盖率 | 代码测试覆盖比例 | TOC + TOB |
| 技术债务数量 | 待偿还技术债务数量 | TOC + TOB |
| 债务偿还率 | 按计划偿还债务的比例 | TOC + TOB |
| 架构健康度 | 架构评估健康评分 | TOC + TOB |
### 用户教育与支持闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 文档完整度 | 功能文档覆盖比例 | TOC + TOB |
| 培训完成率 | 用户培训完成比例 | TOC + TOB |
| 工单响应时效 | 工单首次响应时间 | TOC + TOB |
| 工单解决率 | 工单成功解决比例 | TOC + TOB |
| 用户满意度 | 用户满意度评分 | TOC + TOB |
| 反馈处理率 | 用户反馈处理比例 | TOC + TOB |

122
docs/00_Business/Business_ClosedLoops/14_CrossBorder.md Normal file
View File

@@ -0,0 +1,122 @@
# 14 跨境电商域业务闭环
> 本文档包含跨境电商相关的业务闭环：跨境电商、多语言业务
---
## 4️⃣8️⃣ 跨境电商闭环（Cross-Border E-Commerce Loop）
- **目标**：支持跨境电商全流程，解决清关、物流、支付等痛点，整合多平台能力提升运营效率。
- **流程**：
1. **跨境商品管理**：
- 商品合规性检查
- 关税计算与预估
- 商品分类与HS编码管理
- 多平台一键上架与批量listing
2. **清关服务**：
- 自动生成清关文件
- 海关申报与追踪
- 关税和税费处理
3. **跨境物流**：
- 国际物流渠道选择
- 运费计算与优化
- 物流轨迹追踪
- 跨境仓储管理
- 与主流物流商集成（如Flexport）
4. **跨境支付**：
- 多币种支付支持
- 汇率管理与优化
- 跨境支付安全
- 多支付方式覆盖（信用卡/电子钱包/分期付款）
5. **合规管理**：
- 出口/进口法规遵守
- 税务合规与申报
- 产品认证与标准
6. **全渠道营销**：
- 社媒营销（Meta/Facebook/TikTok/Google）
- SEO优化
- 联盟营销
7. **客户沟通与私域运营**：
- 多渠道消息聚合（Livechat、WhatsApp、Facebook Messenger等）
- 智能自动化客服
- 客户分层与精准运营
- 跨境沟通适配（自动翻译）
- **平台能力整合**：
| 平台 | 核心能力 | 适用场景 |
| --- | --- | --- |
| **Sellbrite** | 多平台一键集成、批量上架与优化、库存自动同步、一站式订单履约、灵活定价与数据洞察 | Amazon/eBay/Walmart等多渠道卖家 |
| **Shoplazza** | 5步快速建站、全渠道营销引流、精细化店铺管理（库存/支付/团队/物流） | 希望建立品牌独立站的跨境卖家 |
| **SaleSmartly** | 全渠道消息聚合、智能自动化客服、团队高效协作、客户精细化管理、多维度数据洞察、跨境沟通适配 | B2B或独立站跨境卖家，注重客户沟通与私域运营 |
- **决策点**：
- 物流渠道选择（成本vs时效）
- 清关策略（自行清关vs代理清关）
- 支付方式选择（安全性vs便捷性）
- 合规风险评估
- 平台选择与组合使用策略
- **输入**：商品信息、订单数据、目的地国家/地区、支付信息
- **输出**：清关文件、物流信息、支付状态、合规报告、营销效果分析
- **状态机**：`PENDING` → `PROCESSING` → `CLEARANCE` → `SHIPPING` → `DELIVERED`
***
## 6️⃣6️⃣ 多国语言业务闭环（Multi-Language Business Loop）
- **目标**：构建完整的多语言支持体系，实现全球业务的本地化运营，提升用户体验和市场竞争力。
- **支持语言**：
- 主流语言：英语、中文、西班牙语、法语、德语、日语、韩语
- 区域语言：俄语、葡萄牙语、意大利语、阿拉伯语、印度语等
- **流程**：
1. **多语言内容管理**：
- 内容创建与管理：统一内容库，支持多语言版本
- 翻译工作流：自动翻译 + 人工审核
- 内容发布：多语言同步发布
2. **界面本地化**：
- 前端界面多语言支持
- 日期、时间、货币、单位本地化
- 文化习俗适配（如颜色、图标、布局）
3. **业务逻辑本地化**：
- 地区法规合规处理
- 本地支付方式集成
- 物流与配送规则适配
4. **多语言客服**：
- 多语言工单系统
- 智能翻译客服机器人
- 本地化客服团队
- **技术实现**：
- **i18n 服务**：统一的国际化服务层
- **翻译 API 集成**：接入专业翻译服务（如 Google Translate、DeepL）
- **多语言数据库**：支持多语言字段存储
- **语言切换机制**：用户偏好设置 + 自动检测
- **翻译记忆库**：积累和复用翻译内容
- **决策点**：
- 语言支持优先级和扩展策略
- 自动翻译 vs 人工翻译的平衡点
- 本地化程度与成本控制
- 地区法规合规要求
- **输入**：原始内容（基础语言）、翻译资源、地区规则配置、用户语言偏好
- **输出**：多语言界面和内容、本地化配置、翻译记忆库、多语言业务数据
- **状态机**：`CONTENT_CREATED` → `TRANSLATION_REQUESTED` → `TRANSLATED` → `REVIEW_PENDING` → `APPROVED` → `PUBLISHED`
***
## 相关KPI
### 跨境电商闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 清关成功率 | 成功清关的订单比例 | TOC + TOB |
| 物流时效达标率 | 按时送达的跨境订单比例 | TOC + TOB |
| 支付成功率 | 跨境支付成功比例 | TOC + TOB |
| 合规通过率 | 通过合规检查的订单比例 | TOC + TOB |
| 多平台覆盖率 | 已接入平台占目标平台比例 | TOC + TOB |
### 多国语言业务闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 翻译覆盖率 | 内容翻译完成比例 | TOC + TOB |
| 翻译准确率 | 翻译内容准确比例 | TOC + TOB |
| 本地化完成度 | 界面本地化完成比例 | TOC + TOB |
| 多语言支持数 | 支持的语言数量 | TOC + TOB |
| 翻译成本效率 | 单位内容翻译成本 | TOC + TOB |

220
docs/00_Business/Business_ClosedLoops/15_Security.md Normal file
View File

@@ -0,0 +1,220 @@
# 15 安全与风控域业务闭环
> 本文档包含安全、风控、权限相关的业务闭环：安全与风控、用户管理与权限、多租户隔离、多租户层级、账号/店铺健康、店铺隔离
---
## 6️⃣0️⃣ 安全与风控闭环（Security & Risk Control Loop）
- **目标**：统一风控，确保系统安全和业务合规。
- **流程**：
1. **风险分级**：Level 1（安全）、Level 2（中风险）、Level 3（高风险）
2. **人机协同**：AI生成建议 → 人工确认 → 执行
3. **数据安全**：统一数据回传、权限控制、操作审计
- **决策点**：
- Level 1：自动执行
- Level 2：小规模执行 + 确认
- Level 3：仅建议，需人工确认
- **输入**：全流程数据（TOC + TOB）
- **输出**：风险处理记录、规则优化
***
## 6️⃣1️⃣ 用户管理与权限系统闭环（User Management & Permission System Loop）
- **目标**：管理用户账户和权限，确保系统安全和数据隔离。
- **流程**：
1. **用户管理**：注册、登录、个人信息管理、商户管理
2. **权限体系**：角色定义、权限粒度、权限分配
- **决策点**：
- 角色权限分配
- 数据访问控制
- **输入**：用户信息、角色信息、权限信息
- **输出**：用户账户、权限配置、访问控制结果
***
## 6️⃣2️⃣ 多租户隔离闭环（Multi-Tenant Isolation Loop）
- **目标**：实现商户→部门→店铺三层架构的数据隔离和权限控制。
- **流程**：
1. **数据隔离**：数据库级、Schema级、表级隔离
2. **资源隔离**：计算资源、存储资源、网络资源隔离
3. **租户配置**：独立配置、品牌定制、业务规则
- **决策点**：
- 隔离级别选择
- 资源配额管理
- **输入**：租户信息、店铺信息、资源配置
- **输出**：隔离环境、配置管理、资源监控
***
## 5️⃣8️⃣ 多租户层级管理闭环（Multi-Tenant Hierarchy Loop）
- **目标**：实现商户→部门→店铺三层架构的完整管理，确保数据隔离和权限控制
- **层级模型**：
```
┌─────────────────────────────────────────────────────────┐
│ 商户(Merchant) │
│ - 商户ID (merchantId) │
│ - 商户名称、联系方式、认证状态 │
│ - 商户级配置、计费信息 │
└────────────────────┬────────────────────────────────────┘
│ 1:N
┌───────────┴───────────┐
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ 部门(Department) │ │ 部门(Department) │
│ - 部门ID (deptId) │ │ - 部门ID (deptId) │
│ - 部门名称、负责人 │ │ - 部门名称、负责人 │
└────────┬────────┘ └────────┬────────┘
│ 1:N │ 1:N
▼ ▼
┌─────────────────┐ ┌─────────────────┐
│ 店铺(Shop) │ │ 店铺(Shop) │
│ - 店铺ID (shopId) │ │ - 店铺ID (shopId) │
│ - 平台、店铺类型 │ │ - 平台、店铺类型 │
└─────────────────┘ └─────────────────┘
```
- **流程**：
1. **商户入驻**：
- 商户注册与认证
- 商户信息完善
- 商户计费配置
- 商户权限初始化
2. **部门创建**：
- 部门信息录入
- 部门负责人分配
- 部门权限配置
- 部门成员管理
3. **店铺绑定**：
- 店铺创建/导入
- 店铺归属部门
- 店铺类型配置
- 店铺权限设置
4. **层级数据隔离**：
- 商户级：所有下属数据可见
- 部门级：本部门及下属店铺数据可见
- 店铺级：仅本店铺数据可见
5. **跨层级操作**：
- 上级可查看下级数据
- 下级不可查看上级数据
- 同级数据相互隔离
- **决策点**：
- 层级深度限制
- 数据继承规则
- 权限传递规则
- 跨层级操作审批
- **输入**：商户信息、部门信息、店铺信息、用户角色
- **输出**：
- 层级结构管理界面
- 数据隔离配置
- 权限分配结果
- 层级报表
- **状态机**：
- 商户：`MERCHANT_PENDING` → `MERCHANT_VERIFIED` → `MERCHANT_ACTIVE` → `MERCHANT_SUSPENDED`
- 部门：`DEPT_CREATED` → `DEPT_ACTIVE` → `DEPT_SUSPENDED`
- 店铺：`SHOP_REGISTERED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED`
***
## 1️⃣6️⃣ 账号/店铺健康度闭环（Account/Shop Health Loop）
- **目标**：监控和维护店铺健康状态，预防封号、限流等风险。
- **流程**：
- 数据采集 → 健康度评估 → 风险预警 → 干预措施
- **决策点**：
- 健康度阈值设定
- 风险等级划分
- 干预策略制定
- **输入**：违规记录、发货延迟、差评率、退款率、账号活动数据
- **输出**：
- 店铺健康评分
- 风险预警
- 干预建议（暂停广告、限制上新、下架高风险商品）
***
## 1️⃣7️⃣ 店铺隔离与自动化闭环（Shop Isolation & Automation Loop）
- **目标**：
1. 确保每个 TOC / TOB 店铺环境隔离，防止账号关联导致封禁
2. 自动化执行 API 不支持或无 API 的操作（刊登、采集、调价、库存同步等）
3. 支持多云环境，可灵活选择云服务商（阿里云、腾讯云、AWS、Azure 等）
- **流程**：
1. **镜像/虚拟机管理**
- 每个店铺对应独立云镜像或虚拟机（Win/Linux 可选）
- 云商 API 对接：镜像购买/续费、快照/重置、开机/关机/重启
- 支持多云商切换，可根据价格、性能、地理位置灵活部署
2. **预置环境配置**
- 浏览器、自动化脚本、指纹管理工具、VPN 或固定 IP 配置
- 自动登录店铺账户，无需人工干预
3. **任务调度与自动化执行**
- 脚本调度可使用 JS / Python / 后端 API 方式控制
- 支持平台无 API 操作（如商品采集、库存更新、手动刊登模拟等）
- 自动执行任务后状态反馈至任务调度闭环，并记录日志
4. **监控与异常自愈**
- 云镜像健康监控（在线状态、资源使用、脚本异常）
- 自动重启 / 快照恢复 / 切换备用镜像
- 异常信息反馈至异常检测与自愈闭环
- **决策点**：
- 店铺隔离等级（独立镜像、不同 IP、不同指纹）
- 云商选择与成本控制
- 异常处理策略（自动恢复或人工介入）
- **输入**：
- 店铺列表、业务需求（采集、刊登、广告等）
- 云商账户与资源配置
- 自动化脚本 / 后端控制接口
- **输出**：
- 各店铺独立镜像环境
- 自动化执行日志与状态报告
- 异常修复记录
- **闭环价值**：
1. 高度隔离，降低账号封禁与关联风险
2. 自动化落地，提高效率与可扩展性
3. 支持多云部署，增强业务弹性和成本优化能力
***
## 相关KPI
### 安全与风控闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ---------- | --------- |
| 风险识别准确率 | 风险识别的准确性 | TOC + TOB |
| 风控处理时效 | 风险处理的时间 | TOC + TOB |
| 安全事件数 | 发生的安全事件数量 | TOC + TOB |
| 风险拦截率 | 成功拦截的风险比例 | TOC + TOB |
### 多租户层级管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 商户数量 | 入驻商户总数 | TOC + TOB |
| 部门数量 | 创建部门总数 | TOC + TOB |
| 店铺数量 | 绑定店铺总数 | TOC + TOB |
| 数据隔离有效性 | 数据隔离的成功率 | TOC + TOB |
| 权限配置准确性 | 权限配置的准确率 | TOC + TOB |
### 账号/店铺健康度闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------ | --------- |
| 店铺健康评分 | 店铺整体健康状态评分 | TOC + TOB |
| 风险预警准确率 | 风险预警的准确性 | TOC + TOB |
| 干预措施有效性 | 干预后店铺健康度改善程度 | TOC + TOB |
| 违规率 | 违规事件发生频率 | TOC + TOB |
| 账号稳定性 | 账号正常运行时间比例 | TOC + TOB |
### 店铺隔离与自动化闭环
| KPI 指标 | 描述 | 适用业务类型 |
| --------- | ------------- | --------- |
| 店铺隔离成功率 | 成功隔离的店铺比例 | TOC + TOB |
| 自动化操作成功率 | 成功执行的自动化操作比例 | TOC + TOB |
| 异常恢复时长 | 异常从发生到恢复的时间 | TOC + TOB |
| 脚本异常率 | 脚本执行异常的比例 | TOC + TOB |
| 镜像可用性 | 镜像正常运行时间比例 | TOC + TOB |
| 云API调用成功率 | 云服务商API调用成功率 | TOC + TOB |
| 多云切换成功率 | 云服务商切换成功率 | TOC + TOB |

181
docs/00_Business/Business_ClosedLoops/16_Others.md Normal file
View File

@@ -0,0 +1,181 @@
# 16 其他独立业务闭环
> 本文档包含其他独立的业务闭环：定价与利润决策、核心服务优先级、多店铺管理、商家选择发货、客户/商家押金
---
## 1️⃣5️⃣ 定价与利润决策闭环（Pricing & Profit Decision Loop）
- **目标**：基于成本、市场和业务目标，自动生成定价策略和利润优化建议。
- **流程**：
- 成本数据收集 → 市场分析 → 定价策略生成 → 利润预测 → 决策执行
- **决策点**：
- 利润率红线控制（B2C < 20% 预警，B2B < 15% 禁止）
- 价格弹性分析
- 竞争定价策略
- **输入**：商品成本、运费、平台费、广告预估、市场竞争数据
- **输出**：
- 建议售价
- 建议 ROI
- 上架决策（开/关）
- 广告投放 ROI 区间
- 最大可承受 CPA
***
## 5️⃣0️⃣ 核心服务优先级闭环（Core Service Priority Loop）
- **目标**：确定核心业务服务的优先级顺序，确保资源合理分配。
- **流程**：
1. **服务评估**：
- 业务价值评估
- 技术复杂度评估
- 资源需求评估
- 风险评估
2. **优先级排序**：
- 基于业务价值的排序
- 基于依赖关系的排序
- 基于时间窗口的排序
3. **资源分配**：
- 人力分配
- 技术资源分配
- 时间规划
4. **执行监控**：
- 进度跟踪
- 资源使用监控
- 风险预警
- **决策点**：
- 优先级调整时机
- 资源重新分配决策
- 项目范围变更管理
- **输入**：服务需求、业务目标、资源状况
- **输出**：优先级排序结果、资源分配计划、执行进度报告
- **状态机**：`ASSESSMENT` → `PRIORITIZATION` → `RESOURCE_ALLOCATION` → `EXECUTION` → `MONITORING`
***
## 5️⃣7️⃣ 多店铺管理闭环（Multi-Shop Management Loop）
- **目标**：实现多店铺、多商户、多部门的统一管理与数据隔离，支持独立站/外部独立站/报表等一对多交互
- **层级架构**：
```
商户(Merchant) → 部门(Department) → 店铺(Shop)
↓ ↓ ↓
商户级数据 部门级数据 店铺级数据
```
- **流程**：
1. **店铺注册与配置**：
- 店铺类型划分（独立站/平台店/外部独立站）
- 平台账号绑定
- 店铺基础信息配置
- 店铺状态管理
2. **权限配置**：
- 层级权限继承
- 数据访问范围控制
- 操作权限分配
- 角色管理
3. **数据隔离**：
- 店铺级数据隔离
- 部门级数据聚合
- 商户级数据汇总
- 跨店铺数据访问控制
4. **业务操作**：
- 商品管理（单店/批量）
- 订单管理（单店/聚合）
- 库存管理（单店/同步）
- 价格管理（单店/批量）
5. **报表聚合**：
- 单店报表
- 部门聚合报表
- 商户汇总报表
- 跨店对比分析
- **决策点**：
- 店铺类型划分标准
- 数据权限边界定义
- 报表聚合规则
- 跨店操作权限
- **输入**：店铺信息、商户信息、部门信息、用户角色
- **输出**：
- 店铺管理界面
- 跨店铺数据报表
- 权限控制策略
- 数据隔离配置
- **状态机**：`SHOP_REGISTERED` → `SHOP_CONFIGURED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED` → `SHOP_CLOSED`
***
## 2️⃣0️⃣ 商家选择发货闭环（Merchant Selective Fulfillment Loop）
- **目标**：商家可选择自己有库存的订单发货，剩余由平台/公司发货。
- **流程**：
1. **订单选择**
- 商家登录落地页选择自己有货的订单发货
2. **系统检查**
- 押金或余额是否足够覆盖订单
- 时效性（保证订单不过期）
3. **订单状态更新**
- 状态流转：`available → requested → shipped → completed`
- 剩余无货订单由平台/公司自己发货
- **决策点**：
- 订单分配规则
- 库存检查策略
- 时效保证机制
- **输入**：
- 商家库存信息
- 订单数据
- 押金/余额状态
- **输出**：
- 订单分配结果
- 发货状态更新
- 异常订单标记
***
## 1️⃣9️⃣ 客户/商家押金与账户管理闭环（Customer/Merchant Deposit & Account Management Loop）
- **目标**：管理客户预缴押金、账户余额，支持订单抵扣和提现。
- **流程**：
1. **押金管理**
- 客户预缴押金（例：100 元抵 2 单）
- 押金余额、已抵扣订单数量记录
2. **账户管理**
- 客户可查看：可申请发货订单、历史回款、押金/余额状态
- 自动扣减押金或余额完成发货操作
3. **提现管理**
- 检查账户余额 → 生成提现单 → 审核 → 打款
- **决策点**：
- 押金抵扣规则
- 提现审核流程
- 余额管理策略
- **输入**：
- 客户押金信息
- 订单数据
- 提现申请
- **输出**：
- 押金/余额状态
- 提现处理结果
- 财务流水记录
***
## 相关KPI
### 定价与利润决策闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------- | ------------- | --------- |
| 定价准确率 | 建议售价与最优价格的偏差率 | TOC + TOB |
| 利润率达标率 | 达到目标利润率的商品比例 | TOC + TOB |
| 定价决策时效 | 从成本数据到定价决策的时间 | TOC + TOB |
| 价格竞争力 | 与市场平均价格的对比 | TOC + TOB |
| 利润预测准确率 | 预测利润与实际利润的偏差率 | TOC + TOB |
### 多店铺管理闭环
| KPI 指标 | 描述 | 适用业务类型 |
| ------ | ----------- | --------- |
| 店铺数量 | 管理的店铺总数 | TOC + TOB |
| 活跃店铺数 | 活跃店铺数量 | TOC + TOB |
| 跨店订单量 | 跨店铺订单数量 | TOC + TOB |
| 数据隔离有效性 | 数据隔离的成功率 | TOC + TOB |
| 报表生成效率 | 报表生成的平均时间 | TOC + TOB |