hhy5277 / order-backend

Order backend for e-commerce.

本示例代码对应博客：

• Spring Boot项目模板

项目简介

本项目是ecommerce系统的订单（Order）子系统，用于接受用户订单。

技术选型

Spring Boot、Gradle、MySQL、Junit 5、Rest Assured、Docker

本地构建

在本地构建之前必须完成以下步骤：

• 命令行进入ecommerce-sample/devops项目的跟目录
• 运行./start-nexus.sh，用于启动Nexus
• 运行./start-rabbitmq.sh，用于启动RabbitMQ
• 命令行进入ecommerce-sample/common项目的根目录
• 运行./publish.sh，该命令将推送公共的common.jar包到Nexus

功能	命令	备注
生成IntelliJ工程	./idea.sh	自动打开IntelliJ
本地运行	./run.sh	自动启动MySQL，监听5005调试端口
本地构建	./local-build.sh	启动启动MySQL，运行所有类型的自动化测试
停止MySQL	./gradlew composeDown	将清空所有数据
手动启动MySQL	./gradlew composeUp

领域对象

领域对象	中文名	业务功能
Order	订单	表示用于下的订单，包含多个产品及其数量

测试策略

测试类型	代码目录	测试内容
单元测试	src/test/java	包含核心领域模型（包含领域对象和Factory类）的测试
组件测试	src/componentTest/java	用于测试一些核心的组件级对象，比如Repository
API测试	src/apiTest/java	模拟客户端调用API

技术架构

技术架构图

部署架构

部署架构图

外部依赖

列出项目所依赖的其他系统，比如订单系统依赖于会员系统。

环境信息

列出各个环境的访问方式，数据库连接等。

编码实践

列出常用的公共的编码实践方式。

FAQ

常见问题列表

原则

• Api gateway负责所有的authentication和authorization，各个微服务之间不用任何token机制，用户id放在url中，这样符合rest的资源格式
• 所有和列表相关的东西全部放到bff层中，也即各个服务只会暴露单个聚合根详情的接口，cqrs的bff接到事件通知后调用各个子服务的详情接口同步数据
• 各个服务发出的事件应该包含事件相关的数据，即便consumer端只是用于通知，但是对于发送发自己来讲应该通知事件相应的事件
• 根据id查看聚合根详情api优先领域模型转换或者数据模型，通过单独的representationservice
• 所有事件放到common包中,同时包括command和representation，因为这些是服务对外的接口，事件中带入尽量少的恰如其分的数据，对于创建ar来说，尽量少，并且最好是原始类型