feat: add ticket list visual support api

backend/apps/tickets/api.py

@@ -1,10 +1,12 @@
 import csv
+from math import ceil
 
 from django.contrib.auth import get_user_model
 from django.db.models import Q
 from django.http import HttpResponse
 from django.utils import timezone
 from ninja import Router
+from ninja.errors import HttpError
 
 from apps.accounts.api import require_permission
 from apps.audit.models import OperationAuditLog
@@ -15,6 +17,7 @@ from apps.tickets.schemas import (
     TicketCommentIn,
     TicketCommentOut,
     TicketIn,
+    TicketListOut,
     TicketOut,
     TicketStatusIn,
     TicketUpdateIn,
@@ -30,6 +33,36 @@ def next_ticket_no() -> str:
     return f"{prefix}{count:04d}"
 
 
+def serialize_ticket_user(user):
+    if user is None:
+        return None
+    return {
+        "id": user.id,
+        "username": user.username,
+        "display_name": user.get_full_name() or user.username,
+    }
+
+
+def serialize_ticket(ticket: Ticket) -> dict:
+    return {
+        "id": ticket.id,
+        "ticket_no": ticket.ticket_no,
+        "title": ticket.title,
+        "description": ticket.description,
+        "status": ticket.status,
+        "priority": ticket.priority,
+        "impact_scope": ticket.impact_scope,
+        "environment": ticket.environment,
+        "related_system": ticket.related_system,
+        "requester_id": ticket.requester_id,
+        "assignee_id": ticket.assignee_id,
+        "requester": serialize_ticket_user(ticket.requester),
+        "assignee": serialize_ticket_user(ticket.assignee),
+        "created_at": ticket.created_at,
+        "updated_at": ticket.updated_at,
+    }
+
+
 @router.post("", response=TicketOut)
 def create_ticket(request, payload: TicketIn):
     require_permission(request, "ticket.create")
@@ -45,6 +78,7 @@ def create_ticket(request, payload: TicketIn):
         environment=payload.environment,
         related_system=payload.related_system,
         assignee=assignee,
+        requester=request.user if request.user.is_authenticated else None,
         created_by=request.user if request.user.is_authenticated else None,
     )
     TicketEvent.objects.create(
@@ -52,18 +86,57 @@ def create_ticket(request, payload: TicketIn):
         event_type="created",
         to_value={"status": ticket.status},
     )
-    return ticket
+    return serialize_ticket(ticket)
 
 
-@router.get("", response=list[TicketOut])
-def list_tickets(request, status: str | None = None, q: str | None = None):
+@router.get("", response=TicketListOut)
+def list_tickets(
+    request,
+    page: int = 1,
+    page_size: int = 20,
+    status: str | None = None,
+    priority: str | None = None,
+    q: str | None = None,
+    related_system: str | None = None,
+    assignee_id: int | None = None,
+    view: str = "all",
+):
     require_permission(request, "ticket.view")
-    queryset = Ticket.objects.all()
+    queryset = Ticket.objects.select_related("requester", "assignee").all()
     if status:
         queryset = queryset.filter(status=status)
+    if priority:
+        queryset = queryset.filter(priority=priority)
     if q:
-        queryset = queryset.filter(Q(ticket_no__icontains=q) | Q(title__icontains=q))
-    return queryset[:100]
+        queryset = queryset.filter(
+            Q(ticket_no__icontains=q)
+            | Q(title__icontains=q)
+            | Q(description__icontains=q)
+        )
+    if related_system:
+        queryset = queryset.filter(related_system__icontains=related_system)
+    if assignee_id:
+        queryset = queryset.filter(assignee_id=assignee_id)
+    if view == "assigned_to_me":
+        queryset = queryset.filter(assignee=request.user)
+    if view == "created_by_me":
+        queryset = queryset.filter(created_by=request.user)
+    if view == "high_priority":
+        queryset = queryset.filter(priority__in=["high", "urgent"])
+
+    page = max(page, 1)
+    page_size = min(max(page_size, 1), 100)
+    total = queryset.count()
+    total_pages = ceil(total / page_size) if total else 0
+    start = (page - 1) * page_size
+    end = start + page_size
+    return {
+        "items": [serialize_ticket(ticket) for ticket in queryset[start:end]],
+        "page": page,
+        "page_size": page_size,
+        "total": total,
+        "total_pages": total_pages,
+    }
 
 
 @router.get("/export")
@@ -97,7 +170,9 @@ def export_tickets(request):
 @router.get("/{ticket_id}", response=TicketOut)
 def get_ticket(request, ticket_id: int):
     require_permission(request, "ticket.view")
-    return Ticket.objects.get(id=ticket_id)
+    return serialize_ticket(
+        Ticket.objects.select_related("requester", "assignee").get(id=ticket_id)
+    )
 
 
 @router.patch("/{ticket_id}", response=TicketOut)
@@ -125,19 +200,22 @@ def update_ticket(request, ticket_id: int, payload: TicketUpdateIn):
         to_value=payload.dict(exclude_unset=True),
         operator=request.user if request.user.is_authenticated else None,
     )
-    return ticket
+    return serialize_ticket(ticket)
 
 
 @router.post("/{ticket_id}/status", response=TicketOut)
 def update_ticket_status(request, ticket_id: int, payload: TicketStatusIn):
     require_permission(request, "ticket.edit")
+    if not payload.remark.strip():
+        raise HttpError(400, "Transition remark is required")
     ticket = Ticket.objects.get(id=ticket_id)
-    return transition_ticket(
+    updated = transition_ticket(
         ticket,
         payload.status,
         payload.remark,
         request.user if request.user.is_authenticated else None,
     )
+    return serialize_ticket(updated)
 
 
 @router.post("/{ticket_id}/comments", response=TicketCommentOut)