Product search indexing
How product catalog changes are projected into the Search System for customer-facing search.
Product Search IndexingProduct Search IndexingFlowv1.0.0How a change to a product in the catalog reliably flows into the search index — via the outbox, product events and the i...Ownersearch-platformView flowView docs keeps product search aligned with catalog changes. It is intentionally asynchronous: product writes should not wait for search indexing to complete.
Flow map
Producers
Product Catalog SystemProduct Catalog SystemSystemv1.0.0Internal system that is the source of truth for product data. Owns the product database and publishes product change eve...Ownerproduct-platformMapView docs owns product data. Product changes are represented by:
- Product CreatedProduct CreatedEventv1.0.0Published when a new product has been added to the catalog. Ownerproduct-platformSchemaMapView docs
- Product UpdatedProduct UpdatedEventv1.0.0Published when an existing product's data has changed. Ownerproduct-platformSchemaMapView docs
- Product DeletedProduct DeletedEventv1.0.0Published when a product has been removed from the catalog. Ownerproduct-platformSchemaMapView docs
These events are published by services inside the Product Catalog System, including Product Search PublisherProduct Search PublisherServicev1.0.0
Reads product changes from the product database (outbox) and reliably publishes product-created, product-updated and pro...Publishesproduct-created, product-updated +1Ownerproduct-platformMapRepoView docs.
Consumers
Search SystemSearch SystemSystemv1.0.0Internal system that keeps product data searchable. Consumes product change events from the Product Catalog System, main...Ownersearch-platformMapView docs consumes product change events and updates Search IndexSearch IndexContainerv1.0.0
The denormalised, search-optimised index of products that powers product search.MapView docs. Search APISearch APIServicev1.0.0
Public-facing API that serves fast, relevant product search to the rest of the business, reading from the search index.
Subscribessearch-productsAPIsOpenAPIOwnersearch-platformMapRepoView docs then serves Search ProductsSearch ProductsQueryv1.0.0Query to search the catalog for products matching a term, with optional filters and pagination.
Ownersearch-platformSchemaMapView docs against that index.
Consistency model
The product database is immediately authoritative. The search index is eventually consistent. User interfaces should tolerate a short delay between product update and search result update.
Operational signals
Watch for indexing lag, failed event handling and search query errors. A stale search index affects product discovery even when product writes are healthy.