feat: 添加MSW模拟服务和数据源集成

refactor: 重构页面组件移除冗余Layout组件 feat: 实现WebSocket和事件总线系统 feat: 添加队列和调度系统 docs: 更新架构文档和服务映射 style: 清理重复接口定义使用数据源 chore: 更新依赖项配置 feat: 添加运行时系统和领域引导 ci: 配置ESLint边界检查规则 build: 添加Redis和WebSocket依赖 test: 添加MSW浏览器环境入口 perf: 优化数据获取逻辑使用统一数据源 fix: 修复类型定义和状态管理问题
2026-03-19 01:39:34 +08:00
parent cd55097dbf
commit 0dac26d781
176 changed files with 47075 additions and 8404 deletions
--- a/docs/00_Business/Business_ClosedLoops.md
+++ b/docs/00_Business/Business_ClosedLoops.md
@@ -1,6 +1,6 @@
 # 📌 Crawlful Hub 业务闭环（TOC + TOB Unified Business Loops）

-> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **50个业务闭环**。
+> **说明**：本闭环文档是战略层业务流程，关注"做什么、为什么做、顺序和决策点"，为下层模块功能和系统实现提供指引。TOC（零售/前端）和 TOB（B2B贸易）共享通用模块，特有流程用 `businessType` 标记。共 **56个业务闭环**。

 ## 📑 目录

@@ -54,12 +54,20 @@
 48. [跨境电商闭环](#4️⃣8️⃣-跨境电商闭环cross-border-e-commerce-loop)
 49. [AI驱动智能决策闭环](#4️⃣9️⃣-ai驱动智能决策闭环ai-driven-smart-decision-loop)
 50. [核心服务优先级闭环](#5️⃣0️⃣-核心服务优先级闭环core-service-priority-loop)
-41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
-42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
-43. [关键绩效指标](#📊-关键绩效指标kpi)
-44. [追踪与审计](#🔍-追踪与审计)
-45. [业务审核状态机](#📋-业务审核状态机)
-46. [说明](#💡-说明)
+51. [多商户收益排行榜系统（信任引擎）](#5️⃣1️⃣-多商户收益排行榜系统信任引擎merchant-leaderboard-loop) 🆕
+52. [策略市场（Strategy Marketplace）](#5️⃣2️⃣-策略市场strategy-marketplace-loop) 🆕
+53. [自动选品+自动上架系统（增长引擎）](#5️⃣3️⃣-自动选品自动上架系统增长引擎auto-product-selection-listing-loop) 🆕
+54. [AI店铺托管（AutoPilot）](#5️⃣4️⃣-ai店铺托管autopilot-loop) 🆕
+55. [跨平台套利系统](#5️⃣5️⃣-跨平台套利系统cross-platform-arbitrage-loop) 🆕
+56. [AI动态定价系统](#5️⃣6️⃣-ai动态定价系统ai-dynamic-pricing-loop) 🆕
+57. [多店铺管理闭环](#5️⃣7️⃣-多店铺管理闭环multi-shop-management-loop) 🆕
+58. [多租户层级管理闭环](#5️⃣8️⃣-多租户层级管理闭环multi-tenant-hierarchy-loop) 🆕
+52. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
+53. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
+54. [关键绩效指标](#📊-关键绩效指标kpi)
+55. [追踪与审计](#🔍-追踪与审计)
+56. [业务审核状态机](#📋-业务审核状态机)
+57. [说明](#💡-说明)

 ***

@@ -2597,34 +2605,120 @@ Controller

 ## 4️⃣9️⃣ AI驱动智能决策闭环（AI-Driven Smart Decision Loop）

- **目标**：利用AI技术提升运营效率和决策准确性，实现智能化运营。
- **流程**：
-  1. **数据采集与处理**：
-     - 多源数据整合
-     - 数据清洗与预处理
-     - 特征工程与选择
-  2. **AI模型训练与部署**：
-     - 模型选择与训练
-     - 模型评估与优化
-     - 模型部署与监控
-  3. **智能决策应用**：
-     - 智能定价与动态调价
-     - 智能库存预测与补货
-     - 智能广告投放与优化
-     - 智能客户服务与售后
-     - 智能风控与异常检测
-  4. **决策执行与反馈**：
-     - 决策执行与监控
-     - 效果评估与分析
-     - 模型迭代与优化
+- **目标**：利用AI技术提升运营效率和决策准确性，实现"AI主导决策 + 人类验证 + 操作执行 + 日志记录"的智能化运营。
+- **核心理念**：
+  - **AI建议为主**：AI生成策略、推荐操作、人类只作为参考或最终确认
+  - **人类介入可控**：前期可高干预，AI越强介入越低，最后趋近于完全自动
+  - **操作可追踪**：每次AI建议、用户操作和系统执行都要有LOG，保证可审计性
+
+### 流程概览
+
+```
+[AI生成决策建议] → [人类确认/修改] → [系统执行操作] → [日志记录]
+```
+
+### 详细流程
+
+#### 1. AI生成决策建议
+- **输入**：历史数据 + 实时数据 + 规则库
+- **输出示例**：
+  ```json
+  {
+    "action": "调整价格",
+    "params": {"sku": "A123", "new_price": 88.5},
+    "confidence": 0.92,
+    "risk_level": "low",
+    "alternative_solutions": [
+      {"action": "促销折扣", "params": {"sku":"A123", "discount":10}, "confidence":0.85}
+    ]
+  }
+  ```
+- **设计要点**：
+  - 每个建议带 **置信度、风险等级、替代方案**
+  - 支持多维度评分（收益、风险、用户体验）
+
+#### 2. 人类确认/修改
+- **UI/插件端展示**：
+  - 建议动作、参数、风险提示
+  - 支持修改参数或拒绝
+  - 可选"自动执行模式"，允许置信度高于阈值自动执行
+- **记录内容**：
+  - 谁确认/修改
+  - 修改内容及理由
+  - 时间戳
+
+#### 3. 系统执行操作
+- **执行方式**：API调用 / 脚本执行 / 自动化任务
+- **失败重试策略**：
+  - 可配置重试次数
+  - 超时或失败记录到日志
+- **成功后**：返回执行状态，更新状态数据库
+
+#### 4. 日志记录
+- **全链路ID关联**：每条操作有唯一ID，AI建议→人操作→系统执行关联
+- **日志结构示例**：
+  ```json
+  {
+    "operation_id": "20260319-001",
+    "ai_suggestion": {
+      "action": "调整价格",
+      "params": {"sku": "A123", "new_price": 88.5},
+      "confidence": 0.92,
+      "timestamp": "2026-03-19T00:00:00"
+    },
+    "human_review": {
+      "operator": "操作员姓名",
+      "modified_params": {"new_price": 89.0},
+      "reason": "小幅提升利润",
+      "timestamp": "2026-03-19T00:05:00"
+    },
+    "system_execution": {
+      "status": "success",
+      "timestamp": "2026-03-19T00:06:00"
+    }
+  }
+  ```
+
+### 自动化程度演进
+
+| 阶段 | AI角色 | 人类角色 | 说明 |
+|------|--------|----------|------|
+| **初期** | 建议生成 | 审核确认 | 人工操作占主导 |
+| **中期** | 自动执行（高置信度） | 异常处理 | 对置信度高、低风险的操作可自动执行 |
+| **后期** | 全链路决策 | 仅异常介入 | AI全链路决策 + 自动执行 |
+
+### 角色与权限
+
+| 角色 | 权限 | 备注 |
+|------|------|------|
+| AI Agent | 决策生成、数据分析、风险评估 | 输出建议，带置信度 |
+| 人类操作者 | 审核/修改/确认 | 前期高干预，后期可降低 |
+| 系统执行层 | 自动化操作执行 | 仅执行经过确认的操作 |
+| 日志管理系统 | 全链路记录 | 可回溯，每条操作打时间戳 |
+
+### 智能决策应用场景
+
+1. **智能定价与动态调价**
+2. **智能库存预测与补货**
+3. **智能广告投放与优化**
+4. **智能客户服务与售后**
+5. **智能风控与异常检测**
+
 - **决策点**：
  - 模型选择（监督学习vs无监督学习）
  - 预测结果置信度阈值
  - 人工干预时机
  - 模型更新频率
+  - 自动执行阈值设定
 - **输入**：业务数据、市场数据、用户行为数据
- **输出**：智能决策建议、预测结果、优化方案
- **状态机**：`DATA_COLLECTION` → `MODEL_TRAINING` → `DECISION_MAKING` → `EXECUTION` → `FEEDBACK`
+- **输出**：智能决策建议、预测结果、优化方案、执行日志
+- **状态机**：`DATA_COLLECTION` → `AI_SUGGESTION` → `HUMAN_REVIEW` → `EXECUTION` → `LOGGING` → `FEEDBACK`
+- **关键指标**：
+  - AI建议采纳率
+  - 自动执行比例
+  - 人工干预次数
+  - 决策准确率
+  - 执行成功率

 ***

@@ -2659,6 +2753,474 @@ Controller

 ***

+## 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`
+- **关键指标**：
+  - 商户总数
+  - 活跃商户数
+  - 平均ROI
+  - 最高ROI
+  - 榜单更新频率
+- **数据表**：
+  - `cf_merchant_metrics`：商户指标汇总表
+  - `cf_leaderboard`：排行榜表
+  - `cf_leaderboard_history`：排行榜历史表
+
+***
+
+## 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`
+- **关键指标**：
+  - 策略总数
+  - 活跃策略数
+  - 策略使用次数
+  - 平均ROI
+  - 策略收益
+- **数据表**：
+  - `cf_strategies`：策略表
+  - `cf_merchant_strategies`：商户策略关联表
+  - `cf_strategy_usage`：策略使用记录表
+  - `cf_strategy_metrics`：策略指标表
+
+***
+
+## 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`
+- **关键指标**：
+  - 商品池大小
+  - 选品成功率
+  - 平均ROI
+  - 上架成功率
+  - 自动化率
+- **数据表**：
+  - `cf_products_pool`：商品池表
+  - `cf_merchant_products`：商户商品表
+  - `cf_product_selection_logs`：选品记录表
+  - `cf_product_metrics`：商品指标表
+
+***
+
+## 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`
+- **关键指标**：
+  - 托管商户数
+  - 自动化运营率
+  - 平均ROI
+  - 风险事件数
+  - 紧急停止次数
+- **数据表**：
+  - `cf_autopilot_config`：托管配置表
+  - `cf_autopilot_status`：托管状态表
+  - `cf_autopilot_logs`：托管日志表
+  - `cf_autopilot_decisions`：托管决策表
+
+***
+
+## 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`
+- **关键指标**：
+  - 套利机会数
+  - 套利成功率
+  - 平均利润
+  - 平均ROI
+  - 风险事件数
+- **数据表**：
+  - `cf_arbitrage_products`：套利商品表
+  - `cf_arbitrage_opportunities`：套利机会表
+  - `cf_arbitrage_orders`：套利订单表
+  - `cf_arbitrage_profits`：套利利润表
+
+***
+
+## 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`
+- **关键指标**：
+  - 价格调整次数
+  - 平均利润率
+  - 转化率
+  - ROI
+  - 定价准确率
+- **数据表**：
+  - `cf_pricing_decisions`：定价决策表
+  - `cf_pricing_history`：定价历史表
+  - `cf_competitor_prices`：竞争对手价格表
+  - `cf_pricing_metrics`：定价指标表
+
+***
+
+## 5️⃣7️⃣ 多店铺管理闭环（Multi-Shop Management Loop）🆕
+
+- **目标**：实现多店铺、多商户、多部门的统一管理与数据隔离，支持独立站/外部独立站/报表等一对多交互
+- **层级架构**：
+  ```
+  商户(Merchant) → 部门(Department) → 店铺(Shop)
+       ↓                ↓                ↓
+    商户级数据        部门级数据        店铺级数据
+  ```
+- **流程**：
+  1. **店铺注册与配置**：
+     - 店铺类型划分（独立站/平台店/外部独立站）
+     - 平台账号绑定
+     - 店铺基础信息配置
+     - 店铺状态管理
+  2. **权限配置**：
+     - 层级权限继承
+     - 数据访问范围控制
+     - 操作权限分配
+     - 角色管理
+  3. **数据隔离**：
+     - 店铺级数据隔离
+     - 部门级数据聚合
+     - 商户级数据汇总
+     - 跨店铺数据访问控制
+  4. **业务操作**：
+     - 商品管理（单店/批量）
+     - 订单管理（单店/聚合）
+     - 库存管理（单店/同步）
+     - 价格管理（单店/批量）
+  5. **报表聚合**：
+     - 单店报表
+     - 部门聚合报表
+     - 商户汇总报表
+     - 跨店对比分析
+- **决策点**：
+  - 店铺类型划分标准
+  - 数据权限边界定义
+  - 报表聚合规则
+  - 跨店操作权限
+- **输入**：店铺信息、商户信息、部门信息、用户角色
+- **输出**：
+  - 店铺管理界面
+  - 跨店铺数据报表
+  - 权限控制策略
+  - 数据隔离配置
+- **状态机**：`SHOP_REGISTERED` → `SHOP_CONFIGURED` → `SHOP_ACTIVE` → `SHOP_SUSPENDED` → `SHOP_CLOSED`
+- **关键指标**：
+  - 店铺数量
+  - 活跃店铺数
+  - 跨店订单量
+  - 数据隔离有效性
+  - 报表生成效率
+- **数据表**：
+  - `cf_shop`：店铺主表（含层级关系）
+  - `cf_department`：部门表
+  - `cf_merchant`：商户表
+  - `cf_shop_config`：店铺配置表
+  - `cf_shop_permission`：店铺权限表
+- **📋 技术实现指引**：
+  | 层级 | 实现模块 | 关键文件 | 任务ID |
+  | -- | ------- | ------ | ---- |
+  | 后端 | 数据隔离服务 | `DataIsolationService.ts` | BE-MT001 |
+  | 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts` | BE-MT002 |
+  | 后端 | 订单聚合服务 | `OrderAggregationService.ts` | BE-ORDER-MS001 |
+  | 后端 | 报表聚合服务 | `ShopReportAggregationService.ts` | BE-SHOP-REP001 |
+  | 前端 | 层级选择器组件 | `HierarchySelector.tsx` | FE-MT001 |
+  | 前端 | 多店铺管理页面 | `MerchantManage.tsx, ShopManage.tsx` | FE-MT002 |
+  | 前端 | 订单多店铺页面 | `OrderMultiShopList.tsx, OrderAggregate.tsx` | FE-ORDER-MS001, FE-ORDER-MS002 |
+  | 前端 | 多店铺报表页面 | `MultiShopReport.tsx` | FE-SHOP-REP001 |
+
+***
+
+## 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`
+- **关键指标**：
+  - 商户数量
+  - 部门数量
+  - 店铺数量
+  - 层级数据隔离有效性
+  - 权限配置准确性
+- **数据表**：
+  - `cf_merchant`：商户主表
+  - `cf_department`：部门表（含商户ID、父部门ID）
+  - `cf_shop`：店铺表（含商户ID、部门ID）
+  - `cf_user_hierarchy`：用户层级关系表
+- **📋 技术实现指引**：
+  | 层级 | 实现模块 | 关键文件 | 任务ID |
+  | -- | ------- | ------ | ---- |
+  | 后端 | 层级服务 | `HierarchyService.ts` | BE-MT001 |
+  | 后端 | 层级权限中间件 | `HierarchyAuthMiddleware.ts` | BE-MT002 |
+  | 前端 | 层级选择器 | `HierarchySelector.tsx` | FE-MT001 |
+  | 前端 | 层级管理页面 | `HierarchyManage.tsx` | FE-MT002 |
+
+***
+
 ### 📋 业务审核状态机

 - **通用审核流程**：`SUBMITTED` (提交) → `PENDING_REVIEW` (人工审核) → `EXECUTED` / `REJECTED`