What's New: Pre-Flight Checklist & Completion Gate for Check-Out Reports
What's New: Pre-Flight Checklist & Completion Gate for Check-Out Reports
Release: v0.1.186
Finalising a check-out report is irreversible. From the moment a report is locked it becomes the primary evidence record for any deposit deduction — which means an incomplete report, locked by mistake, is a serious problem. This release adds two safeguards that make it much harder to finalise a report before it's ready.
The Problem
The Finalise Report button was previously enabled any time a report contained at least one item, regardless of how many of those items had actually been rated or had photos attached. The confirmation dialog surfaced warnings about deteriorated items and an amber caution banner, but gave no indication of how much work was still outstanding. Agents working quickly — or handing off a report mid-session — could lock a near-empty report with no friction.
What's New
1. Pre-Flight Checklist in the Finalise Dialog
When an agent clicks Finalise Report, the confirmation dialog now shows a structured checklist before they can commit:
| Check | Green ✓ | Amber ⚠ |
|---|---|---|
| Items rated | All (or ≥ 50 %) rated | Fewer than 50 % rated |
| Photos attached | Every rated/flagged item has a photo | One or more items lack photos |
| Rooms fully assessed | All rooms have ≥ 1 rated item | One or more rooms have 0 rated items |
The checklist is shown every time the dialog opens, giving agents a clear picture of what still needs attention before locking.
2. Completion Gate on 'Finalise & Lock'
The Finalise & Lock button is now disabled when fewer than 50 % of the report's items have been rated. A tooltip on the disabled button explains the requirement and prompts the agent to return to the incomplete rooms.
The button re-enables automatically as soon as the 50 % threshold is crossed — there is no manual override required once the condition is met.
3. SummaryBar Moved to the Page Header
The completion summary (rated vs. total items) now appears directly alongside the Finalise button in the page header row. Previously the SummaryBar was displayed in a separate section of the page, meaning an agent would have to scroll or look away to check overall progress before finalising. Collocating them removes that friction entirely.
Who Is Affected
- Letting agents using the Check-Out Report Builder — the finalise flow now requires a minimum completion level.
- Landlords — benefit from stronger evidence quality in finalised reports.
- Tenants — greater confidence that a locked report represents a genuine, thorough inspection.
Compliance Context
Under the Renters' Rights Act, deposit deductions must be substantiated by clear evidence. A finalised report with unrated items or missing photos weakens that evidence base. These guardrails help ensure that every locked report meets a baseline standard of completeness before it can be used in a deduction or dispute workflow.
Notes for Agents
- Reports with fewer than 50 % of items rated cannot be finalised. Use the pre-flight checklist to identify which rooms need attention.
- The 50 % threshold applies to the total item count across the whole report, not per-room.
- Amber warnings in the checklist (missing photos, empty rooms) are advisory — they do not block finalisation on their own, but they are logged against the report.
- Once finalised, a report remains immutable. There is no undo.