Dispute Outcome Post-Adjudication Summary & AI Feedback

When a dispute is resolved and an adjudication outcome is recorded, the platform automatically notifies the agent with a structured lessons-learned summary and feeds the result back into the AI assessment system.

Overview

This workflow is triggered by the dispute_outcome.recorded event, which fires every time a new row is created in disputeOutcomes. No manual action is required — everything runs automatically once the outcome is logged.

What agents receive

Once an adjudication outcome is recorded against a deposit release, the agent responsible for that release receives:

In-app notification

A structured notification appears in the platform dashboard, including:

Field	Description
Awarded categories	Deduction categories where the adjudicator ruled in the landlord/agent's favour
Rejected categories	Deduction categories that were not upheld
Award ratio	The proportion of the total claimed amount that was granted
Reasoning tags	Structured tags from the adjudicator explaining the basis for each decision

Email summary

The same structured summary is delivered by email, ensuring agents have a persistent record outside the platform.

How it improves future AI assessments

Alongside the agent notification, the workflow fires an ai.feedback.dispute_outcome event. The AI assessment system consumes this event to:

• Learn which deduction categories and evidence types are more or less likely to be upheld at adjudication.
• Refine the confidence scores and recommendations it surfaces during future deposit release assessments.
• Reduce the likelihood of agents raising deductions that adjudicators consistently reject.

This creates a continuous improvement loop: each resolved dispute makes the AI's future suggestions more accurate and better aligned with real adjudication outcomes.

Event reference

Event	Direction	Description
dispute_outcome.recorded	Inbound trigger	Raised when a disputeOutcomes row is created
ai.feedback.dispute_outcome	Outbound	Emitted for consumption by the AI assessment system

Entities involved

• disputeOutcomes — the adjudication record that triggers the workflow
• depositReleases — the release linked to the dispute
• depositReleaseDeductions — individual deduction line items assessed during the dispute
• aiDeductionAssessments — prior AI-generated assessments for those deductions
• tenancies — the tenancy associated with the release
• properties — the property associated with the tenancy
• notifications — stores the in-app notification delivered to the agent
• orgMembers — used to identify and route the notification to the correct agent