docs(M07-D): 记录会员管理验收并推进顾客端

2026-06-24 16:05:15 +08:00
parent ed0d455083
commit c90f6e34a1
6 changed files with 70 additions and 12 deletions
@@ -0,0 +1,29 @@
+# M07-D members
+
+- 工程 commit：`ed0d455`
+- 数据库迁移：无新增迁移，复用 M02 用户、M03 订单访问、M04 订单、M07 钱包/充值/权益表。
+
+## 新增后台 API
+
+- `GET /admin-api/members`
+  - 权限：有效后台会话，具备 `user.read`、`tenant.manage` 或 `PLATFORM_ADMIN`。
+  - 查询：`page`、`pageSize`、`status`、`search`。
+  - 返回：会员基础信息、脱敏手机号、余额汇总、充值汇总、订单汇总、优惠券和套餐汇总。
+
+- `GET /admin-api/members/:id`
+  - 权限：同会员列表。
+  - 返回：会员聚合档案，并额外返回最近钱包流水。
+
+## 访问范围
+
+- 租户管理员和平台管理员可查看租户内会员。
+- 门店管理员必须具备 `user.read`，且仅能查看在其门店范围内存在钱包账户的会员。
+- 无门店范围的普通员工返回空列表，详情按 `MEMBER_NOT_FOUND` 处理。
+
+## 错误码
+
+- `AUTH_SESSION_INVALID`：会话无效。
+- `MEMBER_READ_FORBIDDEN`：缺少会员查看权限。
+- `INVALID_MEMBER_REQUEST`：参数非法。
+- `MEMBER_NOT_FOUND`：会员不存在或不在当前访问范围。
+