# Product Search Engine Architecture ## Decoupled `SearchService` Abstraction The application interacts with search via a strict `SearchService` interface to decouple business logic from OpenSearch cluster topology. ```text Backend Routers / Services │ ▼ SearchService Interface │ ├─────► OpenSearch Cluster (Normal Production Mode) │ └─────► Restricted MySQL Fallback (Circuit Breaker Mode) ``` --- ## OpenSearch Outage Circuit Breaker Strategy ```mermaid flowchart TD Req["Incoming Search Request"] --> CBCheck{"Circuit Breaker State"} CBCheck -->|Closed / Healthy| OpenSearch["Execute OpenSearch Faceted Search"] CBCheck -->|Open / Tripped| FallbackChoice{"Query Type Check"} FallbackChoice -->|Exact ID / SKU / Category| DirectMySQL["Execute Simple Indexed MySQL Query"] FallbackChoice -->|Complex Multi-Filter Query| RejectGracefully["Reject Gracefully\n(429 / 503 Basic Mode Notification)"] ``` --- ## Out-of-Order Event Protection Every search indexing event contains `aggregate_id` and `aggregate_version`. ```text Consumer Logic: IF incoming.aggregate_version <= current_index.aggregate_version THEN IGNORE (Stale Event) ELSE IF incoming.aggregate_version == current_index.aggregate_version + 1 THEN APPLY UPDATE ELSE RE-QUEUE FOR SEQUENTIAL PROCESSING END IF ```