# 快速启动

> 完整文档请查看 [README.md](README.md)

## 服务端口

| 服务 | 端口 | 说明 |
|------|------|------|
| Admin 管理端 | 3000 | `/admin/` |
| Chat 访问端 | 3001 | `/chat/` |
| Builder 构建端 | 3002 | `/builder/` |
| Django Web | 8080 | REST API |
| PostgreSQL | 5432 | 数据库 |
| Redis | 6379 | 缓存 |

## 启动步骤

```bash
# 1. 安装后端依赖
uv sync

# 2. 安装前端依赖（三端独立）
cd ui && npm run install:all

# 3. 配置数据库
cp config_example.yml config.yml
# 编辑 config.yml 填写数据库连接信息

# 4. 启动后端
python main.py dev celery    # 终端 1
python main.py dev web       # 终端 2

# 5. 启动前端（三端独立）
cd ui
npm run dev:admin      # 管理端 :3000
npm run dev:builder    # 构建端 :3002
npm run dev:chat       # 访问端 :3001

# 或同时启动三端
npm run dev:all
```

## 默认账号

- 用户名：`admin@zhagent.com`
- 密码：`ZhAgent@980123`

## Windows 一键启动

```bash
startTools.bat
# 选择 1 启动全部服务
```

## 三端独立开发

每个端完全独立，位于 `ui/` 下的独立目录：
- `ui/admin/` — 管理端（系统管理）
- `ui/builder/` — 构建端（智能体构建）
- `ui/chat/` — 访问端（对话访问）

进入对应目录可独立开发：
```bash
cd ui/admin && npm run dev    # 仅启动管理端
cd ui/builder && npm run dev  # 仅启动构建端
cd ui/chat && npm run dev     # 仅启动访问端
```

## Docker 部署

```bash
# 构建前端
bash build-frontend.sh

# 启动全部服务（PostgreSQL + Redis + Django + Celery + Nginx）
docker compose up -d

# 查看日志
docker compose logs -f

# 停止服务
docker compose down
```

数据目录（挂载到本地磁盘）：
- `./data/postgresql` — 数据库
- `./data/redis` — 缓存
- `./data/uploads` — 上传文件

访问地址：`http://localhost`（Nginx 端口 80）