初级开发者在考虑 CRUD 之外时所需的设计工具

虽然 CRUD 功能已经完成，但维护的恐惧感随之而来。从表结构设计开始的习惯会让系统变得错综复杂。本文涵盖了将代码按领域进行拆分、标准化环境并将修改范围控制在最小的具体方法论。

提高代码内聚性：分离数据访问与逻辑

如果业务逻辑混杂在控制器中，每次更改数据库结构时都必须对代码进行全面重构。引入分层架构（Layered Architecture）来隔离这两者。这样可以将代码库的维护时间减少约 40%。

分离数据访问与逻辑的步骤如下：

将控制器的验证代码迁移到请求 DTO 中，并使用验证注解。
将分散在事务脚本中的逻辑汇聚到领域实体（Domain Entity）内部的方法中。
声明定义持久化行为的接口，而不是直接使用具体的数据库驱动，从而实现与领域层的分离。

即使特定的表结构发生变化，核心规则依然保持不变。

通过依赖注入构建测试环境

如果在类中直接使用 new 关键字创建对象，则无法进行单元测试。通过实现控制反转（IoC），无需外部服务器即可使用模拟对象（Mock）进行独立测试。

提高测试效率的实务流程：

将对象所使用的协作对象声明为接口，而非具体类。
配置外部容器，使其在运行时注入合适的实现类。
使用如 @automock/jest 等工具实现测试双向配置（Test Double）的自动化。

采用这种结构，测试执行速度可提升 20% 以上。

隔离实体与 DTO

如果 UI 结构与数据库表一一对应，那么修改一个页面时，甚至需要修改数据库模式（Schema）。请严格分离网络消息用的 DTO 和领域实体。

利用映射器（Mapper）隔离两者的做法：

创建专门负责数据转换的纯映射器类。
仅在映射器内部传输数据，确保 DTO 和实体之间不产生直接依赖。
强制服务层仅使用实体。

即使更换数据存储，也无需修改逻辑。

使用 Docker Compose 统一开发环境

如果每位开发者的本地环境不同，协作就会陷入停滞。使用 Docker Compose 将基础设施编写为代码，从而同步环境。

构建标准环境的流程：

在 docker-compose.yml 文件中写入数据库和缓存服务器的版本及环境变量。
通过卷挂载（Volume Mount），将初始 SQL 架构放置在 /docker-entrypoint-initdb.d 路径下。
使用 pnpm Workspaces 等包链接工具，防止依赖关系混乱。

完成此配置后，无需关注本地机器设置，即可在 3 秒内启动标准基础设施。

在设计表结构之前进行领域建模

如果从 ERD（实体关系图）开始绘制，只会得出以数据为中心、碎片化的逻辑。Shopify 的 800 多名工程师已经摆脱了以物理模式为中心的传统模式，转向了以业务对象为中心的建模方式。

开始领域建模的阶段：

基于用例（Use Case）和通用语言（Ubiquitous Language），列出领域的主要名词和动词。
定义需要状态转换的实体和具有不变属性的值对象（Value Object）。
确定聚合根（Aggregate Root），以事务为单位验证业务完整性。

这种方法即使在需求变更时，也能将修改范围锁定在特定模块内。复杂的系统设计是消除迷茫感的最切实替代方案。

初级开发者在考虑 CRUD 之外时所需的设计工具

提高代码内聚性：分离数据访问与逻辑

分离数据访问与逻辑的步骤如下：

将控制器的验证代码迁移到请求 DTO 中，并使用验证注解。
将分散在事务脚本中的逻辑汇聚到领域实体（Domain Entity）内部的方法中。
声明定义持久化行为的接口，而不是直接使用具体的数据库驱动，从而实现与领域层的分离。

即使特定的表结构发生变化，核心规则依然保持不变。

通过依赖注入构建测试环境

如果在类中直接使用 new 关键字创建对象，则无法进行单元测试。通过实现控制反转（IoC），无需外部服务器即可使用模拟对象（Mock）进行独立测试。

提高测试效率的实务流程：

将对象所使用的协作对象声明为接口，而非具体类。
配置外部容器，使其在运行时注入合适的实现类。
使用如 @automock/jest 等工具实现测试双向配置（Test Double）的自动化。

采用这种结构，测试执行速度可提升 20% 以上。

隔离实体与 DTO

如果 UI 结构与数据库表一一对应，那么修改一个页面时，甚至需要修改数据库模式（Schema）。请严格分离网络消息用的 DTO 和领域实体。

利用映射器（Mapper）隔离两者的做法：

创建专门负责数据转换的纯映射器类。
仅在映射器内部传输数据，确保 DTO 和实体之间不产生直接依赖。
强制服务层仅使用实体。

即使更换数据存储，也无需修改逻辑。

使用 Docker Compose 统一开发环境

如果每位开发者的本地环境不同，协作就会陷入停滞。使用 Docker Compose 将基础设施编写为代码，从而同步环境。

构建标准环境的流程：

在 docker-compose.yml 文件中写入数据库和缓存服务器的版本及环境变量。
通过卷挂载（Volume Mount），将初始 SQL 架构放置在 /docker-entrypoint-initdb.d 路径下。
使用 pnpm Workspaces 等包链接工具，防止依赖关系混乱。

完成此配置后，无需关注本地机器设置，即可在 3 秒内启动标准基础设施。

在设计表结构之前进行领域建模

开始领域建模的阶段：

基于用例（Use Case）和通用语言（Ubiquitous Language），列出领域的主要名词和动词。
定义需要状态转换的实体和具有不变属性的值对象（Value Object）。
确定聚合根（Aggregate Root），以事务为单位验证业务完整性。

这种方法即使在需求变更时，也能将修改范围锁定在特定模块内。复杂的系统设计是消除迷茫感的最切实替代方案。

初级开发者在考虑 CRUD 之外时所需的设计工具

관련 영상

请停止制作 CRUD 项目（常见的开发人员错误）

初级开发者在考虑 CRUD 之外时所需的设计工具

提高代码内聚性：分离数据访问与逻辑

通过依赖注入构建测试环境

隔离实体与 DTO

使用 Docker Compose 统一开发环境

在设计表结构之前进行领域建模

커뮤니티의 다른 글

사내 시스템에 llm api 붙일 때 마주하는 현실적인 한계와 대응법

레거시 백엔드에 GPT-6 Astra 붙일 때 예산 승인과 보안 통과를 먼저 끝내는 법이 있습니다

에이전트끼리 대화하다 6천만 원 청구서가 나오는 이유

사내 RAG 벡터 검색에 Okta 권한 필터를 직접 거는 방법

브라우저 에이전트에게 내 구글 계정을 통째로 넘기면 안 되는 이유

Apple Won the AI Race

댓글 (0)

初级开发者在考虑 CRUD 之外时所需的设计工具

提高代码内聚性：分离数据访问与逻辑

通过依赖注入构建测试环境

隔离实体与 DTO

使用 Docker Compose 统一开发环境

在设计表结构之前进行领域建模