Files
ai-contract-platform/project-docs/V2-contract-web-lightweight-access-boundary-2026-06-23.md
T
yuqei a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
release: freeze V2 release candidate
2026-07-12 15:32:24 +08:00

1.9 KiB

AI 合同平台 V2 前端轻量权限边界记录

时间:2026-06-23

本轮目标

继续遵循《AI 合同平台 V2 重构版开发方案》的体验原则:

  • 普通用户只看到主流程。
  • 管理员能力集中到管理区。
  • 模型、Prompt、知识库、AI Trace、Runtime 等复杂配置不压迫业务用户。

本轮先在 V2 前端建立轻量角色/权限边界,作为真实登录和企业 RBAC 接入前的产品体验护栏。

已完成

1. 角色模型

新增前端轻量角色:

  • admin
  • legal
  • business
  • approver
  • observer

当前通过 NEXT_PUBLIC_DEMO_ROLE 读取演示角色;未配置时默认 admin,方便开发和验收。

2. 管理能力边界

新增管理能力:

  • 企业权限
  • AI 参数
  • Prompt 中心
  • AI 知识导入
  • AI 模型配置
  • AI 质量运营
  • AI 调用 Trace
  • AI Runtime
  • 系统设置

权限原则:

  • admin 可以访问全部管理能力。
  • legal 可以访问质量规则、知识导入、质量看板和 Trace 等偏法务质量能力。
  • business、approver、observer 默认不看到管理区。

3. 页面收束

  • 侧边栏只显示主流程和一个“管理区”入口。
  • 管理区首页按当前角色过滤可见模块。
  • /admin/* 路由增加统一访问保护。
  • 无权限访问时展示清晰提示,并引导返回工作台。

当前边界

这不是最终企业 RBAC,只是 V2 前端体验和路由保护的轻量 MVP。

后续真实上线前仍需:

  1. 接入登录 session。
  2. 从 contract-api 返回租户、角色、权限矩阵。
  3. 服务端 API 做真实权限校验。
  4. 增加权限边界测试。

验证命令

npm --prefix yuqei-contract-platform/apps/contract-web run build

下一步建议

继续进入合同主流程轻量化:把合同列表、合同详情和工作台从 mock 数据切到 Contract API,并让“待我处理 / 下一步操作”来自真实合同状态。