li
ee2b1757d0
- 新增 registration_packages 表：管理员配置注册套餐（名称/角色） - AuthController 新增 register() 和 registrationPackages() 公开接口 - UserController 新增 approve() / reject() 审核接口 - StoreController 新增 publicList() 公开门店列表 - 前端 /register 注册页：选门店→选岗位套餐→填信息→提交 - 前端 system/registration-packages：套餐 CRUD - 用户管理页：待审核状态展示 + 通过/拒绝快捷操作 - 登录页底部加「申请注册」跳转链接 - 路由白名单加 /register
5.7 KiB
5.7 KiB
前后端接口联调检查报告
生成时间：2026-03-14 检查范围：前端
src/api/*.js↔ 后端routes/api.php
总体评估
| 模块 | 状态 | 备注 |
|---|---|---|
| 系统设置 | ✅ 完全匹配 | |
| CRM | ✅ 完全匹配 | |
| 房务 Room | ✅ 完全匹配 | |
| 护理 Care | ✅ 已修复 | resolve→handle别名修复；healthMetric.delete移除 |
| 月子餐 Meal | ⚠️ 部分匹配 | getDetail不存在后端路由（见下） |
| 服务产康 Service | ✅ 已修复 | complete方法移除，统一用finish |
| 月嫂 Nanny | ✅ 完全匹配 | |
| 进销存 Inventory | ✅ 已修复 | stock/transfers/checks 3个Controller已创建，迁移已执行 |
| 财务 Finance | ✅ 已修复 | paymentApi.confirm→audit |
| 人事 HR | ✅ 完全匹配 | |
| 办公协同 Office | ✅ 完全匹配 | 审批流引擎已升级 |
| 报表 Report | ✅ 完全匹配 | |
| 知识库 KB | ✅ 完全匹配 |
已修复问题
✅ care.js — careExceptionApi.resolve 路径修复
- 问题：前端调用
PUT /care/exceptions/{id}/resolve，后端只有/handle - 修复：将
resolve方法改为指向/handle的别名
✅ care.js — healthMetricApi.delete 移除
- 问题：前端调用
DELETE /care/health-metrics/{id}，后端无此路由 - 修复：移除该方法（健康指标不支持前端删除）
✅ finance.js — paymentApi.confirm 改名
- 问题：前端调用
PUT /finance/records/{id}/confirm，后端路由为/audit - 修复：方法改为
audit，路径对齐
✅ service.js — serviceExecutionApi.complete 移除
- 问题：前端有
complete方法调用/complete，后端无此路由（只有/finish） - 修复：移除
complete，使用finish统一
已补充后端（2026-03-14 完成）
✅ inventory — 库存台账 (stock)
StockController已创建，基于inventories表聚合，支持low_stock过滤- 路由：
GET /inventory/stock,GET /inventory/stock/export
✅ inventory — 调拨管理 (transfers)
TransferOrderController已创建，transfer_orders表已迁移- confirm 时自动更新双仓库库存（事务保护）
- 路由：GET/POST/GET{id}/confirm/cancel
✅ inventory — 盘点管理 (checks)
InventoryCheckController已创建，inventory_checks表已迁移- complete 时按实际数量修正 inventories 表（事务保护）
- 路由：GET/POST/GET{id}/complete
其他注意事项
meal.js — mealReviewApi.getDetail
- 后端
/meal/reviews只有GET list和POST create，无GET {id} - 前端
getDetail方法存在但暂时用不到（reviews 页面未调用），低优先级
request.js baseURL
- 配置
baseURL: '/api/v1'✅ 与后端路由前缀一致
认证
- 所有请求通过
Authorization: Bearer {token}传递，与 Sanctum 配置一致 ✅
全链路修复记录（2026-03-14）
P0 — 运行时必崩（已修复）
| 文件 | 问题 | 修复 |
|---|---|---|
views/finance/payments/index.vue |
paymentApi.confirm 不存在 |
改为 paymentApi.audit |
views/service/executions/index.vue |
serviceExecutionApi.complete 不存在 |
改为 serviceExecutionApi.finish |
views/meal/reviews/index.vue |
mealReviewApi.getDetail 不存在且后端无路由 |
直接用行数据 row 展示详情 |
views/care/health-metrics/index.vue |
healthMetricApi.delete 不存在 |
改为本地 filter 移除 |
P1 — 系统模块整体404（已修复）
| 文件 | 问题 | 修复 |
|---|---|---|
api/system.js - dictApi |
全部使用 /dict-types，后端路由是 /dictionaries |
重写 dictApi 路径，item 操作签名适配 |
api/system.js - userApi.resetPassword |
POST /reset-password，后端是 PUT /password |
改为 put + 正确路径 |
api/system.js - userApi.updateStatus |
PATCH，后端是 PUT | 改为 put |
api/system.js - roleApi.assignPermissions |
POST，后端是 PUT | 改为 put |
api/system.js - roleApi.getPermissions |
后端无此子路由 | 删除此方法 |
P2 — except(['show']) 导致404（已修复）
| 文件 | 问题 | 修复 |
|---|---|---|
api/system.js - departmentApi |
getDetail/getTree 后端无路由 |
删除；页面改用行数据 + getList+本地buildTree |
api/system.js - positionApi |
getDetail 后端无路由 |
删除；页面改用行数据 |
api/system.js - menuApi |
getDetail/getTree 后端无路由 |
删除；页面改用行数据 + getList+本地buildTree |
api/system.js - permissionApi |
getDetail/getTree 后端无路由 |
删除；roles页改用 getList+本地buildTree |
api/system.js - logApi |
getDetail 后端无路由 |
删除此方法 |
页面联动修复
views/system/departments/index.vue:getTree→getList+buildTree；getDetail→ 用行数据views/system/menus/index.vue:getTree→getList+buildTree；getDetail→ 用行数据views/system/positions/index.vue:getDetail→ 用行数据views/system/users/index.vue:departmentApi.getTree→getList（平铺列表）views/system/roles/index.vue:permissionApi.getTree→getList+buildPermTree；getPermissions→getDetail.permissionsviews/system/dictionaries/index.vue: 适配新 dictApi 签名（路径/参数全部对齐）
| 优先级 | 任务 | 状态 |
|---|---|---|
| P1 | 执行 migration: php artisan migrate（审批节点字段扩展） |
✅ 已完成 |
| P2 | 创建 inventory transfers/checks 后端 Controller + Migration | ✅ 已完成 |
| P3 | 完善 inventory stock 聚合查询接口 | ✅ 已完成 |
| P4 | 补充 meal/reviews/{id} 详情接口（低优） | ⏳ 待处理 |