# M02-D 用户与员工管理 API ## 新增接口 - `GET /admin-api/users`:分页查询当前租户用户,支持状态和关键词筛选;手机号与最近登录 IP 脱敏。 - `POST /admin-api/staff`:创建员工并分配角色、门店和备注。 - `PATCH /admin-api/users/:id`:更新资料、状态、角色、门店范围和备注。 - `POST /admin-api/users/:id/reset-sessions`:撤销目标用户全部活动会话。 ## 权限与数据范围 - 需要 `staff.manage`、`tenant.manage` 或平台管理员角色。 - 门店管理员只能查看和管理自己授权门店内的员工,不能授予租户级或平台级角色。 - 租户管理员可管理本租户员工,但所有 SQL 仍强制包含 `tenant_id`。 - 禁止管理员修改自己的角色、状态和门店范围,避免自锁或提权绕过。 ## 会话与审计 - 禁用、角色变化、门店范围变化会提升 `role_version` 并撤销活动会话。 - 重置登录会话会提升 `role_version`,旧 JWT 立即失效。 - 创建、更新和重置会话均写入 `qipai_audit_logs`,记录操作者、资源、traceId 和非敏感变更摘要。