/order-backend

Order backend for e-commerce.

Primary LanguageJavaApache License 2.0Apache-2.0

本示例代码对应博客:

项目简介

本项目是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来说,尽量少,并且最好是原始类型