Contact the author

Any questions? Feel free to contact the owners

1 services are in this domain

This service sends messages to downstream consumers

Overview

The Catalog domain is responsible for managing the products that are available for purchase in the BookWorm platform. It serves as the central repository for all book-related information including metadata, inventory status, pricing, and categorization.

This domain allows customers to browse the extensive collection of books, view detailed product information including author details, publisher information,… and preview content when available. The search functionality enables users to find books based on various criteria such as title, author, genre, publication date, and keywords.

The domain also provides robust management capabilities for product categories, series, collections, and publishers. It maintains relationships between books, such as series orders, related titles, and author bibliographies.

For administrators, the Catalog domain offers inventory management tools, allowing them to add new books, update existing information, manage stock levels, and control pricing and discounts.

As a core domain in the BookWorm ecosystem, Catalog integrates with other services like the Basket domain for purchasing flows, the Rating domain for customer reviews, and the Ordering domain for inventory verification during checkout processes.

Architecture

The Catalog service is built using a clean architecture approach with the following key components:

• Domain Layer: Contains the core business logic and domain models
  • Aggregates: Book, Publisher, Author, and Category
  • Domain Events and Event Handlers
  • Domain Exceptions
• Infrastructure Layer: Handles data persistence and external service integration
• Features: Implements specific use cases and business operations
• gRPC: Provides service-to-service communication
• Integration Events: Manages cross-service event communication

Domain Model

The Catalog domain is structured around four main aggregates:

1. Book Aggregate

   • Core entity representing books in the catalog
   • Manages book metadata, pricing, and inventory
   • Handles relationships with authors, publishers, and categories

2. Publisher Aggregate

   • Manages publisher information and relationships
   • Handles publisher-specific metadata and branding

3. Author Aggregate

   • Manages author information and bibliographies
   • Handles author-specific metadata and relationships with books

4. Category Aggregate

   • Manages book categorization and classification
   • Handles hierarchical category structures

Each aggregate maintains its own consistency boundary and encapsulates its business rules and invariants.

Bounded context

Messages for this domain

Sends messages (1)

Quickly find the message you need by searching for the name, type, or summary.

Events (1)

Name	Version	Type	Summary
Updated Book Rating Fail	v1.0.0	event	Represents a failed integration event when updating a book's rating in the system

Receives messages (17)

Quickly find the message you need by searching for the name, type, or summary.

Events (2)Queries (5)Commands (10)

Name	Version	Type	Summary
Update Publisher	v1.0.0	command	Update a publisher
List Publishers	v1.0.0	query	List all publishers
Create Publisher	v1.0.0	command	Create a publisher
Update Category	v1.0.0	command	Update a category

PreviousNext

Showing 1 to 4 of 17 results

Domain Events

The Catalog domain produces and consumes various events including:

• BookCreatedEvent: Event raised when a new book is created
• BookUpdatedEvent: Event raised when a book is updated

Business Rules and Invariants

• Books must have at least one author
• Books must have a valid category
• Books must have a valid publisher
• Books must have a valid price
• Books must have a valid inventory status