Work Queue: Guided 'Next Step' CTAs on Tenancy Cards

Available from: v0.1.209

Overview

The Work Queue displays all active tenancies as cards, each with a progress bar showing the three-stage workflow: Check-in → Check-out → Deposit. From v0.1.209, each card also shows a context-aware action button that tells you — and links you to — the exact next step needed for that tenancy.

How it works

When the Work Queue loads, the server computes the next outstanding action for every tenancy and attaches a nextStep object to each row. The card CTA is then driven entirely by that computed value rather than a static label.

Workflow stages and their CTAs

Current state	Button shown
Check-out not yet started	Start Check-Out
Check-out finalised, deductions not recorded	Create Deductions
Deductions recorded, deposit not released	Release Deposit

Clicking the button takes you directly to the correct page for that stage — no additional navigation required.

What changed technically

• The workQueue tRPC router now includes a nextStep: { label: string; href: string } field on every TenancyRow returned to the client.
• The TenancyCard component in work-queue.tsx reads nextStep.label and nextStep.href to render the primary CTA, replacing the previously hardcoded 'Prepare' / 'Start report' strings.
• The workflow progress bar (Check-in → Check-out → Deposit) is unchanged and continues to show completion status at a glance.

Benefits

• No guesswork. The button always reflects where the tenancy actually is in the process.
• Fewer missed steps. Agents can work through a queue sequentially without needing to open each tenancy to figure out what to do.
• Consistent compliance. Every deposit release is preceded by the correct check-out and deductions stages, keeping you aligned with the Renters' Rights Act.

Related pages

• Changelog