62 lines
1.8 KiB
Plaintext
62 lines
1.8 KiB
Plaintext
# 项目规则文档
|
||
|
||
## 1. 日志查看规则
|
||
- 不允许使用 `tail -f` 命令查看日志文件
|
||
- 应该使用 `tail` 命令查看日志内容
|
||
- 查看日志直接查看项目本身的日志，而非tomcat的日志
|
||
|
||
## 2. 项目结构规则
|
||
- 后端项目目录：`backend/`
|
||
- 前端项目目录：`frontend/`
|
||
- 数据库脚本目录：`database/`
|
||
- 文档目录：`doc/`
|
||
|
||
## 3. 构建和部署规则
|
||
- 使用 Maven 构建后端项目：`mvn clean package -DskipTests`
|
||
- Tomcat 运行在 Docker 容器中：
|
||
- 端口映射：18080
|
||
- 数据目录：`$DOCKER_DATA_DIR/tomcat`
|
||
- 日志目录：`$DOCKER_DATA_DIR/tomcat/logs`
|
||
- WAR包目录：`$DOCKER_DATA_DIR/tomcat/webapps`
|
||
- 应用上下文路径：`/llm-survey-api`
|
||
- 复制文件时，使用 `command cp` 命令
|
||
|
||
## 4. 数据库规则
|
||
- 数据库名称：`llm_survey`
|
||
- 数据库用户：`dev`
|
||
- 数据库地址：`127.0.0.1:3306`
|
||
- 使用 `init_database.sh` 脚本初始化数据库
|
||
|
||
## 5. 代码规范
|
||
- Java源代码使用UTF-8编码
|
||
- 使用Lombok简化代码
|
||
- DAO层继承BaseDao接口
|
||
- Service层继承BaseService接口
|
||
- 控制器使用RestController注解
|
||
|
||
## 6. Spring配置规则
|
||
- 共享的bean定义放在 `applicationContext.xml`
|
||
- MVC相关配置放在 `spring-mvc.xml`
|
||
- MyBatis相关配置放在 `spring-mybatis.xml`
|
||
- 避免重复的bean定义
|
||
|
||
## 7. 错误处理规则
|
||
- 使用统一的错误处理格式（ErrorInfo）
|
||
- 所有异常由GlobalExceptionHandler处理
|
||
- 业务异常使用IllegalArgumentException
|
||
|
||
## 8. API规范
|
||
- RESTful API设计
|
||
- 统一的响应格式
|
||
- 支持跨域访问
|
||
- API文档位于 `doc/api.md`
|
||
|
||
## 9. 安全规则
|
||
- 不在代码中硬编码敏感信息
|
||
- 配置信息放在properties文件中
|
||
- 使用prepared statement防止SQL注入
|
||
|
||
## 10. 版本控制
|
||
- 使用Git进行版本控制
|
||
- 遵循语义化版本规范
|
||
- 重要配置文件加入版本控制 |