Add V2 admin console

This commit is contained in:
2026-07-06 18:13:08 +08:00
parent 301661e7b4
commit 62eeb3186c
34 changed files with 3132 additions and 1 deletions

View File

@@ -33,6 +33,8 @@
| D-010 | 用户端停止生成先使用浏览器 `AbortController` 中断 SSE 读取,后端真实中断等接入真实模型时实现。 | 默认采用 | 当前后端仍是 mock 模型,前端先保证用户操作反馈真实有效。 |
| D-011 | 阶段四外部服务默认保持 mock 开启,通过配置关闭 mock 后再走真实 provider。 | 默认采用 | 当前缺少真实飞书检索地址和模型凭证,默认 mock 可以保证开发、演示和测试连续。 |
| D-012 | 大模型真实调用先按 OpenAI 兼容 `chat/completions` 非流式响应接入。 | 默认采用 | 先打通配置化真实模型调用和失败日志,后续再升级为模型原生流式透传。 |
| D-013 | 管理后台开发阶段支持首次登录自动创建默认管理员。 | 默认采用 | 降低本地初始化成本;生产环境必须修改默认账号密码。 |
| D-014 | 管理后台 Element Plus 先整体引入,后续再做按需导入优化。 | 默认采用 | 阶段五优先保证后台功能闭环和交付速度,体积优化后续处理。 |
## 待确认决策

View File

@@ -0,0 +1,84 @@
# 阶段五记录:管理后台
日期2026-07-06
## 本次目标
补齐一期后台管理能力的第一版,让系统具备基础运营、配置和审计入口。
## 已完成后端能力
- 管理员登录:
- 新增 `/api/admin/login`
- 新增 `/api/admin/profile`
- 开发阶段支持首次登录自动创建默认管理员。
- Dashboard
- 用户数、会话数、消息数、AI 请求数、知识库数。
- 用户管理:
- 用户列表
- 用户详情
- 修改状态、每日额度、过期时间
- 逻辑删除
- 知识库管理:
- 列表
- 新增
- 编辑
- 删除
- Prompt 管理:
- 查看当前 Prompt
- 保存 Prompt
- 恢复默认
- 模型管理:
- 列表
- 新增模型
- 启用模型
- 删除模型
- 系统配置:
- 列表
- 新增或更新配置项
- 记录审计:
- 聊天会话列表
- 聊天详情
- AI 请求日志
- 操作日志
## 已完成前端能力
- 新增 `apps/admin-web`
- 技术栈Vue 3 + Vite + TypeScript + Element Plus。
- 页面包括:
- 登录页
- Dashboard
- 用户管理
- 知识库管理
- Prompt 管理
- 模型管理
- 系统配置
- 记录审计
- 已接入阶段五后端管理接口。
## 默认管理员
```text
账号admin
密码admin123456
```
该账号只用于开发阶段,生产环境必须通过环境变量修改。
## 当前边界
- 管理后台是第一版可用骨架,表单校验、批量操作、导出文件和更细权限还需要后续增强。
- 当前管理员权限尚未按角色矩阵细分,默认登录管理员拥有全部后台能力。
- 模型 API Key 当前新增时写入数据库,页面列表只展示脱敏值;生产环境还需要进一步做加密或密钥托管。
- Element Plus 当前整体引入,构建有体积提示;阶段五先保证功能闭环,后续可做按需导入优化。
## 阶段五判断
阶段五已经具备管理后台主链路:
1. 管理员可以登录后台。
2. 后台可以查看核心统计。
3. 后台可以维护用户、知识库、Prompt、模型和系统配置。
4. 后台可以查看聊天、AI 请求和操作日志。
5. 关键管理动作会写操作日志。

View File

@@ -31,3 +31,4 @@
| `2026-07-06-phase2-rag-skeleton.md` | 阶段二 RAG 问答链路骨架记录。 |
| `2026-07-06-phase3-user-client-completion.md` | 阶段三用户端 H5 主链路补齐记录。 |
| `2026-07-06-phase4-rag-external-services.md` | 阶段四 RAG 和外部服务接入骨架记录。 |
| `2026-07-06-phase5-admin-console.md` | 阶段五管理后台记录。 |