2025年汽车行业研发部→工程师→代码规范编写手册.docxVIP

2025年汽车行业研发部→工程师→代码规范编写手册

第1章项目结构与代码组织

1.1根目录与核心模块划分

根目录（root）必须严格遵循src命名规范，作为所有代码的绝对起点，禁止在此存放配置文件、日志文件或测试数据，确保项目启动时自动加载所有源文件。核心业务逻辑模块应命名为`ject.domain`或`ject.module`，每个模块对应一个独立的业务领域（如用户管理、订单中心），禁止跨模块混用命名空间。

数据访问层（DataAccessLayer）统一命名为`ject.data`，包含所有数据库操作接口（DAO），将业务逻辑与数据库细节彻底解耦，遵循单一职责原则。实体类（Entity）采用`ject.entity`命名，所有JavaBean类必须继承`java.lang.Object`或`java.io.Serializable`，并显式声明`Entity`注解以指示MyBatis框架。工具类与基础配置类应放置在`jectmon`包下，包含全局常量、异常定义、全局异常处理器及通用工具方法，避免全局污染。

配置文件（application.yml）必须位于项目根目录，严禁将敏感信息（如密码、密钥）硬编码在代码中，所有环境配置需通过`Value`注入或环境变量动态加载。

1.2接口定义与依赖注入

所有服务层接口（S