15 KiB
15 KiB
ws_health 未完成事项与后续计划
整理日期:2026-11-10 依据:2026-11 的六份专项设计文档(已并入
architecture-overview.html),并结合当前代码核对 配套架构文档:architecture-overview.html 状态口径:已完成 / 部分完成 / 未开始 / 上线前运维项 / 明确延后
0. 总览
| 模块 | 完成度 | 剩余重点 | 最高优先级 |
|---|---|---|---|
| 用户多应用模型 | 部分完成 | P4 删旧 app、P5 下游切读 apps |
P2 |
| 陪诊师入驻 | 已完成 | 索引迁移与真机联调属上线动作 | P0(运维) |
| 订单域后端 | 已完成 | 无 | — |
| 微信支付 | 已完成 | 商户配置、合规、上线核验 | P0(运维) |
| Web 管理后台一期 | 已完成 | 二期医院 / 培训 / 内容、扫码配置、默认密码 | P0(配置)/ P2(功能) |
| 陪诊师小程序 | 部分完成 | 客户详情、档案归属、订单信息与编辑、培训、医院库、请求层 | P1 |
| 陪诊师成长与资金闭环 | 部分完成 | 履约埋点、分成结算、考核快照(等级展示、用户指定、订单池抢单、管理端派单与在线开关已落地) | P2 |
| 后端架构优化 | 部分完成 | 凭证轮换、Redis 外移、配置统一 | P0 / P2 |
1. 陪诊师小程序(ui/wxapp_companion)
1.1 已完成基线
- 角色层:
utils/role.js的ensureRole / ensureRoleSafe / guardAdminPage / queryOrders,管理员 / 陪诊员 / 无身份三态。 - 全局守卫:
app.js包装Page(),无身份跳申请页,解析失败停留当前页。 - 入驻申请页:
pages/apply/*三视图(表单 / 待审核 / 已是员工)。 - 订单主链路:角色化数据源、服务端筛选、分页与
hasMore修复、支付锁定、退款查单、线下补录入口(全额)。 - 身份等级展示(2026-11):
attendantInfo.stage(实习 / 正式)与grade(青铜 / 白银 / 黄金 / 钻石 + 星级);/employee/me返回阶段等级,首页 / 个人中心展示,管理端可调级。 - 订单池接单与共享(2026-11):陪诊师按身份看「未分配 + 本人已接 + 被共享」订单;正式可接单(不校验支付、取消中不可接、条件更新防并发),实习只读脱敏;接单本人可共享给任意在职陪诊师并支持取消。
- 派单与在线状态(2026-11):管理端可在订单详情把未分配订单指派给在职正式陪诊师;首页接单开关已接
PATCH /employee/me/online落库,仅正式陪诊师可切换。 - 用户指定陪诊师(2026-11):用户端新增陪诊师列表 / 详情页(首页「找陪诊师」入口),下单页可选「指定陪诊师」;只提交
employeeId,后端校验在职正式并回填真实姓名 / 电话快照,未指定订单进入公共池。 - 后端支撑已就绪:
GET /employee/me、陪诊师订单池列表、接单 / 共享接口、POST /escort-record/:id/assign、PATCH /employee/me/online、GET /employee/shareable-attendants、代客下单(档案锚定)、用户下单指定陪诊师(服务端校验)、员工列表、订单搜索与各状态计数。
1.2 待完成
| 编号 | 事项 | 现状 / 缺口 | 优先级 | 来源 |
|---|---|---|---|---|
| M1 | 客户详情页 | pages/customer/index.js 跳转 /pages/customer/detail,但该页面未注册、不存在;列表 total 仍取当前页长度,hasMore 不准 |
P1 | sync-plan P1-5 |
| M2 | 健康档案归属 | 新建档案没有“所属用户”选择;列表无归属回显;profileInfo 不传 userId |
P1 | sync-plan P1-4 / B13 |
| M3 | 订单详情补全 | 缺 cancelReason / cancelRequestedAt / cancelledAt、paidFee、支付窗口与超时标识、主动查支付状态、删除订单、服务记录编辑 |
P1 | sync-plan P1-1 / P1-2 / P1-8 |
| M4 | 订单编辑规则对齐 | 医院仍是手填,缺地址 / 病历号 / 性别要求 / 收货地址 / 支付渠道;日期时段未按服务目录渲染;未按角色限制可编辑字段 | P1 | sync-plan P1-3 |
| M5 | 部分支付与补录 | 仅支持“全额已支付 / 未支付”;无 paidFee 区间校验;payChannel 编辑缺失;支付状态文案回填不准确 |
P1 | sync-plan P1-11 |
| M6 | 培训报名列表 | 无页面、无 API 封装;后端只有列表,无详情与状态更新接口 | P1 | sync-plan P1-6 / B7 |
| M7 | 医院库维护 | utils/api.js 未封装医院库 CRUD(仅医院信息 / 榜单),无医院列表与编辑页;订单不能选院回填地址 |
P1 | sync-plan P1-7 |
| M8 | 请求层与环境配置 | 无 utils/config.js;utils/request.js:3 写死 https://api.huashengtec.com;无 401 静默重登;AI 页 appId 未定义 |
P1 | sync-plan P1-10 |
| M10 | AI 快捷问题 / 语音 / 图片 | 快捷问题仍硬编码;ai.asr / ai.ocr 未封装 |
P2 | sync-plan P2-1 |
| M11 | 内容页与个人资料 | 协议 / 指南 / 关于 / 联系、个人资料编辑均未落地;设置页仍有“开发中”占位 | P2 | sync-plan P2-2 / P2-3 / P2-7 |
| M12 | 隐私与展示细节 | 实习订单池脱敏已做(患者姓名 / 电话 / 地址 / 病历号 / 病史 / 诉求,keyword 侧信道已封);其余列表未脱敏,陪诊员与管理员信息无差异;医院榜单 / 公示预览未做;部分页面缺空态兜底 | P2 | sync-plan P2-4 / P2-5 / P2-6 / P2-8 |
1.3 关键验收口径
- 客户详情能从列表进入,展示用户资料、名下档案、名下订单,并支持代客下单 / 新增档案;分页以服务端
total为准。 - 新建档案必须选择归属客户(或本人),编辑页回显归属;无归属档案有明确提示。
- 订单详情在档案 403 或已删除时仍能展示订单里的患者快照;已取消订单能看到完整取消信息。
- 已支付订单的支付字段只读且显示真实状态文案;补录线下收款时
0 ≤ paidFee ≤ totalFee,状态由页面按金额推导。 - 请求层支持本地 / 生产环境切换,token 失效可静默重登并重试一次。
2. Web 管理后台(ui/web_escort_admin)
2.1 已完成基线
- 登录:手机号密码 + 微信扫码回调页;路由守卫校验
apps中的web-escort-admin管理员成员关系。 - 工作台、订单(列表 / 详情 / 状态流转 / 支付补录 / 取消审核 / 退款查询、重试、人工核销 / 软删除 / 未分配订单「分配陪诊师」)。
- 用户管理(筛选 / 锁定解锁)、就诊人管理、陪诊师管理(在职列表 + 入驻审核页签 + 材料弹窗 + 累计接单展示)。
2.2 待完成
| 编号 | 事项 | 现状 / 缺口 | 优先级 |
|---|---|---|---|
| W1 | 二期模块 | 医院管理、培训报名审核闭环、内容配置(协议 / 指南)均未建页面与路由 | P2 |
| W2 | 管理员授权管理 | 后端 /user/grant 已可用,后台暂无授权页面 |
P2 |
| W3 | 模板 demo 清理 | 仍保留 views/admin/*、views/auth/* 等大量未使用模板页 |
P3 |
| W4 | 微信扫码登录配置 | conf.json 的 app["web-escort-admin"] 需填 appid / secret,回调域名需配到微信后台;未配置时扫码接口返回 503 |
上线前运维 |
| W5 | 初始管理员安全 | 默认密码 Escort@2026 必须在上线前更换;重跑 api/user/scripts/create_web_admin.js 即可 |
上线前运维 |
| W6 | 服务重启 / 构建 | 后端改动需重启,前端需构建部署;当前无热重载 | 上线前运维 |
3. 用户多应用模型(api/user)
| 编号 | 事项 | 现状 / 缺口 | 优先级 | 来源 |
|---|---|---|---|---|
| U1 | P4:停止写旧 app、删除字段、strict: true |
api/user/models/schema/user.js:74 仍有 app,:87 仍为 strict: false;写入仍在双写 |
P2 | multi-app P4 |
| U2 | P5:下游完全切读 apps |
health 侧 permissions.js 已优先读 apps,但仍保留旧 app 兜底;web_tcm 仍读 app.tcm(外部仓库) |
P2 | multi-app P5 |
| U3 | 多端登录互踢 | 仍为单 token,管理端登录会把 C 端踢下线;user_session 未建 |
明确延后 | multi-app §6.2 / §12.3 |
| U4 | unionid 跨应用合并 |
依赖微信开放平台绑定后才有值;未绑定时退化为手机号 | 运营配置 | multi-app §10 |
| U5 | 新应用 config 白名单 | ttapp-escort 等未配置 APP_CONFIG_SCHEMAS,写入会返回 400;接入前需补 |
接入前 | multi-app §6.7 |
U1 前置条件:所有客户端已改读 apps,且兼容视图稳定运行至少一个发布周期;执行前备份 user 集合。
4. 后端能力缺口(api/health)
| 编号 | 事项 | 现状 / 缺口 | 优先级 |
|---|---|---|---|
| B1 | 培训报名详情与状态流转 | 只有 GET /training-application;缺 GET /:id(含材料)与 PATCH /:id/status |
P1(若做审核闭环) |
| B3 | 档案归属校验增强 | handler/health_profile.js:56-62 只校验 ObjectId 格式,未校验用户在 user 服务存在,也未禁止管理端转移归属 |
P1 |
| B5 | 陪诊师分成与结算 | 无分成比例、无结算单、无提现;payment_record 只覆盖用户→平台,缺平台→陪诊师的资金链路 |
P2 |
| B6 | 等级与考核快照 | attendantInfo.stage / grade / star 已建(人工调级、仅展示、不留历史);缺考核指标快照与自动评级,考核周期(自然月 / 滚动窗口)与降级规则待定 |
P2 |
| B7 | 评价写入接口 | employee_review 表与 recordId 唯一索引已建,但全项目无写入点;公示评分恒为 count=0 / score=null(阈值 5 条) |
P2 |
| B9 | 履约过程埋点 | 无签到、过程上报、异常上报;考核指标、准时率、履约证据都缺数据源,是 B6 的前置 | P2(B6 前置) |
已补齐、无需再排期:
GET /employee/me、陪诊师订单池口径(按身份合并可见范围)、接单 / 共享 / 取消共享接口、POST /escort-record/:id/assign管理端指派(仅未分配、在职正式陪诊师、条件更新防并发)、PATCH /employee/me/online接单开关、attendantInfo.orderCount接单 / 指派 / 用户指定回写、公示累计接单展示与排序、用户端陪诊师列表 / 详情页与下单指定陪诊师(服务端校验在职正式 + 快照回填)、共享候选名单、PATCH /employee/:id/level调级、公示接口排除实习、代客下单档案锚定、订单搜索 / 支付状态筛选 / 各状态计数、订单详情软删除过滤、陪诊员服务记录字段、/user/lock解锁接口、/user/info/batch批量取用户。
5. 安全与上线运维项
| 编号 | 事项 | 说明 | 优先级 |
|---|---|---|---|
| O1 | 凭证轮换 | MongoDB 密码、微信 AppSecret、.env 内 3 个 API key 均已入 git 历史;需更换凭证,并确认 conf.json / .env 已从索引移除 |
P0(安全) |
| O2 | 员工 userId 索引迁移 | 依次执行 node scripts/check_employee_binding.js → node scripts/migrate_employee_userid_unique_index.js --apply → node scripts/check_db_schema_sync.js |
P0(部署) |
| O3 | 微信支付商户配置 | JSAPI 权限、商户号与小程序 APPID 绑定、API 证书、APIv3 密钥、微信支付公钥、账户余额;服务器 conf.json、环境变量、出网、回调 IP / WAF |
P0(上线前) |
| O4 | 支付合规 | 交易类小程序需接入“订单发货管理”,否则可能被限制支付权限 | P0(上线前) |
| O5 | Web 后台配置 | 扫码 appid / secret / 回调域名;默认管理员密码更换;服务重启与前端构建 | P0(上线前) |
| O6 | Redis 外移 | 限流、微信 access_token 缓存、WS Agent 缓存均为进程内存态,多实例部署前需外移 | P2(扩容前) |
| O7 | 配置统一 | 两服务各一份 conf.json,Mongo 连接信息重复;统一到服务器级 .env |
P2(中期) |
| O8 | JWT / refresh token | 当前为不透明 token + 5 分钟缓存;中期可换短 access + refresh,降低登出延迟 | P3(中期) |
6. 微信支付:明确延后项
以下均为原微信支付方案第十节已确认“本期不做”,不属于遗漏:
- 交易账单 / 资金账单自动下载与自动对账(现由巡检 + 人工下载账单兜底)。
- 巡检多频率退避与告警(现固定 10 分钟一轮)。
- 退款
ABNORMAL(银行卡作废 / 冻结)自动异常退款(现转人工)。 - 支付主备域名自动切换(现只连主域名)。
- 部分退款 / 多次退款(现一单一退,
outRefundNo固定-R1)。 - 培训报名复用
payment_record接入支付。
7. 待产品确认
- 管理端小程序定位:长期是“管理员 + 陪诊员”共用,还是只面向陪诊员?决定管理类入口是否保留。
- 代客下单补归属的入口与核对方式:是否需要防误挂校验(如二次确认、操作日志)。
- 陪诊员可见字段范围:是否需要查看身份证号、完整费用与退款信息?建议只给服务必需字段。
- 培训报名是否需要审核流转(联系 / 入班 / 取消),还是只读列表即可?决定 B1 是否排期。
- 医院库维护放在陪诊师小程序、Web 后台,还是独立后台?
- 部分支付 / 线下收款补录是否为必须能力?当前后端支持,管理端仅做了全额补录。
- 多应用同时登录(不互踢)是否需要在下一阶段解决?
- 陪诊师获单模式:平台派单 / 陪诊师抢单 / 用户指定?已拍板——三条链路全部落地:用户下单可指定在职正式陪诊师(也可不选)、正式陪诊师可抢未分配订单、管理端可指派;仍待定:是否需要「待接单 / 拒单」状态。
- 陪诊师等级体系与考核周期:已拍板——采用「青铜 / 白银 / 黄金 / 钻石」档位(钻石可带 0-5 星),等级只做展示与排序、人工调整、不留历史,钻石规则人工定;仍待定:考核周期(自然月 / 滚动窗口)与降级是否需连续不达标触发。
- 平台与陪诊师的分成规则、结算周期与提现方式:按单结算还是按周打款?是否需要冻结期与申诉期?
- 履约是否强制签到与过程上报:不定这一条,B6 的考核指标拿不到数据源,B9 就无法排期。
8. 建议执行顺序
- 上线硬项:O1 凭证轮换 → O2 索引迁移 → O3 / O4 支付配置与合规 → O5 Web 后台配置与密码。
- 管理端 P1 闭环:M8 请求层(前置)→ M1 客户详情 → M2 + B3 档案归属 → M3 / M5 订单详情与支付 → M4 订单编辑。
- 管理能力补齐:M6 + B1 培训、M7 医院库。
- 陪诊师成长域启动(等级展示、订单池抢单、管理端派单与在线开关已先行落地):第 7 节 8–11 条拍板(8 / 9 已部分拍板)→ B9 履约埋点 → B7 评价写入点 → B5 / B6 分成结算与等级考核。
- 模型收尾:U1 P4 → U2 P5(需一个发布周期与全量回归)。
- 扩容前优化:O6 Redis 外移、O7 配置统一。
- 按需排期:M10 / M11 / M12、W1 / W2 / W3、第 6 节延后项。