140 lines
4.0 KiB
Markdown
140 lines
4.0 KiB
Markdown
# AI 中转代理管理后台
|
||
|
||
## ✅ 已完成的功能
|
||
|
||
### 1. 删除 ensure_tables.go 文件
|
||
- ✅ 已删除 `./server/initialize/ensure_tables.go`
|
||
- ✅ 已在 `gorm.go` 中添加 app 模型的自动迁移
|
||
|
||
### 2. 前端项目结构 (web/)
|
||
|
||
```
|
||
web/
|
||
├── index.html # 入口 HTML
|
||
├── package.json # 依赖配置
|
||
├── vite.config.js # Vite 配置
|
||
├── README.md # 项目说明
|
||
└── src/
|
||
├── main.js # 应用入口
|
||
├── App.vue # 根组件
|
||
├── router/
|
||
│ └── index.js # 路由配置
|
||
├── layout/
|
||
│ └── index.vue # 布局组件
|
||
├── views/
|
||
│ ├── login/
|
||
│ │ └── index.vue # 登录页
|
||
│ ├── dashboard/
|
||
│ │ └── index.vue # 仪表盘
|
||
│ ├── system/
|
||
│ │ ├── user/
|
||
│ │ │ └── index.vue # 用户管理
|
||
│ │ └── api/
|
||
│ │ └── index.vue # API 管理
|
||
│ └── ai/
|
||
│ ├── preset/
|
||
│ │ └── index.vue # 预设管理
|
||
│ ├── provider/
|
||
│ │ └── index.vue # 提供商管理
|
||
│ └── binding/
|
||
│ └── index.vue # 预设绑定
|
||
├── api/
|
||
│ ├── user.js # 用户 API
|
||
│ ├── preset.js # 预设 API
|
||
│ └── provider.js # 提供商 API
|
||
└── utils/
|
||
└── request.js # Axios 封装
|
||
```
|
||
|
||
### 3. 功能模块
|
||
|
||
#### 系统管理
|
||
- ✅ 用户管理 - 用户列表、创建、编辑、删除
|
||
- ✅ API 管理 - API 密钥管理、文档查看
|
||
|
||
#### AI 管理
|
||
- ✅ 预设管理 - 预设列表、创建、编辑、删除、导入、导出
|
||
- ✅ 提供商管理 - AI 服务提供商配置
|
||
- ✅ 预设绑定 - 为不同 AI 配置不同预设
|
||
|
||
### 4. 技术栈
|
||
|
||
- **Vue 3** - 渐进式 JavaScript 框架
|
||
- **Vite** - 下一代前端构建工具
|
||
- **Element Plus** - Vue 3 组件库
|
||
- **Vue Router** - 路由管理
|
||
- **Pinia** - 状态管理
|
||
- **Axios** - HTTP 客户端
|
||
|
||
### 5. 特性
|
||
|
||
- ✅ 响应式布局
|
||
- ✅ 侧边栏导航
|
||
- ✅ 面包屑导航
|
||
- ✅ 用户认证（JWT）
|
||
- ✅ 请求拦截器
|
||
- ✅ 统一错误处理
|
||
- ✅ 中文界面
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
cd web
|
||
npm install
|
||
```
|
||
|
||
### 开发模式
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
访问 http://localhost:3000
|
||
|
||
### 构建生产版本
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
## 📝 API 接口
|
||
|
||
### 系统管理
|
||
- `POST /v1/system/user/login` - 用户登录
|
||
- `GET /v1/system/user/info` - 获取用户信息
|
||
- `GET /v1/system/user/list` - 获取用户列表
|
||
|
||
### AI 管理
|
||
- `GET /app/preset/list` - 获取预设列表
|
||
- `POST /app/preset` - 创建预设
|
||
- `PUT /app/preset` - 更新预设
|
||
- `DELETE /app/preset/:id` - 删除预设
|
||
- `POST /app/preset/import` - 导入预设
|
||
- `GET /app/preset/:id/export` - 导出预设
|
||
|
||
- `GET /app/provider/list` - 获取提供商列表
|
||
- `POST /app/provider` - 创建提供商
|
||
- `PUT /app/provider` - 更新提供商
|
||
- `DELETE /app/provider/:id` - 删除提供商
|
||
|
||
## 📋 待完善功能
|
||
|
||
1. **后端 system 层 API** - 需要在 `server/api/v1/system/` 下添加用户管理相关的 API
|
||
2. **预设绑定功能** - 完善预设与提供商的绑定逻辑
|
||
3. **用户权限管理** - 添加角色和权限控制
|
||
4. **请求日志查看** - 添加 AI 请求日志查看页面
|
||
5. **统计图表** - 在仪表盘添加数据可视化
|
||
|
||
## 🎨 界面预览
|
||
|
||
- 登录页 - 渐变背景 + 卡片式登录表单
|
||
- 仪表盘 - 统计卡片 + 快速操作
|
||
- 管理页面 - 表格 + 操作按钮 + 分页
|
||
- 侧边栏 - 深色主题 + 图标导航
|
||
|
||
## 📦 项目已保留 system 目录
|
||
|
||
现有的 `server/service/system/`、`server/model/system/`、`server/api/v1/system/` 和 `server/router/system/` 目录已保留，这些是管理后台的基础功能模块。
|