互联网行业技术部工程师接口开发工作手册.docxVIP

互联网行业技术部工程师接口开发工作手册

第1章项目结构与基础规范

1.1项目目录树规范

在分布式微服务架构中，清晰的项目目录树是团队协作的基石，它直接决定了代码的可维护性与部署效率。所有接口项目必须严格遵循统一的目录结构，严禁随意更改根目录下的文件命名。

根目录应严格限定为`src/`或`api/`，内部禁止包含`node_modules`、`dist`等第三方依赖或构建产物目录，所有业务逻辑代码必须位于根目录的子文件夹内。目录命名需采用`domain/`作为顶层分类，分别对应业务领域（如`user/`代表用户域，`order/`代表订单域），避免使用`module/`或`feature/`等易混淆的命名方式。

每个业务域下必须包含`controller/`（控制器）、`service/`（服务层）和`domain/`（领域层）三个核心子目录，且控制器目录不得直接存放业务逻辑代码，必须通过接口层调用服务层。服务层内部应进一步划分为`impl/`（实现类）和`interface/`（接口定义），确保所有业务逻辑均通过接口声明，实现高内聚低耦合的架构设计。在`impl/`目录下，必须严格区分`BaseServiceImpl`（基类实现）、`BusinessServiceImpl`（业务实现）和`ExceptionServic