2025年互联网行业后端部后端工程师后端开发规范手册.docxVIP

2025年互联网行业后端部后端工程师后端开发规范手册

第1章项目架构与目录规范

1.1目录结构总览与核心原则

本项目采用基于微服务的云原生架构，核心设计理念是“单一职责、解耦设计、高内聚低耦合”。所有模块必须遵循DDD（领域驱动设计）思想，通过清晰的边界划分来降低系统复杂度。目录结构需严格映射到需求文档中的功能模块，确保从代码库到配置文件的一一对应关系，杜绝“代码脱离文档”的现象。根目录（/）下应严格划分为src和test两个核心子目录，严禁在此层级下放置任何配置文件（如.gitignore,package.json,docker-compose.yml）或依赖管理脚本（如Makefile）。所有构建脚本和依赖管理命令必须位于根目录下的根目录子目录中，以保证构建流程的可复现性和可维护性。

子目录命名需严格遵循语义化命名规范，禁止使用纯数字命名（如user001,api002），所有目录名必须包含业务含义（如user-service,auth-service）。若业务名称过长，需采用驼峰式命名（如user-service）或下划线式命名（如user_service），并统一大小写风格。每个服务模块内部必须建立严格的层级目录，遵循“业务逻辑在前，基础设施在后”的原则。业务逻辑层应包含Controller、Service、Repositor