llm-survey/doc/deployment.md

部署文档

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 编译打包

# 进入后端项目目录
cd backend

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

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

2.2 数据库初始化

# 进入数据库脚本目录
cd database

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

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

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

3. 开发环境部署

3.1 部署WAR包

# 复制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 查看部署结果

# 查看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会自动重新部署