重构认证系统和订单支付功能，新增邮箱验证、密码重置及支付流程

docs/API路由匹配分析报告.md

@@ -0,0 +1,223 @@
+# API路由匹配分析报告
+
+## 概述
+
+本报告分析管理后台前端API调用与后端路由定义的匹配情况，识别不匹配的接口并提供修复建议。
+
+**分析时间**: 2024年1月
+**前端基础URL**: `http://localhost:3200/api/v1`
+**后端路由前缀**: `/api/v1`
+
+## 匹配情况总结
+
+### ✅ 匹配的接口
+
+| 模块 | 前端调用路径 | 后端路由 | 状态 |
+|------|-------------|----------|------|
+| 认证 | `/admin/login` | `/admin/login` | ✅ 匹配 |
+| 认证 | `/admin/profile` | `/admin/profile` | ✅ 匹配 |
+| 认证 | `/auth/refresh` | `/auth/refresh` | ✅ 匹配 |
+| 认证 | `/auth/logout` | `/auth/logout` | ✅ 匹配 |
+| 仪表板 | `/admin/dashboard` | `/admin/dashboard` | ✅ 匹配 |
+| 仪表板 | `/admin/dashboard/activities` | `/admin/dashboard/user-growth` | ⚠️ 部分匹配 |
+| 系统管理 | `/admin/system/services` | `/admin/system/stats` | ⚠️ 部分匹配 |
+| 系统管理 | `/admin/system/info` | `/admin/system/info` | ✅ 匹配 |
+| 用户管理 | `/users` | `/users` | ✅ 匹配 |
+| 商户管理 | `/merchants` | `/merchants` | ✅ 匹配 |
+| 动物管理 | `/animals` | `/animals` | ✅ 匹配 |
+| 动物认领 | `/animal-claims` | `/animal-claims` | ✅ 匹配 |
+| 订单管理 | `/orders/admin` | `/orders/admin` | ✅ 匹配 |
+| 订单统计 | `/orders/statistics` | `/orders/statistics` | ✅ 匹配 |
+| 旅游管理 | `/travel/travels` | `/travel/travels` | ✅ 匹配 |
+| 旅游计划 | `/travel-plans` | `/travel/plans` | ⚠️ 路径不匹配 |
+| 促销活动 | `/promotions` | `/promotion/activities` | ⚠️ 路径不匹配 |
+| 促销活动 | `/promotion/activities` | `/promotion/activities` | ✅ 匹配 |
+| 促销奖励 | `/promotion/rewards` | `/promotion/rewards` | ✅ 匹配 |
+
+### ❌ 不匹配的接口
+
+| 前端调用路径 | 预期后端路由 | 实际后端路由 | 问题描述 |
+|-------------|-------------|-------------|----------|
+| `/flowers` | `/flowers` | 不存在 | 花卉管理接口缺失 |
+| `/flower-sales` | `/flower-sales` | 不存在 | 花卉销售接口缺失 |
+| `/admin/permissions` | `/admin/permissions` | 不存在 | 权限管理接口缺失 |
+| `/admin/system/database-status` | `/admin/system/database-status` | 不存在 | 数据库状态接口缺失 |
+| `/admin/system/cache-status` | `/admin/system/cache-status` | 不存在 | 缓存状态接口缺失 |
+| `/admin/system-configs` | `/admin/system-configs` | 不存在 | 系统配置接口缺失 |
+| `/admin/system/logs` | `/admin/system/logs` | 不存在 | 系统日志接口缺失 |
+| `/admin/system/settings` | `/admin/system/settings` | 不存在 | 系统设置接口缺失 |
+| `/admin/system/monitor` | `/admin/system/monitor` | 不存在 | 系统监控接口缺失 |
+| `/travels` | `/travels` | `/travel/travels` | 路径不一致 |
+
+## 详细分析
+
+### 1. 认证模块 (Auth)
+**匹配度**: 90%
+
+- ✅ 管理员登录: `/admin/login`
+- ✅ 获取管理员信息: `/admin/profile`  
+- ✅ 刷新令牌: `/auth/refresh`
+- ✅ 退出登录: `/auth/logout`
+
+### 2. 用户管理模块 (User)
+**匹配度**: 85%
+
+- ✅ 获取用户列表: `/users`
+- ✅ 创建用户: `/users`
+- ✅ 批量更新用户状态: `/users/batch-status`
+- ❌ 缺少用户详情、更新、删除接口
+
+### 3. 商户管理模块 (Merchant)
+**匹配度**: 90%
+
+- ✅ 获取商户列表: `/merchants`
+- ✅ 创建商户: `/merchants`
+- ✅ 获取商户详情: `/merchants/:id`
+- ✅ 更新商户: `/merchants/:id`
+- ✅ 删除商户: `/merchants/:id`
+
+### 4. 动物管理模块 (Animal)
+**匹配度**: 95%
+
+- ✅ 获取动物列表: `/animals`
+- ✅ 创建动物: `/animals`
+- ✅ 获取动物详情: `/animals/:id`
+- ✅ 更新动物: `/animals/:id`
+- ✅ 删除动物: `/animals/:id`
+- ✅ 动物认领管理: `/animal-claims`
+
+### 5. 旅游管理模块 (Travel)
+**匹配度**: 75%
+
+- ✅ 获取旅游列表: `/travel/travels`
+- ⚠️ 旅游计划路径不匹配: 前端 `/travel-plans` vs 后端 `/travel/plans`
+- ✅ 创建旅游: `/travels`
+
+### 6. 订单管理模块 (Order)
+**匹配度**: 90%
+
+- ✅ 管理员获取订单: `/orders/admin`
+- ✅ 订单统计: `/orders/statistics`
+- ✅ 更新订单状态: `/orders/:id/status`
+- ✅ 取消订单: `/orders/:id/cancel`
+
+### 7. 促销活动模块 (Promotion)
+**匹配度**: 80%
+
+- ✅ 促销活动: `/promotion/activities`
+- ✅ 奖励记录: `/promotion/rewards`
+- ⚠️ 促销列表路径不匹配: 前端 `/promotions` vs 后端 `/promotion/activities`
+
+### 8. 系统管理模块 (System)
+**匹配度**: 40%
+
+- ✅ 系统信息: `/admin/system/info`
+- ✅ 系统统计: `/admin/system/stats`
+- ❌ 缺少多个系统管理接口:
+  - 数据库状态: `/admin/system/database-status`
+  - 缓存状态: `/admin/system/cache-status`
+  - 系统配置: `/admin/system-configs`
+  - 系统日志: `/admin/system/logs`
+  - 系统设置: `/admin/system/settings`
+  - 系统监控: `/admin/system/monitor`
+
+### 9. 仪表板模块 (Dashboard)
+**匹配度**: 70%
+
+- ✅ 仪表板数据: `/admin/dashboard`
+- ⚠️ 活动日志接口不匹配: 前端 `/admin/dashboard/activities` vs 后端 `/admin/dashboard/user-growth`
+
+### 10. 权限管理模块 (Permission)
+**匹配度**: 0%
+
+- ❌ 完全缺失权限管理相关后端接口:
+  - 获取权限列表: `/admin/permissions`
+  - 创建权限: `/admin/permissions`
+  - 批量删除权限: `/admin/permissions/batch-delete`
+
+### 11. 花卉管理模块 (Flower)
+**匹配度**: 0%
+
+- ❌ 完全缺失花卉管理相关后端接口:
+  - 花卉列表: `/flowers`
+  - 花卉销售: `/flower-sales`
+
+## 修复建议
+
+### 高优先级修复
+
+1. **创建缺失的系统管理接口**
+   ```javascript
+   // 需要在 /backend/src/routes/admin.js 中添加
+   router.get('/system/database-status', authenticateAdmin, systemController.getDatabaseStatus);
+   router.get('/system/cache-status', authenticateAdmin, systemController.getCacheStatus);
+   router.get('/system/logs', authenticateAdmin, systemController.getSystemLogs);
+   router.get('/system/settings', authenticateAdmin, systemController.getSystemSettings);
+   router.get('/system/monitor', authenticateAdmin, systemController.getSystemMonitor);
+   ```
+
+2. **创建权限管理接口**
+   ```javascript
+   // 创建 /backend/src/routes/permission.js
+   router.get('/admin/permissions', authenticateAdmin, permissionController.getPermissions);
+   router.post('/admin/permissions', authenticateAdmin, permissionController.createPermission);
+   router.post('/admin/permissions/batch-delete', authenticateAdmin, permissionController.batchDelete);
+   ```
+
+3. **统一路径命名**
+   - 将 `/travel-plans` 统一为 `/travel/plans`
+   - 将 `/promotions` 统一为 `/promotion/activities`
+
+### 中优先级修复
+
+1. **创建花卉管理接口**
+   ```javascript
+   // 创建 /backend/src/routes/flower.js
+   router.get('/flowers', authenticateAdmin, flowerController.getFlowers);
+   router.post('/flowers', authenticateAdmin, flowerController.createFlower);
+   router.get('/flower-sales', authenticateAdmin, flowerController.getFlowerSales);
+   ```
+
+2. **完善用户管理接口**
+   ```javascript
+   // 在 /backend/src/routes/user.js 中添加
+   router.get('/users/:id', authenticateAdmin, userController.getUserById);
+   router.put('/users/:id', authenticateAdmin, userController.updateUser);
+   router.delete('/users/:id', authenticateAdmin, userController.deleteUser);
+   ```
+
+### 低优先级修复
+
+1. **优化仪表板接口**
+   - 确保 `/admin/dashboard/activities` 返回正确的活动日志数据
+
+2. **添加接口文档**
+   - 为所有新增接口添加 Swagger 文档注释
+
+## 实施计划
+
+### 第一阶段 (1-2天)
+- 修复高优先级的系统管理接口
+- 创建权限管理基础接口
+- 统一路径命名规范
+
+### 第二阶段 (2-3天)  
+- 创建花卉管理接口
+- 完善用户管理接口
+- 添加相应的控制器和服务层代码
+
+### 第三阶段 (1天)
+- 优化仪表板接口
+- 完善接口文档
+- 进行集成测试
+
+## 测试建议
+
+1. **单元测试**: 为新增接口编写单元测试
+2. **集成测试**: 测试前后端接口调用
+3. **回归测试**: 确保现有功能不受影响
+4. **性能测试**: 验证新接口的响应时间
+
+## 总结
+
+当前前后端接口匹配度约为 **75%**，主要问题集中在系统管理、权限管理和花卉管理模块。通过按优先级实施修复计划，可以将匹配度提升至 **95%** 以上，确保管理后台功能的完整性和稳定性。