产品底座与账户 / 账户与认证

权限与角色控制（RBAC）

部分验证Windows 桌面 · 待验证Web · 已验证代码更新于 2026-10-29

按角色分配功能与数据权限，管理员、业务员工各见其职，降低误操作与越权风险。

返回产品底座与账户

功能价值

按角色分配功能与数据权限，管理员、业务员工各见其职，降低误操作与越权风险。

使用方式

管理员在管理后台为员工分配角色；业务页面按角色自动显隐。

所属模块

产品底座与账户 / 账户与认证

适用平台

Windows 桌面 · 待验证Web · 已验证

已知限制

细粒度到字段级的权限控制仍在迭代

平台验证状态

本项适用于 2 个平台，逐平台独立判定：平台状态只由该平台的实机验收记录产生，总体状态由平台状态自动汇总，目录与页面都不存放可手写的状态。验收结论仅覆盖记录所列版本、Git SHA 与产物；当前源码或新安装包仍需独立验收。

Windows 桌面

待验证

该平台尚无完整且通过的实机验收记录。平台状态只由该平台的实机验收产生，代码与自动化测试不计入；本项在此平台保持「待验证」，不会因其他平台通过而变绿。

变为已验证需要完整 PASS acceptance JSON、可追溯的产品版本和 Git SHA、交付身份 JSON 与安装包 / 部署产物 SHA-256，以及引用有效且哈希匹配的截图、录像和运行日志。

验收结果：BLOCKED；通过 0 / 失败 0；产品版本 1.0.0.5；Git SHA 54325894cc6e3fc2becfcbc98697a099310d9420；验证时间 2026-09-20。Acceptance JSON SHA-256 641956acb4fb54dd5470b21ed6022d7b79bbc1168300c2c46d2522aa2eded61e

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：阻塞；画面内容：/api/rbac/roles and /api/rbac/permissions return 401 before login; /api/xcmax/admin/session returns 403 ADMIN_DESKTOP_FORBIDDEN; health component business_route:rbac reports ok=true；SHA-256：3ec07a3eb50509ef7f39def5724afc61a8f8e189d081f581a1395f9b7aea5e0d（原始文件：FHD/docs/evidence/e2e/windows-real-machine-1.0.0.5/media/videos/base-rbac.mp4）下载原始录像

实机截图

权限与角色控制（RBAC）已复核截图 — 媒体内容已复核，记录结论：验收结果：阻塞；画面内容：/api/rbac/roles and /api/rbac/permissions return 401 before login; /api/xcmax/admin/session returns 403 ADMIN_DESKTOP_FORBIDDEN; health component business_route:rbac reports ok=true；SHA-256：`8dc8864213eb1d02cbd15173f510b349bdd5ae47affe5da68921111a38cf58e6`（原始文件：FHD/docs/evidence/e2e/windows-real-machine-1.0.0.5/media/screenshots/base-rbac.png）查看原图

运行日志

下载原件：base-rbac.log；SHA-256：5f089a4fd6c8a54ee7a0de899c6f96c81152d4d67a40217ad92be53e338a5ce4（仓库路径：FHD/docs/evidence/e2e/windows-real-machine-1.0.0.5/logs/base-rbac.log）

安装包 / 部署产物 SHA-256：45f761cf1ad968c5abeae466e8b0749364e1d1edfabf0821ef28db52f5cb572e · 交付身份 JSON

Web

已验证

验收结果：PASS；通过 4 / 失败 0；产品版本 1.0.0.5；Git SHA 086a98f1fbad9f9b357692a85e656d8972cb6bc3；验证时间 2026-09-29。Acceptance JSON SHA-256 1c4e1055587978d2377c0511bb041bfa6616d6d66fee7a068c79f7cbab1a44aa

实机录像 / 操作流程

媒体内容已复核，记录结论：验收结果：通过；画面内容：本轮真实浏览器会话录像（webm，13.04s，VP8 1600x1000 25fps，ffmpeg 实测）：管理员登录 → 读取角色/权限 → 门控矩阵 → 越权角色管理与全局权限管理 403。；SHA-256：f24beb5cbc9ae176e7785396fc11a741d3c0e7695ccbabec844bcc5728936538（原始文件：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-rbac/video/base-rbac-web-20260929-135143.webm）下载原始录像

实机截图

运行日志

下载原件：base-rbac-web-20260929-135143.log；SHA-256：915e7ee1f2f6b5d8cb81d0dde63c3bb5e1f47200bcea31c12cf193431e4447c8（仓库路径：FHD/docs/evidence/e2e/feature-acceptance-webadmin-20260929/tools/runs/base-rbac/log/base-rbac-web-20260929-135143.log）

安装包 / 部署产物 SHA-256：cfa52148ab19fd69e6bea715cc2b9ad046f9607dbdee31033cb9d5357d3c7368 · 交付身份 JSON

实现与测试（平台无关）

所列构建仅在 Web 有通过的实机验收记录；Windows 桌面仍为「待验证」，因此总体状态不构成「已验证」。

图片内容复核（2026-09-30，Mac 1.0.0.5）：角色与权限页列出 MAC验收角色和权限勾选。

源码实现

FHD/app/fastapi_routes/rbac.py
FHD/app/fastapi_routes/xcmax_admin_auth.py

自动化测试

FHD/tests/test_auth_decorators.py

CI 门禁：FHD/.github/workflows/ci-cd.yml

CI 工作流定义

FHD/.github/workflows/ci-cd.yml

未标注平台的补充资料

下列资料未绑定到具体平台，仅作实现与历史资料参考，不计入任何平台状态，也不构成实机验收。

原始抓取（脱敏）

逐条原始产物汇编：见文件。凭据值已脱敏，其余内容逐字保留。未经脱敏的原件留在操作机，逐件 sha256 记录在文件内。

查看逐条原始抓取与原件 sha256 →（仓库路径：FHD/docs/evidence/e2e/windows-capabilities-20260929/windows-installer.json）

证据原件存放于私有对象存储，页面通过短时效签名地址读取原图与原始录像；「核验哈希」会对照本页登记的 SHA-256 与存储对象元数据。对象存储不可用时自动改用站内副本，也可下载原件后用 sha256sum 自行核对。