Files
ws_health/doc/escort-admin-sync-plan.md
T
lik 762bd0e7da chore: 注册陪诊 Web 后台子模块并补充管理端方案文档
新增 ui/web_escort_admin 子模块;补充陪诊后台实施方案与陪诊师端同步改造清单;用户多应用方案登记 web-escort-admin 应用。
2026-11-06 19:54:17 +08:00

791 lines
55 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 陪诊师端(wxapp_escort_admin)功能同步改造清单
> 分析日期:2026-11-06
> 分析基准:`api/health/routes/index.js`(接口能力)、`ui/wxapp_escort`(用户端已实现功能)、`ui/wxapp_escort_admin`(陪诊师/管理端现状)
> 本文只做差距分析与改动项整理,不包含代码实现。
> 2026-11-06 review 修订:原 P0-5(支付补录与编辑锁定)经核实 `paymentLocked` 锁定已生效,降级为 P1-11 并重写现状;原 P0-6 顺延为 P0-5;新增预约补充幂等键要求;修正部分行号与退款查单按钮显示条件。
> 2026-11-06 二次修订(按后端最新代码回填):B8 订单搜索、B12 用户列表筛选已实现;P1-4/P1-5 的检索与 userId 查询后端已就绪;B1 收窄为仅查员工档案(管理员身份改由登录响应的 `apps` 判定);B3 定为档案锚定且无归属可留空。
## 一、结论摘要
1. **这个端实际同时承载「管理员」和「陪诊员」两种身份,但代码默认按管理员工作。** 订单列表、首页统计都调用 `GET /health/escort-record`(要求管理员),陪诊员登录后会直接 403;专门给陪诊员用的 `GET /health/escort-record/attendant` 已封装却从未使用。
2. **「新增预约」目前只能给管理员本人下单。** 后端 `createRecord` 强制 `userId = token 用户`,且就诊人档案必须属于该用户;前端却允许选择任意客户的档案,选到客户档案会提示「就诊人档案不存在」。
3. **订单支付补录只支持「全额已支付/未支付」,且已收款状态显示误导。** 编辑页 `paymentLocked` 已对 `partial/paid/refunding/refunded` 四种状态锁定且保存时不回传支付字段,不存在误改回未支付的风险;但表单会把它们回填显示为「未支付」,没有部分支付补录能力,手工标记「线上微信已支付」还会被后端拒绝。
4. **订单列表的分页、筛选、统计都是前端按当前页计算的。** `hasMore` 计算后恒为 `false`,上拉加载永远不会触发;状态筛选只对已加载的当前页生效。
5. **多个接口能力尚未接入管理端:** 陪诊员本人订单、支付查单、订单软删除、培训报名列表、医院库 CRUD、AI 语音/图片识别、AI 快捷问题、服务协议/服务指南等内容页。
6. **健康档案缺少「所属用户」概念。** 管理端新建档案不写 `userId`,生成的档案无法用于任何客户订单;客户详情页的路由还指向一个不存在的页面。
7. **建议顺序:先补后端 3 个能力(角色查询、陪诊员订单列表口径、管理员代客下单),再改前端。** 否则前端只能做「隐藏入口」,无法真正支撑陪诊员日常使用。
## 二、优先级定义
| 优先级 | 定义 | 典型事项 |
| --- | --- | --- |
| P0 | 不修则陪诊员端无法正常使用,或会产生错误数据、资金/权限风险 | 角色识别、订单列表数据源、代客下单、患者信息兜底 |
| P1 | 影响日常操作效率、信息完整性或数据一致性 | 取消申请闭环、支付信息补全、支付补录与锁定、订单表单规则对齐、档案归属、客户详情、培训/医院管理 |
| P2 | 体验补齐、内容页、非核心管理能力 | AI 语音/图片、帮助页、个人资料编辑、隐私展示、榜单页 |
## 三、关键现状
### 3.1 角色与权限
| 身份 | 判定依据 | 可访问的核心接口 | 当前管理端表现 |
| --- | --- | --- | --- |
| 管理员 | `user.app["wxapp-escort-admin"].role` 含 `admin`,或 Employee 在职且 `role=admin`(`api/health/utils/permissions.js:31-45`、`:83-98`) | `GET /escort-record`、档案管理、医院写接口、培训报名列表、退款查单、删除订单 | 当前所有页面默认按该身份工作 |
| 陪诊员 | Employee `status=active` 且 `role=attendant`(`api/health/utils/permissions.js:53-68`、`:83-98`) | `GET /escort-record/attendant`、`GET /escort-record/:id`(仅本人名下)、`PATCH .../status`(仅本人名下)、`GET .../pay/status`(仅本人名下) | 订单列表 403;档案接口 403;没有角色感知 |
| C 端用户 | token 用户本人 | `/escort-record/my`、`/health-profile/mine`、支付/取消等 | 不在本端范围 |
关键事实:
- `GET /health/escort-record` 已挂 `requireAdmin`(`api/health/routes/index.js:96`),陪诊员不可用。
- `GET /health/escort-record/attendant` 只要求登录(`api/health/routes/index.js:94`),但返回结构缺少 `total/counts`,且没有过滤软删除、已取消和支付窗口(`api/health/handler/escort_record.js:319-339`)。
- 健康档案管理接口全部要求管理员(`api/health/routes/index.js:124-128`),陪诊员在订单详情里按 `profileId` 拉档案会 403。
- 管理员身份已可从登录响应的 `apps` 判定(`api/health/utils/permissions.js:44-76` 同口径),但陪诊员身份仍需员工档案查询,且管理端尚未接入,页面无法按角色切换数据源与操作按钮。
### 3.2 订单状态与支付口径
| 维度 | 取值 | 说明 |
| --- | --- | --- |
| 服务状态 `status` | `pending` / `confirmed` / `in_progress` / `completed` | 只描述服务生命周期,不含取消;`completed` 为终态 |
| 取消状态 `cancelStatus` | `none` / `requested` / `cancelled` | 与 `status` 解耦;展示状态优先取 `cancelStatus` |
| 支付状态 `payment.status` | `unpaid` / `partial` / `paid` / `refunding` / `refunded` | 已支付/部分支付/退款中/已退款受后端保护 |
| 支付渠道 `payment.payChannel` | `online_wechat` / `offline` | 用户下单时的选择;历史订单缺失按 `offline` 解释 |
| 实际收款方式 `payment.method` | 空串 / `online_wechat` / `offline_cash` / `offline_transfer` | 线下收款由平台补记;线上微信只能由支付回调写入 |
| 支付窗口 `paymentWindowEnd` | ISO 时间 / `null` | 由后端按创建时间与微信支付配置派生;列表/详情用于判断「支付已超时」 |
后端关键规则:
- 状态迁移只允许 `pending → confirmed → in_progress → completed`,`completed` 不可再变(`api/health/utils/record_state.js:12-25`)。
- 取消迁移只允许 `none → requested/cancelled`、`requested → cancelled`(`api/health/utils/record_state.js:12-25`)。
- 已收款订单禁止改支付状态、实收金额和总金额(`api/health/handler/escort_record.js:488-504`)。
- 手工标记「线上微信 + 已支付」必须存在支付流水,否则返回 400(`api/health/handler/escort_record.js:506-516`)。
- 存在未支付流水时禁止改价(`api/health/handler/escort_record.js:560-575`)。
- 管理员/陪诊员取消时,未确认且未收款会物理删除;其余进入 `cancelStatus=cancelled`,已收款自动进入退款(`api/health/handler/escort_record.js:745-811`)。
- 删除订单仅管理员可用,且为软删除(`api/health/handler/escort_record.js:830-834`)。
### 3.3 服务目录与排期
服务目录 `api/health/resource/services.js` 是预约规则的唯一事实源:
- `service.id / title / price / areas`
- `service.booking.advanceDays`:至少提前预约天数
- `service.booking.durationMinutes`:标准时长
- `service.booking.sessions[]`:可预约时段
- `service.booking.requiresAddress`:是否需要收货地址(跑腿/买药)
后端下单/改期会忽略客户端提交的 `schedule.duration` 和 `payment.totalFee`,统一按服务目录重新派生并校验(`api/health/handler/escort_record.js:166-219`、`:367-390`、`:589-603`)。管理端表单需要按同一份目录渲染,否则会出现「前端能填、后端拒绝」。
### 3.4 关键字段
订单 `escort_record` 主要字段:
| 分组 | 字段 |
| --- | --- |
| 归属 | `userId`、`healthProfileId`、`deletedAt` |
| 就诊人快照 | `patient.name/mobile/sex/birth` |
| 服务 | `escort.serviceId/serviceName/sexRequirement` |
| 陪诊员 | `attendant.id/name/sex/mobile` |
| 医院 | `hospital.province/name/address/department/doctor/medicalRecordNo` |
| 排期 | `schedule.date/startTime/endTime/duration` |
| 费用 | `payment.totalFee/paidFee/method/payChannel/paymentRecordId/status` |
| 备注 | `notes.patientNote/escortNote/medicalSummary` |
| 问诊 | `inquiry.medicalHistory/demand` |
| 收货 | `shippingAddress.recipientName/mobile/address` |
| 取消 | `cancelStatus/cancelReason/cancelRequestedAt/cancelledAt` |
| 元数据 | `meta.createtime/updatetime`、改期审计 `schedule.scheduleUpdatedAt` |
健康档案 `health_profile` 主要字段:
- `userId`(所属用户,可为空)
- `profile.name/mobile/sex/birth/idnumber`
- `location.country/province/city/district/address`
- `health.height/weight/bloodType/remark`
## 四、接口覆盖矩阵
### 4.1 health 服务
图例:✅ 已封装且已使用;⚠️ 已封装未使用;❌ 未封装。
| 接口 | 管理端 `utils/api.js` | 当前使用情况 | 结论 |
| --- | --- | --- | --- |
| `GET /health/escort-record` | ✅ | 首页、订单列表、档案详情 | 管理员可用,陪诊员 403 |
| `GET /health/escort-record/attendant` | ✅ | 未使用 | 陪诊员主列表应改用它 |
| `GET /health/escort-record/my` | ✅ | 未使用 | 可选:查看本人在 C 端的订单 |
| `GET /health/escort-record/:id` | ✅ | 订单详情、编辑回填 | 需按角色控制可编辑范围 |
| `POST /health/escort-record` | ✅ | 新增预约 | 只能给 token 用户本人下单 |
| `PUT /health/escort-record/:id` | ✅ | 编辑订单 | 管理员全字段;陪诊员仅部分字段 |
| `PATCH /health/escort-record/:id/status` | ✅ | 列表、详情 | 已使用,流程基本正确 |
| `DELETE /health/escort-record/:id` | ✅ | 未使用 | 缺管理员「删除订单」入口 |
| `POST /health/escort-record/:id/pay` | ❌ | — | 仅订单本人可发起,管理端不适用 |
| `GET /health/escort-record/:id/pay/status` | ❌ | — | 建议补:管理员/陪诊员可查支付结果 |
| `POST /health/escort-record/:id/refund/query` | ✅ | 订单详情 | 已使用,仅管理员 |
| `GET /health/health-profile` | ✅ | 档案列表、订单选档案 | 管理员专属 |
| `GET /health/health-profile/:id` | ✅ | `patient-info` 组件 | 管理员专属;陪诊员 403 |
| `POST/PUT/DELETE /health/health-profile` | ✅ | 档案新增/编辑/删除 | 管理员专属 |
| `GET /health/training-application` | ❌ | — | 缺培训报名管理页 |
| `GET /health/hospital`、`GET /health/hospital/:id` | ❌ | — | 缺医院选择/详情 |
| `POST/PUT/DELETE /health/hospital` | ❌ | — | 缺医院维护页 |
| `GET /health/service` | ✅ | 订单编辑服务下拉 | 已使用 |
| `GET /health/agreement` | ✅ | 未使用 | 缺服务协议页 |
| `GET /health/hospital-info` | ✅ | 未使用 | 缺医院信息页 |
| `GET /health/hospital-ranking` | ✅ | 未使用 | 缺医院榜单页 |
| `GET /health/department-rankings` | ✅ | 未使用 | 缺科室榜单页 |
| `GET /health/ai-quick-questions` | ✅ | 未使用,页面写死 | 应改为接口下发 |
| `POST /health/ai/asr` | ❌ | — | AI 页缺语音输入 |
| `POST /health/ai/ocr` | ❌ | — | AI 页缺图片识别 |
| `GET /health/attendant`、`/health/attendant/:id` | ❌ | — | 公开公示接口;不能直接用于派单 |
### 4.2 user 服务
| 接口 | 管理端 `utils/api.js` | 当前使用情况 | 结论 |
| --- | --- | --- | --- |
| `POST /user/wxsignin` | ✅ | `app.js` 静默登录、设置页弹窗 | 弹窗口径与 C 端不一致,见 P1-10 |
| `POST /user/signout` | ✅ | 设置页退出 | 已使用 |
| `POST /user/update` | ✅ | 未使用 | 缺个人资料编辑 |
| `POST /user/userInfo` | ✅ | 未使用 | 可用于刷新当前用户 |
| `POST /user/list` | ✅ | 客户列表 | 后端未支持关键词/用户ID筛选,前端只过滤当前页 |
| `POST /user/wxgetphonenumber` | ✅ | 未使用 | 登录弹窗应改用手机号 code |
### 4.3 C 端功能对照
| C 端功能 | C 端位置 | 管理端现状 | 同步动作 |
| --- | --- | --- | --- |
| 服务列表/详情/下单 | `pages/home/index`、`pages/escort/itemlist|itemdetail|itemorder` | 仅订单编辑里选服务 | 表单按服务目录渲染;补医院选择、性别要求、收货地址、支付渠道 |
| 预约记录 | `pages/escort/recordlist` | `pages/order/index` | 补角色数据源、服务端筛选、分页、支付/取消状态 |
| 预约详情 | `pages/escort/recorddetail` | `pages/order/orderDetail` | 补取消原因、支付窗口、实收金额、收货地址、改期审计 |
| 就诊人 | `pages/health/profilelist|profileedit` | `pages/healthprofile/*` | 补所属用户、搜索、分页、校验、隐私展示 |
| 培训报名 | `pages/train/index|apply` | 无 | 新增管理端报名列表 |
| AI 助手 | `pages/ai/aichat` | `pages/ai/index` | 补语音/图片识别、接口快捷问题 |
| 我的/资料 | `pages/mine/mine|profileedit` | `pages/me/index`、`pages/set/index` | 补资料编辑;设置页占位项落地或移除 |
| 协议/指南/关于/联系 | `pages/escort/agreement|guide`、`pages/mine/about|contact` | 无 | 可选补齐内容页 |
| 医院选择 | `components/hospital-select` + `app.loadHospitals()` | 手填医院名 | 补医院库选择与地址回填 |
| 陪诊师公示 | API 已有,C 端未落页面 | 无 | 管理端可选做预览,不用于派单 |
## 五、具体改动项
### P0-1 角色识别与权限分层
**现状**
- 管理端没有角色状态,`pages/home`、`pages/order/index`、`pages/healthprofile` 都默认当前账号是管理员。
- 陪诊员登录后调用 `GET /escort-record` 会 403;订单详情里的 `patient-info` 调 `GET /health-profile/:id` 也会 403。
- `GET /escort-record/attendant` 已在 `utils/api.js` 封装,但没有任何页面调用。
- 后端没有「当前账号的员工身份」查询接口;`permissions.js` 里的角色判定只在服务端使用。
**目标**
- 管理员身份无需新增接口:登录响应已带 `apps: [{ appId, roles, status }]`(`api/user/handler/users.js:178-227`、`:255-261`),前端按 `apps` 中 `appId ∈ {wxapp-escort-admin, web-escort-admin}` 且 `roles` 含 `admin`、`status !== 'disabled'` 判定,与 `api/health/utils/permissions.js:44-76` 同口径(注意 `web-escort-admin` 也算管理员)。
- 陪诊员身份仍需服务端查员工档案:新增 `GET /health/employee/me`(登录态,只返回员工档案 `role/employeeNo/profile`,不重复返回 admin 判定),或在 `POST /user/userInfo` 响应中附带。
- 前端登录后缓存 `role`,提供统一的 `canAdmin` / `canAttendant` 判断。
- 按角色切换:订单数据源、首页统计、档案/客户/医院/培训入口、订单详情操作按钮、退款查单/删除按钮。
- 陪诊员只显示本人名下订单;管理员保留全量能力。
**涉及**
- 后端:`api/health/routes/index.js`、`api/health/handler/employee.js`
- 前端:`app.js`、新增 `utils/role.js`、`pages/home/*`、`pages/order/*`、`pages/healthprofile/*`、`pages/customer/*`、`pages/set/*`
**依赖**:仅陪诊员身份需后端员工档案接口(B1 已收窄为只查员工档案)。
### P0-2 陪诊员订单列表数据源
**现状**
- `pages/order/index.js:198-240` 固定调用 `API.escort.getAllRecords`,参数写死 `status: 'pending,confirmed,in_progress,completed'` 和 `includeCancelled: 1`。
- `getAllRecords` 路由要求管理员(`api/health/routes/index.js:96`),陪诊员无法使用。
- `getAttendantRecords` 返回结构只有 `records`,没有 `total`、`counts`、`paymentWindowEnd`,也没有过滤软删除和已取消(`api/health/handler/escort_record.js:319-339`、`api/health/models/schema/escort_record.js:360-375`)。
**目标**
- 管理员走 `GET /escort-record`,陪诊员走 `GET /escort-record/attendant`,页面按角色选择。
- 后端补齐陪诊员列表口径:支持 `status` 多值、`cancelStatus`、`includeCancelled`、`page/pageSize`、返回 `total` 与 `counts`,并补 `paymentWindowEnd`。
- 列表页角标/统计与管理员口径一致。
**涉及**
- 后端:`api/health/handler/escort_record.js`、`api/health/models/schema/escort_record.js`
- 前端:`utils/api.js`、`pages/order/index.js/wxml`、`pages/home/index.js`
**依赖**:后端陪诊员列表增强。
### P0-3 管理员代客下单
**现状**
- `createRecord` 强制 `userId = ctx.state.user._id`(`api/health/handler/escort_record.js:333`),并要求 `healthProfileId` 属于该用户(`:352-355`)。
- 管理端新增预约页可以打开全部档案(`pages/order/orderEdit.js:102-126`),但选到客户档案提交会报「就诊人档案不存在」。
- 即使提交成功,订单也挂在管理员本人名下,客户在 C 端看不到。
- 表单里填写的 `payment.totalFee`、`schedule.duration` 会被后端忽略:总价取服务目录价格,时长/结束时间按服务目录派生(`:367-390`、`:409-414`)。
**目标**(已定案:档案锚定归属,见 9.2-1)
- 后端改为「档案锚定」:管理员建单不传 `userId`(传了也忽略),订单归属取 `healthProfileId` 对应档案的 `profile.userId`;档案有归属则订单带上,无归属则订单 `userId` 留空(schema 非必填),后期由管理员在订单编辑中补归属(`RECORD_FIELDS` 已含 `userId`,无需改后端白名单)。
- 前端增加「代客下单」流程:先选客户(或从客户详情进入),再选该客户档案;订单价格只读展示服务目录价格;支付状态初始为未支付,线下收款通过编辑页补记。
- 无归属档案允许选择,但表单明确提示「该档案未关联客户,订单归属留空,可后期补」;创建成功后按是否有归属分别提示,并跳转订单详情。
- 新增预约携带 `idempotencyKey`(与 C 端 `pages/escort/itemorder.js` 一致),防止连点重复建单;管理端新增预约当前未传该字段。
**涉及**
- 后端:`api/health/handler/escort_record.js`
- 前端:`pages/order/orderEdit.js/wxml`、`pages/customer/detail`(新增)、`pages/healthprofile/profileInfo.js`
**依赖**:后端管理员代客下单支持;客户列表/详情接口(见 P1-5)。
### P0-4 订单详情就诊人信息兜底
**现状**
- `pages/order/orderDetail.wxml:22-28` 只传 `profile-id` 给 `patient-info` 组件,没有传订单里的 `patient` 快照。
- `patient-info` 组件在 `profile-id` 存在时只调 `API.healthProfile.getProfileById`(`components/patient-info/index.js:43-60`)。
- 陪诊员调用该接口会 403;档案被删除时也会静默失败,最终患者姓名/电话为空。
- 后端 `getRecordById` 本身返回完整的 `record.patient` 快照(`api/health/handler/escort_record.js:308-324`)。
**目标**
- 订单详情始终用 `order.patient` 作为兜底展示(姓名、性别、年龄、电话);档案加载成功后再覆盖。
- 管理员可查看档案完整信息;陪诊员至少能看订单快照里的联系人信息。
- 可选:后端允许「该订单的陪诊员」读取订单关联档案的脱敏信息,避免陪诊员只能看快照。
**涉及**
- 前端:`pages/order/orderDetail.js/wxml`、`components/patient-info/index.js`
- 后端(可选):`api/health/routes/index.js`、`api/health/handler/health_profile.js`
**依赖**:无(前端兜底即可);完整档案信息需后端授权。
### P0-5 订单列表筛选、分页与统计修正
**现状**
- `pages/order/index.js:198-240` 一次拉取 4 种状态 + 已取消订单,然后在前端按 `displayStatus` 过滤。
- 统计 `calculateStats` 只统计当前已加载列表;切换状态页签不重新请求,只在本地过滤。
- `hasMore` 在过滤后被赋值为 `orderList.length < total`,而 `total` 又被覆盖成 `orderList.length`,结果恒为 `false`,`onReachBottom` 永远不会加载下一页。
- 状态筛选未使用后端支持的 `status` / `cancelStatus` / `includeCancelled` / `keyword` 参数(`api/health/handler/escort_record.js:249-313`)。
- 「待取消」页签没有列表级操作入口,只有详情页能处理。
**目标**
- 每个页签使用服务端筛选:
- 全部:`includeCancelled=1`
- 待确认:`status=pending` + `cancelStatus=none`
- 待取消:`cancelStatus=requested`
- 已确认:`status=confirmed` + `cancelStatus=none`
- 进行中:`status=in_progress`
- 已完成:`status=completed`
- 已取消:`cancelStatus=cancelled`
- 使用后端返回的 `total` 判断 `hasMore`;上拉加载下一页;下拉刷新重置页码。
- 页签计数使用后端聚合;当前 `findRecordPage` 只返回 `counts.all/ongoing`(`api/health/models/schema/escort_record.js:284-300`),需要扩展为各状态计数,或由前端并行请求各页签的总数。
- 「待取消」卡片增加「同意取消」快捷操作;取消/确认后刷新当前列表与统计。
- 接入已支持的订单搜索:`keyword` 可匹配就诊人姓名/电话、陪诊员姓名、医院名、订单ID(`api/health/models/schema/escort_record.js:298-311`);另有 `userId/healthProfileId/appointmentDate/startDate/endDate/paymentStatus/payChannel` 可用(`:234-313`),无需后端改造。
**涉及**
- 前端:`pages/order/index.js/wxml`
- 后端:`api/health/models/schema/escort_record.js`(仅各状态计数需扩展)
**依赖**:各状态计数(B9);订单搜索已就绪。
### P1-1 取消申请闭环
**现状**
- 详情页能识别 `cancelStatus=requested` 并显示「同意取消」(`pages/order/orderDetail.js:174-179`),但:
- 不显示 `cancelReason`、`cancelRequestedAt`、`cancelledAt`;
- 列表页「待取消」卡片没有处理入口;
- 管理员直接取消时没有填写取消原因的入口(后端支持 `reason`,会截断 200 字,`api/health/handler/escort_record.js:652`);
- 取消成功后不区分「物理删除」和「进入已取消」,列表不会自动移除已删除订单。
- 后端对管理员取消已完成订单会拒绝(`:763-766`),前端按钮已隐藏,但缺少提示文案。
**目标**
- 详情页增加「取消信息」区块:申请原因、申请时间、取消时间、当前处理状态。
- 待取消订单在列表/详情都提供「同意取消」;管理员额外提供「拒绝并保留订单」需要后端新增状态(当前没有 `rejected`,暂不做)。
- 管理员取消时可选填原因;确认弹窗说明「未确认且未收款将直接删除订单,已收款将进入退款」。
- 取消成功后按后端 `data.deleted` 决定返回列表或刷新详情;列表页删除对应卡片。
**涉及**
- 前端:`pages/order/index.js/wxml`、`pages/order/orderDetail.js/wxml`
- 后端:无需新增(拒绝取消需要新增状态,暂不在范围)
**依赖**:无。
### P1-2 支付/退款信息补全
**现状**
- 订单详情展示 `payment.status`、`payChannel`、`method`,但缺少 `paidFee`、支付窗口、是否超时、支付流水状态。
- 管理端 API 未封装 `GET /escort-record/:id/pay/status`,无法主动查单;该接口对管理员/陪诊员均可用(`api/health/handler/payment.js:656-663`)。
- 退款查单已有按钮,但仅 `payment.status === 'refunding'` 且 `payment.method === 'online_wechat'` 时显示(`pages/order/orderDetail.js:143-186`);退款失败/异常时没有入口查看详情。
**目标**
- 费用区补充:应收、实收、支付渠道、实际收款方式、支付状态、支付窗口截止时间、是否超时。
- 增加「查询支付状态」按钮(`payChannel=online_wechat` 且未支付/退款中时),调用 `GET .../pay/status`,刷新详情。
- 明确区分「未支付」「部分支付」「已支付」「退款中」「已退款」,与 C 端文案一致。
- 退款查单按钮保持管理员可见;陪诊员隐藏。
**涉及**
- 前端:`utils/api.js`、`pages/order/orderDetail.js/wxml`
- 后端:无
**依赖**:无。
### P1-3 订单编辑与用户端规则对齐
**现状**
- 管理端订单编辑只有:省份、医院名称(手填)、科室、医生、日期、开始时间、服务名称、费用、是否已支付、支付方式、病历、诉求、备注(`pages/order/orderEdit.wxml:38-144`)。
- 缺少:医院地址、病历号、性别要求、收货地址、支付渠道、服务目录的预约规则。
- 日期可选今天起任意日期,时间可选任意时刻;后端会按 `advanceDays`、`sessions` 校验并拒绝(`api/health/handler/escort_record.js:176-219`)。
- `schedule.duration` 固定写 60(`pages/order/orderEdit.js:430-433`),后端会忽略并按服务目录重算。
- 新建时费用输入框可编辑,但后端固定取服务价格。
- 编辑时未按角色限制字段;陪诊员提交支付/费用字段会被后端过滤或直接 400。
**目标**
- 服务选择后加载该服务的 `areas`、`booking.advanceDays`、`sessions`,日期最小值为今天 + `advanceDays`,开始时间使用半小时档位(与 C 端 `buildTimeSlots` 一致)。
- 医院改为从 `GET /health/hospital` 选择(可按省份/关键词),选中后回填 `name/address`;保留「其他医院」手填入口。
- 增加 `hospital.address`、`hospital.medicalRecordNo`、`escort.sexRequirement`(不限/男/女)、`shippingAddress`(当 `booking.requiresAddress` 为 true 时展示)。
- 新建时费用改为只读展示服务目录价格;编辑时管理员可改价,但受「已收款/在途流水」锁定。
- 增加 `payment.payChannel`(线上微信/线下支付)选择;切换规则与后端一致(仅未支付、待确认/已确认、未申请取消)。
- 按角色控制可编辑字段:陪诊员只保留服务执行相关字段(医院/排期/备注/病历/诉求),隐藏费用、支付、归属、陪诊员分配。
- 移除或忽略无效的 `duration` 提交;排期以后端返回为准。
**涉及**
- 前端:`pages/order/orderEdit.js/wxml`、`utils/api.js`、`components/hospital-select`(可从 C 端复用/适配)
- 后端:无(现有校验已足够)
**依赖**:公共医院列表接口。
### P1-4 健康档案归属、检索与校验
**现状**
- 管理端新建档案不设置 `userId`(`pages/healthprofile/profileInfo.js:180-201`),生成的档案没有归属用户,无法用于任何客户订单。
- 列表只取最近 20 条,无分页、无搜索(`pages/healthprofile/index.js:28-54`)。
- 快捷菜单「全部档案」「患者查询」「就诊记录」均为占位提示(`:56-72`)。
- 表单只校验姓名/电话非空(`pages/healthprofile/profileInfo.js:170-178`),不校验手机号格式、身份证格式、出生日期范围、身高体重范围;后端管理端创建接口也没有做这些校验(`api/health/handler/health_profile.js:253-261`)。
- 列表展示 `item.profile.birth` 时未对 `profile` 缺失做兜底(`pages/healthprofile/index.js:37`)。
**目标**
- 档案增加「所属用户」:新建时必选客户(管理员自己的档案可选择本人);编辑时展示归属,不允许随意转移(后端当前允许改 `userId`,建议收紧)。
- 列表分页、搜索(姓名/手机号)、排序(最近更新):后端已支持(`api/health/handler/health_profile.js:97-115` 的 `userId/name/mobile/sortBy` + 分页),前端接入即可。
- 展示归属用户姓名/手机号:用 `POST /user/info/batch` 批量取(`api/user/routes/index.js:35`,单次上限 100),不要逐行查询。
- 实现快捷菜单:全部档案、患者查询(姓名/手机号)、就诊记录(按 `healthProfileId` 查订单)。
- 表单校验与 C 端对齐:手机号 `1[3-9]\d{9}`、身份证 18 位、出生日期 1900-01-01 至今天、身高 30–250、体重 2–300;提交前给出字段级错误。
- 详情增加身份证号(可脱敏/展开)、地区、血型、备注;删除时提示「已关联订单仍保留订单快照」。
- 陪诊员不展示档案管理入口,仅从订单快照查看联系人。
**涉及**
- 前端:`pages/healthprofile/index.js/wxml`、`pages/healthprofile/profileInfo.js/wxml`、`pages/order/orderEdit.js`、`utils/api.js`
- 后端(建议):管理端创建/更新档案时校验 `userId` 存在且属于 C 端用户;更新时禁止转移归属
**依赖**:客户选择(P1-5)。
### P1-5 客户详情与客户搜索
**现状**
- `pages/customer/index.js:215-220` 点击客户跳转 `/pages/customer/detail?id=...`,但该页面不存在(目录下只有 `index.*`)。
- `POST /user/list` 后端已升级:以 `user_app` 为分页主体(语义为「`wxapp-escort` 有效成员」),支持 `keyword`(姓名/手机/邮箱/拼音)、`accountStatus`、`startDate/endDate`,并返回 `total/page/pageSize`(`api/user/handler/users.js:637-712`);前端已传 keyword,只需改为服务端搜索并使用 `res.data.total`。
- `GET /escort-record?userId=` 与 `GET /health-profile?userId=` 均已支持(`api/health/models/schema/escort_record.js:264`、`api/health/handler/health_profile.js:97-115`),客户详情页所需查询无需后端改造。
- 当前页面仍有:`total` 取 `data.users.length` 导致 `hasMore` 恒 `false`(`pages/customer/index.js:139-167`),属纯前端修复。
**目标**
- 新增客户详情页:用户资料、健康档案列表、订单列表、快捷「代客下单」「新增档案」「拨打电话」。
- 客户列表分页使用后端 `total`;搜索改为服务端 `keyword`(姓名/手机);按 `userId` 精确取用户用 `POST /user/info/batch`。
- 客户详情通过 `userId` 拉档案(`GET /health-profile?userId=`)和订单(`GET /escort-record?userId=`)。
- 仅管理员可见;陪诊员隐藏入口。
**涉及**
- 前端:`pages/customer/index.js/wxml`、新增 `pages/customer/detail.*`、`app.json`、`utils/api.js`
- 后端:无需改造(列表筛选与按 userId 查询均已具备)
**依赖**:无。
### P1-6 培训报名管理
**现状**
- 报名接口已存在:用户端 `POST /health/training-application`、`GET /health/training-application/mine`;管理端 `GET /health/training-application`(管理员,`api/health/routes/index.js:118-121`)。
- 管理端没有报名列表页面,`utils/api.js` 也没有封装。
- 后端列表返回 `applicant.name/mobile/education`、`examMonth`、`course`、`status`、`createtime`,不返回照片/身份证图片(`api/health/handler/training_application.js:20-39`)。
- 没有「查看材料」「修改报名状态」接口。
**目标**
- 新增管理端报名列表:状态页签(待审核/已联系/已入班/已取消)、分页、按姓名/手机号搜索(后端暂不支持搜索,可先前端过滤当前页)。
- 列表展示报名人、手机号、学历、考试月份、课程、提交时间、状态。
- 明确只读;如需审核流转,后端补 `GET /training-application/:id`(含材料)和 `PATCH /training-application/:id/status`。
- 入口放首页/设置页,仅管理员可见。
**涉及**
- 前端:新增 `pages/training/index.*`、`app.json`、`utils/api.js`、`pages/home/index.js`、`pages/set/index.js`
- 后端(可选):报名详情、状态更新
**依赖**:后端状态更新/材料查看(若需要审核闭环)。
### P1-7 医院库维护与订单选院
**现状**
- 医院接口已完整:公开列表/详情(`GET /health/hospital`、`/:id`),管理员新增/修改/删除(`POST/PUT/DELETE /health/hospital`,`api/health/routes/index.js:130-135`)。
- 管理端 `utils/api.js` 完全没有医院接口,也没有医院管理页面。
- 订单编辑只能手填医院名,无法带出地址、科室、等级,也无法复用医院库。
- 医院字段:`name/entityName/province/city/address/phone/departments/level`,`pinyin/fudanRank` 由服务端生成(`api/health/handler/hospital.js:14`)。
**目标**
- 新增医院库页面:关键词/省份/主体名称搜索、分页、详情、新增、编辑、删除;仅管理员可写。
- 表单字段按后端白名单:名称、主体名称、省份、城市、地址、电话、科室(数组)、等级;不要编辑拼音/复旦档位。
- 订单编辑使用医院库选择器;选中后回填 `hospital.name/address`,支持「其他医院」手填。
- 可选:用 `GET /health/hospital-info`、`/hospital-ranking`、`/department-rankings` 做医院资料/榜单展示页。
**涉及**
- 前端:`utils/api.js`、新增 `pages/hospital/index|detail|edit.*`、`app.json`、`pages/order/orderEdit.*`、`components/hospital-select`
- 后端:无
**依赖**:无。
### P1-8 陪诊师派单与在线状态
**现状**
- 订单编辑/详情没有「分配/更换陪诊师」入口;后端管理员可以通过 `PUT /escort-record/:id` 写 `attendant` 字段(`api/health/handler/escort_record.js:463-484`、白名单 `:19-23`),但没有可选的陪诊师列表接口。
- 公开的 `GET /health/attendant` 返回的是脱敏姓名、`Employee._id`,不含手机号和登录用户 ID;而订单的 `attendant.id` 需要是 `user._id`(`api/health/handler/escort_record.js:110-117`),不能直接复用。
- 首页「在线/离线」开关只改本地 `data.online`(`pages/home/index.js:91-95`),没有写库;Employee 有 `attendantInfo.isOnline`,但没有对应接口。
- 陪诊员无法写 `notes.escortNote` / `notes.medicalSummary`:`updateRecord` 对非管理员只允许 `OWNER_NOTE_FIELDS`(`api/health/handler/escort_record.js:29-38`),不含服务记录/就诊摘要。
**目标**
- 后端新增管理员可用的陪诊师列表(含 `userId`、姓名、手机号、性别、服务区域、在职状态),例如 `GET /health/employee?role=attendant&status=active`;不要复用公开公示接口。
- 订单详情/编辑增加「分配陪诊师」:按性别要求、服务区域筛选;选中后写 `attendant.id/name/sex/mobile`;后端校验该 `userId` 是当前在职陪诊员。
- 首页在线状态改为读写员工在线状态接口;未能实现前,移除或标注「仅本地展示」。
- 后端允许陪诊员更新本人订单的 `notes.escortNote` 和 `notes.medicalSummary`(或新增服务记录接口);前端增加服务记录编辑区。
**涉及**
- 后端:`api/health/routes/index.js`、`api/health/handler/employee.js`、`api/health/handler/escort_record.js`
- 前端:`pages/order/orderDetail.*`、`pages/order/orderEdit.*`、`pages/home/index.*`、`utils/api.js`
**依赖**:员工列表、在线状态、陪诊员字段权限(后端)。
### P1-9 首页统计与入口权限
**现状**
- 首页今日收益/今日订单/近 7 日订单都调用 `getAllRecords`(`pages/home/index.js:97-152`),陪诊员 403。
- 今日收益按 `payment.totalFee` 累加,未支付订单也会计入(`:104-120`)。
- 快捷入口固定展示「注册用户」「健康档案」「个人信息」等,未按角色隐藏。
- 近 7 日订单一次取 50 条后前端过滤,数据量大时不准。
**目标**
- 按角色选择数据源:管理员全量,陪诊员本人订单。
- 收益按 `payment.paidFee` 或「已支付/部分支付」口径统计,排除未支付与已退款。
- 统计与列表使用服务端筛选/分页;首页只取必要字段。
- 陪诊员隐藏客户/档案/医院/培训等管理员入口;管理员保留。
- 今日订单数按 `appointmentDate` 查询,避免前端按时间戳猜日期。
**涉及**
- 前端:`pages/home/index.js/wxml`
- 后端:可选补员工统计接口,避免前端二次聚合
**依赖**:P0-1、P0-2。
### P1-10 请求层、环境配置与登录口径
**现状**
- `utils/config.js` 是空对象(`export default { baseUrl: '' }`),`utils/request.js` 构造函数写死 `https://api.huashengtec.com`;`utils/api.js` 的 user 接口也写死绝对地址(`utils/api.js:5-10`)。本地调试必须改代码。
- `utils/request.js` 没有 401 静默重登与重试;C 端 `utils/request.js:24-37` 已有 `recoverUnauthorized`。管理端 token 被轮换后页面只会报错。
- `pages/ai/index.js:216` 发送 `appId: app.globalData.appId || ''`,但 `app.js` 的 `globalData` 没有 `appId`(`app.js:102-106`)。
- 设置页登录弹窗用 `phoneNumber` 直传(`pages/set/index.js:112-118`);已有手机号的账号会返回 409「该手机号已注册,请先使用手机号登录后再绑定微信」(`api/user/handler/users.js:375-380`)。
**目标**
- 按 C 端模式补齐 `config.js`:`DEBUG`、`APP_ID`、`BASE_URL`、`USER_BASE_URL`、`WS_BASE_URL`、AI 媒体超时;`request.js`/`chatmsg.js`/`api.js` 全部从配置取值。
- `request.js` 增加 401 恢复回调,由 `app.js` 注入静默重登;避免与 `ensureLogin` 死锁。
- `app.js` 补 `appId`,或从 AI 发送参数中移除未定义字段。
- 登录弹窗改用微信手机号授权 `phoneCode`(与 C 端一致),或直接移除弹窗、统一走静默登录 + 管理员后台开通。
- 统一错误提示:网络错误、401、403、业务 code 分类展示。
**涉及**
- 前端:`utils/config.js`、`utils/request.js`、`utils/api.js`、`utils/chatmsg.js`、`app.js`、`pages/set/index.js`
**依赖**:无。
### P1-11 订单支付补录与编辑锁定(review 后自 P0 降级)
**现状**(按当前代码修订)
- 编辑页已实现已收款锁定:`paymentLocked` 在 `pages/order/orderEdit.js:46` 定义、`:187-192` 按 `partial/paid/refunding/refunded` 计算并 `setData`,wxml 中禁用支付开关/方式选择并显示提示;保存时锁定订单不回传任何 payment 字段(`:508-513`),不存在「把已支付/退款中订单改回未支付」的风险。
- 剩余问题:
- 显示误导:`loadOrder` 只把 `payment.status === 'paid'` 判为已支付(`:223`),`partial/refunding/refunded` 在开关上回填为「未支付」,虽被锁定但展示不准确;
- 无部分支付补录:`paidFee` 只能等于全额或 0(`:511`),线下只支持全额已支付或未支付;
- 「是否已支付」开关与「支付方式」没有联动:选中 `online_wechat` 再打开已支付,后端会返回「线上微信收款只能由支付回调写入」(`api/health/handler/escort_record.js:506-516`);
- 订单详情缺 `payment.paidFee`、支付窗口与超时状态。
- 后端支持已核实:对 `unpaid` 订单,管理员写 `offline_cash/offline_transfer` + `paidFee` + `payment.status=partial` 不被任何校验拦截(锁定只在当前状态已收款时生效,`api/health/handler/escort_record.js:486-516`),无需新增后端接口。
**目标**
- 统一支付编辑状态机:
- `partial/paid/refunding/refunded` 时保持现有锁定,并把回填显示改为真实支付状态文案(不再显示「未支付」),附「退款请走取消流程」提示;
- `unpaid` 且存在未支付流水时,锁定总金额(保留现有 `amountLocked`),提示先关单/取消;
- `unpaid` 且无在途流水时,允许管理员补录线下收款:选择 `offline_cash` / `offline_transfer`,填写 `paidFee`,由页面推导 `payment.status`(`0 → unpaid`、`0 < paidFee < totalFee → partial`、`paidFee >= totalFee → paid`);
- 选中 `online_wechat` 时禁止手工标记已支付,并提示「线上支付由微信回调自动入账」。
- 增加实收金额展示与校验:`0 ≤ paidFee ≤ totalFee`。
- 保存前做本地校验,避免把必然失败的请求发到后端。
- 订单详情补 `payment.paidFee`、`paymentWindowEnd`、是否超时、支付流水/退款状态。
**涉及**
- 前端:`pages/order/orderEdit.js/wxml`、`pages/order/orderDetail.js/wxml`、新增 `utils/payment.js`(统一支付文案/状态推导)
- 后端:无需新增接口,按现有规则做前端约束即可
**依赖**:无。
### P2-1 AI 快捷问题、语音与图片
**现状**
- 管理端 AI 页快捷问题是硬编码的 4 条(`pages/ai/index.js:10-15`);后端已有 `GET /health/ai-quick-questions`,`utils/api.js` 也已封装但未使用。
- 管理端 `utils/api.js` 没有 `ai.asr` / `ai.ocr`;AI 页没有语音输入和图片识别。
- C 端已实现实时语音(WS `asr_start/asr_chunk/asr_stop`,失败回退 `POST /health/ai/asr`)和图片 OCR(`POST /health/ai/ocr`)。
**目标**
- 快捷问题改为接口下发,失败时回退本地默认问题。
- 增加语音输入:优先走 WS 实时识别,失败回退整段识别;识别结果回填输入框,用户确认后发送。
- 增加图片识别:选择图片 → `ocr` → 文本回填输入框/作为消息发送;沿用 C 端的 `format` 帧与权限提示。
- 按角色提示:陪诊员无权限时后端会返回「当前账号未绑定在职陪诊员档案」,前端直接展示。
**涉及**
- 前端:`utils/api.js`、`pages/ai/index.js/wxml`、`utils/chatmsg.js`
- 后端:无(接口已存在)
**依赖**:无。
### P2-2 内容与帮助页
**现状**
- 设置页「消息通知」「帮助中心」没有 URL,点击提示「功能开发中」(`pages/set/index.js:15-19`、`:145-158`)。
- 管理端没有服务协议、服务指南、关于我们、联系我们页面;C 端已有对应页面,接口 `GET /health/agreement`、`GET /health/service` 已存在。
**目标**
- 增加「服务协议」「服务指南」「关于我们」「联系我们」页面;协议/服务内容从接口读取,联系信息用静态配置。
- 设置页菜单接入真实页面;「消息通知」若无后端能力,先移除或标注「暂无消息」。
- 仅保留对陪诊师有用的内容,避免把 C 端「合作与入驻」直接搬过来。
**涉及**
- 前端:新增内容页、`app.json`、`pages/set/index.js/wxml`、`utils/api.js`
**依赖**:无。
### P2-3 个人资料编辑
**现状**
- `pages/me/index.js` 只读展示用户资料;设置页「个人资料」跳到该页,不能编辑。
- `utils/api.js` 已封装 `POST /user/update`,但未使用。
**目标**
- 增加资料编辑:姓名、性别、出生日期、手机号、邮箱、身份证号(按 user 服务允许字段)。
- 陪诊员可补充员工档案信息?当前没有员工自助更新接口,暂不做;只编辑用户资料。
- 保存后刷新 `globalData.user` 与页面。
**涉及**
- 前端:`pages/me/index.js/wxml`、新增 `pages/me/profileedit.*`、`utils/api.js`、`app.json`
**依赖**:无(用户资料接口已存在)。
### P2-4 隐私与展示细节
**现状**
- 管理端档案详情展示完整身份证号;列表不展示证件号。
- 订单详情展示完整订单号;C 端做了脱敏。
- 陪诊员与管理员看到的信息没有差异。
**目标**
- 列表默认脱敏(手机号中间四位、身份证号中间位);详情可展开查看完整值。
- 订单号在管理端可保留完整(对账需要),但分享/截图场景建议脱敏。
- 陪诊员只展示服务必需信息(联系人电话、医院、地址、注意事项),隐藏身份证号、费用明细、退款信息。
- 统一空态/加载态/错误态。
**涉及**
- 前端:`utils/privacy.js`(可从 C 端复用)、订单/档案页面
**依赖**:无。
### P2-5 医院信息与榜单页
**现状**
- `GET /health/hospital-info`、`/hospital-ranking`、`/department-rankings` 已封装,但管理端未使用。
**目标**
- 可选做「医院资料/榜单」只读页,供陪诊师了解医院等级、科室排名。
- 若不做,移除 `utils/api.js` 中未使用的封装,减少误导。
**涉及**
- 前端:`utils/api.js`、新增页面或删除未用 API
**依赖**:无。
### P2-6 陪诊师公示预览
**现状**
- 公开接口 `GET /health/attendant`、`/:id` 已存在,返回脱敏姓名、服务年限、健康证明有效期、培训记录、评价聚合,不含手机号/身份证/证书编号(`api/health/handler/employee.js:75-103`)。
- 管理端未展示。
**目标**
- 可选做「陪诊师公示预览」,让管理员核对对外展示内容。
- 不用于派单选择(`id` 是 Employee._id,不是登录用户 ID)。
**涉及**
- 前端:`utils/api.js`、可选页面
**依赖**:无。
### P2-7 设置页占位与消息通知
**现状**
- 「消息通知」「帮助中心」占位;「清除缓存」会清空 `admin_user_info` 等本地缓存并重置登录态(`pages/set/index.js:198-216`)。
**目标**
- 明确每个菜单的去向;无能力的功能移除,避免「开发中」长期存在。
- 清除缓存后重新登录并刷新首页,避免停留在无用户状态。
**涉及**
- 前端:`pages/set/index.js/wxml`
**依赖**:无。
### P2-8 健壮性与空态
- `pages/healthprofile/index.js:37` 读取 `item.profile.birth` 未兜底 `profile` 缺失。
- `pages/order/orderDetail.wxml` 直接访问 `order.hospital.name` 等嵌套字段,订单数据不完整时可能渲染异常;建议 JS 侧归一化。
- `pages/order/index.js` 统计/筛选切换后未重置加载态;失败时 `isLoading` 可能残留。
- 统一 loading / empty / error / retry 三态,避免空白页。
## 六、后端接口缺口(需先补)
| 编号 | 缺口 | 现状 | 建议 | 影响 | 优先级 |
| --- | --- | --- | --- | --- | --- |
| B1 | 员工档案查询(原「角色查询」已收窄) | 管理员身份已可从登录响应的 `apps` 判定;陪诊员身份需按 userId 查 Employee,无接口 | `GET /health/employee/me` 只返回员工档案 `role/employeeNo/profile` | 陪诊员页面角色判定 | P0 |
| B2 | 陪诊员订单列表口径 | `GET /escort-record/attendant` 无 total/counts、单状态、未过滤软删除/取消、无支付窗口 | 复用管理员列表的过滤/分页/派生逻辑,按 `attendant.id` 限定 | 陪诊员订单列表/首页 | P0 |
| B3 | 管理员代客下单 | `createRecord` 强制 `userId=token 用户`,档案必须属于该用户 | 档案锚定:订单归属取 `profile.userId`,不传/忽略管理员传入的 userId;无归属档案允许下单,`userId` 留空后期补(见 9.2-1) | 新增预约/客户详情 | P0 |
| B4 | 陪诊员读取订单档案 | `GET /health-profile/:id` 要求管理员 | 允许该订单的陪诊员读取关联档案(可脱敏),或提供订单专属档案接口 | 订单详情患者信息 | P0(可选) |
| B5 | 陪诊师列表(派单) | 只有公开脱敏列表,无 userId/手机号 | `GET /health/employee?role=attendant&status=active`(管理员) | 派单/更换陪诊师 | P1 |
| B6 | 陪诊员写服务记录 | `updateRecord` 对非管理员只允许患者备注/病历/诉求 | 允许本人订单写 `notes.escortNote`、`notes.medicalSummary` | 服务记录/就诊摘要 | P1 |
| B7 | 培训报名详情/状态 | 只有列表,无详情/状态更新 | `GET /training-application/:id`(含材料)、`PATCH .../status` | 培训报名管理 | P1 |
| B8 | ~~订单搜索~~(已实现) | `buildRecordFilter` 已支持 keyword(就诊人姓名/电话、陪诊员、医院、订单ID)及 userId/healthProfileId/日期/支付状态筛选(`schema/escort_record.js:234-313`) | 无需改造,前端接入 | 订单列表 | — |
| B9 | 各状态计数 | `counts` 只有 `all/ongoing` | 扩展为各状态 + `cancelRequested` | 订单页签角标 | P1 |
| B10 | 员工在线状态 | 首页开关只改本地 | `PATCH /health/employee/me/online` 或员工更新接口 | 首页在线状态 | P2 |
| B11 | 订单详情软删除过滤 | `getRecordById` 使用 `findById`,未过滤 `deletedAt` | 改用 `findRecordById` 或加 `deletedAt: null` | 删除后的详情/权限一致性 | P1 |
| B12 | ~~用户列表筛选~~(已实现) | `userList` 已按 `user_app` 有效成员分页,支持 keyword/accountStatus/日期并返回 total(`api/user/handler/users.js:637-712`) | 无需改造;按 userId 取用户用 `POST /user/info/batch` | 客户搜索/详情 | — |
| B13 | 管理端档案归属校验 | 管理员创建/更新档案不校验 `userId` 是否存在 | 校验目标用户存在且属于 C 端;更新时禁止转移归属 | 档案归属 | P1 |
## 七、前端文件级改动清单
| 文件/目录 | 改动 | 优先级 |
| --- | --- | --- |
| `app.json` | 增加客户详情、培训、医院、内容页、资料编辑等页面路由 | P0/P1 |
| `app.js` | 增加 `appId`、401 恢复回调、角色加载与全局缓存 | P0 |
| `utils/config.js` | 补 DEBUG/APP_ID/BASE_URL/USER_BASE_URL/WS_BASE_URL/AI 超时 | P1 |
| `utils/request.js` | 从配置取 baseURL;增加 401 重登重试;统一错误 | P1 |
| `utils/api.js` | 补 `getAttendantRecords` 参数/支付查单/删除/培训/医院/AI 媒体/公示接口;user 接口从配置派生 | P0/P1 |
| 新增 `utils/role.js` | 角色读取、`canAdmin/canAttendant`、页面级守卫 | P0 |
| 新增 `utils/order.js` | 统一状态/支付映射、展示状态派生、支付窗口判断 | P1 |
| `pages/home/index.js/wxml` | 角色化数据源、收益口径、入口权限、在线状态 | P0/P1 |
| `pages/order/index.js/wxml` | 角色化列表、服务端筛选、分页修复、待取消操作、支付/取消标识 | P0 |
| `pages/order/orderDetail.js/wxml` | 患者快照兜底、取消信息、支付/退款信息、查支付、删除、分配陪诊师、服务记录 | P0/P1 |
| `pages/order/orderEdit.js/wxml` | 服务目录规则、医院选择、地址/病历号、性别要求、收货地址、支付渠道、支付锁定、角色字段限制 | P0/P1 |
| `pages/healthprofile/index.js/wxml` | 分页/搜索/归属用户、快捷菜单落地 | P1 |
| `pages/healthprofile/profileInfo.js/wxml` | 所属用户、校验、证件号/地区/血型、删除提示 | P1 |
| `pages/customer/index.js/wxml` | 分页修复、服务端搜索、详情跳转 | P1 |
| 新增 `pages/customer/detail.*` | 客户资料 + 档案 + 订单 + 代客下单 | P1 |
| 新增 `pages/training/index.*` | 培训报名列表/状态筛选 | P1 |
| 新增 `pages/hospital/*` | 医院库列表/详情/编辑 | P1 |
| `components/hospital-select` | 从 C 端复用/适配 | P1 |
| `pages/ai/index.js/wxml` | 接口快捷问题、语音/图片识别 | P2 |
| `pages/set/index.js/wxml` | 菜单落地、登录口径、清除缓存后刷新 | P1/P2 |
| `pages/me/index.js/wxml` | 个人资料编辑入口 | P2 |
| 新增内容页 | 协议/指南/关于/联系 | P2 |
## 八、验收清单(P0)
- [ ] 管理员登录后能看到全部订单;陪诊员登录后只能看到 `attendant.id = 本人 userId` 的订单,不再出现 403。
- [ ] 陪诊员订单列表支持状态筛选、分页、上拉加载;所有页签计数正确。
- [ ] 管理员选择有归属客户的档案创建订单,订单 `userId` 为该客户,客户在 C 端能看到;选择无归属档案可下单,订单 `userId` 留空并提示,后续可通过订单编辑补归属;不再报「档案不存在」。
- [ ] 订单详情在档案 403/已删除时仍能显示订单快照中的患者姓名、电话、性别、年龄。
- [ ] 已支付/部分支付/退款中/已退款订单的支付字段在编辑页锁定只读,且显示真实支付状态文案(不再显示「未支付」);线下补录与部分支付的详细验收见 P1-11。
- [ ] 订单列表不再出现「没有更多了」但实际还有数据的分页问题。
- [ ] 所有管理员专属接口(全量订单、档案、客户、医院、培训、退款查单、删除)在陪诊员身份下不会出现在界面中。
## 九、实施评审结论(2026-11-06,代码级核实)
**总体结论:P0 计划可实施,且工作量比正文预估更小。** 后端三个缺口(B1/B2/B3)在模型层与 handler 层均有现成基础;实施前需确认 1 个跨服务依赖,注意 2 个实现约束。
### 9.1 实施利好(比正文预估更小的改造面)
- **B3 改造面很小**:`createRecord` 已有完整管理员分支——payChannel 按 method 推导(`escort_record.js:400-407`)、method 白名单(`:416-419`)、attendant 对管理员放行(`:377`);档案归属校验(`:352-355`)与未完成单上限(`:421-423`)都基于 `userId` 变量,放开 userId 后自动正确。幂等键后端已实现(`:337-344`),P0-3 的幂等键要求后端零改动,管理端前端传字段即可。
- **B1/B5 模型层现成**:`Employee.userId`(`schema/employee.js:31`)、`findByUserId`(`:194`)、`findByRole(role, {page,pageSize,status})`(`:180-183`)、`attendantInfo.isOnline`(`:99`)均已存在,handler 只需薄封装。
- **B2 复用点明确**:`withPaymentWindow` 是 handler 静态方法(`escort_record.js:125`),attendant 列表增强可直接复用;分页/计数参照 `findRecordPage`(`schema/escort_record.js:283-299`)。
### 9.2 实施前需确认 / 注意
1. **【已定方案】B3 归属校验采用「档案锚定」,不查用户;无归属档案可下单,userId 留空后期补**(产品已确认):health 服务获取用户的唯一途径是经 user 服务的 `getUserByToken`(`utils/user_service.js`),且其注释明确「user 服务已不再接受按 userId 明文查询,避免凭 userId 冒充他人身份」——为代客下单新开按 userId 查询接口会撞上这条安全设计。故 B3 实施为:
- 管理员建单**不传 userId**(传了也忽略),订单归属取 `healthProfileId` 对应档案的 `profile.userId`;档案有归属则订单带该 userId;
- 档案无归属时**允许下单**,订单 `userId` 留空(schema 非必填,`schema/escort_record.js:28-33`),后期由管理员通过 `PUT /escort-record/:id` 补归属(`RECORD_FIELDS` 已含 `userId`,`handler/escort_record.js:19-23`,后端无需新增能力);
- 实现注意:`createRecord` 的 `userId` 来源从 token 用户改为 `profile.userId || null`;
- 幂等键(`:342`、`:469`)按 `userId: null` 查询可用:`{ userId: null }` 同时匹配字段缺失,唯一索引仍生效,键随机无实际碰撞风险;
- **未完成单上限(`:455-461`)对空 userId 必须跳过校验**:`countUnfinishedRecords(null)` 会统计全部无主订单,第 4 张无主订单起会被「每个用户最多 3 个」全局拦截;
- 留空订单不出现在 C 端「我的预约」(按 userId 查询天然不命中),补归属后客户才可见;
- 档案归属必填(B13/P1-4)不再是代客下单的前置条件,两者解耦。
2. **tabBar 不能按角色动态切换**:管理端 `app.json` 为静态 3 tab(首页/AI/设置),微信原生 tabBar 无法按角色隐藏;角色化只能在页内做(数据源切换 + 入口隐藏 + 页面守卫),不引入 custom tabBar。P0-1 实施时按此理解。
3. **路由注册顺序**:新增 `/employee/me` 必须注册在 `/employee/:id` 之前(本文件已有同类注释先例:`:88`、`:154`)。
### 9.3 建议实施顺序(两批次)
- **批次 1(后端,可一次合入)**:B1(`GET /employee/me`)→ B2(attendant 列表增强)→ B3(代客下单,档案锚定方案已定,见 9.2-1)。三项相互独立,均为小改动。
- **批次 2(前端 P0)**:P0-1 角色层 → P0-2 + P0-5 订单列表 → P0-3 新增预约表单。P0-4(患者快照兜底)无后端依赖,可与批次 1 并行先行。
- P1 项按 B5/B6/B8/B9/B12 后端缺口到位的节奏排入。
## 十、需要产品确认
1. 本端定位是「管理员 + 陪诊员」共用,还是只面向陪诊员?这决定管理类入口是否保留。
2. 管理员「代客下单」已定案为档案锚定、无归属可留空(见 9.2-1);剩余待确认:补归属的入口与核对方式(是否需要防误挂校验)。
3. 陪诊员是否需要查看患者身份证号、完整费用与退款信息?建议只给服务必需字段。
4. 培训报名是否需要审核流转(联系/入班/取消),还是只读列表即可?
5. 医院库维护是否放在本端,还是由独立后台维护?
6. 部分支付/线下收款补录是否为必须能力?当前后端支持,但管理端没有界面。