# 阶段五记录：管理后台

日期：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. 关键管理动作会写操作日志。
