Creating a Repair

Creating a Repair

NexusRMS offers two creation paths for logging a new repair: a multi-step wizard (Create.vue) for guided entry, and a tab-based form (CreateRepair.vue) for experienced users who prefer to jump between sections. Both paths create the same Repair record.

Tab-Based Form — 6 Tabs

Tab 1: General

• Equipment — Autocomplete search across all equipment items (equipment_id)
• Serial Number — Shown conditionally when the selected equipment uses serial tracking (equipment_serial_id)
• Quantity Affected — For bulk (non-serialised) equipment; defaults to 1 (quantity_affected)
• Project Link — Optional link to the project where damage occurred (project_id)
• Priority — Required; 5 levels with colour icons: Low (grey, mdi-chevron-down), Medium (info, mdi-minus), High (warning, mdi-chevron-up), Critical (error, mdi-chevron-double-up), Emergency (error, mdi-fire)
• Severity — Required; minor, moderate, major, or critical (severity)
• Usable During Repair — Switch toggle; defaults to on (equipment_usable_during_repair)
• Repair Type — Default: corrective. Options: corrective, preventive, inspection, upgrade, recall, warranty (repair_type)

Tab 2: Diagnosis

• Problem Description — Required; minimum 10 characters (problem_description)
• Failure Type — Required; one of: mechanical, electrical, software, wear_and_tear, user_error, environmental, unknown (failure_type)
• Location During Repair — Required; on_site, workshop, external_vendor, or warehouse (location_during_repair)
• Estimated Hours — Numeric input in 0.5 increments (estimated_hours)
• Estimated Cost — Currency input with £ prefix (estimated_cost)

Tab 3: Assignment

Choose between Internal Technician or External Vendor via a radio group (assignment_type).

Internal assignment:

• Technician autocomplete showing active repair count per user (assigned_to)
• Scheduled start and end dates via VueDatePicker (scheduled_start_date, scheduled_end_date)
• Deadline date (deadline)

External vendor assignment:

• Vendor autocomplete from Suppliers list (external_vendor_id)
• RMA number (external_tracking_number)
• Expected return date (external_sla_deadline)
• External cost (external_cost)
• External notes and vendor contact card

Tab 4: Parts

• Add Part — Dialog with parts autocomplete and quantity input
• Parts Table — Columns: Part Name (part_name), SKU (part_sku), Qty (quantity), Unit Cost (unit_cost), Total (total_cost)
• Stock Warning — A chip appears if the part has fewer than 5 units in stock
• Footer — Displays the combined parts cost total

Tab 5: Client Charging

• Billable to Client — Switch toggle (billable_to_client); when enabled, additional fields appear
• Client — Autocomplete from Clients list (client_id)
• Charged Amount — Currency field with £ prefix (charged_amount)
• Chargeback Reason — Select: Client Damage (client_damage), Misuse (misuse), Lost Equipment (lost), Late Return Damage (late_return), Other (other)

Warranty section:

• Under Warranty — Switch toggle (is_under_warranty)
• Warranty Claim Number — Text field, e.g. WCN-2025-12345 (warranty_claim_number)
• Warranty Coverage — Slider from 0% to 100% in 5% increments (warranty_coverage_percentage)

Tab 6: Attachments

• Drag-and-Drop Dropzone — Accepts images, PDFs, and Word documents
• File Thumbnails — Preview grid for uploaded files
• Tags — Combobox for applying custom tags (tags)
• Internal Notes — Free-text area for private team notes

Validation & Auto-Save

Each tab header shows a red border and warning icon if required fields within that tab are incomplete. The General tab requires equipment_id, priority, and severity. The Diagnosis tab requires problem_description (min 10 chars), failure_type, and location_during_repair.

An auto-save indicator in the toolbar confirms that your draft is periodically saved. If you navigate away and return, a draft restore dialog offers to reload your unsaved data.