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

- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
This commit is contained in:
2026-03-23 12:41:35 +08:00
parent a037843851
commit 2b86715c09
363 changed files with 39305 additions and 40622 deletions

View File

@@ -0,0 +1,26 @@
# 测试文档索引
> **模块**: 07_Testing - 测试规范与质量保障
> **更新日期**: 2026-03-19
---
## 核心文档
| 文档 | 描述 | 状态 |
|------|------|------|
| [01_Test_Spec](01_Test_Spec.md) | 测试规范与标准 | ✅ |
| [02_Quality_Optimization](02_Quality_Optimization.md) | 质量优化方案 | ✅ |
---
## 关联模块
- [后端模块](../02_Backend/00_Backend_Index.md)
- [前端模块](../03_Frontend/00_Frontend_Index.md)
---
## 最近更新
- 2026-03-19: 重构测试文档结构,统一命名规范

View File

@@ -0,0 +1,134 @@
# TEST_SPEC
## 1. 功能开通测试
- 未开通访问 → 403
- 创建支付单 → 成功
- 支付成功 → 状态变 active
- 权限生效
- 账单生成
- 功能过期 → 自动变为 expired
- 功能暂停 → 状态变 suspended
---
## 2. 多商户订单测试
- 一个订单 → 多子订单
- 每个子订单归属正确商户
- 库存正确扣减
- 订单状态流转正确
- 子订单状态与主订单状态同步
---
## 3. 结算测试
- 订单完成 → 生成账单
- 抽成正确
- 商户收入正确
- 结算周期正确
- 账单状态流转正确
---
## 4. 权限测试
- A商户不能访问B数据
- 未开通功能不能访问
- 不同角色权限正确
- 超级管理员可访问所有数据
- 权限变更生效
---
## 5. 状态机测试
- 不允许跳状态(如 pending → completed
- 状态变更必须通过 Service
- 状态变更触发相关业务逻辑
- 状态变更记录操作日志
---
## 6. 商户管理测试
- 商户注册 → 成功
- 商户认证 → 成功
- 商户状态变更 → 正确
- 商户信息修改 → 成功
- 商户删除 → 正确处理相关数据
---
## 7. 店铺管理测试
- 店铺创建 → 成功
- 店铺信息修改 → 成功
- 店铺状态变更 → 正确
- 店铺绑定平台 → 成功
---
## 8. 商品管理测试
- 商品创建 → 成功
- 商品上下架 → 正确
- 商品信息修改 → 成功
- 商品库存更新 → 正确
---
## 9. 库存管理测试
- 库存同步 → 成功
- 库存预警 → 正确
- 库存状态变更 → 正确
- 多仓库库存管理 → 正确
---
## 10. 数据分析测试
- 销售报表生成 → 成功
- 库存报表生成 → 成功
- 财务报表生成 → 成功
- 数据导出 → 成功
---
## 11. 异常处理测试
- 支付失败 → 正确处理
- 库存不足 → 阻止下单
- 权限错误 → 返回 403
- 系统异常 → 记录日志并报警
---
## 12. 性能测试
- API 响应时间 < 500ms
- 并发处理能力 ≥ 100 QPS
- 大数据量查询性能
- 系统稳定性测试
---
## 13. 安全测试
- 密码加密存储
- 敏感数据保护
- 防止 SQL 注入
- 防止 XSS 攻击
- API 调用认证
---
## 测试执行规范
- 所有测试必须基于 SERVICE_MAP 定义的流程
- 测试用例必须覆盖所有状态流转
- 测试结果必须记录详细日志
- 测试失败必须及时修复
- 定期执行回归测试

View File

@@ -0,0 +1,44 @@
# 💎 Quality & Optimization (Crawlful Hub)
> **定位**Crawlful Hub 质量保障与内容优化 - 包含前端交付标准、UX 检查清单及文档内容分析报告。
> **更新日期**: 2026-03-17
---
## 1. 前端交付质量标准 (Frontend Delivery)
### 1.1 UI/UX 规范
- **框架**: UmiJS 4.x, Ant Design 5.x.
- **交互模式**: 业务审核工作流 (Business-Review-Workflow).
- **Red Lines (严禁事项)**: 严禁 Mock 数据、严禁越权修改、严禁敏感数据暴露。
### 1.2 性能优化
- **加载**: Code Splitting, Lazy Loading.
- **请求**: TanStack Query 缓存, 减少重渲染.
---
## 2. 用户体验检查清单 (UX Checklist)
### 2.1 加载与响应
- [ ] 异步操作展示 Loading 状态。
- [ ] 长时操作展示进度。
- [ ] 按钮点击反馈即时。
### 2.2 错误与异常
- [ ] 4xx 错误展示具体根因分析,而非模糊的“系统错误”。
- [ ] 5xx 错误展示友好提示并记录 `traceId`
---
## 3. 文档内容分析报告 (Document Review)
### 3.1 质量与优化
- **命名规范**: 文件名必须使用小写短横线 (kebab-case)。
- **分类存放**: `docs/blueprints/`, `docs/quality/` 等。
- **引用闭环**: 文档内引用必须使用完整 Markdown 链接。
- **原子化更新**: 每次功能变更必须同步更新对应蓝图。
### 3.2 文档地图
- 建议维护 `doc-index.md` 索引,确保全量文档导航。
- 定期审查文档结构,确保与物理文件系统保持一致。