DDD Example

使用Clean Architecture、DDD思想，实现基本的账号登录、注册接口

运行需求

• docker
• golang
• gow (go install github.com/mitranim/gow@latest)
• wire (go install github.com/google/wire/cmd/wire@latest)

Make命令

• make serve 启动本地测试服务
• make clean 清除docker容器
• make test 执行单元测试
• make alltest 执行所有测试(单元测试和数据库集成测试)
• make wire 依赖注入代码更新

make alltest需要初始化完成的数据库，可以用make serve来实现初始化，只需要初始化一次即可，但在make clean之后需要重新初始化

接口测试

VSCode可以使用test/api.http测试脚本对本地启动好的服务进行测试，需要安装REST Client插件

项目结构

/cmd/server

服务器二进制命令行启动代码

/internal/option

系统配置，外部服务资源初始化

/internal/presentaion

表现层，http、grpc、定时任务、队列consumer等

/internal/app

业务逻辑层

表现层所有的请求都由app/handler内封装的各种handler来处理

多个handler之间共用的逻辑被封装为相应的app/service，service只应该被handler调用，不应该被直接使用

/internal/domain

领域逻辑

/internal/infra

基础设施，实现/app/adapter内约定的接口行为

/pkg/

各种不包含具体业务逻辑的工具函数、对象、接口

代码不应该直接放到pkg package下面，应该被放到pkg内的子package内，避免pkg成为一个什么都能放的筐

参考文章

• The Clean Architecture
• threedots.tech
• How I write HTTP services after eight years.