# 部署指南

## 快速开始

### Windows 开发环境（构建）

```cmd
build.bat
```

执行后会：
1. 构建前端项目
2. 打包为 `lq_label_dist.tar.gz`
3. 提交到 Git

### Linux 服务器（部署）

```bash
chmod +x deploy.sh
./deploy.sh
```

执行后会：
1. 拉取最新代码
2. Docker 部署后端
3. 解压前端到 Nginx 目录
4. 重载 Nginx

## 部署流程

```
┌─────────────────┐     ┌─────────────────┐
│  Windows 开发机  │     │   Linux 服务器   │
├─────────────────┤     ├─────────────────┤
│  1. build.bat   │     │  1. git pull    │
│  2. git push    │ ──► │  2. deploy.sh   │
└─────────────────┘     └─────────────────┘
```

## 配置说明

### 1. 修改部署目录

编辑 `deploy.sh` 顶部的配置：

```bash
FRONTEND_DEPLOY_DIR="/var/www/lq_label"  # 前端目录
GIT_BRANCH="main"                         # Git 分支
```

### 2. 后端配置

首次部署前，编辑 `backend/config.yaml`：

```yaml
jwt:
  secret_key: "生成一个安全的密钥"

database:
  type: "mysql"
  mysql:
    host: "数据库地址"
    port: 3306
    user: "用户名"
    password: "密码"
    database: "数据库名"
```

### 3. Nginx 配置

将 `web/apps/lq_label/nginx.conf` 复制到 Nginx 配置目录：

```bash
sudo cp web/apps/lq_label/nginx.conf /etc/nginx/sites-available/lq_label
sudo ln -s /etc/nginx/sites-available/lq_label /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
```

## 常用命令

| 操作 | 命令 |
|------|------|
| 查看后端日志 | `cd backend && docker compose logs -f` |
| 重启后端 | `cd backend && docker compose restart` |
| 停止后端 | `cd backend && docker compose down` |
| 重新部署 | `./deploy.sh` |

## 故障排查

### 后端启动失败

```bash
cd backend
docker compose logs
```

### 前端 404

检查 Nginx 配置中的 `root` 路径是否正确。

### 数据库连接失败

检查 `backend/config.yaml` 中的数据库配置。