fix(rbac): 录入页跨菜单依赖——只有「更新录入」权限也能录入定制项目

- 问题:renderIntake / renderCustomIntake 要读 /custom/meta 与 /custom/projects、写
  POST /custom/updates,这三个接口按 SEGMENT_MENU 全归 custom 菜单 →
  仅有 intake 权限的账号进录入页直接 403 白屏(后端审计 B-3 发现)。
- guard 增加 assist 分支:GET custom/meta、GET custom/projects、POST custom/updates
  按 custom / intake 中较高级别放行;定制本体(详情/新建/修改/归档/删除)仍严格 custom。
- 新增回归:intake-only 账号读 meta/清单 200、写交付记录 200、进定制详情/新建 403;
  staff-only 账号不享受 assist。
- README 权限章节与 MEMORY 同步 assist 口径 + EXPORT_MENU fail-closed 说明;
  MEMORY 记录 migrate_legacy_rbac 已下线(10-01 前旧库需经含迁移版本中转)。
- pytest 89 passed
main
mula.liu 2026-11-04 01:18:24 +08:00
parent 2026040baa
commit 7ff0242c30
4 changed files with 37 additions and 2 deletions

View File

@ -51,8 +51,8 @@
## 登录与权限 / RBAC(2026-10-01 成体系)
- 全站需**登录**:未登录访问 `/api/*` 返回 **401**。默认管理员 **admin / admin123**(`app/config.py` 的 `ADMIN_PASSWORD`,可用 `.env` 覆盖);另有 `user`(部门成员)。
- **三层模型**:`users` ←(`user_roles`)→ `roles` ←(`role_menus`)→ 菜单授权。`role_menus` 一行 = 一个菜单一个级别(`rw` 可编辑 / `ro` 只读),**表里没这行 = 看不到该菜单**;一个用户可挂多个角色,最终权限取**并集**(同菜单取更高级别,`constants.merge_levels` + `LEVEL_RANK`)。旧库由 `security.migrate_legacy_rbac()` 从 `roles.menus` / `users.menus` JSON 迁过来。`audit_logs` 记写操作与登录行为。
- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写操作按钮;后端 `security.guard` 按 `SEGMENT_MENU`(接口路径首段 → 菜单)二次校验,直接调接口绕不过去。菜单 = `constants.MENUS` 八项:board / projects / custom / focus / staff / intake / settings / rbac。
- **三层模型**:`users` ←(`user_roles`)→ `roles` ←(`role_menus`)→ 菜单授权。`role_menus` 一行 = 一个菜单一个级别(`rw` 可编辑 / `ro` 只读),**表里没这行 = 看不到该菜单**;一个用户可挂多个角色,最终权限取**并集**(同菜单取更高级别,`constants.merge_levels` + `LEVEL_RANK`)。`security.migrate_legacy_rbac()`(一次性旧库迁移)已于 2026-11-04 删除——2026-10-01 之前形态的库要先跑含迁移的版本中转。`audit_logs` 记写操作与登录行为。
- **两端同时管**:前端 `canR/canW/can` 过滤侧栏与写操作按钮;后端 `security.guard` 按 `SEGMENT_MENU`(接口路径首段 → 菜单)二次校验,直接调接口绕不过去。**唯一跨菜单开口**:录入定制项目要读的 `custom/meta`、`custom/projects`(GET) 与要写的 `custom/updates`(POST) 按 custom/intake 较高级别放行(guard 里的 assist 分支)。`/export/*` 未登记 `EXPORT_MENU` 一律 403(fail-closed)。菜单 = `constants.MENUS` 八项:board / projects / custom / focus / staff / intake / settings / rbac。
- **会话 = 服务端 token + HttpOnly Cookie `unis_session`**(`SESSION_DAYS=30`,启动时 `purge_expired_sessions()` 清过期)。**只认 Cookie,不认自定义头**;退出 / 停用 / 改密 / 强制下线都是删 token,立即失效。写脚本登录用 `http.cookiejar` + `POST /api/auth/login`,响应体是 user dict,**不含 token**。
- **防锁死**:`ensure_seed()` 保证至少留一个 `rbac: rw` 的启用账号;内置角色(管理员 / 部门成员 / 只读访客)`is_builtin`,禁止删除。
- **界面**:「权限管理」四个子页签 `#view-rbac .ctab[data-rbactab=roles|users|sessions|logs]`:角色权限(授权矩阵)/ 用户 / 在线会话(强制下线)/ 操作日志(菜单 + 动作 + 时间过滤,可清空)。

View File

@ -382,6 +382,9 @@ python scripts/legacy/add_entry_date.py --force # 全部重算
每个路由都挂了 `security` 的权限依赖,按路径首段映射菜单(`SEGMENT_MENU`),
读请求要求 `ro`、写请求要求 `rw`;越权返回 403 并记一条 `audit_logs`(`action=deny`)。
`/api/auth/*`、`/api/meta` 这类只要求登录,不看菜单,否则无法登录与自助改密。
录入页跨菜单依赖单独开口:`GET /api/custom/meta`、`GET /api/custom/projects`、`POST /api/custom/updates`
按 **custom / intake 两者中较高的级别**判定——只有「更新录入 rw」的账号也能录入定制项目;
定制本体(详情 / 新建 / 修改 / 归档)仍严格走 custom。新增这类跨菜单读接口要同步改 `security.guard` 的 assist 白名单。
- **内置角色**:`管理员`(全部 `rw`)、`部门成员`(业务菜单 `rw`,设置与权限只读/无)、`只读访客`(除权限外全部 `ro`),
`is_builtin` 标记,不能删除。
- **不会被锁死**:系统始终保证至少有一个「启用 + 权限管理可编辑」的账号;

View File

@ -24,6 +24,7 @@ from sqlalchemy.orm import Session
from . import config
from .constants import (
LEVEL_LABELS,
LEVEL_RANK,
LEVELS,
MENU_KEYS,
MENU_LABELS,
@ -225,6 +226,19 @@ def guard(request: Request, db: Session = Depends(get_db)) -> User | None:
if request.method not in READ_METHODS and user.menus.get("rbac") != "rw":
raise HTTPException(status_code=403, detail=f"「{MENU_LABELS['rbac']}」是只读权限,不能修改")
return user
# 录入页跨菜单依赖:录入定制项目必须能读定制元数据 / 项目清单并写定制交付记录。
# 只给「更新录入」权限的账号也要能完成录入,这三个接口按 custom / intake 两者中较高的级别放行;
# 定制项目其余接口(详情、修改、归档……)仍严格走 custom 菜单。
assist = ((request.method in READ_METHODS and path in ("/api/custom/meta", "/api/custom/projects"))
or (request.method == "POST" and path == "/api/custom/updates"))
if assist:
need_write = request.method not in READ_METHODS
have = max((user.menus.get(m, "") for m in ("custom", "intake")),
key=lambda x: LEVEL_RANK.get(x, 0))
if have and (not need_write or have == "rw"):
return user
raise HTTPException(status_code=403,
detail=f"录入定制项目需要「{MENU_LABELS['intake']}」或「{MENU_LABELS['custom']}」的可编辑权限")
rule = resolve_rule(path, request.method)
if rule is None:
return user

View File

@ -51,3 +51,21 @@ def test_操作日志服务端分页(h):
ids0 = {x["id"] for x in p0["items"]}
ids1 = {x["id"] for x in p1["items"]}
assert not (ids0 & ids1)
def test_录入页跨菜单依赖(h):
"""只给「更新录入 rw」的账号:能读定制 meta/清单、能写定制交付记录(录入闭环),
但定制项目详情 / 新建仍归 custom 菜单。"""
pid = h.today_period_id
cp = h.custom("录入联动用定制项目")
c = h.user_client("intake_only", menus={"intake": "rw"})
assert c.get("/api/custom/meta").status_code == 200
assert c.get("/api/custom/projects").status_code == 200
r = c.post("/api/custom/updates", json={"custom_project_id": cp["id"], "period_id": pid, "content": "只凭录入权限写的交付记录"})
assert r.status_code == 200, r.text
# 定制项目本体操作不在 assist 白名单里
assert c.get(f"/api/custom/projects/{cp['id']}").status_code == 403
assert c.post("/api/custom/projects", json={"name": "越界新建"}).status_code == 403
# 连 custom 读都没有的其它菜单账号(如只有 staff rw)不享受 assist
s = h.user_client("staff_only", menus={"staff": "rw"})
assert s.get("/api/custom/projects").status_code == 403