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

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

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

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

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

View File

@@ -0,0 +1,130 @@
# Orders 页面前端业务说明书
## 1⃣ 页面定义
### 页面目标
帮助商户:
- 管理订单信息
- 跟踪订单状态
- 分析订单数据
- 优化订单处理流程
- 监控现金流
### 页面类型
- 业务核心页(直接影响现金流)
## 2⃣ 页面核心数据
### 核心数据字段
- orderId订单ID唯一标识订单
- customerInfo客户信息客户姓名、联系方式等
- productList商品列表订单包含的商品
- totalAmount总金额订单总金额
- status订单状态待处理、已发货、已完成、已取消等
- paymentStatus支付状态待支付、已支付、已退款等
- shippingInfo物流信息物流单号、物流公司等
- profit利润订单利润
- roiROI订单投资回报率
- createdAt创建时间订单创建时间
- updatedAt更新时间订单更新时间
## 3⃣ 页面核心操作
### 用户操作
- 查看订单列表:浏览所有订单
- 查看订单详情:查看单个订单的详细信息
- 更新订单状态:修改订单状态
- 处理异常订单:处理异常情况的订单
- 分析订单数据:查看订单统计和趋势
- 导出订单数据导出订单数据为Excel或CSV
## 4⃣ 操作 → 业务结果
### 操作闭环
1. **更新订单状态**
- 触发:用户点击"更新状态"按钮
- 服务OrderService.updateStatus
- 结果:更新订单状态,触发相关业务流程(如发货、结算等)
- 反馈:显示状态更新成功提示
2. **处理异常订单**
- 触发:用户点击"处理异常"按钮
- 服务OrderService.handleException
- 结果:标记异常订单,触发异常处理流程
- 反馈:显示异常处理成功提示
3. **分析订单数据**
- 触发:用户点击"分析"按钮
- 服务AnalyticsService.analyzeOrders
- 结果生成订单分析报告显示销售趋势和ROI
- 反馈:显示分析结果和图表
## 5⃣ 页面状态
### 状态定义
- loading数据加载中
- empty无订单数据
- error操作错误
- success操作成功
- processing订单处理中
- exception订单异常
## 6⃣ 收费点
### 收费触发点
- 高级订单分析:按功能使用时间收费
- 批量订单处理:按操作次数收费
- 订单数据导出:按导出数据量收费
## 7⃣ 页面结构
### 主要区域
1. **订单列表区**:显示所有订单,包含核心数据字段
2. **订单详情区**:显示单个订单的详细信息
3. **订单状态区**:显示和更新订单状态
4. **异常订单区**:显示和处理异常订单
5. **订单分析区**:显示订单统计和趋势分析
## 8⃣ 业务价值
### 核心价值
- 帮助商户实时跟踪订单状态
- 优化订单处理流程,提高效率
- 分析订单数据,识别销售趋势
- 监控现金流,确保资金安全
- 及时处理异常订单,减少损失
### 商业闭环
订单创建 → 支付 → 处理 → 发货 → 完成 → 结算 → 分析
## 9⃣ 前端实现要点
### 技术实现
- 使用React组件化开发
- 集成Ant Design表格和表单组件
- 实现虚拟列表,优化大数据量渲染
- 使用Umi Model管理全局状态
- 实现实时数据更新和WebSocket连接
### 用户体验
- 响应式设计,支持多终端访问
- 操作反馈及时显示loading和success/error提示
- 数据可视化,使用图表展示订单趋势和分析
- 批量操作支持,提高工作效率
- 订单状态颜色区分,直观显示订单状态
## 🔟 后端服务依赖
### 核心服务
- OrderService订单管理和状态更新
- AnalyticsService订单数据分析
- LogisticsService物流信息管理
- SettlementService订单结算
### 数据接口
- GET /api/v1/orders获取订单列表
- GET /api/v1/orders/:id获取订单详情
- PUT /api/v1/orders/:id/status更新订单状态
- POST /api/v1/orders/:id/exception处理异常订单
- GET /api/v1/orders/analytics获取订单分析数据
- POST /api/v1/orders/export导出订单数据