/ecommerce-order-query-service

CQRS query service for Order with Product.

Primary LanguageJavaApache License 2.0Apache-2.0

项目简介

本项目是Ecommerce系统的订单(Order)查询子系统,用于订单查询。

Ecommerce项目包括:

代码库 用途 地址
ecommerce-order-service Order服务 https://github.com/e-commerce-sample/ecommerce-order-service
ecommerce-order-query-service Order查询服务 https://github.com/e-commerce-sample/ecommerce-order-query-service
ecommerce-product-service Product服务 https://github.com/e-commerce-sample/ecommerce-product-service
ecommerce-inventory-service Inventory服务 https://github.com/e-commerce-sample/ecommerce-inventory-service
ecommerce-shared-model 共享模型,不含Spring https://github.com/e-commerce-sample/ecommerce-shared-model
ecommerce-spring-common Spring共享基础配置 https://github.com/e-commerce-sample/ecommerce-spring-common
ecommerce-devops 基础设施 https://github.com/e-commerce-sample/ecommerce-devops

技术选型

Spring Boot、Gradle、MySQL、Junit 5、Rest Assured、Docker、RabbitMQ/Kafka

本地构建

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

  • Pull最新devops代码
  • 命令行进入devops项目的local/rabbitmq目录
  • 运行./start-rabbitmq.sh,用于启动RabbitMQ,整个Ecommerce下的所有服务只需启动RabbitMQ一次
  • 进入devopsecommerce-sample/devops/local/zipkin目录
  • 运行./start-zipkin.sh,用于启动zipkin服务器,整个Ecommerce下的所有服务只需启动Zipkin一次
功能 命令 备注
生成IntelliJ工程 ./idea.sh 自动打开IntelliJ
本地运行 ./run.sh 自动启动MySQL,开启HTTP 8084端口,监听5008调试端口
本地构建 ./local-build.sh 启动启动MySQL,运行所有类型的自动化测试
停止本地MySQL ./gradlew composeDown 将清空所有数据
清空本地MySQL ./mysql-clean-local.sh 不会重建MySQL实例
登录本地MySQL ./mysql-login-local.sh
手动启动MySQL ./gradlew composeUp
发布sdk ./publish-sdk.sh 可以通过修改gradle.properties文件中的version指定版本

查询对象

查询对象 功能
OrderWithProductRepresentation 表示包含了产品信息的订单数据

测试策略

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

技术架构

技术架构图

部署架构

部署架构图

外部依赖

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

环境信息

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

编码实践

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

FAQ

常见问题列表