feat(分组权限): 分组管理接口 + 管理页 + 端到端验收

后端 endpoints/groups.py(**仅 SUPER_ADMIN**):
· 组的 CRUD(两级,子组不配范围则继承父组 —— 生产大组配一次,下面的
  生产/测试小组都不用再配)
· 成员增删 / 设组长 / 候选人下拉(复用 MOM 查询口径,部门已钉死为 ORG_DEPARTMENT)
· **删组仅限空组**:级联删是一次静默的批量权限变更,误点一下一批人就突然
  看不到数据了;强制「先移人再删组」多一步,但出错时是可见的
· 停用组的语义写死在接口文档:成员**立即**退回未分组状态

为什么只有超管能管分组(不是偏好,是必须):
  被显式分进组的 SUPERVISOR 会从「全厂」降级为只看本组;若允许主管管理分组,
  他把自己移出组就能恢复全厂视野 —— 这是一条现成的提权路径,分组对他无效。

前端:
· AdminGroupsPage:组列表 + 可见范围勾选 + 成员管理 + 组长标记 + 二次确认
· AdminLayout 加菜单项,页头显示数据范围徽标 —— 空范围(未分组)用橙色显眼
  提示,否则用户看到空列表会以为系统坏了,这是最难排查的一类反馈
· AuthContext 登录后补拉一次 /auth/me 拿 scope(登录接口不查库、不返回它)
· constants/task.ts 新增 isSuperAdmin,不手写 === 比较

端到端验收(实测):先造 1 生产 + 1 售后产品,然后
  生产组员 → 1 条,全 PRODUCTION;范围经「生产小组 → 生产大组」继承而来
  维修组员 → 1 条,全 AFTER_SALES
  超管     → 2 条,全量
  任务列表 total 与 returned 一致(验证 count/select 双过滤)
  扫码跨组仍 200(符合「能看、不能操作」的既定决策)
  停用维修大组 → 成员立即退回未分组
  上述测试数据已还原
This commit is contained in:
2026-09-21 17:10:33 +08:00
parent cfcfca7269
commit 3c1c5d6fb5
9 changed files with 1218 additions and 3 deletions

View File

@ -13,11 +13,28 @@ import { login as loginApi, getMe, logout as logoutApi } from "../services/authA
// 类型
// ============================================================
/**
* 业务分组数据范围 —— 来自 /auth/me。
*
* ⚠️ 登录接口(/auth/login)**不查库**、不返回 scope,所以登录后要先静默
* 调一次 getMe() 才拿得到;否则页头的范围徽标会空一下。
*/
export interface DataScopeInfo {
is_unrestricted: boolean; // 全厂(超管 / 未分组主管)
is_empty: boolean; // 未分组 —— 看不到任何数据
phases: string[];
phase_labels: string[]; // 中文标签,服务端下发
groups: string[];
is_leader: boolean;
reason: string;
}
export interface UserInfo {
id: string;
username: string;
display_name: string;
role: string;
scope?: DataScopeInfo;
}
interface AuthState {
@ -105,11 +122,22 @@ export function AuthProvider({ children }: { children: ReactNode }) {
const result = await loginApi(username, password);
const accessToken = result.access_token;
const refreshToken = result.refresh_token;
const user: UserInfo = result.user;
let user: UserInfo = result.user;
// 存储双 Token
localStorage.setItem(ACCESS_TOKEN_KEY, accessToken);
localStorage.setItem(REFRESH_TOKEN_KEY, refreshToken);
// 补拉一次 /auth/me 拿数据范围(scope)。
// ⚠️ 登录接口不查库、不返回 scope,直接用 result.user 的话页头范围徽标会
// 空一下,用户会以为分组没生效。多这一次请求换状态一致,值得。
// 失败不阻断登录:拿不到 scope 只是徽标不显示,不影响使用。
try {
user = { ...user, ...(await getMe(accessToken)) };
} catch {
/* 忽略:保持登录,只是暂时没有范围信息 */
}
localStorage.setItem(USER_KEY, JSON.stringify(user));
setState({ user, token: accessToken, loading: false });
}, []);