Files
marqdo/doc/design/ext-web-rbac.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

3.3 KiB
Executable File
Raw Blame History

ext/web 可配置 RBAC(角色 ⊥ 权限)

验收 qdqc:门禁 desk:access + 评论权限;tests/ext/web-rbac-*-smoke.mq.md
状态 Accepted · 已落地核心(gate permissions;/_rbac/* 管理台 opt-in 管理台=真)

0. 一句话

权限是原子能力(resource:action);角色是权限包;用户通过 user_roles 获得角色。门禁与业务都问 can(user, permission)。管理员可在后台新建角色、勾选权限、赋给用户——禁止只靠写死的 role=admin|user 字符串作为唯一模型(兼容期仍可读旧 roles= gate)。


1. 表结构(SQLite / Postgres 同构)

表 列
web_permissions code PK, resource, action, description
web_roles id PK, name UNIQUE, is_system INT, tenant_id TEXT NULL
web_role_permissions role_id, permission_code PK(role_id, permission_code)
web_user_roles user_id, role_id, tenant_id TEXT NULL, PK(user_id, role_id, tenant_id)
web_users id PK, username UNIQUE, password_hash, created_at

命名带 web_ 前缀,避免与业务表冲突。站点也可映射自定义表名(后期);首版固定。


2. 权限码约定

形如 comments:create、desk:access、roles:manage。内置种子见 DefaultCatalog。* 或角色名 superadmin / 兼容 admin:登录时展开为目录全集。


3. 作者 API

**`应用` = > `应用`.权限 确保结构=真 目录=`权限目录`**
**`应用` = > `应用`.门禁 路径="/desk" 权限="desk:access" 匹配="prefix" 拒绝="redirect"**
**`应用` = > `应用`.鉴权 用户表=`管理员` 注册=真 注册路径="/register" …**
方法 ABI 说明
app.rbac / 启用权限 web_app_rbac ensure schema;可选 目录;管理台=真 才挂 /_rbac/*
app.gate web_app_gate 新增 permissions/权限(CSV);与 roles 可并存:有 permissions 时按权限判定
rbac.can web_rbac_can {ok, allowed}
rbac.assign_role web_rbac_assign_role 用户←角色
rbac.set_role_permissions web_rbac_set_role_permissions 角色←权限列表

防提权:set_role_permissions / assign_role 在 HTTP 管理面检查操作者 roles:manage 且不能授予自身没有的 permission。


4. 运行时

  1. listen:若 auth.rbac=true 或调用过 app.rbac,对 db URL EnsureSchema + 种子。
  2. 仅当 auth.rbac_desk=true(启用权限 管理台=真)时挂载 /_rbac/* API 与 desk。
  3. 登录成功:解析角色 → DB user_roles ∪ GFM 角色展开 → session permissions(CSV)+ 兼容 role。
  4. withRBAC:gate 含 permissions 则 PermissionAllowed;否则旧 RoleAllowed。
  5. 注册:POST /register 写入 web_users,默认赋 member 角色。

5. qdqc 映射

产品 权限码
发评论 comments:create
删任意评论 comments:delete
进 desk desk:access
管角色 roles:manage

首个 GFM admin 用户登录后视为 superadmin(全权限);DB 迁移后绑定 superadmin 角色。


6. 非目标(本切片)

对象级 ACL 全图、ABAC;租户列先可空,多租户波次再启用。