Limit schedule¶
A limit schedule declares a daily flow cap for a
(parent_role, rail_name, direction) triple. Operationally:
"all customer DDAs combined MUST NOT send more than $50M of
outbound ACH on any single business day" or "any single customer
DDA MUST NOT receive more than $20K of inbound ACH on any day".
Each schedule has:
parent_role— the role whose children's flow gets summed up (e.g.DDAControlaggregates every customer DDA). Direct (singleton) caps use the singleton account's role itself.rail_name— which kind of money movement this cap applies to. Caps are per-rail-type, not global.cap— the daily ceiling, expressed as a Money type (currency symbol + amount). The L1limit_breachmatview surfaces every(account, business_day, rail, direction)cell whose summed flow exceeds this.direction(AB.1, 2026-05-19) — which side the cap watches.Outbound(default) is the classic per-rail send cap; cap is compared against Debit-flow totals (money leaving the child).Inboundis the AML / structuring threshold pattern; cap is compared against Credit-flow totals (money arriving). The same(parent_role, rail_name)pair may carry both an Outbound AND an Inbound schedule — they're separate U5 keys.
The L1 dashboard's Limit Breach sheet shows breach rows, ranked by "how far over the cap", with a Direction column distinguishing Outbound from Inbound rows. A breach is a SHOULD-violation, not necessarily a hard regulatory failure — the bank can choose to honor or block individual transactions; the dashboard's job is to surface the breach so an operator can decide. Routing convention: Outbound breaches typically flow into ops triage queues, Inbound (AML) breaches into the compliance review queue.
Every (parent_role, rail_name, direction) triple MUST be
unique across the schedule list — two schedules keying on the
same triple would silently override each other at matview-emit
time.
Limit schedules are configuration, not topology. They don't appear in the accounts diagram or chains diagram — they're a per-(role, rail_name) ceiling the L1 limit-breach matview consults. The diagram below is a conceptual representation of the mapping rather than an actual graph.