# 12-AI知识库系统权限矩阵（Permission Matrix）V1.0 (1).docx

12

AI知识库系统权限矩阵

Permission Matrix

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

项目交付文档

## 目录

## 第一章 文档说明

### 1.1 编写目的

权限矩阵用于统一定义系统各类角色的访问权限，为：

后端权限控制

前端菜单控制

按钮权限

API 权限校验

测试验收

提供统一依据。

### 1.2 权限模型

系统采用三级权限模型：

权限控制贯穿：

页面访问

API 接口

按钮操作

数据范围

AI 知识库访问

## 第二章 系统角色

系统定义三类角色：

## 第三章 后台菜单权限

## 第四章 用户管理权限

## 第五章 管理员管理权限

## 第六章 知识库管理权限

删除知识库后：

自动解除所有用户授权

写入操作日志

AI 不再参与检索

## 第七章 Prompt 管理权限

Prompt 保存后：

立即生效

写入操作日志

## 第八章 AI 模型管理权限

## 第九章 系统配置权限

修改后：

立即生效。

## 第十章 聊天记录权限

聊天记录：

永久保存。

用户删除：

仅逻辑删除。

## 第十一章 操作日志权限

## 第十二章 普通用户权限

普通用户仅拥有以下权限：

## 第十三章 AI 数据权限

AI 检索必须经过权限过滤：

原则：

仅检索授权知识库

不允许跨知识库越权

不允许使用未授权内容生成答案

## 第十四章 API 权限矩阵

## 第十五章 权限校验流程

所有后台接口统一执行：

任一环节失败：

## 第十六章 权限维护规范

所有新增页面必须同步补充权限矩阵。

所有新增接口必须配置接口权限。

所有按钮必须支持前端显示控制与后端接口校验双重控制。

权限变更需记录操作日志。

## Table 1
| 版本 | V1.0 |
| --- | --- |
| 项目名称 | AI 企业知识库问答系统 |
| 依据文档 | PRD V1.0、SRS V1.0 |
| 适用版本 | V1.0 |

## Table 2
| 第一章 文档说明 | 第九章 系统配置权限 |
| --- | --- |
| 第二章 系统角色 | 第十章 聊天记录权限 |
| 第三章 后台菜单权限 | 第十一章 操作日志权限 |
| 第四章 用户管理权限 | 第十二章 普通用户权限 |
| 第五章 管理员管理权限 | 第十三章 AI 数据权限 |
| 第六章 知识库管理权限 | 第十四章 API 权限矩阵 |
| 第七章 Prompt 管理权限 | 第十五章 权限校验流程 |
| 第八章 AI 模型管理权限 | 第十六章 权限维护规范 |

## Table 3
| 角色权限（Role） |
| --- |
| ↓ |
| 功能权限（Permission） |
| ↓ |
| 数据权限（Knowledge） |

## Table 4
| 角色 | 编码 | 说明 |
| --- | --- | --- |
| 超级管理员 | SUPER_ADMIN | 系统最高权限 |
| 管理员 | ADMIN | 日常运营管理 |
| 普通用户 | USER | AI 问答用户 |

## Table 5
| 功能模块 | 超级管理员 | 管理员 | 普通用户 |
| --- | --- | --- | --- |
| Dashboard | ✅ | ✅ | ❌ |
| 用户管理 | ✅ | ✅ | ❌ |
| 管理员管理 | ✅ | ❌ | ❌ |
| 知识库管理 | ✅ | ✅ | ❌ |
| Prompt 管理 | ✅ | ✅ | ❌ |
| AI 模型管理 | ✅ | ✅ | ❌ |
| 聊天记录 | ✅ | ✅ | ❌ |
| 系统配置 | ✅ | ✅ | ❌ |
| 操作日志 | ✅ | ✅ | ❌ |

## Table 6
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看用户 | ✅ | ✅ |
| 新增用户 | ✅ | ✅ |
| 编辑用户 | ✅ | ✅ |
| 删除用户 | ✅ | ✅ |
| 批量授权知识库 | ✅ | ✅ |
| 设置聊天次数 | ✅ | ✅ |
| 设置有效期 | ✅ | ✅ |
| 启用账号 | ✅ | ✅ |
| 禁用账号 | ✅ | ✅ |
| 导出用户 | ✅ | ✅ |

## Table 7
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看管理员 | ✅ | ❌ |
| 新增管理员 | ✅ | ❌ |
| 编辑管理员 | ✅ | ❌ |
| 删除管理员 | ✅ | ❌ |
| 修改角色 | ✅ | ❌ |
| 重置密码 | ✅ | ❌ |

## Table 8
| 安全规则：为保证系统安全，管理员账号管理仅开放给超级管理员。 |
| --- |

## Table 9
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看知识库 | ✅ | ✅ |
| 新增知识库 | ✅ | ✅ |
| 编辑知识库 | ✅ | ✅ |
| 删除知识库 | ✅ | ✅ |
| 启用/禁用 | ✅ | ✅ |

## Table 10
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看 Prompt | ✅ | ✅ |
| 编辑 Prompt | ✅ | ✅ |
| 保存 Prompt | ✅ | ✅ |
| 恢复默认 | ✅ | ✅ |

## Table 11
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看模型 | ✅ | ✅ |
| 新增模型 | ✅ | ✅ |
| 编辑模型 | ✅ | ✅ |
| 删除模型 | ✅ | ✅ |
| 启用模型 | ✅ | ✅ |

## Table 12
| 系统限制：同一时间仅允许一个模型为启用状态。 |
| --- |

## Table 13
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看配置 | ✅ | ✅ |
| 修改配置 | ✅ | ✅ |
| 保存配置 | ✅ | ✅ |

## Table 14
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看聊天 | ✅ | ✅ |
| 查看详情 | ✅ | ✅ |
| 导出 Excel | ✅ | ✅ |

## Table 15
| 功能 | 超级管理员 | 管理员 |
| --- | --- | --- |
| 查看日志 | ✅ | ✅ |
| 查询日志 | ✅ | ✅ |
| 导出日志 | ✅ | ✅ |
| 删除日志 | ❌ | ❌ |

## Table 16
| 日志规则：日志禁止删除，仅允许按保留策略归档。 |
| --- |

## Table 17
| 功能 | 权限 |
| --- | --- |
| 登录 | ✅ |
| AI 问答 | ✅ |
| 新建会话 | ✅ |
| 修改标题 | ✅ |
| 删除会话 | ✅ |
| 查看历史记录 | ✅ |
| 停止生成 | ✅ |
| 后台管理 | ❌ |

## Table 18
| 用户 |
| --- |
| ↓ |
| 用户知识库授权 |
| ↓ |
| 过滤禁用知识库 |
| ↓ |
| 过滤过期授权 |
| ↓ |
| 飞书实时检索 |
| ↓ |
| AI 回答 |

## Table 19
| API 分类 | 超级管理员 | 管理员 | 普通用户 |
| --- | --- | --- | --- |
| /auth/* | ✅ | ✅ | ✅ |
| /user/* | ❌ | ❌ | ✅ |
| /chat/* | ❌ | ❌ | ✅ |
| /admin/dashboard | ✅ | ✅ | ❌ |
| /admin/user/* | ✅ | ✅ | ❌ |
| /admin/admin/* | ✅ | ❌ | ❌ |
| /admin/knowledge/* | ✅ | ✅ | ❌ |
| /admin/prompt/* | ✅ | ✅ | ❌ |
| /admin/model/* | ✅ | ✅ | ❌ |
| /admin/config/* | ✅ | ✅ | ❌ |
| /admin/log/* | ✅ | ✅ | ❌ |

## Table 20
| JWT 校验 |
| --- |
| ↓ |
| 账号状态校验 |
| ↓ |
| 角色权限校验 |
| ↓ |
| 功能权限校验 |
| ↓ |
| 数据权限校验 |
| ↓ |
| 执行业务逻辑 |

## Table 21
| 失败处理：返回统一权限错误。 |
| --- |

## Table 22
| 《12-权限矩阵》V1.0 完成 本权限矩阵定义了： • 系统角色 • 菜单权限 • 按钮权限 • API 权限 • 数据权限 • AI 知识库权限 • 权限校验流程 • 权限维护规范 |
| --- |
