System Diagram

The Claims and Dispute Management data model, mapped — 22 models, 62 relationships

🔍 Open the Interactive Diagram Viewer — pan, mouse-wheel zoom, fit-to-screen, full-screen, per-area tabs, the full ERD, and a focus mode that draws one model and its neighbours at a chosen depth. Claim, DisputeMatter and Person are hub tables, so their links can be hidden to declutter the overview.

Architecture overview

A matter sits under a contract; claims live in the matter; each claim is assessed on entitlement, causation and quantum, evidenced, responded to, negotiated, and — if unresolved — crystallised into a dispute that ends in a determination and/or a settlement.

flowchart LR
    subgraph MATTERS["📁 Matters & contracts"]
        DisputeMatter
        Contract
        ContractClause
        Organisation
        Person
    end
    subgraph CLAIMS["📌 Claims"]
        Claim
        ClaimIssue
        ClaimEvent
        ClaimNotice
    end
    subgraph ASSESSMENT["🧮 Entitlement, causation & quantum"]
        EntitlementAssessment
        CausationAssessment
        QuantumItem
    end
    subgraph EVIDENCE["🔎 Evidence"]
        EvidenceItem
        ClaimEvidenceLink
    end
    subgraph RESOLUTION["⚖️ Responses, negotiation & disputes"]
        Response
        NegotiationRecord
        Dispute
        DisputeClaimLink
        Determination
        Settlement
    end
    subgraph TASKS["✅ Tasks & exceptions"]
        Task
        ExceptionRecord
    end

    Organisation --> Person
    Organisation --> Contract
    Contract --> ContractClause
    Contract --> DisputeMatter
    DisputeMatter --> Claim
    Claim --> ClaimIssue
    Claim --> ClaimEvent
    Claim --> ClaimNotice
    Claim --> EntitlementAssessment
    Claim --> CausationAssessment
    Claim --> QuantumItem
    DisputeMatter --> EvidenceItem
    Claim --> EvidenceItem
    EvidenceItem --> ClaimEvidenceLink
    Claim --> Response
    DisputeMatter --> NegotiationRecord
    DisputeMatter --> Dispute
    Dispute --> DisputeClaimLink
    Claim --> DisputeClaimLink
    Dispute --> Determination
    DisputeMatter --> Settlement
    DisputeMatter --> Task
    DisputeMatter --> ExceptionRecord

Matters & contracts

DisputeMatter is the overarching container, under a Contract and its self-nesting ContractClauses. Organisation and Person are the party directories (a matter names an owner, a legal owner and the opposing organisation).

Claims

Claim carries the claim narrative and its three assessment statuses; ClaimIssue breaks out the points in contention, ClaimEvent records the factual events, and ClaimNotice preserves rights and time bars (inbound and outbound).

Entitlement, causation & quantum

EntitlementAssessment and CausationAssessment are versioned merits assessments; QuantumItem is the line-by-line money build-up with claimed / assessed / agreed amounts.

Evidence

EvidenceItem holds custody, hash, confidentiality and privilege; ClaimEvidenceLink attaches evidence to the claim and issue it supports, with a weight.

Responses, negotiation & disputes

Response is the counterparty's position; NegotiationRecord logs without-prejudice movement; Dispute is the crystallised dispute in a forum, linked to its claims via DisputeClaimLink, resolved by a Determination and/or a Settlement.

Tasks & exceptions

Task tracks follow-ups; ExceptionRecord captures time-bar, privilege and completeness risks across matters, claims and disputes.

Regenerating this diagram

The interactive viewer is generated — after any DSL, menu_config.yaml or schema/diagram_config.yaml change, re-run:

python scripts/build_diagram_viewer.py dispute