chore: 子模块 wxapp_escort_admin 更名为 wxapp_companion 并切换仓库地址
This commit is contained in:
+3
-3
@@ -7,9 +7,9 @@
|
||||
[submodule "ui/wxapp_escort"]
|
||||
path = ui/wxapp_escort
|
||||
url = http://gitea.huashengtec.com/xJourney/wxapp_escort.git
|
||||
[submodule "ui/wxapp_escort_admin"]
|
||||
path = ui/wxapp_escort_admin
|
||||
url = http://gitea.huashengtec.com/xJourney/wxapp_escort_admin.git
|
||||
[submodule "ui/wxapp_companion"]
|
||||
path = ui/wxapp_companion
|
||||
url = http://gitea.huashengtec.com/xJourney/wxapp_companion.git
|
||||
[submodule "ui/web_tcm"]
|
||||
path = ui/web_tcm
|
||||
url = http://gitea.huashengtec.com/xJourney/web_tcm.git
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -1,7 +1,7 @@
|
||||
# 陪诊师入驻申请与审核方案
|
||||
|
||||
> 制定日期:2026-11-07
|
||||
> 代码基准:`api/health/routes/index.js`、`handler/employee.js`、`utils/permissions.js`、`ui/wxapp_escort_admin/utils/role.js`、`ui/web_escort_admin/src/views/attendants`
|
||||
> 代码基准:`api/health/routes/index.js`、`handler/employee.js`、`utils/permissions.js`、`ui/wxapp_companion/utils/role.js`、`ui/web_escort_admin/src/views/attendants`
|
||||
> 状态:已实施(2026-11-08 完成编码与文档同步,实施记录见 §12)
|
||||
|
||||
## 0. 修订记录(2026-11-07 review)
|
||||
@@ -148,7 +148,7 @@ await AttendantApplication.updateOne({ _id: doc._id }, { $set: { approvedEmploye
|
||||
|
||||
驳回:`{ status: "rejected", review: { reviewerId, reviewedAt, rejectReason } }`,原因必填、≤200 字,仅允许从 `pending` 迁移。
|
||||
|
||||
## 5. 小程序端(`ui/wxapp_escort_admin`)
|
||||
## 5. 小程序端(`ui/wxapp_companion`)
|
||||
|
||||
### 5.1 新增页面
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@ d:\work\ws_health
|
||||
│ └── HTTP :9010
|
||||
├── ui/ # 小程序端
|
||||
│ ├── wxapp_escort/ # C 端
|
||||
│ └── wxapp_escort_admin/ # 管理端
|
||||
│ └── wxapp_companion/ # 管理端
|
||||
└── doc/
|
||||
```
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
# 陪诊师端(wxapp_escort_admin)功能同步改造清单
|
||||
# 陪诊师端(wxapp_companion)功能同步改造清单
|
||||
|
||||
> 分析日期:2026-11-06
|
||||
> 分析基准:`api/health/routes/index.js`(接口能力)、`ui/wxapp_escort`(用户端已实现功能)、`ui/wxapp_escort_admin`(陪诊师/管理端现状)
|
||||
> 分析基准:`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 定为档案锚定且无归属可留空。
|
||||
|
||||
+154
@@ -0,0 +1,154 @@
|
||||
# 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 节延后项。
|
||||
@@ -7,7 +7,7 @@
|
||||
|
||||
## 一、背景与范围
|
||||
|
||||
现有管理能力承载在 `ui/wxapp_escort_admin`(小程序端,管理员/陪诊员混用),缺少桌面端后台。本方案新建 Vue Web 后台,第一期覆盖:
|
||||
现有管理能力承载在 `ui/wxapp_companion`(小程序端,管理员/陪诊员混用),缺少桌面端后台。本方案新建 Vue Web 后台,第一期覆盖:
|
||||
|
||||
- 登录 + 工作台
|
||||
- 订单管理(写操作接口齐全,列表筛选需补强)
|
||||
|
||||
@@ -363,7 +363,7 @@ escort_record (业务订单) payment_record (支付流水) refu
|
||||
| 2 | `pages/escort/itemorder.js` | 新增支付方式选择(微信支付 / 线下支付,默认微信支付);提交订单时带 `payment.payChannel`。选微信支付:下单成功 → 立即 `payOrder` → `wx.requestPayment` → 查单确认 → 按结果跳转;选线下支付:下单成功后直接跳订单列表并提示线下支付 |
|
||||
| 3 | `pages/escort/recordlist` / `recorddetail` | `unpaid` 订单按 `payChannel` 展示:`online_wechat` 显示「待支付」+「去支付」(超过支付窗口则显示「支付已超时」并隐藏去支付,只保留改线下 / 取消),`offline` 显示「线下支付」。详情页保留「取消订单」(无删除按钮):待确认且未收款取消即删除;已确认/已收款提示「取消申请已提交」。详情页增加「切换支付方式」入口(仅待支付可改);支付按钮防抖 |
|
||||
|
||||
管理端(`ui/wxapp_escort_admin`):`pages/order/orderDetail` 需展示 `refunding` / `refunded` 与 `payChannel`,并新增「查询退款结果」按钮(调 `POST /escort-record/:id/refund/query`),用于退款回调丢失时的人工兜底;`orderEdit` 在存在未决流水时禁用金额输入。
|
||||
管理端(`ui/wxapp_companion`):`pages/order/orderDetail` 需展示 `refunding` / `refunded` 与 `payChannel`,并新增「查询退款结果」按钮(调 `POST /escort-record/:id/refund/query`),用于退款回调丢失时的人工兜底;`orderEdit` 在存在未决流水时禁用金额输入。
|
||||
|
||||
## 七、关键技术点与易错点
|
||||
|
||||
|
||||
Submodule
+1
Submodule ui/wxapp_companion added at a8b896846b
Submodule ui/wxapp_escort_admin deleted from 5915396192
Reference in New Issue
Block a user