tourem/bookstore-cqrs-example

This system is a distributed e-commerce platform built on a CQRS architecture, separating command and query responsibilities across distinct bounded contexts. It manages the full lifecycle of orders, shopping carts, and product catalogs through dedicated services that expose REST APIs for client interaction. The architecture leverages event-driven patterns, using domain events and sagas to coordinate state changes and maintain read models for reporting.

A new OrderResource class has been introduced to expose order-related endpoints. It provides POST endpoints for placing orders and activating existing orders, mapping incoming requests to internal commands via a CommandFactory and dispatching them through the CommandBus.

order-context-parent/order-command/src/main/java/se/citerus/cqrs/bookstore/ordercontext/resource · high confidence

The order-query module now includes a complete read-model stack for orders. This adds an in-memory projection repository, denormalizer, and aggregator that listen to order events to maintain up-to-date order lists and daily sales counts. A new REST resource exposes endpoints for retrieving all events, the full order list, and orders-per-day statistics, allowing users to query order data directly.

order-context-parent/order-query · high confidence

Users can now register new publisher contracts and record purchases against them. This introduces a new REST endpoint at /publisher-contract-requests to create contracts, and tracks the accumulated fees for each publisher, capping the total fees at a defined limit.

order-context-parent/publisher-contract-command · high confidence

A new saga, PurchaseRegistrationSaga, has been added to the order context to handle the processing of OrderActivatedEvent. Upon receiving the event, the saga queries the order details and iterates through each order line to publish a corresponding RegisterPurchaseCommand to the publisher contract, enabling the system to track purchases per product.

order-context-parent/sagas · high confidence

Added the foundational classes for the command-side of the application. This includes the abstract Command base class providing standard object identity methods, the CommandBus interface for dispatching commands and registering handlers, the CommandHandler marker interface, and the abstract Saga class implementing DomainEventListener with replay support disabled.

cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/command, cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/saga · high confidence

Added the foundational classes for the application's event-driven architecture. This includes the DomainEvent base class, which standardizes aggregate ID, version, and timestamp, along with the DomainEventBus and DomainEventListener interfaces for publishing and subscribing to domain events, and the DomainEventStore interface for persisting and retrieving event streams.

cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/event · high confidence

The product-catalog-context now includes a new service built on Dropwizard, exposing a REST API for managing products and books. The service provides endpoints to create, retrieve, and list products, with an in-memory repository for data storage. A configuration file (dev.yml) sets up HTTP and admin connectors, logging, and CORS headers. The API includes DTOs for books and products, a factory for mapping domain objects to DTOs, and a resource class handling the HTTP requests. Tests verify the resource's behavior, and a test client and data importer are provided for manual testing.

product-catalog-context · high confidence

The domain layer now includes an \AggregateRoot\ base class that automatically manages uncommitted events, versioning, and timestamps, while allowing optional event handlers. A \Repository\ interface is added to support loading and saving aggregate roots, and a \ValueObject\ base class provides standard equality and hashing behavior. These changes establish the foundational structure for implementing CQRS aggregates within the bookstore domain.

cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/domain · high confidence

New domain event classes and identifiers have been added to the publisher contract module. Specifically, the codebase now includes \PublisherContractId\ and three new domain events: \PublisherContractRegisteredEvent\, \PurchaseRegisteredEvent\, and their associated structures. These changes define the data contracts for publisher-related events, including fields for publisher name, fee percentages, limits, and accumulated fees, facilitating the tracking of purchase and fee data within the order context.

order-context-parent/eventbus-contract/src/main/java/se/citerus/cqrs/bookstore/ordercontext/publishercontract · high confidence

The shopping context has been extracted into its own application, exposing a REST API for managing shopping carts. Users can now create carts, add items, and view cart details via the new CartResource endpoints. The implementation includes domain models for carts and line items, an in-memory repository for cart persistence, and a client for the product catalog service.

shopping-context · high confidence

The order application module now includes a complete runtime setup using the Dropwizard framework, featuring an in-memory domain event store and a file-based event store for persistence. It registers command and domain event buses, sets up REST resources for orders and publisher contracts, and exposes an admin interface (admin.html) for viewing and activating orders. Additionally, a task is provided to replay domain events, and test utilities are included for importing publisher contract data.

order-context-parent/order-application · high confidence

New event classes, OrderActivatedEvent and OrderPlacedEvent, have been introduced in the eventbus contract. These classes extend DomainEvent and include Jackson @JsonProperty annotations on their constructor parameters, enabling proper serialization of order events for the event bus.

order-context-parent/eventbus-contract/src/main/java/se/citerus/cqrs/bookstore/ordercontext/order/event · medium confidence

The order context now includes new value objects: BookId, OrderId, ProductId, CustomerInformation, OrderLine, and OrderStatus. These classes define the structure for order-related data, including customer information, order lines with product details, and order status enumeration. The introduction of these value objects supports the separation of value objects from transfer objects in the system architecture.

order-context-parent/eventbus-contract/src/main/java/se/citerus/cqrs/bookstore/ordercontext/order · high confidence

The codebase now includes a GenericId class that enforces a specific regex pattern for ID validation, alongside a new TransportObject abstract class that standardizes equality, hash code, and string representation for transport objects.

cqrs-lib/src/main/java/se/citerus/cqrs/bookstore · medium confidence

Added new API classes to support order management: ActivateOrderRequest for activating orders, PlaceOrderRequest for placing orders with customer and cart details, and DTOs (CartDto, LineItemDto) to represent cart and line item data. These classes introduce validation constraints (NotEmpty, Pattern, Min, NotNull) for order IDs, customer information, and cart contents.

order-context-parent/order-command/src/main/java/se/citerus/cqrs/bookstore/ordercontext/api · high confidence

The order context now introduces specific command classes (PlaceOrderCommand, ActivateOrderCommand) and a corresponding handler (OrderCommandHandler) to process order placement and activation requests. The CommandFactory maps incoming API requests (PlaceOrderRequest, ActivateOrderRequest) into these domain commands, ensuring that customer information, order lines, and total amounts are correctly transferred to the domain layer for processing.

order-context-parent/order-command/src/main/java/se/citerus/cqrs/bookstore/ordercontext/order/command · high confidence

The order context's domain model has been restructured to use explicit ValueObjects for customer and line item data. A new \CustomerInformation\ class now holds customer name, email, and address, while \OrderLine\ encapsulates product details. The \Order\ aggregate has been updated to accept these new types, and the \place\ method now accepts a \totalAmount\ directly from the cart's total price.

order-context-parent/order-command/src/main/java/se/citerus/cqrs/bookstore/ordercontext/order/domain · medium confidence

Added new test classes for the Order domain (OrderTest) and the Order resource (OrderResourceTest). The domain tests verify order placement, activation, and event generation, while the resource tests validate the HTTP endpoint for creating orders using mocked dependencies.

order-context-parent/order-command/src/test · high confidence

The project now uses a multi-module Maven structure with a parent POM that defines a centralized dependency management section. This includes specific versions for Dropwizard (1.2.2), JUnit (4.12), Mockito (2.15.0), and other libraries, ensuring consistent dependency versions across all submodules like order-context-parent, shopping-context, and product-catalog-context.

(dependencies) · medium confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

• CAI 51 → 44 (-7.5)
• Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

• Code Health 99 → 99 (-0.3)
• Architecture 100 → 90 (-10.3)
• Maturity 64 → 43 (-21.1)
• Readiness 39 → 32 (-7.3)
• Security 100 → 82 (-18.0)
• Domain Modelling 100 → 100 (-0.0)
• Accessibility 37 → 38 (+0.5)

• Coverage not included — suite not readable by the collector
• Dependency hygiene not measured — dependency manifest found but not parsed for hygiene
• Duplicated block (6 lines × 2) (order-context-parent/order-application/src/main/java/se/citerus/cqrs/bookstore/ordercontext/application/OrderApplication.java)
• Duplicated block (9 lines × 2) (order-context-parent/publisher-contract-command/src/main/java/se/citerus/cqrs/bookstore/ordercontext/publishercontract/command/RegisterPublisherContractCommand.java)
• No exposed public API
• Scanner failed to run — not a clean result
• Test reliability not included
• dormant codebase — no living knowledge left to concentrate

• Dependency hygiene PARTLY measured — Maven/Gradle declarations read, no dependency graph resolved
• Documentation: no installation or build instructions (README.md)
• Documentation: no usage examples (README.md)
• Duplicated block (12 lines × 2) (order-context-parent/order-query/src/main/java/se/citerus/cqrs/bookstore/ordercontext/client/productcatalog/ProductCatalogClient.java)
• Duplicated block (23 lines × 2) (cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/TransportObject.java)
• Duplicated block (27 lines × 2) (cqrs-lib/src/main/java/se/citerus/cqrs/bookstore/command/Command.java)
• Duplicated block (7 lines × 2) (order-context-parent/order-application/src/main/java/se/citerus/cqrs/bookstore/ordercontext/application/OrderApplication.java)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• Medium: security finding (details withheld)
• No ADRs found
• No assertions: cannotPlaceAnOrderTwice (order-context-parent/order-command/src/test/java/se/citerus/cqrs/bookstore/ordercontext/order/domain/OrderTest.java)
• No assertions: feeCannotBeNegative (order-context-parent/publisher-contract-command/src/test/java/se/citerus/cqrs/bookstore/ordercontext/publishercontract/domain/AccumulatedFeeTest.java)
• No assertions: requireOrderLinesWhenPlacingAnOrder (order-context-parent/order-command/src/test/java/se/citerus/cqrs/bookstore/ordercontext/order/domain/OrderTest.java)
• No assertions: shouldClearCart (shopping-context/src/test/java/se/citerus/cqrs/bookstore/shopping/resource/CartResourceTest.java)
• No assertions: testCannotRegisterTwice (order-context-parent/publisher-contract-command/src/test/java/se/citerus/cqrs/bookstore/ordercontext/publishercontract/domain/PublisherContractTest.java)
• …and 5 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

tourem/bookstore-cqrs-example was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.