Files

166 lines
15 KiB
Markdown
Raw Permalink 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.
# ws_health 未完成事项与后续计划
> 整理日期:2026-11-10
> 依据:2026-11 的六份专项设计文档(已并入 `architecture-overview.html`),并结合当前代码核对
> 配套架构文档:[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 | 多端登录互踢 | 已改为多端会话:`security.tokens` 每端一条 token 哈希(上限 10 条),登录互不覆盖;`token/tokenExpiry` 镜像最新会话兼容旧客户端 | 已完成 | 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. 待产品确认
1. 管理端小程序定位:长期是“管理员 + 陪诊员”共用,还是只面向陪诊员?决定管理类入口是否保留。
2. 代客下单补归属的入口与核对方式:是否需要防误挂校验(如二次确认、操作日志)。
3. 陪诊员可见字段范围:是否需要查看身份证号、完整费用与退款信息?建议只给服务必需字段。
4. 培训报名是否需要审核流转(联系 / 入班 / 取消),还是只读列表即可?决定 B1 是否排期。
5. 医院库维护放在陪诊师小程序、Web 后台,还是独立后台?
6. 部分支付 / 线下收款补录是否为必须能力?当前后端支持,管理端仅做了全额补录。
7. 多应用同时登录(不互踢)是否需要在下一阶段解决?
8. 陪诊师获单模式:平台派单 / 陪诊师抢单 / 用户指定?已拍板——三条链路全部落地:用户下单可指定在职正式陪诊师(也可不选)、正式陪诊师可抢未分配订单、管理端可指派;仍待定:是否需要「待接单 / 拒单」状态。
9. 陪诊师等级体系与考核周期:已拍板——采用「青铜 / 白银 / 黄金 / 钻石」档位(钻石可带 0-5 星),等级只做展示与排序、人工调整、不留历史,钻石规则人工定;仍待定:考核周期(自然月 / 滚动窗口)与降级是否需连续不达标触发。
10. 平台与陪诊师的分成规则、结算周期与提现方式:按单结算还是按周打款?是否需要冻结期与申诉期?
11. 履约是否强制签到与过程上报:不定这一条,B6 的考核指标拿不到数据源,B9 就无法排期。
---
## 8. 建议执行顺序
1. **上线硬项**:O1 凭证轮换 → O2 索引迁移 → O3 / O4 支付配置与合规 → O5 Web 后台配置与密码。
2. **管理端 P1 闭环**:M8 请求层(前置)→ M1 客户详情 → M2 + B3 档案归属 → M3 / M5 订单详情与支付 → M4 订单编辑。
3. **管理能力补齐**:M6 + B1 培训、M7 医院库。
4. **陪诊师成长域启动**(等级展示、订单池抢单、管理端派单与在线开关已先行落地):第 7 节 8–11 条拍板(8 / 9 已部分拍板)→ B9 履约埋点 → B7 评价写入点 → B5 / B6 分成结算与等级考核。
5. **模型收尾**:U1 P4 → U2 P5(需一个发布周期与全量回归)。
6. **扩容前优化**:O6 Redis 外移、O7 配置统一。
7. **按需排期**:M10 / M11 / M12、W1 / W2 / W3、第 6 节延后项。