add backend for metric order

Co-authored-by: Copilot <copilot@github.com>

Author: thaafei

src/backend/api/database/metrics/management/__init__.py

@@ -0,0 +1,48 @@
+from django.core.management.base import BaseCommand
+from django.db.models import F
+
+from api.database.metrics.models import Metric, MetricOrder
+
+
+class Command(BaseCommand):
+    help = "Populate MetricOrder with current metrics organized by category"
+
+    def handle(self, *args, **options):
+        try:
+            # Get all metrics grouped by category
+            metrics = Metric.objects.all().order_by("category", "metric_name")
+
+            category_order = {}
+            for metric in metrics:
+                category = metric.category or "Uncategorized"
+                if category not in category_order:
+                    category_order[category] = []
+                category_order[category].append(str(metric.metric_ID))
+
+            # Get or create the MetricOrder instance
+            metric_order, created = MetricOrder.objects.get_or_create(pk=1)
+            metric_order.category_order = category_order
+            metric_order.save()
+
+            if created:
+                self.stdout.write(
+                    self.style.SUCCESS(
+                        f"✓ Created MetricOrder with {len(metrics)} metrics"
+                    )
+                )
+            else:
+                self.stdout.write(
+                    self.style.SUCCESS(
+                        f"✓ Updated MetricOrder with {len(metrics)} metrics"
+                    )
+                )
+
+            # Print summary
+            self.stdout.write("\nMetrics by category:")
+            for category, metric_ids in sorted(category_order.items()):
+                self.stdout.write(f"  {category}: {len(metric_ids)} metrics")
+
+        except Exception as e:
+            self.stdout.write(
+                self.style.ERROR(f"✗ Error populating MetricOrder: {str(e)}")
+            )

src/backend/api/database/metrics/management/commands/__init__.py

@@ -0,0 +1,38 @@
+# Generated by Django 5.2.7 on 2026-05-04 02:06
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("metrics", "0008_alter_metric_value_type"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="MetricOrder",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                (
+                    "category_order",
+                    models.JSONField(
+                        default=dict,
+                        help_text="JSON object mapping category names to ordered lists of metric IDs",
+                    ),
+                ),
+                ("updated_at", models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                "verbose_name_plural": "Metric Orders",
+            },
+        ),
+    ]

src/backend/api/database/metrics/management/commands/populate_metric_order.py

@@ -39,3 +39,18 @@ class Metric(models.Model):
 
     def __str__(self):
         return self.metric_name
+
+
+class MetricOrder(models.Model):
+    """Stores the display order of metrics by category"""
+    category_order = models.JSONField(
+        default=dict,
+        help_text="JSON object mapping category names to ordered lists of metric IDs"
+    )
+    updated_at = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name_plural = "Metric Orders"
+
+    def __str__(self):
+        return f"Metric Order (updated {self.updated_at})"

src/backend/api/database/metrics/migrations/0009_metricorder.py

@@ -5,6 +5,7 @@
     MetricCategoryView,
     MetricListCreateView,
     MetricListFlatView,
+    MetricReorderView,
     MetricRetrieveUpdateDestroyView,
     MetricRulesView,
     MetricUpdateWeightView,
@@ -14,6 +15,7 @@
     path("", MetricListCreateView.as_view(), name="metric-list-create"),
     path("auto-options/", AutoMetricOptionsView.as_view(), name="metric-auto-options"),
     path("all/", MetricListFlatView.as_view(), name="metric-all-flat"),
+    path("reorder/", MetricReorderView.as_view(), name="metric-reorder"),
     path("rules/", MetricRulesView.as_view(), name="metric-rules"),
     path("categories/", MetricCategoryView.as_view(), name="metric-categories"),
     path(

src/backend/api/database/metrics/models.py

@@ -8,7 +8,7 @@
 from rest_framework.response import Response
 from rest_framework.views import APIView
 
-from .models import Metric
+from .models import Metric, MetricOrder
 from .serializers import FlatMetricSerializer, MetricSerializer
 
 
@@ -134,3 +134,75 @@ def patch(self, request, metric_id):
 class MetricListFlatView(generics.ListAPIView):
     serializer_class = FlatMetricSerializer
     queryset = Metric.objects.all().order_by("metric_name")
+
+
+class MetricReorderView(APIView):
+    permission_classes = [IsAuthenticatedOrReadOnly]  # noqa: F811
+
+    def get(self, request):
+        """Retrieve the current metric display order"""
+        try:
+            metric_order = MetricOrder.objects.first()
+            if metric_order:
+                return Response(
+                    {"category_order": metric_order.category_order},
+                    status=status.HTTP_200_OK,
+                )
+            else:
+                return Response(
+                    {"category_order": {}},
+                    status=status.HTTP_200_OK,
+                )
+        except Exception as e:
+            return Response(
+                {"error": str(e)},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            )
+
+    def post(self, request):
+        """Save the metric display order"""
+        try:
+            category_order = request.data.get("category_order")
+            if category_order is None:
+                return Response(
+                    {"error": "category_order field is required"},
+                    status=status.HTTP_400_BAD_REQUEST,
+                )
+
+            # Validate that all metric IDs exist
+            all_metric_ids = set()
+            for category_metrics in category_order.values():
+                if isinstance(category_metrics, list):
+                    all_metric_ids.update(category_metrics)
+
+            # Check if all metric IDs exist
+            existing_metrics = set(
+                str(m_id) for m_id in Metric.objects.filter(
+                    metric_ID__in=all_metric_ids
+                ).values_list("metric_ID", flat=True)
+            )
+            
+            invalid_ids = all_metric_ids - existing_metrics
+            if invalid_ids:
+                return Response(
+                    {"error": f"Invalid metric IDs: {list(invalid_ids)}"},
+                    status=status.HTTP_400_BAD_REQUEST,
+                )
+
+            # Get or create the single MetricOrder instance
+            metric_order, _ = MetricOrder.objects.get_or_create(pk=1)
+            metric_order.category_order = category_order
+            metric_order.save()
+
+            return Response(
+                {
+                    "message": "Metric display order updated successfully",
+                    "category_order": metric_order.category_order,
+                },
+                status=status.HTTP_200_OK,
+            )
+        except Exception as e:
+            return Response(
+                {"error": str(e)},
+                status=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            )

src/backend/api/database/metrics/urls.py

@@ -1,20 +1,9 @@
 import React from "react";
-import { Metric } from "../pages/MetricPageTypes";
-
-interface ReorderMetricsModalProps {
-  isOpen: boolean;
-  categoryOrder: string[];
-  reorderCategory: string;
-  categoryMetricOrder: Record<string, string[]>;
-  metricsById: Map<string, Metric>;
-  onCategoryChange: (category: string) => void;
-  onMoveMetric: (metricId: string, direction: "up" | "down") => void;
-  onClose: () => void;
-  onSave: () => void;
-}
+import { ReorderMetricsModalProps } from "../pages/MetricPageTypes";
 
 export const ReorderMetricsModal: React.FC<ReorderMetricsModalProps> = ({
   isOpen,
+  formError,
   categoryOrder,
   reorderCategory,
   categoryMetricOrder,
@@ -25,6 +14,10 @@ export const ReorderMetricsModal: React.FC<ReorderMetricsModalProps> = ({
   onSave,
 }) => {
   if (!isOpen) return null;
+  const handleReorder = async () => {
+    const ok = await onSave();
+    if (ok) onClose();
+  };
 
   return (
     <div
@@ -80,7 +73,21 @@ export const ReorderMetricsModal: React.FC<ReorderMetricsModalProps> = ({
             ✕
           </button>
         </div>
-
+        {formError && (
+          <div
+            style={{
+              marginBottom: 12,
+              padding: "10px 12px",
+              borderRadius: 10,
+              border: "1px solid rgba(255, 99, 99, 0.45)",
+              background: "rgba(255, 99, 99, 0.10)",
+              color: "#ffb3b3",
+              fontSize: "0.95rem",
+            }}
+          >
+            {formError}
+          </div>
+        )}
         <div style={{ display: "grid", gap: 12 }}>
           <div style={{ display: "flex", flexDirection: "column", gap: 6 }}>
             <label style={{ opacity: 0.85 }}>Category</label>
@@ -171,7 +178,7 @@ export const ReorderMetricsModal: React.FC<ReorderMetricsModalProps> = ({
             <button className="dx-btn dx-btn-outline" onClick={onClose}>
               Cancel
             </button>
-            <button className="dx-btn dx-btn-primary" onClick={onSave}>
+            <button className="dx-btn dx-btn-primary" onClick={handleReorder}>
               Save Order
             </button>
           </div>

src/backend/api/database/metrics/views.py

@@ -75,4 +75,17 @@ export interface AddMetricModalProps {
   setEditTemplate: (value: string) => void;
   onEditTypeChange: (value: string) => void;
   isRuleType: (type: string) => boolean;
-}
+}
+
+export interface ReorderMetricsModalProps {
+  isOpen: boolean;
+  formError: string;
+  categoryOrder: string[];
+  reorderCategory: string;
+  categoryMetricOrder: Record<string, string[]>;
+  metricsById: Map<string, Metric>;
+  onCategoryChange: (category: string) => void;
+  onMoveMetric: (metricId: string, direction: "up" | "down") => void;
+  onClose: () => void;
+  onSave: () => Promise<boolean>;
+}