ADR-051: EventBridge bus naming — hyphen-separated names matching repo pattern¶
| Status | Accepted |
| Date | 2026-05-01 |
| Deciders | CTO, Head of Platform Engineering |
| Affects repos | bank-core, bank-kyc, bank-aml, bank-payments, bank-credit, bank-risk-platform, bank-platform, bank-app |
Status: Accepted — 2026-05-01
Context¶
ADR-029 established EventBridge as the domain event bus with one custom bus per system domain. The bus naming table in ADR-029 contained an internal inconsistency: most buses were listed with dot-separated names (bank.core, bank.kyc, bank.payments, etc.) while SD03 was listed with a hyphen (bank-aml). MOD-104 (the AWS bootstrap module, status: Built) provisioned all eight buses using hyphen-separated names matching the repo names: bank-core, bank-kyc, bank-aml, bank-payments, bank-credit, bank-risk-platform, bank-platform, bank-app. All SSM paths in MOD-104 use the hyphen form (e.g. /bank/{env}/eventbridge/bank-payments/arn).
The dot-separated names in ADR-029 were never deployed. The inconsistency in ADR-029 (some dots, some hyphens) would cause confusion for any agent or engineer reading the ADR alongside the deployed stack. This ADR corrects the naming convention to match the deployed reality.
All other decisions in ADR-029 — one bus per system domain, SQS dead-letter queues on all rule targets, schema registry governance, synchronous calls via direct Lambda invocation — remain in full force and are not changed by this ADR.
Decision¶
EventBridge custom bus names use hyphen-separated lowercase, matching the repository name pattern exactly:
| Bus name | Owner domain | Repo |
|---|---|---|
bank-core |
SD01 Core Banking | bank-core |
bank-kyc |
SD02 KYC Platform | bank-kyc |
bank-aml |
SD03 AML Monitoring | bank-aml |
bank-payments |
SD04 Payments | bank-payments |
bank-credit |
SD05 Credit | bank-credit |
bank-risk-platform |
SD06 Risk Platform | bank-risk-platform |
bank-platform |
SD07 Data Platform | bank-platform |
bank-app |
SD08 App | bank-app |
SSM paths follow the same pattern: /bank/{env}/eventbridge/{bus-name}/arn.
Event source strings and event detail-type values use dot-separated notation (bank.core.account_status_changed) as defined in the event catalogue. Bus names and event naming conventions are orthogonal: the bus uses hyphens; the event source uses dots.
Consequences¶
Positive: - Bus names are unambiguous — they match the repo name exactly, making it trivial to identify which team owns which bus without consulting a mapping table. - SSM paths are predictable: given a repo name, the bus ARN path can be derived mechanically. - Removes the dot/hyphen inconsistency in ADR-029 that was causing confusion for build agents reading the ADR alongside deployed infrastructure.
Negative: - None. MOD-104 is already deployed with hyphen names; no infrastructure change is required. The correction is documentation-only.
All ADRs
Compiled 2026-05-22 from source/entities/adrs/ADR-051.yaml