Feature: Backend scaffolding for Repair Orders (#12064)

src/backend/InvenTree/generic/states/tests.py

@@ -232,8 +232,8 @@ def test_all_states(self):
         """Test the API endpoint for listing all status models."""
         response = self.get(reverse('api-status-all'))
 
-        # 11 built-in state classes, plus the added GeneralState class
-        self.assertEqual(len(response.data), 12)
+        # 12 built-in state classes, plus the added GeneralState class
+        self.assertEqual(len(response.data), 13)
 
         # Test the BuildStatus model
         build_status = response.data['BuildStatus']
@@ -273,7 +273,7 @@ def test_all_states(self):
         )
         response = self.get(reverse('api-status-all'))
 
-        self.assertEqual(len(response.data), 12)
+        self.assertEqual(len(response.data), 13)
 
         stock_status_cstm = response.data['StockStatus']
         self.assertEqual(stock_status_cstm['status_class'], 'StockStatus')

src/backend/InvenTree/order/admin.py

@@ -208,3 +208,34 @@ class TransferOrderAdmin(admin.ModelAdmin):
         'project_code',
         'responsible',
     ]
+
+
+@admin.register(models.RepairOrder)
+class RepairOrderAdmin(admin.ModelAdmin):
+    """Admin class for the RepairOrder model."""
+
+    list_display = ['reference', 'customer', 'status', 'description']
+
+    search_fields = ['reference', 'customer__name', 'description']
+
+    autocomplete_fields = ['customer']
+
+
+@admin.register(models.RepairOrderLineItem)
+class RepairOrderLineItemAdmin(admin.ModelAdmin):
+    """Admin class for RepairOrderLineItem model."""
+
+    list_display = ['order', 'part', 'quantity']
+
+    search_fields = ['order__reference', 'part__name', 'part__IPN']
+
+    autocomplete_fields = ['order', 'part']
+
+
+@admin.register(models.RepairOrderAllocation)
+class RepairOrderAllocationAdmin(admin.ModelAdmin):
+    """Admin class for RepairOrderAllocation model."""
+
+    list_display = ['line', 'item', 'quantity']
+
+    autocomplete_fields = ['line', 'item']

src/backend/InvenTree/order/api.py

@@ -2518,6 +2518,89 @@ def item_link(self, item):
         return construct_absolute_url(item.get_absolute_url())
 
 
+class RepairOrderList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrder objects."""
+
+    queryset = models.RepairOrder.objects.all()
+    serializer_class = serializers.RepairOrderSerializer
+
+
+class RepairOrderDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrder object."""
+
+    queryset = models.RepairOrder.objects.all()
+    serializer_class = serializers.RepairOrderSerializer
+
+
+class RepairOrderLineItemList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrderLineItem objects."""
+
+    queryset = models.RepairOrderLineItem.objects.all()
+    serializer_class = serializers.RepairOrderLineItemSerializer
+
+
+class RepairOrderLineItemDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrderLineItem object."""
+
+    queryset = models.RepairOrderLineItem.objects.all()
+    serializer_class = serializers.RepairOrderLineItemSerializer
+
+
+class RepairOrderAllocationList(ListCreateAPI):
+    """API endpoint for accessing a list of RepairOrderAllocation objects."""
+
+    queryset = models.RepairOrderAllocation.objects.all()
+    serializer_class = serializers.RepairOrderAllocationSerializer
+
+
+class RepairOrderAllocationDetail(RetrieveUpdateDestroyAPI):
+    """API endpoint for detail view of a single RepairOrderAllocation object."""
+
+    queryset = models.RepairOrderAllocation.objects.all()
+    serializer_class = serializers.RepairOrderAllocationSerializer
+
+
+repair_order_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path('', RepairOrderDetail.as_view(), name='api-repair-order-detail')
+        ]),
+    ),
+    path('', RepairOrderList.as_view(), name='api-repair-order-list'),
+]
+
+repair_order_line_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path(
+                '',
+                RepairOrderLineItemDetail.as_view(),
+                name='api-repair-order-line-detail',
+            )
+        ]),
+    ),
+    path('', RepairOrderLineItemList.as_view(), name='api-repair-order-line-list'),
+]
+
+repair_order_allocation_api_urls = [
+    path(
+        '<int:pk>/',
+        include([
+            path(
+                '',
+                RepairOrderAllocationDetail.as_view(),
+                name='api-repair-order-allocation-detail',
+            )
+        ]),
+    ),
+    path(
+        '', RepairOrderAllocationList.as_view(), name='api-repair-order-allocation-list'
+    ),
+]
+
+
 order_api_urls = [
     # API endpoints for purchase orders
     path(
@@ -2906,4 +2989,8 @@ def item_link(self, item):
         OrderCalendarExport(),
         name='api-po-so-calendar',
     ),
+    # Repair Order endpoints
+    path('repair/', include(repair_order_api_urls)),
+    path('repair-line/', include(repair_order_line_api_urls)),
+    path('repair-allocation/', include(repair_order_allocation_api_urls)),
 ]

src/backend/InvenTree/order/migrations/0120_repairorder_repairorderlineitem_and_more.py

@@ -0,0 +1,72 @@
+# Generated by Django 5.2.14 on 2026-06-04 09:58
+
+import InvenTree.fields
+import InvenTree.models
+import django.db.models.deletion
+import generic.states.fields
+import generic.states.states
+import generic.states.transition
+import generic.states.validators
+import order.status_codes
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('company', '0079_auto_20260212_1054'),
+        ('order', '0119_transferorderlineitem_line_int'),
+        ('part', '0150_part_maximum_stock'),
+        ('stock', '0123_remove_stockitem_review_needed'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='RepairOrder',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('metadata', models.JSONField(blank=True, help_text='JSON metadata field, for use by external plugins', null=True, verbose_name='Plugin Metadata')),
+                ('reference_int', models.BigIntegerField(default=0)),
+                ('notes', InvenTree.fields.InvenTreeNotesField(blank=True, help_text='Markdown notes (optional)', max_length=50000, null=True, verbose_name='Notes')),
+                ('barcode_data', models.CharField(blank=True, help_text='Third party barcode data', max_length=500, verbose_name='Barcode Data')),
+                ('barcode_hash', models.CharField(blank=True, help_text='Unique hash of barcode data', max_length=128, verbose_name='Barcode Hash')),
+                ('reference', models.CharField(help_text='Repair Order Reference', max_length=100, unique=True, verbose_name='Reference')),
+                ('description', models.CharField(help_text='Repair order description', max_length=250, verbose_name='Description')),
+                ('symptoms', models.TextField(blank=True, help_text='Reported symptoms or issues', verbose_name='Symptoms')),
+                ('status_custom_key', generic.states.fields.ExtraInvenTreeCustomStatusModelField(blank=True, default=None, help_text='Additional status information for this item', null=True, validators=[generic.states.validators.CustomStatusCodeValidator(status_class=order.status_codes.RepairOrderStatus)], verbose_name='Custom status key')),
+                ('status', generic.states.fields.InvenTreeCustomStatusModelField(choices=[(10, 'Pending'), (20, 'In Progress'), (25, 'On Hold'), (30, 'Complete'), (40, 'Cancelled')], default=10, help_text='Repair order status', validators=[generic.states.validators.CustomStatusCodeValidator(status_class=order.status_codes.RepairOrderStatus)], verbose_name='Status')),
+
+                ('customer', models.ForeignKey(blank=True, help_text='Customer reference', limit_choices_to={'is_customer': True}, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='repair_orders', to='company.company', verbose_name='Customer')),
+            ],
+            options={
+                'verbose_name': 'Repair Order',
+            },
+            bases=(generic.states.states.StatusCodeMixin, generic.states.transition.StateTransitionMixin, InvenTree.models.InvenTreeAttachmentMixin, InvenTree.models.InvenTreePermissionCheckMixin, InvenTree.models.ContentTypeMixin, InvenTree.models.PluginValidationMixin, models.Model),
+        ),
+        migrations.CreateModel(
+            name='RepairOrderLineItem',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('metadata', models.JSONField(blank=True, help_text='JSON metadata field, for use by external plugins', null=True, verbose_name='Plugin Metadata')),
+                ('quantity', models.DecimalField(decimal_places=5, default=1, help_text='Item quantity required for repair', max_digits=15, verbose_name='Quantity')),
+                ('order', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lines', to='order.repairorder', verbose_name='Repair Order')),
+                ('part', models.ForeignKey(blank=True, help_text='Part to be consumed for repair', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='repair_order_line_items', to='part.part', verbose_name='Part')),
+            ],
+            options={
+                'verbose_name': 'Repair Order Line Item',
+            },
+            bases=(InvenTree.models.ContentTypeMixin, InvenTree.models.PluginValidationMixin, models.Model),
+        ),
+        migrations.CreateModel(
+            name='RepairOrderAllocation',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('quantity', models.DecimalField(decimal_places=5, default=1, help_text='Allocated stock quantity', max_digits=15, verbose_name='Quantity')),
+                ('item', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='repair_order_allocations', to='stock.stockitem', verbose_name='Stock Item')),
+                ('line', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='allocations', to='order.repairorderlineitem', verbose_name='Line Item')),
+            ],
+            options={
+                'verbose_name': 'Repair Order Allocation',
+            },
+        ),
+    ]

src/backend/InvenTree/order/migrations/0121_merge_20260604_1637.py

@@ -0,0 +1,14 @@
+# Generated by Django 5.2.14 on 2026-06-04 11:07
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('order', '0120_purchaseorder_tags_returnorder_tags_salesorder_tags_and_more'),
+        ('order', '0120_repairorder_repairorderlineitem_and_more'),
+    ]
+
+    operations = [
+    ]

src/backend/InvenTree/order/models.py

@@ -54,6 +54,7 @@
 from order.status_codes import (
     PurchaseOrderStatus,
     PurchaseOrderStatusGroups,
+    RepairOrderStatus,
     ReturnOrderLineStatus,
     ReturnOrderStatus,
     ReturnOrderStatusGroups,
@@ -4002,3 +4003,145 @@ def _touch_order_updated_at(instance):
 def update_order_on_lineitem_change(sender, instance, **kwargs):
     """Update parent order updated_at when any line item is saved or deleted."""
     _touch_order_updated_at(instance)
+
+
+class RepairOrder(
+    StatusCodeMixin,
+    StateTransitionMixin,
+    InvenTree.models.InvenTreeParameterMixin,
+    InvenTree.models.InvenTreeAttachmentMixin,
+    InvenTree.models.InvenTreeBarcodeMixin,
+    InvenTree.models.InvenTreeNotesMixin,
+    report.mixins.InvenTreeReportMixin,
+    InvenTree.models.ReferenceIndexingMixin,
+    InvenTree.models.InvenTreeMetadataModel,
+):
+    """A RepairOrder represents a repair request from a customer."""
+
+    STATUS_CLASS = RepairOrderStatus
+    REFERENCE_PATTERN_SETTING = 'REPAIRORDER_REFERENCE_PATTERN'
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Repair Order')
+
+    reference = models.CharField(
+        max_length=100,
+        unique=True,
+        blank=False,
+        null=False,
+        help_text=_('Repair Order Reference'),
+        verbose_name=_('Reference'),
+    )
+
+    customer = models.ForeignKey(
+        'company.Company',
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        related_name='repair_orders',
+        limit_choices_to={'is_customer': True},
+        verbose_name=_('Customer'),
+        help_text=_('Customer reference'),
+    )
+
+    description = models.CharField(
+        max_length=250,
+        verbose_name=_('Description'),
+        help_text=_('Repair order description'),
+    )
+
+    symptoms = models.TextField(
+        blank=True,
+        verbose_name=_('Symptoms'),
+        help_text=_('Reported symptoms or issues'),
+    )
+
+    status = InvenTreeCustomStatusModelField(
+        default=RepairOrderStatus.PENDING.value,
+        choices=RepairOrderStatus.items(),
+        status_class=RepairOrderStatus,
+        help_text=_('Repair order status'),
+        verbose_name=_('Status'),
+    )
+
+    @staticmethod
+    def get_api_url():
+        """Return the API URL associated with the RepairOrder model."""
+        return reverse('api-repair-order-list')
+
+
+class RepairOrderLineItem(InvenTree.models.InvenTreeMetadataModel):
+    """Model for a repair order line item."""
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Repair Order Line Item')
+
+    order = models.ForeignKey(
+        RepairOrder,
+        on_delete=models.CASCADE,
+        related_name='lines',
+        verbose_name=_('Repair Order'),
+    )
+
+    part = models.ForeignKey(
+        'part.Part',
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        related_name='repair_order_line_items',
+        verbose_name=_('Part'),
+        help_text=_('Part to be consumed for repair'),
+    )
+
+    quantity = models.DecimalField(
+        max_digits=15,
+        decimal_places=5,
+        default=1,
+        verbose_name=_('Quantity'),
+        help_text=_('Item quantity required for repair'),
+    )
+
+    @staticmethod
+    def get_api_url():
+        """Return the API URL associated with the RepairOrderLineItem model."""
+        return reverse('api-repair-order-line-list')
+
+
+class RepairOrderAllocation(models.Model):
+    """Model linking RepairOrderLineItem to specific stock.StockItem quantities."""
+
+    class Meta:
+        """Model meta options."""
+
+        verbose_name = _('Repair Order Allocation')
+
+    line = models.ForeignKey(
+        RepairOrderLineItem,
+        on_delete=models.CASCADE,
+        related_name='allocations',
+        verbose_name=_('Line Item'),
+    )
+
+    item = models.ForeignKey(
+        'stock.StockItem',
+        on_delete=models.CASCADE,
+        related_name='repair_order_allocations',
+        verbose_name=_('Stock Item'),
+    )
+
+    quantity = models.DecimalField(
+        max_digits=15,
+        decimal_places=5,
+        default=1,
+        verbose_name=_('Quantity'),
+        help_text=_('Allocated stock quantity'),
+    )
+
+    @staticmethod
+    def get_api_url():
+        """Return the API URL associated with the RepairOrderAllocation model."""
+        return reverse('api-repair-order-allocation-list')