Financial Domain Modeling Readme
Practical entries
Start with the financial question and the results already established. To explain what a service contributed, you may need an account of a position or event. A newly established payment may require revising an earlier claim about what funds were available. Use the Table of Contents to go directly to a method. The cases below show how to combine them.
FDM is the reference code for this framework. FDM.3:4.2 identifies section 4.2 of pattern 3. You can apply the methods yourself or ask an agent to model the case or explain it in the language of your work. The examples stipulate their terms and facts. For an actual arrangement, use the applicable financial and institutional interpretation.
FDM-E1 — A score is presented as a financial benefit
- Situation: A better score is reported as a benefit to a borrower, but the financial change is unclear.
- Question: What did the service change for this participant, and what remains unresolved?
- First useful result or blocker: A supported contribution to the participant’s result, an unchanged financial outcome, or a missing term or event.
- Start with: FDM.5 to examine how the service was used. Use a position or event method if the claimed change depends on a question still open.
- Stop or return: Report the established contribution and any material limit. Reconsider a term, occurrence or link to the participant’s outcome when the conclusion depends on it.
A scoring team improves the accuracy of its output and wants to explain the benefit to a borrower. Use FDM.5 to identify how the score affects the decision. If the applicable rule gives this borrower the same decision and terms at both scores, the gain in accuracy produces no difference through that route. That can answer the question. A claim that the borrower spent less time supplying information requires its own comparison.
Suppose an authorized decision maker uses the new score and changes a lending decision. Use FDM.1 to identify any rights and obligations created under the applicable terms. If the lender’s or borrower’s identity is disputed, use FDM.2 to resolve it. The agreement’s formation conditions determine which duties already exist before funding. To establish whether the funds are usable, follow the funding event.
In this example a valid agreement provides that successful funding of 100 creates a position with 105 due on day 30. Use FDM.3 to derive the contractual flows for each party and FDM.4 to determine what occurred and what it changed. Suppose 60 was paid and applied in full to the amount due, with no further interest or fees. The remaining obligation is 45. Reconcile a record showing 105 unpaid with that effect. The original contractual amount remains 105. If the evidence establishes only an instruction to pay 60, the payment and its effect remain open.
Use FDM.5 to explain what the financial service supplied. Funding may make the agreed proceeds usable even if the equipment bought with them never arrives. Report the funding and the failed delivery in their respective scopes. A later business benefit requires evidence that the financed work produced it.
For unclear terms, use FDM.1 or FDM.3. For a disputed occurrence, use FDM.4. For a gap between the service output and the participant’s result, use FDM.5. In each case, apply a sufficient existing result directly.
FDM-E2 — A group’s cash is used to justify one entity’s payment
- Situation: A group’s cash balance is used to claim that one member can pay a debt.
- Question: Which funds can this entity actually use by the due date?
- First useful result or blocker: The resources available to the entity by the due date and any shortfall, or the particular support term or receipt that remains uncertain.
- Start with: FDM.2 for the payment boundary, then FDM.1 and FDM.3 for support terms and FDM.4 for what occurred.
- Stop or return: Report what the entity could use by the due date. Revisit a conclusion about availability or support if a relevant event or term changes.
X owes 100 on day 7 and has 20 of unrestricted cash available then, after all its other receipts and obligations. Y has 150. X and Y share a founder. Use FDM.2 to distinguish exposure to the founder group from X’s ability to pay. On the supplied facts X is short of 80. Adding the two balances establishes no right or means for X to use Y’s cash.
Suppose Y undertakes to transfer 80 to X before day 7. Use FDM.1 to establish the obligation and its parties and FDM.3 to derive the conditions and timing of the transfer. A guarantee payable to the creditor after X fails and a valid demand is made gives the creditor a conditional recovery route. Performance of that guarantee would pay the creditor. It would not give X cash to make the original day-7 payment. If the terms leave the timing of support open, report that limit.
Use FDM.4 to examine the event that would make the funds usable. A support commitment, transfer permission or sent payment instruction can precede receipt. Suppose Y transfers 60 under its support obligation and X can use it before day 7, with nothing else in the cash account changed. X now has 80 and is short of 20. Y has performed 60 of its commitment of 80. Update X’s payment account with the confirmed receipt. If the deadline is still ahead, receiving the remaining 20 in time remains a conditional scenario until its outcome is established. Revise any conclusion inconsistent with the established events.
The question can end with the amount available or with a precise limit if receipt is unknown. When a financing or payment choice is needed, the responsible party can use that result to compare its options. For portfolio risk, common dependence on the founder may matter even when X cannot use Y’s funds. Keep the group exposure distinct from the cash available to X.