docs(M08-C): 回填会员检索与员工概况

docs/devlogs/2026-08-10-M08-C-管理员员工端.md

@@ -55,3 +55,30 @@ M08-C 保持 `DOING`。门店概况、授权房态、订单总览和最小房态
 ### 状态
 
 M08-C 保持 `DOING`。订单筛选、处置、备注和代下单已形成授权闭环；下一工程增量继续会员检索/概况与员工运营，不移动到 M08-D。
+
+## 2026-08-10 会员检索与员工概况
+
+- `ENGINEERING_DELTA=YES`
+- 新增 `/app-api/management/members` 和 `/app-api/management/members/:id`，复用既有会员聚合服务及 `user.read`、租户、门店范围校验；授权门店会员可由该店钱包账户或历史 OWNER 订单命中。
+- 会员详情展示钱包、订单、优惠券、套餐和最近钱包流水；实付聚合状态修正为当前订单状态 `PAID/RESERVED/IN_PROGRESS/FINISHED`。
+- 新增 `/app-api/management/staff`，服务端强制 `userType=STAFF`，避免租户管理员账号混入员工列表；返回角色、门店范围、状态、备注和脱敏手机号/最近登录 IP。
+- 管理员小程序新增“会员与员工”页，支持会员搜索、聚合详情和员工搜索；代下单页改为从授权会员搜索结果中选择目标会员，取消手工填写全局用户 ID。
+- MySQL 8.4.10 实测发现当前 Node 驱动无法执行 `LIMIT ? OFFSET ?`；会员、员工、订单、保洁仓储统一改为夹取整数后拼接分页常量，其余查询过滤继续参数化，并新增静态防回归断言。
+
+### 测试证据
+
+- `powershell -ExecutionPolicy Bypass -File scripts/dev/windows/test-all.ps1`：退出码 0；仓库完整性、敏感信息、后端全量、M08-C 静态验收、迁移计划和后台生产构建全部通过。
+- WSL 原生临时副本 + MySQL 8.4.10：首次运行准确暴露分页占位符错误且清理钩子完成；修复后 `up → verify → down → up → verify` 通过，136 条 up、114 条 verify、130 条 down，并验证历史 OWNER 订单会员发现。
+- 路由/服务测试覆盖会员列表与详情、钱包/订单门店范围、STAFF 类型限定、脱敏输出及代下单会员选择。
+- 已知非阻塞提示：参考目录既有 xjar 超过 100MB；Element Plus 产物 chunk 超过 500kB；WSL `npm ci` 报告 7 个 high audit 项及 allow-scripts 提示，未执行破坏性自动升级。
+
+### 变更影响
+
+- 数据库：无 schema 迁移；修正会员聚合状态与多个既有列表的 MySQL 分页兼容实现。
+- API：新增 3 个小程序管理端会员/员工读取端点；代下单写接口契约不变。
+- 部署：后端与小程序有变化，数据库无迁移；未自动部署生产。
+- 工程提交：`1b0839e`，已推送并验证 `HEAD == origin/main`。
+
+### 状态
+
+M08-C 保持 `DOING`。会员检索、聚合详情、STAFF 员工概况和代下单会员选择已完成；下一工程增量继续保洁任务、设备状态与临时控制，不移动到 M08-D。