Why this matters
- Teams confuse "async" with "fully decoupled" while sharing brittle protobuf schemas that break three consumers on every deploy.
- Consumer-driven contracts and schema registry compatibility checks catch breaking changes before production.
- ShardPay uses Confluent Schema Registry with BACKWARD compatibility on settlement topics — producers evolve, old consumers keep working.
- Interviewers ask what couplings remain in event-driven architecture and how you govern shared contracts.
Coupling types in event-driven systems
Temporal coupling: caller blocks until callee responds — synchronous REST. Spatial coupling: caller knows host/port of callee. Schema coupling: producer and consumers share event structure; change the schema, break consumers if unmanaged.
ShardPay's TransferCompleted event removes temporal coupling — fraud scores when ready, notifications fan out independently. Spatial coupling is reduced via Kafka bootstrap URLs and service discovery. Schema coupling remains: every consumer deserializes the same Avro record.
Walkthrough: the breaking field rename
A developer renames amountCents to amountMinorUnits without compatibility check. Schema registry rejects in CI — good. An earlier incident before registry adoption deployed rename; three consumers failed deser; settlement pipeline stalled 40 minutes. ShardPay now requires additive-only changes (new optional field) with BACKWARD mode and consumer contract tests in CI.
Key points
- Temporal coupling — caller waits for callee completion; events decouple time by buffering in broker. ShardPay's transfer API returns 202 after ledger commit while
TransferCompletedconsumers process over the next seconds without blocking the user. - Spatial coupling — dependency on network location of service instance; Kafka topic names replace direct URLs but consumers still depend on topic contract and cluster address. ShardPay abstracts cluster via internal DNS; teams depend on topic names in service catalog, not pod IPs.
- Schema coupling — shared structure of payload fields, enums, and semantics.
TransferCompleted.statusenum change affects fraud, settlement, and CRM — governed by registry compatibility and design review for enum extensions only. - Consumer-driven contract — consumers publish expected schema fixtures; CI verifies producer compatibility. ShardPay's fraud team owns contract test for
TransferCompleted; ledger PRs must pass fraud's fixture suite before merge. - Event notification vs event-carried state transfer — thin events (ID only) reduce schema coupling but increase temporal/API coupling via callback lookups. ShardPay uses event-carried state for settlement amounts to keep projectors autonomous during fraud API outages.
The rest of this guide is part of Pro
Free covers every fresher guide in full. Pro unlocks Senior, Staff and Architect guides across every track.
Still to come · 2 sections
- Versioning and compatibility rules
- Avoiding the distributed monolith
Test yourself
Answer these before moving on — recall is what makes it stick.