Files
ws_health/doc/plan.md
T

155 lines
12 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.
# ws_health 未完成事项与后续计划
> 整理日期:2026-11-10
> 依据:`backend-architecture.md`、`user-multi-app-plan.md`、`attendant-onboarding-plan.md`、`escort-admin-sync-plan.md`、`web-escort-admin-plan.md`、`wechatpay-plan.md`,并结合当前代码核对
> 配套架构文档:[architecture-overview.html](./architecture-overview.html)
> 状态口径:**已完成** / **部分完成** / **未开始** / **上线前运维项** / **明确延后**
## 0. 总览
| 模块 | 完成度 | 剩余重点 | 最高优先级 |
| --- | --- | --- | --- |
| 用户多应用模型 | 部分完成 | P4 删旧 `app`、P5 下游切读 `apps` | P2 |
| 陪诊师入驻 | 已完成 | 索引迁移与真机联调属上线动作 | P0(运维) |
| 订单域后端 | 已完成 | 无 | — |
| 微信支付 | 已完成 | 商户配置、合规、上线核验 | P0(运维) |
| Web 管理后台一期 | 已完成 | 二期医院 / 培训 / 内容、扫码配置、默认密码 | P0(配置)/ P2(功能) |
| 陪诊师小程序 | 部分完成 | 客户详情、档案归属、订单信息与编辑、培训、医院库、请求层 | P1 |
| 后端架构优化 | 部分完成 | 凭证轮换、Redis 外移、配置统一 | P0 / P2 |
---
## 1. 陪诊师小程序(`ui/wxapp_companion`)
### 1.1 已完成基线
- 角色层:`utils/role.js` 的 `ensureRole / ensureRoleSafe / guardAdminPage / queryOrders`,管理员 / 陪诊员 / 无身份三态。
- 全局守卫:`app.js` 包装 `Page()`,无身份跳申请页,解析失败停留当前页。
- 入驻申请页:`pages/apply/*` 三视图(表单 / 待审核 / 已是员工)。
- 订单主链路:角色化数据源、服务端筛选、分页与 `hasMore` 修复、支付锁定、退款查单、线下补录入口(全额)。
- 后端支撑已就绪:`GET /employee/me`、陪诊员订单列表、代客下单(档案锚定)、员工列表、订单搜索与各状态计数。
### 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 |
| M9 | 派单与在线状态 | 员工列表接口已有,但订单无“分配陪诊师”入口;首页在线开关只改本地 `data.online`,无写接口 | P1 / P2 | sync-plan P1-8 / B10 |
| M10 | AI 快捷问题 / 语音 / 图片 | 快捷问题仍硬编码;`ai.asr` / `ai.ocr` 未封装 | P2 | sync-plan P2-1 |
| M11 | 内容页与个人资料 | 协议 / 指南 / 关于 / 联系、个人资料编辑均未落地;设置页仍有“开发中”占位 | P2 | sync-plan P2-2 / P2-3 / P2-7 |
| M12 | 隐私与展示细节 | 列表未脱敏;陪诊员与管理员看到的信息无差异;医院榜单 / 公示预览未做;部分页面缺空态兜底 | 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(若做审核闭环) |
| B2 | 员工在线状态 | `attendantInfo.isOnline` 已有,但无写接口;需 `PATCH /employee/me/online` | P2 |
| B3 | 档案归属校验增强 | `handler/health_profile.js:56-62` 只校验 ObjectId 格式,未校验用户在 user 服务存在,也未禁止管理端转移归属 | P1 |
| B4 | 派单校验 | 分配陪诊师需校验目标 `userId` 是当前在职陪诊员;目前只有员工列表接口,无订单侧校验封装 | P1 |
> 已补齐、无需再排期:`GET /employee/me`、陪诊员订单列表口径、代客下单档案锚定、订单搜索 / 支付状态筛选 / 各状态计数、订单详情软删除过滤、陪诊员服务记录字段、`/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. 微信支付:明确延后项
以下均为 `wechatpay-plan.md` 第十节已确认“本期不做”,不属于遗漏:
- 交易账单 / 资金账单自动下载与自动对账(现由巡检 + 人工下载账单兜底)。
- 巡检多频率退避与告警(现固定 10 分钟一轮)。
- 退款 `ABNORMAL`(银行卡作废 / 冻结)自动异常退款(现转人工)。
- 支付主备域名自动切换(现只连主域名)。
- 部分退款 / 多次退款(现一单一退,`outRefundNo` 固定 `-R1`)。
- 培训报名复用 `payment_record` 接入支付。
---
## 7. 待产品确认
1. 管理端小程序定位:长期是“管理员 + 陪诊员”共用,还是只面向陪诊员?决定管理类入口是否保留。
2. 代客下单补归属的入口与核对方式:是否需要防误挂校验(如二次确认、操作日志)。
3. 陪诊员可见字段范围:是否需要查看身份证号、完整费用与退款信息?建议只给服务必需字段。
4. 培训报名是否需要审核流转(联系 / 入班 / 取消),还是只读列表即可?决定 B1 是否排期。
5. 医院库维护放在陪诊师小程序、Web 后台,还是独立后台?
6. 部分支付 / 线下收款补录是否为必须能力?当前后端支持,管理端仅做了全额补录。
7. 多应用同时登录(不互踢)是否需要在下一阶段解决?
---
## 8. 建议执行顺序
1. **上线硬项**:O1 凭证轮换 → O2 索引迁移 → O3 / O4 支付配置与合规 → O5 Web 后台配置与密码。
2. **管理端 P1 闭环**:M8 请求层(前置)→ M1 客户详情 → M2 + B3 档案归属 → M3 / M5 订单详情与支付 → M4 订单编辑。
3. **管理能力补齐**:M6 + B1 培训、M7 医院库、M9 + B2 / B4 派单与在线状态。
4. **模型收尾**:U1 P4 → U2 P5(需一个发布周期与全量回归)。
5. **扩容前优化**:O6 Redis 外移、O7 配置统一。
6. **按需排期**:M10 / M11 / M12、W1 / W2 / W3、第 6 节延后项。