55 KiB
陪诊师端(wxapp_companion)功能同步改造清单
分析日期:2026-11-06 分析基准:
api/health/routes/index.js(接口能力)、ui/wxapp_escort(用户端已实现功能)、ui/wxapp_companion(陪诊师/管理端现状) 本文只做差距分析与改动项整理,不包含代码实现。 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 定为档案锚定且无归属可留空。
一、结论摘要
- 这个端实际同时承载「管理员」和「陪诊员」两种身份,但代码默认按管理员工作。 订单列表、首页统计都调用
GET /health/escort-record(要求管理员),陪诊员登录后会直接 403;专门给陪诊员用的GET /health/escort-record/attendant已封装却从未使用。 - 「新增预约」目前只能给管理员本人下单。 后端
createRecord强制userId = token 用户,且就诊人档案必须属于该用户;前端却允许选择任意客户的档案,选到客户档案会提示「就诊人档案不存在」。 - 订单支付补录只支持「全额已支付/未支付」,且已收款状态显示误导。 编辑页
paymentLocked已对partial/paid/refunding/refunded四种状态锁定且保存时不回传支付字段,不存在误改回未支付的风险;但表单会把它们回填显示为「未支付」,没有部分支付补录能力,手工标记「线上微信已支付」还会被后端拒绝。 - 订单列表的分页、筛选、统计都是前端按当前页计算的。
hasMore计算后恒为false,上拉加载永远不会触发;状态筛选只对已加载的当前页生效。 - 多个接口能力尚未接入管理端: 陪诊员本人订单、支付查单、订单软删除、培训报名列表、医院库 CRUD、AI 语音/图片识别、AI 快捷问题、服务协议/服务指南等内容页。
- 健康档案缺少「所属用户」概念。 管理端新建档案不写
userId,生成的档案无法用于任何客户订单;客户详情页的路由还指向一个不存在的页面。 - 建议顺序:先补后端 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 / areasservice.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/idnumberlocation.country/province/city/district/addresshealth.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 实施前需确认 / 注意
- 【已定方案】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)不再是代客下单的前置条件,两者解耦。
- 管理员建单不传 userId(传了也忽略),订单归属取
- tabBar 不能按角色动态切换:管理端
app.json为静态 3 tab(首页/AI/设置),微信原生 tabBar 无法按角色隐藏;角色化只能在页内做(数据源切换 + 入口隐藏 + 页面守卫),不引入 custom tabBar。P0-1 实施时按此理解。 - 路由注册顺序:新增
/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 后端缺口到位的节奏排入。
十、需要产品确认
- 本端定位是「管理员 + 陪诊员」共用,还是只面向陪诊员?这决定管理类入口是否保留。
- 管理员「代客下单」已定案为档案锚定、无归属可留空(见 9.2-1);剩余待确认:补归属的入口与核对方式(是否需要防误挂校验)。
- 陪诊员是否需要查看患者身份证号、完整费用与退款信息?建议只给服务必需字段。
- 培训报名是否需要审核流转(联系/入班/取消),还是只读列表即可?
- 医院库维护是否放在本端,还是由独立后台维护?
- 部分支付/线下收款补录是否为必须能力?当前后端支持,但管理端没有界面。