Skip to content
Back to search

Wow

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Ahoo-Wang/Wow with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Ahoo-Wang/Wow'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/ahoo-wang--wow/badge.svg)](/listings/ahoo-wang--wow)

HTML

<a href="/listings/ahoo-wang--wow"><img src="/api/listings/ahoo-wang--wow/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 155 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center" style="text-align:center;">
  2. <img width="150" src="documentation/docs/public/images/logo.svg" alt="Wow"/>
  3. </p>
  4. <h1 align="center">Wow</h1>
  5. > **Wow 10.0 is in pre-release on this branch.** The stable 9.x line lives on the [`v9`](https://github.com/Ahoo-Wang/Wow/tree/v9) branch.
  6. <p align="center"><strong>Domain Model as a Service</strong></p>
  7. <p align="center">Write only the domain model, and get a system you can run: its API, its contract, its clients and its read models.</p>
  8. <p align="center">
  9. <a href="https://www.kaicode.org/2026.html"><img width="280" src="documentation/docs/public/images/kaicode-2026-wow.svg" alt="KaiCode'26 Excellent Award"/></a><br/>
  10. <strong>KaiCode’26 Excellent Award</strong>
  11. </p>
  12. <p align="center">
  13. <a href="https://github.com/Ahoo-Wang/Wow/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-Apache%202-4EB1BA.svg" alt="License"/></a>
  14. <a href="https://github.com/Ahoo-Wang/Wow/releases"><img src="https://img.shields.io/github/release/Ahoo-Wang/Wow.svg" alt="GitHub release"/></a>
  15. <a href="https://central.sonatype.com/artifact/me.ahoo.wow/wow-bom"><img src="https://img.shields.io/maven-central/v/me.ahoo.wow/wow-bom" alt="Maven Central"/></a>
  16. <a href="https://codecov.io/gh/Ahoo-Wang/Wow"><img src="https://codecov.io/gh/Ahoo-Wang/Wow/branch/main/graph/badge.svg?token=uloJrLoQir" alt="Codecov"/></a>
  17. <a href="https://github.com/Ahoo-Wang/Wow/actions/workflows/ci.yml"><img src="https://github.com/Ahoo-Wang/Wow/actions/workflows/ci.yml/badge.svg" alt="CI"/></a>
  18. <a href="https://kotlin.link/"><img src="https://kotlin.link/awesome-kotlin.svg" alt="Awesome Kotlin"/></a>
  19. </p>
  20. <p align="center">
  21. <a href="https://wow.ahoo.me/">Documentation</a> &middot; <a href="https://wow.ahoo.me/zh/">中文文档</a>
  22. </p>
  23. ---
  24. ## What you write, and what you get
  25. You write an aggregate: it takes a command, looks at its state, and decides the events.
  26. <!-- sample: examples/quickstart/src/main/kotlin/me/ahoo/wow/example/quickstart/Account.kt#withdraw -->
  27. ```kotlin
  28. fun onCommand(command: Withdraw): Withdrawn {
  29. if (command.amount > state.balance) {
  30. reject(Rejections.INSUFFICIENT_BALANCE, "The balance is ${state.balance}.")
  31. }
  32. return Withdrawn(command.amount)
  33. }
  34. ```
  35. and you test it in the same terms:
  36. <!-- sample: examples/quickstart/src/test/kotlin/me/ahoo/wow/example/quickstart/AccountSpec.kt#withdraw -->
  37. ```kotlin
  38. @Test
  39. fun `a withdrawal the balance does not cover is rejected`() = aggregateSpec(model, id = "alice") {
  40. given(AccountOpened("Alice"), Deposited(100))
  41. whenCommand(Withdraw(150)) { expectRejected(Account.Rejections.INSUFFICIENT_BALANCE) }
  42. whenCommand(Withdraw(30)) {
  43. expectEvents(Withdrawn(30))
  44. expectState { balance.assert().isEqualTo(70) }
  45. }
  46. }
  47. ```
  48. From that, Wow gives you an HTTP route for every command, a state read and queries for every aggregate, an OpenAPI document, a typed TypeScript client, retries and parking for every handler, and a contract that the build checks for compatibility.
  49. ## Why Wow
  50. - **The log is the bus.** Every commit is appended to the log, and everything else (snapshots, read models, other contexts, the warehouse) follows it from there. Nothing is lost between a write and its consequences.
  51. - **You write decisions, not plumbing.** Aggregates decide; sagas derive commands; projections and reactors follow events. Routes, persistence, delivery and retries are the framework's.
  52. - **Failures are data.** A handler that keeps failing parks one aggregate, recorded in a ledger; it never skips an event or stops a subscription.
  53. - **One contract.** Routes, OpenAPI, typed clients, views and compatibility checks all come from one Manifest the compiler writes.
  54. - **Read models are disposable.** Every read model is rebuilt from the log, so changing one needs no migration.
  55. - **Measured on stated hardware.** [Performance](https://wow.ahoo.me/guide/performance) gives one node's sustainable and peak rates on a 4-core cloud runner and an 18-core workstation, and the comparison with Axon Framework 4, each figure with its build, CPU and JDK.
  56. ## Quickstart
  57. 1. Apply the Gradle plugin `me.ahoo.wow.service`, which brings the BOM `me.ahoo.wow:wow-bom` of its version.
  58. 2. Write a command, an event, a state and an aggregate.
  59. 3. `./gradlew run`, then send a command with `curl`.
  60. The [Quickstart](https://wow.ahoo.me/start/quickstart) walks through it in about thirty minutes.
  61. ## Architecture
  62. ```mermaid
  63. flowchart LR
  64. C[Clients] -->|commands| N[Service nodes]
  65. N -->|decide| L[(Log)]
  66. L --> S[Snapshots]
  67. L --> P[Projections and reactors]
  68. L --> G[Sagas]
  69. G -->|commands| N
  70. L -->|published streams| K[(Kafka)]
  71. K --> O[Other contexts]
  72. L --> W[(Warehouse)]
  73. ```
  74. A service runs as one or more nodes over PostgreSQL or MongoDB; they split the log's partitions through leases in the same store. Contexts talk over Kafka. [Concepts](https://wow.ahoo.me/concepts/) explains the model.
  75. ## Modules
  76. | Artifact | Holds |
  77. | --- | --- |
  78. | `me.ahoo.wow:wow-bom` | The versions of every module |
  79. | `me.ahoo.wow:wow-api` | The annotations and types domain code uses |
  80. | `me.ahoo.wow:wow-kernel` | The kernel the generated models build on |
  81. | `me.ahoo.wow:wow-spring-boot` | The Spring Boot host |
  82. | `me.ahoo.wow:wow-test` | The test DSL |
  83. | `me.ahoo.wow:wow-postgres`, `wow-mongo` | The backends |
  84. | `me.ahoo.wow:wow-kafka`, `wow-clickhouse`, `wow-elasticsearch` | The transport, the warehouse, search |
  85. ## TypeScript
  86. | Package | Does |
  87. | --- | --- |
  88. | `@ahoo-wang/wow-client` | Commands with their waits, state reads and queries |
  89. | `@ahoo-wang/wow-generator` | Typed clients generated from a service's Manifest |
  90. | `@ahoo-wang/wow-react` | React hooks for queries |
  91. | `@ahoo-wang/wow-view-engine` | Configurable data views: records, analyses and dashboards |
  92. | `@ahoo-wang/wow-view-store` | Saved views on a Wow server |
  93. ## Platform services and examples
  94. - [The ops service and console](platform/ops): the parked aggregates of every service in one place.
  95. - [The view store](platform/view-store): saved views and dashboards.
  96. - [The analytics catalog](platform/analytics/catalog): datasets across services (incubating).
  97. - [The eShop](examples/eshop): five services on PostgreSQL, Kafka and ClickHouse, with a web UI.
  98. - [The quickstart](examples/quickstart): the service of the Quickstart page.
  99. ## Requirements
  100. | Component | Version |
  101. | --- | --- |
  102. | Java | 21 |
  103. | Kotlin | 2.4.21 |
  104. | KSP | 2.3.14 |
  105. | Spring Boot | 4.1.2 |
  106. ## From 9.x
  107. [Migrating from 9.x](https://wow.ahoo.me/migrate/) covers the source, the data and the cut-over. The 9.x line is maintained on the [`v9`](https://github.com/Ahoo-Wang/Wow/tree/v9) branch.
  108. ## Agent Skills
  109. Six Skills help an agent write, migrate and query Wow applications: install the plugin `ahoo-wow-skills` from the Ahoo Skills Hub, or copy the [skills](skills) of an exact Wow tag into the agent's Skills directory.
  110. ## Community
  111. - Read [Contributing](CONTRIBUTING.md), the [Code of Conduct](CODE_OF_CONDUCT.md) and the [Security Policy](SECURITY.md).
  112. - Wow received the [KaiCode’26 Excellent Award](https://www.kaicode.org/2026.html).
  113. - Related projects: [CosId](https://github.com/Ahoo-Wang/CosId), [CoSec](https://github.com/Ahoo-Wang/CoSec), [Simba](https://github.com/Ahoo-Wang/Simba) and [FluentAssert](https://github.com/Ahoo-Wang/FluentAssert).
  114. ## License
  115. Wow is released under the [Apache 2.0 License](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.