Code Monkey home page Code Monkey logo

ahoo-wang / wow Goto Github PK

View Code? Open in Web Editor NEW
168.0 7.0 23.0 19.39 MB

Modern Reactive CQRS Architecture Microservice development framework based on DDD and EventSourcing | 基于 DDD & EventSourcing 的现代响应式 CQRS 架构微服务开发框架

Home Page: https://wow.ahoo.me/

License: Apache License 2.0

Kotlin 95.55% JavaScript 0.10% Dockerfile 0.03% Java 1.49% Lua 0.16% TypeScript 1.99% HTML 0.63% SCSS 0.02% Less 0.02%
cqrs domain-driven-design event-driven event-sourcing microservice reactive-programming high-performance ddd architecture elasticsearch

wow's Introduction

Wow:A Modern Reactive CQRS Architecture Microservice development framework based on DDD and EventSourcing

Wow : Modern Reactive CQRS Architecture Microservice development framework based on DDD and EventSourcing

中文文档

License GitHub release Maven Central Codacy Badge codecov Integration Test Status Awesome Kotlin Badge

Domain-Driven | Event-Driven | Test-Driven | Declarative-Design | Reactive Programming | Command Query Responsibility Segregation | Event Sourcing

Quick Start

Use Wow Project Template to quickly create a DDD project based on the Wow framework.

Features Overview

Wow-Features

Architecture

Wow-Architecture

Performance Test (Example)

  • Test Code: Example
  • Test Case: Add To Shopping Cart / Create Order
  • Command WaitStrategy: SENTPROCESSED

Deployment

Test Report

Add To Shopping Cart

WaitStrategy:SENT Mode, The AddCartItem command write request API After 2 minutes of stress testing, the average TPS was 59625, the peak was 82312, and the average response time was 29 ms.

AddCartItem-SENT

WaitStrategy:PROCESSED Mode, The AddCartItem command write request API After 2 minutes of stress testing, the average TPS was 18696, the peak was 24141, and the average response time was 239 ms.

AddCartItem-PROCESSED

Create Order

WaitStrategy:SENT Mode, The CreateOrder command write request API After 2 minutes of stress testing, the average TPS was 47838, the peak was 86200, and the average response time was 217 ms.

CreateOrder-SENT

WaitStrategy:PROCESSED Mode, The CreateOrder command write request API After 2 minutes of stress testing, the average TPS was 18230, the peak was 25506, and the average response time was 268 ms.

CreateOrder-PROCESSED

Event Sourcing

Wow-EventSourcing

Observability

Wow-Observability

OpenAPI (Spring WebFlux Integration)

Automatically register the Command routing processing function (HandlerFunction), and developers only need to write the domain model to complete the service development.

Wow-Spring-WebFlux-Integration

Test suite: 80%+ test coverage is very easy

Given -> When -> Expect .

Wow-CI-Flow

Preconditions

  • Understanding Domain Driven Design:《Implementing Domain-Driven Design》,《Domain-Driven Design: Tackling Complexity in the Heart of Software》
  • Understanding Command Query Responsibility Segregation(CQRS)
  • Understanding EventSourcing
  • Understanding Reactive Programming

Order Service(Kotlin)

Example-Order

Transfer(JAVA)

Example-Transfer

Unit Test Suite

80%+ test coverage is very easy.

Test Coverage

Given -> When -> Expect .

Aggregate Unit Test (AggregateVerifier)

Aggregate Test

internal class OrderTest {

    @Test
    private fun createOrder() {
        val tenantId = GlobalIdGenerator.generateAsString()
        val customerId = GlobalIdGenerator.generateAsString()

        val orderItem = OrderItem(
            GlobalIdGenerator.generateAsString(),
            GlobalIdGenerator.generateAsString(),
            BigDecimal.valueOf(10),
            10,
        )
        val orderItems = listOf(orderItem)
        val inventoryService = object : InventoryService {
            override fun getInventory(productId: String): Mono<Int> {
                return orderItems.filter { it.productId == productId }.map { it.quantity }.first().toMono()
            }
        }
        val pricingService = object : PricingService {
            override fun getProductPrice(productId: String): Mono<BigDecimal> {
                return orderItems.filter { it.productId == productId }.map { it.price }.first().toMono()
            }
        }
        aggregateVerifier<Order, OrderState>(tenantId = tenantId)
            .inject(DefaultCreateOrderSpec(inventoryService, pricingService))
            .given()
            .`when`(CreateOrder(customerId, orderItems, SHIPPING_ADDRESS, false))
            .expectEventCount(1)
            .expectEventType(OrderCreated::class.java)
            .expectStateAggregate {
                assertThat(it.aggregateId.tenantId, equalTo(tenantId))
            }
            .expectState {
                assertThat(it.id, notNullValue())
                assertThat(it.customerId, equalTo(customerId))
                assertThat(it.address, equalTo(SHIPPING_ADDRESS))
                assertThat(it.items, equalTo(orderItems))
                assertThat(it.status, equalTo(OrderStatus.CREATED))
            }
            .verify()
    }

    @Test
    fun createOrderGivenEmptyItems() {
        val customerId = GlobalIdGenerator.generateAsString()
        aggregateVerifier<Order, OrderState>()
            .inject(mockk<CreateOrderSpec>(), "createOrderSpec")
            .given()
            .`when`(CreateOrder(customerId, listOf(), SHIPPING_ADDRESS, false))
            .expectErrorType(IllegalArgumentException::class.java)
            .expectStateAggregate {
                /*
                 * 该聚合对象处于未初始化状态,即该聚合未创建成功.
                 */
                assertThat(it.initialized, equalTo(false))
            }.verify()
    }

    /**
     * 创建订单-库存不足
     */
    @Test
    fun createOrderWhenInventoryShortage() {
        val customerId = GlobalIdGenerator.generateAsString()
        val orderItem = OrderItem(
            GlobalIdGenerator.generateAsString(),
            GlobalIdGenerator.generateAsString(),
            BigDecimal.valueOf(10),
            10,
        )
        val orderItems = listOf(orderItem)
        val inventoryService = object : InventoryService {
            override fun getInventory(productId: String): Mono<Int> {
                return orderItems.filter { it.productId == productId }
                    /*
                     * 模拟库存不足
                     */
                    .map { it.quantity - 1 }.first().toMono()
            }
        }
        val pricingService = object : PricingService {
            override fun getProductPrice(productId: String): Mono<BigDecimal> {
                return orderItems.filter { it.productId == productId }.map { it.price }.first().toMono()
            }
        }

        aggregateVerifier<Order, OrderState>()
            .inject(DefaultCreateOrderSpec(inventoryService, pricingService))
            .given()
            .`when`(CreateOrder(customerId, orderItems, SHIPPING_ADDRESS, false))
            /*
             * 期望:库存不足异常.
             */
            .expectErrorType(InventoryShortageException::class.java)
            .expectStateAggregate {
                /*
                 * 该聚合对象处于未初始化状态,即该聚合未创建成功.
                 */
                assertThat(it.initialized, equalTo(false))
            }.verify()
    }
}

Saga Unit Test (SagaVerifier)

Saga Test

class CartSagaTest {

    @Test
    fun onOrderCreated() {
        val orderItem = OrderItem(
            GlobalIdGenerator.generateAsString(),
            GlobalIdGenerator.generateAsString(),
            BigDecimal.valueOf(10),
            10,
        )
        sagaVerifier<CartSaga>()
            .`when`(
                mockk<OrderCreated> {
                    every {
                        customerId
                    } returns "customerId"
                    every {
                        items
                    } returns listOf(orderItem)
                    every {
                        fromCart
                    } returns true
                },
            )
            .expectCommandBody<RemoveCartItem> {
                assertThat(it.id, equalTo("customerId"))
                assertThat(it.productIds, hasSize(1))
                assertThat(it.productIds.first(), equalTo(orderItem.productId))
            }
            .verify()
    }
}

Design

Modeling

Single Class Inheritance Pattern Aggregation Pattern
Single Class - Modeling Inheritance Pattern- Modeling Aggregation Pattern- Modeling

Load Aggregate

Load Aggregate

Aggregate State Flow

Aggregate State Flow

Send Command

Send Command

Command And Event Flow

Command And Event Flow

Event Compensation

Use Case

Event-Compensation-UserCase

Execution Sequence Diagram

Event-Compensation

Dashboard

Compensation-Dashboard

Compensation-Dashboard

Compensation-Dashboard

Compensation-Dashboard-Error

wow's People

Contributors

ahoo-wang avatar aimee-xie avatar noahjzc avatar renovate[bot] avatar rocherkong avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

wow's Issues

Quarkus support?

Is your feature request related to a problem? Please describe.
As far as I know, the project template and most configs work best with spring. I would like to use quarkus and try to use Wow with it. Is it supported?

Describe the solution you'd like
If the framework is agnostic in terms of integration, and doesn't depend on Spring, then perhaps a guide to integrate with Quarkus? If the framework does depend on spring, is it possible to make a version/compat patch for Quarkus?

Describe alternatives you've considered
Using spring, because of performance considerations decided to use Quarkus.

Additional context
Thank you for this work.

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

Detected dependencies

dockerfile
compensation/wow-compensation-server/Dockerfile
  • dragonwell-registry.cn-hangzhou.cr.aliyuncs.com/dragonwell/dragonwell 21-ubuntu
example/example-server/Dockerfile
  • dragonwell-registry.cn-hangzhou.cr.aliyuncs.com/dragonwell/dragonwell 21-ubuntu
github-actions
.github/workflows/codecov.yml
  • actions/setup-java v4
  • EnricoMi/publish-unit-test-result-action v2.17.0
  • codecov/codecov-action v4
.github/workflows/compensation-deploy.yml
  • actions/setup-node v4
  • actions/setup-java v4
  • docker/setup-qemu-action v3
  • docker/setup-buildx-action v3
  • docker/login-action v3
  • docker/login-action v3
  • docker/login-action v3
  • docker/metadata-action v5
  • docker/build-push-action v6
.github/workflows/compensation-test.yml
  • actions/setup-java v4
  • actions/setup-java v4
.github/workflows/documentation-deploy.yml
  • actions/setup-java v4
  • actions/setup-node v4
  • crazy-max/ghaction-github-pages v4
.github/workflows/example-deploy.yml
  • actions/setup-java v4
  • docker/setup-qemu-action v3
  • docker/setup-buildx-action v3
  • docker/login-action v3
  • docker/login-action v3
  • docker/login-action v3
  • docker/metadata-action v5
  • docker/build-push-action v6
.github/workflows/example-java-test.yml
  • actions/setup-java v4
.github/workflows/gitee-sync.yml
.github/workflows/integration-test.yml
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
  • actions/setup-java v4
.github/workflows/package-deploy.yml
  • actions/setup-java v4
  • actions/setup-java v4
gradle
gradle.properties
settings.gradle.kts
  • org.gradle.toolchains.foojay-resolver-convention 0.8.0
build.gradle.kts
compensation/wow-compensation-api/build.gradle.kts
compensation/wow-compensation-core/build.gradle.kts
compensation/wow-compensation-domain/build.gradle.kts
compensation/wow-compensation-server/build.gradle.kts
example/example-api/build.gradle.kts
example/example-domain/build.gradle.kts
example/example-server/build.gradle.kts
example/transfer/example-transfer-api/build.gradle.kts
example/transfer/example-transfer-domain/build.gradle.kts
example/transfer/example-transfer-server/build.gradle.kts
gradle/libs.versions.toml
  • org.springframework.boot:spring-boot-dependencies 3.3.2
  • me.ahoo.cosid:cosid-bom 2.9.3
  • me.ahoo.simba:simba-bom 2.5.2
  • me.ahoo.coapi:coapi-bom 1.6.8
  • io.opentelemetry:opentelemetry-bom 1.41.0
  • io.opentelemetry.instrumentation:opentelemetry-instrumentation-bom 2.6.0
  • io.opentelemetry:opentelemetry-semconv 1.29.0-alpha
  • org.testcontainers:testcontainers-bom 1.20.1
  • com.google.devtools.ksp:symbol-processing-api 2.0.10-1.0.24
  • com.google.devtools.ksp:symbol-processing 2.0.10-1.0.24
  • dev.zacsweers.kctfork:ksp 0.5.1
  • com.google.guava:guava 33.2.1-jre
  • io.swagger.core.v3:swagger-core-jakarta 2.2.22
  • org.springdoc:springdoc-openapi-starter-common 2.6.0
  • org.springdoc:springdoc-openapi-starter-webflux-api 2.6.0
  • org.springdoc:springdoc-openapi-starter-webflux-ui 2.6.0
  • gg.jte:jte 3.1.12
  • gg.jte:jte-kotlin 3.1.12
  • org.hamcrest:hamcrest 3.0
  • io.mockk:mockk 1.13.12
  • io.gitlab.arturbosch.detekt:detekt-formatting 1.23.6
  • org.gradle.test-retry 1.5.10
  • com.google.devtools.ksp 2.0.10-1.0.24
  • io.gitlab.arturbosch.detekt 1.23.6
  • org.jetbrains.dokka 1.9.20
  • org.jetbrains.kotlin.jvm 2.0.10
  • org.jetbrains.kotlin.plugin.spring 2.0.10
  • org.jetbrains.kotlin.kapt 2.0.10
  • io.github.gradle-nexus.publish-plugin 2.0.0
wow-api/build.gradle.kts
wow-apiclient/build.gradle.kts
wow-bi/build.gradle.kts
wow-bom/build.gradle.kts
wow-compiler/build.gradle.kts
wow-core/build.gradle.kts
wow-dependencies/build.gradle.kts
wow-elasticsearch/build.gradle.kts
wow-kafka/build.gradle.kts
wow-models/build.gradle.kts
wow-mongo/build.gradle.kts
wow-openapi/build.gradle.kts
wow-opentelemetry/build.gradle.kts
wow-query/build.gradle.kts
wow-r2dbc/build.gradle.kts
wow-redis/build.gradle.kts
wow-spring/build.gradle.kts
wow-spring-boot-starter/build.gradle.kts
wow-webflux/build.gradle.kts
gradle-wrapper
gradle/wrapper/gradle-wrapper.properties
  • gradle 8.9
npm
compensation/wow-compensation-dashboard/package.json
  • @angular/animations ^18.0.3
  • @angular/common ^18.0.3
  • @angular/compiler ^18.0.3
  • @angular/core ^18.0.3
  • @angular/forms ^18.0.3
  • @angular/platform-browser ^18.0.3
  • @angular/platform-browser-dynamic ^18.0.3
  • @angular/router ^18.0.3
  • monaco-editor ^0.50.0
  • ng-zorro-antd ^18.0.0
  • rxjs ~7.8.0
  • tslib ^2.3.0
  • zone.js ~0.14.2
  • @angular-devkit/build-angular ^18.0.4
  • @angular/cli ^18.0.4
  • @angular/compiler-cli ^18.0.3
  • @types/jasmine ~5.1.0
  • jasmine-core ~5.2.0
  • karma ~6.4.0
  • karma-chrome-launcher ~3.2.0
  • karma-coverage ~2.2.0
  • karma-jasmine ~5.1.0
  • karma-jasmine-html-reporter ~2.1.0
  • typescript ~5.4.0
documentation/package.json
  • vitepress ^1.0.0-rc.34

  • Check this box to trigger a request for Renovate to run again on this repository

feat: support wow-connect

Source ->Command --> DomainEvent -> Sink

Connector/ConnectorRegistry

SourceConnector:

  • Kafka
  • RabbitMQ

SinkConnector:

  • Http
  • Kafka
  • RabbitMQ

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.