Compare Scenarios
Side-by-side comparison with decision path analysis. Every dimension traces back to topology, risk propagation, simulation, and advisor intelligence.
Select Scenarios to Compare
Left Scenario
AI / RAG
Multi-Tenant SaaS
Analytics
Financial Ledger
Read-Heavy
Multi-Tenant SaaS
Write-Heavy
Marketplace
Event-Driven
Financial Ledger
Realtime Collab
Realtime Collab
Financial Ledger
Write-Heavy
AI / RAG
Multi-Tenant SaaS
Event-Driven
Analytics
Read-Heavy
Realtime Collab
Search-Heavy
Event-Driven
Event-Driven
Marketplace
Write-Heavy
Right Scenario
AI / RAG
Multi-Tenant SaaS
Analytics
Financial Ledger
Read-Heavy
Multi-Tenant SaaS
Write-Heavy
Marketplace
Event-Driven
Financial Ledger
Realtime Collab
Realtime Collab
Financial Ledger
Write-Heavy
AI / RAG
Multi-Tenant SaaS
Event-Driven
Analytics
Read-Heavy
Realtime Collab
Search-Heavy
Event-Driven
Event-Driven
Marketplace
Write-Heavy
Topology at a Glance
Architecture Comparison
Read-Heavy SaaS API is both simpler and lower-risk than Search-Heavy Content Platform
Read-Heavy SaaS API is the simpler architecture. Read-Heavy SaaS API carries lower operational risk. They share 4 component(s). Read-Heavy SaaS API has 1 unique risk(s); Search-Heavy Content Platform has 3.
7
Nodes
6
Edges
2
Risks
2
Seeds
5
Strengths
2
Adv. Risks
13
Nodes
6
Edges
4
Risks
1
Seeds
5
Strengths
4
Adv. Risks
Comparison Dimensions
Complexity
Read-Heavy SaaS API
moderate complexity, 7 nodes, 6 edges, 2 risks, 2 simulation seeds
Search-Heavy Content Platform
high complexity, 13 nodes, 6 edges, 4 risks, 1 simulation seeds
Read-Heavy SaaS API is simpler: moderate operational complexity with 7 topology nodes vs 13 for Search-Heavy Content Platform.
Operational Risk
Read-Heavy SaaS API
2 risks (top: high), 2 high/critical, 2 confirmed by simulation
Search-Heavy Content Platform
4 risks (top: high), 2 high/critical, 0 confirmed by simulation
Read-Heavy SaaS API has lower operational risk: weighted severity score 8 vs 12 (2 vs 0 simulation-confirmed).
Scalability
Read-Heavy SaaS API
4 scaling thresholds, 2 migration paths, 9 advisor scaling signals
Search-Heavy Content Platform
4 scaling thresholds, 3 migration paths, 4 advisor scaling signals
Read-Heavy SaaS API has more defined scaling paths: 4 thresholds and 2 migration paths.
Operational Maturity
Read-Heavy SaaS API
Advisor assessment: Intermediate; recommended team: Experienced Backend Team; 7 operational requirements
Search-Heavy Content Platform
Advisor assessment: Intermediate; recommended team: Experienced Backend Team; 9 operational requirements
Both scenarios require equivalent team maturity: Intermediate.
Observability
Read-Heavy SaaS API
8 watched metrics, 3 observability recommendations, 2 simulation seeds
Search-Heavy Content Platform
2 watched metrics, 3 observability recommendations, 1 simulation seeds
Search-Heavy Content Platform has lower observability burden: 2 watched metrics vs 8.
Generator Readiness
Read-Heavy SaaS API
generator relevance documented; topology generation relevance noted; simulation relevance noted; 2 seeds with generator notes
Search-Heavy Content Platform
generator relevance documented; topology generation relevance noted; simulation relevance noted; 1 seeds with generator notes
Both scenarios have comparable generator readiness at this stage. Generator support is preliminary. Neither scenario should be treated as fully generation-ready.
Architecture Components
Shared (4)
Only in Read-Heavy SaaS API (3)
Only in Search-Heavy Content Platform (9)
Operational Risks
Shared (1)
Only in Read-Heavy SaaS API (1)
Only in Search-Heavy Content Platform (3)
Consistency Guarantees
Neither scenario has a recorded consistency-guarantee claim.
Neither scenario has recorded a consistency-guarantee claim; no guarantee comparison is possible from the data on record.
Tradeoff Summary
Complexity vs Risk
Read-Heavy SaaS API has moderate complexity. Search-Heavy Content Platform has high complexity. Simpler systems often carry different (not necessarily fewer) risks.
Read-Heavy SaaS API
Read-Heavy SaaS API: 2 risks (top: high), 2 high/critical, 2 confirmed by simulation
Search-Heavy Content Platform
Search-Heavy Content Platform: 4 risks (top: high), 2 high/critical, 0 confirmed by simulation
Scaling Path
Read-Heavy SaaS API offers 4 defined scaling thresholds. Search-Heavy Content Platform offers 4. More defined paths means clearer evolution steps but also more anticipated growth.
Read-Heavy SaaS API
4 scaling thresholds, 2 migration paths, 9 advisor scaling signals
Search-Heavy Content Platform
4 scaling thresholds, 3 migration paths, 4 advisor scaling signals
Architecture Strengths vs Risks Balance
The advisor identifies strengths and risks grounded in knowledge relationships. A higher strengths-to-risks ratio suggests better mitigation coverage in the current topology.
Read-Heavy SaaS API
5 strengths, 2 risks
Search-Heavy Content Platform
5 strengths, 4 risks
Migration Considerations
Migration Step 1
Read-Heavy SaaS API
Single PostgreSQL, no cache, no pooling → PostgreSQL + PgBouncer + Redis cache
Search-Heavy Content Platform
PostgreSQL full-text search (tsvector) serving all search queries → Elasticsearch for full-text and faceted search, PostgreSQL as source of truth
Both scenarios define a migration step at this stage. Read-Heavy SaaS API: triggered by 'Connection pool exhaustion or p99 read latency > 200ms under'. Search-Heavy Content Platform: triggered by 'Search query p99 > 500ms on full-text queries; faceted navig'.
Migration Step 2
Read-Heavy SaaS API
PostgreSQL + PgBouncer + Redis cache → PostgreSQL + PgBouncer + Redis + streaming read replica
Search-Heavy Content Platform
Synchronous dual-write (application writes to PostgreSQL then Elasticsearch) → Asynchronous CDC-based indexing pipeline (PostgreSQL → WAL CDC → Kafka → Elasticsearch)
Both scenarios define a migration step at this stage. Read-Heavy SaaS API: triggered by 'Primary CPU > 70% during peak read hours'. Search-Heavy Content Platform: triggered by 'Application write latency increasing due to Elasticsearch in'.
Migration Step 3
Read-Heavy SaaS API
No further migration step defined
Search-Heavy Content Platform
Single Elasticsearch cluster serving all query types → Separate read-optimized and write-optimized Elasticsearch indexes
Search-Heavy Content Platform has a defined migration; Read-Heavy SaaS API does not at this stage.
Advisor Notes
Strength: Redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude
Redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude. Key trade-off: Introduces eventual consistency: stale reads possible within TTL window. Operational note: Cache-aside (lazy population) is the dominant integration pattern. Evidence: Cache hit rates of 80–95% observed in production read-heavy APIs.
Strength: Redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude
Redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude. Key trade-off: Introduces eventual consistency: stale reads possible within TTL window. Operational note: Cache-aside (lazy population) is the dominant integration pattern. Evidence: Cache hit rates of 80–95% observed in production read-heavy APIs.
Risk (high): Connection Pool Exhaustion
All database connections in the pool are in use; new requests queue and then time out, causing cascading latency and errors across all dependent services.
Risk (high): Hot Partition
One partition (a database shard, a Kafka topic partition, a Redis hash slot) receives traffic so far above its peers that it saturates while the others sit idle. Aggregate capacity looks healthy, but the hot partition throttles or lags, and everything routed to it degrades. The cause is skew in how keys map to partitions, and the fix depends on whether the skew is spread across many keys or concentrated in one.
Shared Operational Requirements
Both scenarios require: Cache sizing and eviction policy configuration, Minimum team maturity: Experienced Backend Team, PostgreSQL: scenario includes high_write_throughput or write_heavy workload.
Supporting Evidence · 13 items
Limitations
- ·Comparison grounded in YAML knowledge only. Not measured from any production system.
- ·Winner assessments are deterministic heuristics, not absolute recommendations. Context, team preferences, and workload specifics may change the conclusion.
- ·1 seed type(s) across both scenarios do not have execution previews. Risk confirmation for those types is unavailable.
- ·Neither scenario has a recorded consistency-guarantee claim. Guarantee comparison is uninformative for this pair, not silently empty.
Read-Heavy SaaS API is the recommended starting point over Search-Heavy Content Platform
Read-Heavy SaaS API leads on 3 weighted dimension(s): Complexity, Operational Risk, Scalability. Weighted score: 5.5 vs 2.0 for Search-Heavy Content Platform.
Decision Intelligence
Architecture Decision Path
Structured reasoning for choosing between Read-Heavy SaaS API and Search-Heavy Content Platform. Every condition and trigger traces back to comparison dimensions, advisor insights, and topology evidence.
Read-Heavy SaaS API is the recommended starting point over Search-Heavy Content Platform
Read-Heavy SaaS API leads on 3 weighted dimension(s): Complexity, Operational Risk, Scalability. Weighted score: 5.5 vs 2.0 for Search-Heavy Content Platform. The architectures share 4 component(s), reducing migration cost if you switch later. Read-Heavy SaaS API is the operationally simpler choice.
Where to Start
Start with Read-Heavy SaaS API
LeftRead-Heavy SaaS API has lower operational complexity. Starting here reduces risk and cognitive load. Migrate to the more capable architecture only when you hit concrete scaling or feature limits.
Complexity: moderate complexity, 7 nodes, 6 edges, 2 risks, 2 simulation seeds
Migrate when:
- p99 database latency rising; connection wait queue growing; requests timing out with "too many connections" or pool queue full errors → Add PgBouncer connection pooler in transaction mode
- Database CPU > 80% sustained; read query p99 rising; cache miss rate stable but overall latency increasing → Add one or more streaming read replicas; implement lag-aware replica routing
- Redis hit rate < 60%; database read pressure rising despite cache presence; TTL expiry storms visible in Redis monitoring → Expand Redis memory allocation; segment cache by object lifecycle; implement staggered TTL jitter to prevent expiry storms
Decision Flow
Does your team have the operational maturity to run Read-Heavy SaaS API (intermediate rating)?
If Yes
Your team can operate Read-Heavy SaaS API. Continue to Step 2 to refine based on risk tolerance and workload fit.
If No
Prefer the lower-maturity option: right scenario.
Is operational stability and minimising production risk your primary concern over feature richness or scalability ceiling?
If Yes
Prefer Read-Heavy SaaS API: it carries lower operational risk weight per the advisor's assessment.
If No
Proceed to Step 3 to evaluate based on scaling requirements.
Do you expect your load to reach: p99 database latency rising; connection wait queue growing; requests timing out with "too many connections" or pool queue full errors ?
If Yes
Left scenario has more defined scaling evolution paths for this growth pattern.
If No
If you don't expect to hit these scaling signals soon, prefer the simpler architecture and re-evaluate when load patterns become clearer.
Is operational simplicity (fewer moving parts, easier debugging, lower ops burden) more important than maximum architectural capability?
If Yes
Read-Heavy SaaS API is the simpler choice: Read-Heavy SaaS API is simpler: moderate operational complexity with 7 topology nodes vs 13 for Search-Heavy Content Platform.
If No
If capability and scalability ceiling matter more than simplicity, evaluate the higher-complexity scenario against your specific load model.
When to Choose Each Scenario
Read-Heavy SaaS API
LeftWhen operational simplicity is a top priority
HighRead-Heavy SaaS API has lower operational complexity: fewer moving parts, easier to reason about and debug.
When stability and predictability matter most
CriticalRead-Heavy SaaS API carries lower overall risk weight per the advisor's assessment.
When you need well-defined scaling thresholds and migration paths
HighRead-Heavy SaaS API has more documented scaling evolution steps (4 thresholds, 2 migration paths).
When your architecture benefits from: redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude
ModerateRedis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude. Key trade-off: Introduces eventual consistency: stale reads possible within TTL window. Operational note: Cache-aside (lazy population) is the dominant integration pattern. Evidence: Cache hit rates of 80–95% observed in production read-heavy APIs.
When your architecture benefits from: a connection pool bounds the total database connections an application can open, preventing connection storms during traffic…
ModerateA connection pool bounds the total database connections an application can open, preventing connection storms during traffic spikes and protecting the database server from exceeding its connection limit. Key trade-off: Pooler becomes a new single point of failure if not replicated. Operational note: PgBouncer transaction-mode pooling is most effective for stateless APIs. Evidence: PgBouncer reduces PostgreSQL connections by 10–100x in typical deployments.
Search-Heavy Content Platform
RightWhen you want to minimise monitoring setup overhead
ModerateSearch-Heavy Content Platform has a lower observability burden: fewer watched metrics and monitoring targets.
When your architecture benefits from: redis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude
ModerateRedis caching absorbs repeated read requests at the edge, reducing database load and latency for high read-to-write ratio workloads by orders of magnitude. Key trade-off: Introduces eventual consistency: stale reads possible within TTL window. Operational note: Cache-aside (lazy population) is the dominant integration pattern. Evidence: Cache hit rates of 80–95% observed in production read-heavy APIs.
When your architecture benefits from: redis distributed locks (via set nx ex or redlock) prevent thundering herd by ensuring only one caller repopulates a cache entry…
ModerateRedis distributed locks (via SET NX EX or Redlock) prevent thundering herd by ensuring only one caller repopulates a cache entry at a time, with other callers either waiting or returning a stale value until the cache is warm. Key trade-off: Distributed locking adds one Redis round-trip to every cache miss that triggers population. Operational note: Lock TTL must be set longer than the cache population time: if it expires before population completes, lock is acquired again. Evidence: Redis SET key value NX EX ttl atomically sets a lock only if absent: enables single-caller cache population.
When to Avoid Each Scenario
Read-Heavy SaaS API
LeftWhen your team cannot mitigate: connection pool exhaustion
HighThis architecture is significantly exposed to Connection Pool Exhaustion. All database connections in the pool are in use; new requests queue and then time out, causing cascading latency and errors across all dependent services.
When your team cannot mitigate: replication lag cascade
HighThis architecture is significantly exposed to Replication Lag Cascade. Asynchronous replicas fall behind the primary under write load and serve reads from an older version of the data. Reads keep succeeding, so nothing errors; what breaks is one of three specific consistency guarantees (read-after-write, monotonic reads, or consistent prefix), each with a distinct user-visible anomaly.
When you expect rapid growth within the next 12–18 months
ModerateThe advisor identifies 4 predicted bottlenecks for Read-Heavy SaaS API. Rapid growth will surface these limitations quickly.
Search-Heavy Content Platform
RightWhen your team cannot mitigate: hot partition
HighThis architecture is significantly exposed to Hot Partition. One partition (a database shard, a Kafka topic partition, a Redis hash slot) receives traffic so far above its peers that it saturates while the others sit idle. Aggregate capacity looks healthy, but the hot partition throttles or lags, and everything routed to it degrades. The cause is skew in how keys map to partitions, and the fix depends on whether the skew is spread across many keys or concentrated in one.
When your team cannot mitigate: thundering herd (cache stampede)
HighThis architecture is significantly exposed to Thundering Herd (Cache Stampede). When a popular cached key expires or a service recovers from downtime, all requests that were waiting or arrive simultaneously miss the cache and hit the origin database concurrently, producing a request spike that can overwhelm the database within seconds.
When you expect rapid growth within the next 12–18 months
ModerateThe advisor identifies 5 predicted bottlenecks for Search-Heavy Content Platform. Rapid growth will surface these limitations quickly.
Team Fit
Solo developer or small startup
LeftRead-Heavy SaaS API is more accessible for small teams. Fewer operational moving parts reduces on-call burden.
- ↳Validate that the simpler architecture can handle your projected load before committing.
Small product team (2–6 engineers)
LeftRead-Heavy SaaS API suits small teams that need to move fast without deep platform tooling investment.
- ↳Consider Search-Heavy Content Platform only if your workload pattern specifically requires it.
Experienced backend team
DependsAn experienced team can operate either architecture. Choose based on workload fit, not team capability.
- ↳Prioritise alignment with existing infrastructure and tooling.
- ↳Search-Heavy Content Platform may require additional runbook coverage and alerting investment.
Platform engineering team or SRE-equipped organisation
RightA platform team can safely operate Search-Heavy Content Platform and will benefit from its more advanced scaling characteristics.
- ↳Ensure observability and alerting are configured before launch.
Migration Triggers
Migration Step 1
Both scenarios define a migration step at this stage. Read-Heavy SaaS API: triggered by 'Connection pool exhaustion or p99 read latency > 200ms under'. Search-Heavy Content Platform: triggered by 'Search query p99 > 500ms on full-text queries; faceted navig'.
Migration Step 2
Both scenarios define a migration step at this stage. Read-Heavy SaaS API: triggered by 'Primary CPU > 70% during peak read hours'. Search-Heavy Content Platform: triggered by 'Application write latency increasing due to Elasticsearch in'.
Migration Step 3
Search-Heavy Content Platform has a defined migration; Read-Heavy SaaS API does not at this stage.
p99 database latency rising; connection wait queue growing; requests timing out with "too many connections" or pool queue full errors
Tier 1: Connection Exhaustion: Database connection pool saturated or max_connections exceeded. Recommended evolution: Add PgBouncer connection pooler in transaction mode.
Database CPU > 80% sustained; read query p99 rising; cache miss rate stable but overall latency increasing
Tier 2: Read Throughput Ceiling: Single PostgreSQL primary saturated with read traffic. Recommended evolution: Add one or more streaming read replicas; implement lag-aware replica routing.
Elasticsearch index CDC consumer lag > 10s; search results showing items that no longer exist or missing recently published items; CDC connector health dashboard showing processing rate below write rate
Tier 1: Index Freshness Degradation: CDC consumer or Elasticsearch bulk indexer not keeping pace with PostgreSQL write rate. Recommended evolution: Increase Elasticsearch bulk indexer thread count; tune bulk index batch size and flush interval; profile CDC connector bottleneck (network vs Elasticsearch write throughput vs mapping complexity) .
Elasticsearch JVM heap usage > 75% sustained; GC pause events visible in cluster logs; query p99 latency spikes during GC; cluster health showing yellow (unassigned shards during GC recovery)
Tier 2: Search Cluster Heap Pressure: Large aggregation queries or high document count per shard exceeding JVM heap budget. Recommended evolution: Increase Elasticsearch heap to 50% of node RAM (max 30GB for ZGC); reduce shard count to keep per-shard document count < 50M; disable dynamic mapping and explicitly define all field types; move to doc values for all non-analyzed fields .
Readiness Requirements
Cache sizing and eviction policy configuration
BothRedis or equivalent cache requires correct maxmemory configuration, eviction policy selection (allkeys-lru is common), and cold-start warming strategy after restarts.
Minimum team maturity: Experienced Backend Team
BothThis scenario has moderate operational complexity. It is recommended for Experienced Backend Team teams or higher.
Required maturity: experienced_backend_team
PostgreSQL: scenario includes high_write_throughput or write_heavy workload
BothDeploy PgBouncer in transaction-mode pooling before relying on vertical scaling
Required maturity: mid_level
Redis: scenario has read_heavy workload with high cache miss risk
BothImplement cache stampede protection (probabilistic early expiry or locking) to prevent thundering herd on cold start
Required maturity: junior
Redis: scenario relies on Redis for data that cannot be re-derived
BothRedis is not a durable store: add persistence layer or treat Redis as expendable cache only
Required maturity: junior
Runbooks and alerting for high-severity risks
Both2 high-severity risks identified. Each requires a documented runbook, alerting threshold, and on-call response procedure before running in production.
Replica lag monitoring and lag-aware routing
LeftRead replicas must be monitored for replication lag. The application router must include a max_lag_ms threshold; queries above that threshold must be redirected to the primary.
Elasticsearch: scenario has full_text_search or log_analytics workload
RightConfigure ILM policies from day one to prevent shard explosion as data grows
Required maturity: senior
Elasticsearch: scenario uses Elasticsearch as a primary datastore
RightElasticsearch is a search index, not a source of truth: add a durable primary store and sync to ES
Required maturity: senior
Elasticsearch: scenario uses dynamic mappings on high-cardinality fields
RightDefine explicit index mappings: dynamic mapping on high-cardinality fields causes mapping explosions and cluster instability
Required maturity: senior
Generator Constraints
Read-Heavy SaaS API
LeftGenerator relevance documented but not yet production-ready.
This scenario is the most common initial architecture for read-heavy SaaS products. The generator should recommend this composition whenever the input brief specifies a read-heavy API workload with moderate consistency requirements. The technology and pattern selections here should be presented as a bundle, not as isolated independent recommendations.
Search-Heavy Content Platform
RightGenerator relevance documented but not yet production-ready.
For content platform or e-commerce product briefs with full-text or faceted search requirements, the generator should propose the PostgreSQL + Elasticsearch + Redis composition. The CDC pipeline should be generated as the canonical indexing path, not synchronous dual-write. Explicit Elasticsearch mapping templates and blue/green alias configuration should be included as mandatory generated artifacts.
Supporting Evidence
| Type | Reference | Explanation |
|---|---|---|
| Comparison | compare_read_heavy_saas_api_vs_search_heavy_content_platform | Full comparison of Read-Heavy SaaS API vs Search-Heavy Content Platform: 6 dimensions, 4 shared components, 1 shared risks. |
| Advisor | advisor_read_heavy_saas_api | Advisor for Read-Heavy SaaS API: 5 strengths, 2 risks, maturity: intermediate. |
| Advisor | advisor_search_heavy_content_platform | Advisor for Search-Heavy Content Platform: 5 strengths, 4 risks, maturity: intermediate. |
| Scenario | read_heavy_saas_api | Scenario 'Read-Heavy SaaS API': 4 scaling thresholds, 2 migration paths, complexity: moderate. |
| Scenario | search_heavy_content_platform | Scenario 'Search-Heavy Content Platform': 4 scaling thresholds, 3 migration paths, complexity: high. |
| Risk Path | prop_technology_profile_redis_risk_connection_exhaustion | Redis → Connection Pool Exhaustion |
| Risk Path | prop_architecture_pattern_read_replica_risk_replication_lag_cascade | Read Replica → Replication Lag Cascade |
| Risk Path | prop_technology_profile_redis_risk_thundering_herd | Redis → Thundering Herd (Cache Stampede) |
| Risk Path | prop_technology_profile_redis_risk_connection_exhaustion | Referenced by the operational risk comparison dimension. |
| Risk Path | prop_architecture_pattern_read_replica_risk_replication_lag_cascade | Referenced by the operational risk comparison dimension. |
Limitations
- ·Decision guidance is grounded in YAML knowledge only. Not measured from any production system.
- ·Recommendations are deterministic heuristics based on structured knowledge. Your specific workload, team profile, and business context may lead to different conclusions.
- ·Generator constraints are preliminary. No scenario should be treated as production generation-ready at this stage.
Comparison complete
Profile, topology, simulation, advisor, comparison, and decision path are ready. Your architecture decision is grounded in structured knowledge and deterministic reasoning.