How miche-let/catalog-service works
Catalog Service is a Spring-based product catalog read model. Its user-facing path serves paginated product views and individual product details; an internal API validates options and calculates total prices. Kafka consumers synchronize product and stock events into MongoDB, while scheduled work updates visibility and resets daily stock. The README is only a title, so capabilities and links here are drawn from the source index and sampled code; unsampled wiring, including cache and broker configuration, is not asserted as fact.
Main entry points: ProductViewRepository.java View repository · ProductViewQueryService.java Product queries · ProductViewCommandService.java View updates · ProductViewController.java Product API
Components 20
Catalog APIs
- Product API
src/main/java/com/michelet/catalog/presentation/ProductViewController.java - Health API
src/main/java/com/michelet/catalog/presentation/ProductController.java - Option API
src/main/java/com/michelet/catalog/presentation/InternalOptionController.java - Scheduler trigger
src/main/java/com/michelet/catalog/presentation/CatalogSchedulerTriggerController.java
Catalog Application
- Product queries
src/main/java/com/michelet/catalog/application/ProductViewQueryService.java - Health query
src/main/java/com/michelet/catalog/application/ProductQueryService.java - Visibility scheduler
src/main/java/com/michelet/catalog/application/CatalogVisibilityScheduler.java - View updates
src/main/java/com/michelet/catalog/application/ProductViewCommandService.java
Event Synchronization
- Product event consumer
src/main/java/com/michelet/catalog/infrastructure/messaging/ProductEventConsumer.java - Stock event consumer
src/main/java/com/michelet/catalog/infrastructure/messaging/StockEventConsumer.java - Dead-letter consumer
src/main/java/com/michelet/catalog/infrastructure/messaging/DeadLetterConsumer.java - Event contracts
src/main/java/com/michelet/catalog/infrastructure/messaging/dto
Catalog Data
- View repository
src/main/java/com/michelet/catalog/domain/repository/ProductViewRepository.java - Product view model
src/main/java/com/michelet/catalog/domain/model/ProductView.java
Other components
- Catalog users
- Internal clients
- MongoDB
- Redis cache
- Kafka broker
- Product and inventory services
Connections 21
- Catalog users → Product API: requests catalog
src/main/java/com/michelet/catalog/presentation/ProductViewController.java - Product API → Product queries: queries views
src/main/java/com/michelet/catalog/presentation/ProductViewController.java - Product queries → View repository: reads products
src/main/java/com/michelet/catalog/application/ProductViewQueryService.java - Product queries → Redis cache: caches results
- Internal clients → Option API: validates options
src/main/java/com/michelet/catalog/presentation/InternalOptionController.java - Option API → Product queries: validates option
src/main/java/com/michelet/catalog/presentation/InternalOptionController.java - Catalog users → Health API: checks health
src/main/java/com/michelet/catalog/presentation/ProductController.java - Health API → Health query: checks status
src/main/java/com/michelet/catalog/presentation/ProductController.java - Internal clients → Scheduler trigger: triggers job
src/main/java/com/michelet/catalog/presentation/CatalogSchedulerTriggerController.java - Scheduler trigger → Visibility scheduler: starts schedule
src/main/java/com/michelet/catalog/presentation/CatalogSchedulerTriggerController.java - Visibility scheduler → View repository: updates visibility
src/main/java/com/michelet/catalog/application/CatalogVisibilityScheduler.java - Product event consumer → View updates: dispatches updates
src/main/java/com/michelet/catalog/infrastructure/messaging/ProductEventConsumer.java - Stock event consumer → View updates: dispatches stock
src/main/java/com/michelet/catalog/infrastructure/messaging/StockEventConsumer.java - Product and inventory services → Kafka broker: publishes events
- Kafka broker → Product event consumer: delivers product events
- Kafka broker → Stock event consumer: delivers stock events
- Kafka broker → Dead-letter consumer: routes failures
- View updates → View repository: writes views
src/main/java/com/michelet/catalog/application/ProductViewCommandService.java - View repository → MongoDB: stores documents
- View repository → Product view model: maps documents
src/main/java/com/michelet/catalog/domain/repository/ProductViewRepository.java - View updates → Event contracts: handles payloads
src/main/java/com/michelet/catalog/application/ProductViewCommandService.java