Repair Detail Page

Repair Detail Page

The Repair Detail page provides a comprehensive view of a single repair record, including the visual workflow stepper, contextual action buttons, and all associated data organised into a two-column layout.

Header

The page header displays the repair number (e.g. RPR-2026-0042), a colour-coded status chip matching the current workflow stage, and an Edit button to open the repair form.

RepairWorkflow Stepper

The RepairWorkflow component renders a horizontal stepper showing 6 primary stages: Reported → Diagnosed → Awaiting Parts → In Repair → Testing → Completed. The current stage is highlighted in the status colour, and all preceding stages show green checkmarks. The stepper emits a status-changed event when a transition occurs.

Workflow Actions Card

Displayed only when the repair is not in a terminal state (completed or cancelled). The available buttons change dynamically based on the current status:

Current Status	Available Actions
Reported	“Diagnose Issue” (primary), “Send to External Vendor” (info)
Diagnosed	“Start Repair” (success); “Request Approval” (warning) — shown only when estimated_cost exceeds £500
Awaiting Approval	“Approve Repair” (success), “Reject” (outlined error)
Awaiting Parts	“Parts Arrived — Start Repair” (primary)
In Repair	“Complete Repair” (success), “Waiting for Parts” (outlined warning)
Testing	“Pass Quality Check” (success), “Fail Quality Check” (outlined error)

Two actions are available regardless of status:

• Cancel Repair — Error text button; opens a confirmation dialog requiring a cancellation reason (cancellation_reason)
• Download External Repair Form — PDF download button; visible only when external_vendor_id is set

Left Column (8 cols)

Repair Details Card

• Equipment name, model, and image
• Priority chip with icon (e.g. mdi-chevron-double-up for Critical)
• Repair type label (e.g. “Corrective Repair”)
• Severity level and problem_description
• Root cause (root_cause) and resolution notes (resolution_notes) when available

Parts Used Table

• Columns: Part Name (part_name), SKU (part_sku), Quantity, Unit Cost, Total Cost
• Each part links to the RepairPart model; warranty items flagged with a chip

Time Tracking Timeline

• Chronological list of time log entries with start/stop times, activity type, and duration

Repair Checklist

• Interactive checklist with per-item tick boxes; overall completion tracked via checklist_completed

Photos & Documents Grid

• Thumbnail grid of uploaded attachments from the attachments JSON array

Right Sidebar (4 cols)

Progress Card — Circular progress indicator showing the status-based percentage (e.g. 60% for in_repair).

Assignment Card — Shows reported_by user, assigned_to technician (or external vendor name and contact).

Timeline Card — Deadline (deadline), estimated hours (estimated_hours), scheduled start/end, and actual start/end dates.

Costs Card — Breakdown of labour cost (labor_cost), parts cost (parts_cost), external cost (external_cost), and combined total (total_cost).

Warranty Card — Claim number (warranty_claim_number), coverage percentage, and approval status (warranty_approved). Visible only when is_under_warranty is true.

Project Link Card — Links to the associated project record when project_id is set.

Dialogs

• Send to External Vendor — Select vendor, enter RMA number, set SLA deadline; updates external_vendor_id and sent_to_vendor_at
• Cancel Repair — Requires a written cancellation_reason (max 500 characters); records cancelled_by and cancelled_at