# HZHub-AI 管理端

<div align="center">

<img src="https://github.com/ageerle/hzhub-ai/raw/main/docs/image/logo.png" alt="HZHub AI Logo" width="120" height="120">

### 企业级AI助手平台 - 管理后台

*HZHub-AI 的管理后台，提供系统管理、模型配置、知识库管理、流程编排等功能*

**[在线体验](https://admin.pandarobot.chat)** | **[后端服务](https://github.com/ageerle/hzhub-ai)** | **[用户端](https://github.com/ageerle/hzhub-portal)**

</div>

## 技术栈

- **框架**: Vue 3 + Vben Admin
- **UI组件**: element-plus-x
- **构建工具**: Vite

## Docker 部署

本管理端支持两种 Docker 部署方式：

### 方式一：一键启动所有服务（推荐）

使用 `docker-compose-all.yaml` 可以一键启动所有服务（包括后端、管理端、用户端及依赖服务）：

```bash
# 克隆后端仓库
git clone https://github.com/ageerle/hzhub-ai.git
cd hzhub-ai

# 启动所有服务（从镜像仓库拉取预构建镜像）
docker-compose -f docker-compose-all.yaml up -d

# 访问管理端
# 地址: http://localhost:25666
# 账号: admin / admin123
```

### 方式二：分步部署（源码编译）

如果您需要从源码构建，请按照以下步骤操作：

#### 第一步：部署后端服务

```bash
# 进入后端项目目录
cd hzhub-ai

# 启动后端服务（源码编译构建）
docker-compose up -d --build

# 等待后端服务启动完成
docker-compose logs -f backend
```

#### 第二步：部署管理端

```bash
# 进入管理端项目目录
cd hzhub-admin

# 构建并启动管理端
docker-compose up -d --build

# 访问管理端
# 地址: http://localhost:5666
```

#### 第三步：部署用户端（可选）

```bash
# 进入用户端项目目录
cd hzhub-portal

# 构建并启动用户端
docker-compose up -d --build

# 访问用户端
# 地址: http://localhost:5137
```

### 服务端口说明

| 服务 | 端口 | 说明 |
|------|------|------|
| 管理端 | 5666 | 管理后台访问地址 |
| 用户端 | 5137 | 用户前端访问地址 |
| 后端服务 | 6039 | 后端 API 服务 |
| MySQL | 23306 | 数据库服务 |
| Redis | 6379 | 缓存服务 |
| Weaviate | 28080 | 向量数据库 |
| MinIO | 9000/9090 | 对象存储 |

### 镜像仓库

所有镜像托管在阿里云容器镜像服务：

```
crpi-31mraxd99y2gqdgr.cn-beijing.personal.cr.aliyuncs.com/ruoyi_ai
```

可用镜像：
- `mysql:v3` - MySQL 数据库（包含初始化 SQL）
- `redis:6.2` - Redis 缓存
- `weaviate:1.30.0` - 向量数据库
- `minio:latest` - 对象存储
- `hzhub-ai-backend:latest` - 后端服务
- `hzhub-ai-admin:latest` - 管理端前端
- `hzhub-ai-web:latest` - 用户端前端

## 本地开发

```bash
# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

# 构建生产版本
pnpm build
```

## 常见问题

**Q: 管理端无法连接后端服务？**

A: 请确保后端服务已启动，并检查环境变量 `UPSTREAM_HOST` 配置是否正确。

**Q: 一键启动和分步部署有什么区别？**

A: 一键启动使用预构建的镜像，部署速度快；分步部署从源码编译，适合需要自定义修改的场景。

## 开源协议

本项目采用 **MIT 开源协议**，详情请查看 [LICENSE](license) 文件。

---

<div align="center">

**[⭐ 点个Star支持一下](https://github.com/ageerle/hzhub-admin)** • **[Fork 开始贡献](https://github.com/ageerle/hzhub-admin/fork)**

*用 ❤️ 打造，由 HZHub AI 开源社区维护*

</div>
