# 部署文档

## 1. 开发环境配置

### 1.1 环境变量
- `DOCKER_DATA_DIR`: Docker数据目录，默认为 `/Volumes/working/docker`

### 1.2 开发环境组件
- Tomcat: 运行在Docker容器中
  - 数据目录: `$DOCKER_DATA_DIR/tomcat`
  - 日志目录: `$DOCKER_DATA_DIR/tomcat/logs`
  - 应用目录: `$DOCKER_DATA_DIR/tomcat/webapps`

## 2. 项目构建

### 2.1 编译打包
```bash
# 进入后端项目目录
cd backend

# 清理并打包项目（跳过测试）
mvn clean package -DskipTests

# 打包结果
# - WAR包位置：backend/target/llm-survey-api.war
```

### 2.2 数据库初始化
```bash
# 进入数据库脚本目录
cd database

# 添加执行权限
chmod +x init_database.sh

# 执行初始化脚本
./init_database.sh

# 初始化内容
# - 创建数据库：llm_survey
# - 创建表：users, questions, options, survey_responses
# - 插入基础数据：工作领域和岗位性质相关的问题和选项
```

## 3. 开发环境部署

### 3.1 部署WAR包
```bash
# 复制WAR包到Tomcat的webapps目录
cp backend/target/llm-survey-api.war $DOCKER_DATA_DIR/tomcat/webapps/

# 部署后的访问地址
# - 上下文路径：/llm-survey-api
# - API基础路径：/llm-survey-api/api
```

### 3.2 查看部署结果
```bash
# 查看Tomcat日志
tail -f $DOCKER_DATA_DIR/tomcat/logs/catalina.out

# 检查应用是否成功部署
ls -l $DOCKER_DATA_DIR/tomcat/webapps/llm-survey-api/
```

### 3.3 验证部署
- 访问测试接口：`http://localhost:8080/llm-survey-api/user/check/13800000000`
- 预期返回：`false`（表示手机号未注册）

## 4. 注意事项
1. 确保MySQL服务已启动且能够通过localhost:3306访问
2. 确保Tomcat容器已启动且8080端口可访问
3. 部署前确保数据库已正确初始化
4. 如需重新部署，可直接覆盖webapps目录下的WAR包，Tomcat会自动重新部署