hs-end/doc/TASK001-项目基础架构搭建.md

TASK001 - 项目基础架构搭建

任务信息

• 任务编号: TASK001
• 任务名称: 项目基础架构搭建
• 版本: V1.0
• 状态: 完成

任务描述

搭建海角AI后端项目的基础架构，包括Spring Boot项目初始化、Maven依赖配置、项目目录结构规划、基础配置文件设置和开发环境配置。

验收标准清单

• Spring Boot 3.x项目创建完成
• Maven依赖配置完整，包括web、jpa、security、jwt、redis、mysql等核心依赖
• 项目目录结构规范，包含controller、service、repository、entity、dto、config等包结构
• application.yml配置文件完成基础配置（数据库、服务器端口、日志等）
• 开发环境profiles配置（dev、test、prod）
• 项目能正常启动并访问健康检查接口
• 集成Swagger/OpenAPI文档工具
• 配置跨域处理
• 添加统一的日志配置

注意事项

1. 使用Spring Boot 3.x最新稳定版本，确保与Java 17+兼容性
2. Maven依赖版本要保持一致性，避免版本冲突
3. 包命名遵循com.lxy.hsend的约定
4. 配置文件中敏感信息使用环境变量或配置中心
5. 预留AI服务调用的HTTP客户端配置（如RestTemplate或WebClient）
6. 考虑文件上传大小限制配置
7. 设置合理的数据库连接池配置
8. 添加actuator健康检查端点
9. 配置时区为Asia/Shanghai
10. 预留Redis配置用于会话管理和缓存

相关文件

• pom.xml
• src/main/resources/application.yml
• src/main/resources/application-dev.yml
• src/main/java/com/lxy/hsend/config/
• src/main/java/com/lxy/hsend/HsEndApplication.java