Contextual Deep-Link CTAs Between Workflow Stages

Available from: v0.1.112

The check-out → deduction claim → deposit release workflow now has direct, tenancy-scoped navigation links at every handoff point. Agents no longer need to navigate through list pages to move between stages.

Overview

The tenancy end workflow spans three distinct stages:

Check-out report — document the property's condition at the end of tenancy
Deduction claim builder — itemise and justify any deposit deductions
Deposit release — process and settle the deposit, including any negotiation

Previously, there were no direct links between these stages. Each required agents to return to a list page and locate the correct record. This release closes those gaps.

Feature details

1. Post-finalisation action banner on the check-out report

When you finalise a check-out report, an action banner appears at the top of the report:

┌─────────────────────────────────────────────────────────┐
│ Report finalised — ready to claim deductions?           │
│                          [ Build Deduction Claim → ]    │
└─────────────────────────────────────────────────────────┘

The Build Deduction Claim → button links to /dashboard/deductions/[tenancyId]
The link is scoped to the specific tenancy, so you land directly on the correct deduction builder
The banner only appears after the report has been finalised

2. Scoped "Go to Deposit Release" link in the deduction builder

In the right sidebar of the deduction claim builder, the Go to Deposit Release link now points to the specific tenancy's deposit release tab rather than the generic list page.

Previous behaviour:

/dashboard/deposit-release

New behaviour:

/dashboard/tenancies/[id]?tab=deposit-release

This means clicking the link takes you directly to the deposit release record for that tenancy, with no additional searching required.

3. "View negotiation thread" link in the deposit release panel

When a negotiation thread is linked to a deposit release, a View negotiation thread link is now displayed within the deposit release panel.

The link is only shown when a thread exists — if no negotiation thread has been started, the link does not appear
This gives agents a one-click path into the relevant negotiation without leaving the deposit release context

Workflow walkthrough

[Check-out report finalised]
        │
        ▼
[ Action banner: Build Deduction Claim → ]  ──▶  /dashboard/deductions/[tenancyId]
                                                          │
                                                          ▼
                                          [ Sidebar: Go to Deposit Release ]  ──▶  /dashboard/tenancies/[id]?tab=deposit-release
                                                                                              │
                                                                                             (if thread exists)
                                                                                              ▼
                                                                               [ View negotiation thread ]

Notes

No changes were made to data models or APIs — this is a navigation-only update
All links are tenancy-scoped; following a link will never take you to a different tenancy's records
The negotiation thread link in the deposit release panel is conditional and only renders when a thread is associated with that release