# 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. 增加权限边界测试。

## 验证命令

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

## 下一步建议

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