qipai/docs/api-changelog/2026-06-18-M02-D-user-management.md

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 和非敏感变更摘要。