Worked case · Reference condition · 12 figures

Minimum system contracts

Create the minimum decision and data contracts

Figure 01 / 12

Determine the eligible population first

Determine the eligible population first — Minimum system contracts. Count; records. Exact values are in the figure data below.
Count; records

Of 18,500 source records, 18,130 are within the stated synthetic scope and 370 are outside it. Eligibility here is an explicit teaching input, not a legal conclusion. Production classification must use the actual entity, product, activity, jurisdiction, and facts.

Figure data and text version
Scope stateRecords
Within stated scope18,130
Outside stated scope370

A product needs stable records for identity, payment intent, decision, ledger effect, case, and evidence. Each record has a responsible writer and reconciliation path.

The reference case starts with the stated population and a functioning evidence path. The owner is platform architect.

All amounts, rates, capacity limits, and outcomes in this case are synthetic. The three conditions are separate assumptions for comparison. A better result in the response condition is not measured proof that the proposed control causes that improvement. The figures expose the calculation and its limits; a real deployment needs its own evidence.

Read the result

The case identifies 18,130 eligible records from a source population of 18,500. The required workflow completes for 17,586, but 264 completed records miss the illustrative internal target. Another 544 remain incomplete. Communication evidence covers 17,410 generated notices. Scope, completion, timeliness, and delivery are four separate properties of the customer outcome.

Model inputs and calculated values

Inputs below are the case-specific values. Each figure states the condition-specific assumptions and units used in its calculation. Calculated values are rounded for display.

InputValue
population18,500
eligibility0.98
Calculated valueResult
population18,500
eligible18,130
excluded370
complete17,586
incomplete544
late264
ontime17,322
notices17,410
undelivered176
pending424
reviewed120
Figure 02 / 12

A control can miss eligible records

A control can miss eligible records — Minimum system contracts. Count at a fixed observation cutoff. Exact values are in the figure data below.
Count at a fixed observation cutoff

The required workflow completes for 17,586 of the 18,130 eligible records. The 544 remainder needs an owned exception path. Reporting completion as a percentage of all source records would answer a different question and could hide the actual coverage gap.

Figure data and text version
MeasureRecords
Eligible records18,130
Workflow completed17,586
Workflow incomplete544
Figure 03 / 12

Completion and timeliness are distinct outcomes

Completion and timeliness are distinct outcomes — Minimum system contracts. Count; exclusive states within eligible population. Exact values are in the figure data below.
Count; exclusive states within eligible population

The illustration applies an internal target, not a statutory deadline. Of 17,586 completed records, 264 miss that target and 17,322 meet it. The 544 open records are a third state; do not automatically classify them as timely merely because their final outcome is unknown.

Figure data and text version
OutcomeEligible records
Complete within target17,322
Complete after target264
Still incomplete544
Figure 04 / 12

An obligation record connects authority to behavior

An obligation record connects authority to behavior — Minimum system contracts. Control contract. Exact values are in the figure data below.
Control contract

This case implements create the minimum decision and data contracts. The record separates scope, trigger, required action, ownership, and retained proof. Exact legal duties belong to the applicable source and interpretation; the timing and counts in this worked example are synthetic.

Figure data and text version
ElementIllustrative value
Control subjectMinimum system contracts
ScopeThe eligible population defined above
TriggerTeams use incompatible identifiers and cannot trace one customer action across systems.
Required behaviorcreate the minimum decision and data contracts
Ownerplatform architect
EvidenceVersioned event, action, and communication records
Figure 05 / 12

Different clocks start from different facts

Different clocks start from different facts — Minimum system contracts. Internal teaching timeline; not a legal deadline schedule. Exact values are in the figure data below.
Internal teaching timeline; not a legal deadline schedule

These relative times are illustrative service targets. They deliberately distinguish customer contact, receipt by the institution, classification, investigation, and communication. A routing delay must not silently replace the original receipt time when that fact matters.

Figure data and text version
EventIllustrative timeRecord
Customer reportT0Original channel and words
Institution receiptT0 + 5 minutesRetained receipt timestamp
ClassificationT0 + 20 minutesApplicable process and owner
Internal review targetT0 + 1 dayInternal target only
Outcome communicationAt decisionContent, destination, and delivery state
Figure 06 / 12

Evidence fields fail independently

Evidence fields fail independently — Minimum system contracts. Count; overlapping field-level checks. Exact values are in the figure data below.
Count; overlapping field-level checks

Each row is one evidence requirement over the eligible population. The same record can fail several checks, so the absent counts across rows must not be added as though they were distinct customers. Completeness does not itself prove that a field is accurate.

Figure data and text version
Evidence fieldPresentAbsent
scope17,949181
trigger18,03991
action17,767363
notice17,949181
evidence17,677453
Figure 07 / 12

A generated notice is not a delivered notice

A generated notice is not a delivered notice — Minimum system contracts. Count; generated equals delivered plus unresolved. Exact values are in the figure data below.
Count; generated equals delivered plus unresolved

17,586 completed records generate a modeled notice event. 17,410 have a delivered state and 176 do not. The system must distinguish generation, dispatch, delivery evidence, and any required follow-up under the actual process.

Figure data and text version
Communication stateNotices
Generated17,586
Delivered state recorded17,410
Delivery unresolved176
Figure 08 / 12

Authority differs by operation

Authority differs by operation — Minimum system contracts. Illustrative permission matrix. Exact values are in the figure data below.
Illustrative permission matrix

The access matrix is a proposed teaching separation of duties. Read, propose, approve, and administer are distinct capabilities. The final policy must match the organization’s actual roles and obligations, with controlled emergency access and an audit trail.

Figure data and text version
RoleRead evidencePropose actionApprove release
platform architectScopedYesNo
Independent approverScopedNoYes
SupportLimitedRequest onlyNo
System administratorOperational logsNoNo
Figure 09 / 12

Exceptions need capacity and a closing state

Exceptions need capacity and a closing state — Minimum system contracts. Records per observation window. Exact values are in the figure data below.
Records per observation window

The control has 544 incomplete records. The available exception capacity covers 120, leaving 424 pending. A pending state requires an owner and a next action; changing a status label without resolving the required behavior does not close the gap.

Figure data and text version
Queue itemRecordsMeaning
Exceptions opened544Eligible workflow incomplete
Capacity applied120Records handled in this window
Pending exceptions424Still require an owned response
Figure 10 / 12

A rate includes its denominator

A rate includes its denominator — Minimum system contracts. Percent; named populations. Exact values are in the figure data below.
Percent; named populations

These rates deliberately use different populations. Overall throughput, eligible coverage, completed-record timeliness, and delivery evidence are not interchangeable. Each needs the same cohort, cutoff, and definition every time it is compared.

Figure data and text version
MetricNumeratorDenominatorPercent
Eligible coverage17,58618,13097
On-time among completed17,32217,58698.5
On-time among eligible17,32218,13095.54
Delivered among generated17,41017,58699
Figure 11 / 12

A change needs an evidence trail

A change needs an evidence trail — Minimum system contracts. Control-change lifecycle. Exact values are in the figure data below.
Control-change lifecycle

The trigger is Teams use incompatible identifiers and cannot trace one customer action across systems.. A controlled change connects the revised requirement or interpretation to implementation, replay, customer impact, and approval. The old version remains relevant to decisions already made under it.

Figure data and text version
StageRetained proof
InterpretScope, source, effective date, and owner
ImplementVersioned logic, data contract, and message template
VerifyBoundary cases and affected-population comparison
ReleaseApproval, start time, and rollback condition
CorrectAffected records and customer outcome where required
Figure 12 / 12

Correction follows the affected population

Correction follows the affected population — Minimum system contracts. Illustrative correction responsibilities. Exact values are in the figure data below.
Illustrative correction responsibilities

A remediation map links the defect to affected records, financial consequences, communication, and closure evidence. It should retain exclusions and unresolved cases. A change that prevents future failures does not by itself correct earlier customer outcomes.

Figure data and text version
FromToRelationship
Minimum system contractsAffected populationReproducible query
Affected populationFinancial reviewAmount and balance impact
Affected populationCustomer messageRequired communication
Financial reviewClosure evidenceVerified adjustment
Customer messageClosure evidenceDelivery and follow-up

Connect the result to the system

Define shared identifiers, state transitions, ownership, and the minimum audit fields.

Check the population, evidence, permitted action, and actual effect together. A balanced calculation can still use the wrong population; a successful response can still leave an unknown financial outcome. The case’s numerical result applies only to its stated assumptions.

Sources and further reading

The chapter sources support the concepts and scope. They do not prescribe the synthetic model rates.

  1. OCC Comptroller’s Handbook: merchant processing
  2. Federal Reserve SR 23-4: third-party relationships
  3. OFAC: A Framework for Compliance Commitments
  4. Federal Reserve SR 26-2: revised model-risk guidance (2026)