refactor: 优化代码结构并修复类型问题

- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
2026-03-23 12:41:35 +08:00
parent a037843851
commit 2b86715c09
363 changed files with 39305 additions and 40622 deletions
--- a/docs/ARCHIVE/00_Business/tasks/backend/16_merchant.md
+++ b/docs/ARCHIVE/00_Business/tasks/backend/16_merchant.md
@@ -0,0 +1,150 @@
+# 多商户功能收费后端任务
+
+## 任务列表
+
+| Task ID  | 闭环关联      | 任务描述      | 输入         | 输出       | 触发条件 | 状态          | 优先级 | 依赖       | 预计耗时 | 负责人           | 完成时间 |
+| -------- | --------- | --------- | ---------- | -------- | ---- | ----------- | --- | -------- | ---- | ------------- | -------- |
+| BE-MV001 | 多商户入驻闭环   | 商户注册与认证接口 | 商户信息, 资质文件 | 商户ID, 状态 | 前端提交 | ✅ completed | P1  | -        | 12h  | AI-Backend-12 | 2026-03-20 |
+| BE-MV002 | 多商户入驻闭环   | 商户店铺管理    | 商户ID, 店铺信息 | 店铺ID     | 前端提交 | ✅ completed | P1  | BE-MV001 | 10h  | AI-Backend-12 | 2026-03-20 |
+| BE-MV003 | 功能模块化闭环   | 功能模块管理    | 模块ID, 配置   | 模块状态     | 系统配置 | ✅ completed | P1  | BE-MV001 | 8h   | AI-Backend-12 | 2026-03-20 |
+| BE-MV004 | 功能开通与支付闭环 | 功能开通接口    | 商户ID, 模块ID | 开通记录     | 前端提交 | ✅ completed | P1  | BE-MV003 | 10h  | AI-Backend-12 | 2026-03-20 |
+| BE-MV005 | 功能开通与支付闭环 | 功能费用计算    | 商户ID, 使用数据 | 费用明细     | 定时任务 | ✅ completed | P1  | BE-MV004 | 8h   | AI-Backend-12 | 2026-03-20 |
+| BE-MV006 | 多商户结算闭环   | 商户结算引擎    | 商户ID, 结算周期 | 结算单      | 定时任务 | ✅ completed | P1  | BE-MV005 | 12h  | AI-Backend-12 | 2026-03-20 |
+| BE-MV007 | 多商户订单闭环   | 多商户订单拆分   | 订单ID, 商户列表 | 子订单列表    | 订单创建 | ✅ completed | P1  | BE-MV002 | 10h  | AI-Backend-12 | 2026-03-20 |
+| BE-MV008 | 多商户库存闭环   | 多商户库存同步   | 商户ID, 库存数据 | 同步状态     | 库存变化 | ✅ completed | P1  | BE-MV002 | 8h   | AI-Backend-12 | 2026-03-20 |
+
+## 相关闭环
+
+- 多商户入驻闭环
+- 功能模块化闭环
+- 功能开通与支付闭环
+- 多商户结算闭环
+- 多商户订单闭环
+- 多商户库存闭环
+
+## 依赖关系
+
+```
+BE-MV001 ─┬─► BE-MV002 ─┬─► BE-MV007
+          │            └─► BE-MV008
+          └─► BE-MV003 ─► BE-MV004 ─► BE-MV005 ─► BE-MV006
+```
+
+## 数据库表结构
+
+### cf_merchant
+| 字段 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| id | string | 商户ID |
+| tenant_id | string | 租户ID |
+| name | string | 商户名称 |
+| contact_name | string | 联系人姓名 |
+| contact_email | string | 联系人邮箱 |
+| status | enum | PENDING/ACTIVE/INACTIVE/SUSPENDED |
+| created_at | datetime | 创建时间 |
+| updated_at | datetime | 更新时间 |
+
+### cf_merchant_shop
+| 字段 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| id | string | 店铺ID |
+| merchant_id | string | 商户ID |
+| name | string | 店铺名称 |
+| domain | string | 店铺域名 |
+| status | enum | ACTIVE/INACTIVE/MAINTENANCE |
+| created_at | datetime | 创建时间 |
+| updated_at | datetime | 更新时间 |
+
+### cf_feature_module
+| 字段 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| id | string | 模块ID |
+| name | string | 模块名称 |
+| description | text | 模块描述 |
+| price | decimal(10,2) | 模块价格 |
+| status | enum | ACTIVE/INACTIVE |
+| created_at | datetime | 创建时间 |
+| updated_at | datetime | 更新时间 |
+
+### cf_merchant_feature
+| 字段 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| id | string | 开通记录ID |
+| merchant_id | string | 商户ID |
+| module_id | string | 模块ID |
+| start_date | datetime | 开始日期 |
+| end_date | datetime | 结束日期 |
+| status | enum | ACTIVE/EXPIRED/CANCELLED |
+| created_at | datetime | 创建时间 |
+| updated_at | datetime | 更新时间 |
+
+### cf_merchant_settlement
+| 字段 | 类型 | 说明 |
+| ---- | ---- | ---- |
+| id | string | 结算单ID |
+| merchant_id | string | 商户ID |
+| period_start | datetime | 结算开始日期 |
+| period_end | datetime | 结算结束日期 |
+| amount | decimal(10,2) | 结算金额 |
+| status | enum | PENDING/COMPLETED/FAILED |
+| created_at | datetime | 创建时间 |
+| updated_at | datetime | 更新时间 |
+
+## API端点
+
+### 商户管理API
+- `GET /api/merchant/merchants` - 获取商户列表
+- `POST /api/merchant/merchants` - 注册商户
+- `GET /api/merchant/merchants/:id` - 获取商户详情
+- `PUT /api/merchant/merchants/:id` - 更新商户信息
+- `GET /api/merchant/shops` - 获取店铺列表
+- `POST /api/merchant/shops` - 创建店铺
+- `GET /api/merchant/shops/:id` - 获取店铺详情
+
+### 功能管理API
+- `GET /api/merchant/modules` - 获取功能模块列表
+- `POST /api/merchant/modules` - 创建功能模块
+- `GET /api/merchant/modules/:id` - 获取模块详情
+- `POST /api/merchant/features/activate` - 开通功能
+- `GET /api/merchant/features/:merchantId` - 获取商户已开通功能
+- `POST /api/merchant/billing/calculate` - 计算功能费用
+- `GET /api/merchant/settlements/:merchantId` - 获取商户结算单
+
+## 验收标准
+
+- [ ] 商户注册与认证接口能正确处理商户注册和认证
+- [ ] 商户店铺管理能有效管理商户店铺
+- [ ] 功能模块管理能正确管理功能模块
+- [ ] 功能开通接口能正确开通功能
+- [ ] 功能费用计算能准确计算费用
+- [ ] 商户结算引擎能正确生成结算单
+- [ ] 多商户订单拆分能正确拆分订单
+- [ ] 多商户库存同步能及时同步库存
+- [ ] 所有接口响应时间不超过2秒
+- [ ] 数据一致性得到保证
+
+## 测试要求
+
+- [ ] 单元测试：覆盖商户管理和功能开通逻辑
+- [ ] 集成测试：验证与订单和库存系统的交互
+- [ ] 端到端测试：模拟完整的商户管理流程
+- [ ] 边界测试：测试异常数据和边界情况
+
+## 风险提示
+
+- **风险点1**：商户资质审核不严格 - 应对措施：建立严格的审核流程和标准
+- **风险点2**：功能费用计算错误 - 应对措施：实现多重校验和审计机制
+- **风险点3**：结算流程异常 - 应对措施：建立结算异常处理机制和人工审核
+
+## 性能要求
+
+- 响应时间：平均响应时间 < 2秒
+- 并发处理：支持200个并发请求
+- 数据处理：能处理5000条商户记录/小时
+
+## 安全要求
+
+- 权限控制：只有ADMIN和MERCHANT角色可访问商户数据
+- 数据加密：敏感商户信息加密存储
+- 审计日志：所有商户操作需记录详细日志
+- 输入验证：严格验证所有商户相关输入