ai-ticket-platform/backend/apps/tickets/tests/test_ticket_api.py

from django.contrib.auth import get_user_model

from apps.tickets.models import Ticket, TicketCategory, TicketEvent


def test_create_ticket_returns_ticket_detail(admin_client, db):
    TicketCategory.objects.get_or_create(code="business_issue", defaults={"name": "业务问题"})
    response = admin_client.post(
        "/api/tickets",
        data={
            "title": "Payment callback fails",
            "description": "Callback returns HTTP 500 in production",
            "category_code": "business_issue",
            "priority": "high",
            "problem_performance": "采集进度未更新",
            "problem_object": "客户 A",
            "submitter_name": "张三",
            "submitter_org": "华东分公司",
            "impact_scope": "payment users",
            "environment": "production",
            "related_system": "payment",
        },
        content_type="application/json",
    )

    assert response.status_code == 200
    payload = response.json()
    assert payload["ticket_no"].startswith("TK")
    assert payload["title"] == "Payment callback fails"
    assert payload["category"]["name"] == "业务问题"
    assert payload["category_code"] == "business_issue"
    assert payload["problem_object"] == "客户 A"
    assert payload["submitter_org"] == "华东分公司"
    assert payload["status"] == "pending"
    assert TicketEvent.objects.filter(ticket_id=payload["id"], event_type="created").exists()


def test_list_tickets_filters_by_status(admin_client, db):
    Ticket.objects.create(ticket_no="TK202606300001", title="A", description="A", status="pending")
    Ticket.objects.create(ticket_no="TK202606300002", title="B", description="B", status="resolved")

    response = admin_client.get("/api/tickets?status=pending")

    assert response.status_code == 200
    payload = response.json()
    assert payload["total"] == 1
    assert payload["items"][0]["ticket_no"] == "TK202606300001"


def test_list_tickets_returns_paginated_response_with_display_users(admin_client, db):
    user_model = get_user_model()
    requester = user_model.objects.create_user(username="requester", first_name="请求人")
    assignee = user_model.objects.create_user(username="assignee", first_name="处理人")
    Ticket.objects.create(
        ticket_no="TK202607010100",
        title="Payment failed",
        description="A",
        requester=requester,
        assignee=assignee,
        related_system="CRM",
    )

    response = admin_client.get("/api/tickets?page=1&page_size=20")

    assert response.status_code == 200
    payload = response.json()
    assert payload["page"] == 1
    assert payload["page_size"] == 20
    assert payload["total"] == 1
    assert payload["total_pages"] == 1
    assert payload["items"][0]["requester"]["display_name"] == "请求人"
    assert payload["items"][0]["assignee"]["display_name"] == "处理人"


def test_list_tickets_filters_by_priority_related_system_and_view(admin_client, db):
    user_model = get_user_model()
    current_user = user_model.objects.get(username="admin")
    Ticket.objects.create(
        ticket_no="TK202607010101",
        title="Mine urgent CRM",
        description="A",
        priority="urgent",
        related_system="CRM",
        assignee=current_user,
        created_by=current_user,
    )
    Ticket.objects.create(
        ticket_no="TK202607010102",
        title="Other medium ERP",
        description="B",
        priority="medium",
        related_system="ERP",
    )

    response = admin_client.get(
        "/api/tickets?priority=urgent&related_system=CRM&view=assigned_to_me"
    )

    assert response.status_code == 200
    payload = response.json()
    assert payload["total"] == 1
    assert payload["items"][0]["ticket_no"] == "TK202607010101"


def test_transition_ticket_status_creates_event(admin_client, db):
    ticket = Ticket.objects.create(
        ticket_no="TK202606300003",
        title="A",
        description="A",
        status="pending",
    )

    response = admin_client.post(
        f"/api/tickets/{ticket.id}/status",
        data={"status": "in_progress", "remark": "Start handling"},
        content_type="application/json",
    )

    assert response.status_code == 200
    ticket.refresh_from_db()
    assert ticket.status == "in_progress"
    assert ticket.events.filter(event_type="status_change").exists()


def test_transition_ticket_requires_non_empty_remark(admin_client, db):
    ticket = Ticket.objects.create(
        ticket_no="TK202607010103",
        title="A",
        description="A",
        status="pending",
    )

    response = admin_client.post(
        f"/api/tickets/{ticket.id}/status",
        data={"status": "in_progress", "remark": ""},
        content_type="application/json",
    )

    assert response.status_code == 400


def test_business_ticket_can_be_resolved_directly_with_resolution(admin_client, db):
    category, _ = TicketCategory.objects.get_or_create(
        code="business_issue",
        defaults={"name": "业务问题"},
    )
    ticket = Ticket.objects.create(
        ticket_no="TK202607010104",
        title="查询采集进度",
        description="客户需要确认采集进度",
        status="pending",
        category=category,
    )

    response = admin_client.post(
        f"/api/tickets/{ticket.id}/status",
        data={
            "status": "resolved",
            "resolution": "已查询采集进度，当前已完成 80%。",
            "replied_to_customer": True,
        },
        content_type="application/json",
    )

    assert response.status_code == 200
    ticket.refresh_from_db()
    assert ticket.status == "resolved"
    assert ticket.resolution_summary == "已查询采集进度，当前已完成 80%。"
    assert ticket.is_resolved is True
    assert ticket.replied_to_customer is True


def test_technical_ticket_cannot_be_resolved_directly(admin_client, db):
    category, _ = TicketCategory.objects.get_or_create(
        code="technical_issue",
        defaults={"name": "技术问题"},
    )
    ticket = Ticket.objects.create(
        ticket_no="TK202607010105",
        title="生产接口异常",
        description="接口 500",
        status="pending",
        category=category,
    )

    response = admin_client.post(
        f"/api/tickets/{ticket.id}/status",
        data={"status": "resolved", "resolution": "已恢复"},
        content_type="application/json",
    )

    assert response.status_code == 400


def test_get_ticket_events_returns_real_timeline_with_operator(admin_client, db):
    user_model = get_user_model()
    operator = user_model.objects.get(username="admin")
    ticket = Ticket.objects.create(
        ticket_no="TK202607020200",
        title="A",
        description="A",
        status="in_progress",
    )
    TicketEvent.objects.create(
        ticket=ticket,
        event_type="created",
        to_value={"status": "pending"},
        operator=operator,
    )
    TicketEvent.objects.create(
        ticket=ticket,
        event_type="status_change",
        from_value={"status": "pending"},
        to_value={"status": "in_progress"},
        operator=operator,
        remark="开始排查认证链路",
    )

    response = admin_client.get(f"/api/tickets/{ticket.id}/events")

    assert response.status_code == 200
    payload = response.json()
    assert [event["event_type"] for event in payload] == ["created", "status_change"]
    assert payload[1]["from_value"] == {"status": "pending"}
    assert payload[1]["to_value"] == {"status": "in_progress"}
    assert payload[1]["remark"] == "开始排查认证链路"
    assert payload[1]["operator"]["display_name"] == "admin"