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

40 lines
1.6 KiB
Markdown
Raw Permalink Normal View History

2025-08-25 16:01:26 +08:00
# TASK001 - 项目基础架构搭建
## 任务信息
- **任务编号**: TASK001
- **任务名称**: 项目基础架构搭建
- **版本**: V1.0
- **状态**: 完成
## 任务描述
搭建海角AI后端项目的基础架构包括Spring Boot项目初始化、Maven依赖配置、项目目录结构规划、基础配置文件设置和开发环境配置。
## 验收标准清单
- [x] Spring Boot 3.x项目创建完成
- [x] Maven依赖配置完整包括web、jpa、security、jwt、redis、mysql等核心依赖
- [x] 项目目录结构规范包含controller、service、repository、entity、dto、config等包结构
- [x] application.yml配置文件完成基础配置数据库、服务器端口、日志等
- [x] 开发环境profiles配置dev、test、prod
- [x] 项目能正常启动并访问健康检查接口
- [x] 集成Swagger/OpenAPI文档工具
- [x] 配置跨域处理
- [x] 添加统一的日志配置
## 注意事项
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