ATP - نتایج جستجو (GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/search-results/)

Endpoint

GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/search-results/

هدف آزمون

مراجع sanitized از artifact S3 (حداکثر ۲۵ مرجع).

شرایط آزمون

• سرویس core-api در حال اجرا باشد
• هدر Authorization با access token معتبر

فرآیند آزمون

1. ارسال درخواست GET به /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/search-results/
2. دریافت پاسخ HTTP
3. بررسی کد وضعیت و بدنه JSON

معرفی ویژگی

خواندن artifact از S3 با tenancy prefix check. فیلدهای برگشتی: publication_number، title، url (http/https sanitised)، relevance_score، abstract (trimmed).

• ورودی معتبر: اعتبارسنجی در مرز API
• پاسخ استاندارد: قالب JSON یکسان با سایر endpointها
• کنترل دسترسی: مطابق policy ماژول مربوطه

سناریوی آزمون

سناریو 1: مسیر موفق

1. ارسال GET /api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/search-results/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

سناریو 2: خطا - درخواست نامعتبر

1. ارسال درخواست با داده یا شناسه نامعتبر
2. دریافت کد خطای 4xx
3. بررسی پیام خطای استاندارد API

سناریو 3: tenancy prefix

1. artifact با prefix نادرست
2. دریافت 400 validation
3. بررسی Invalid prefix

سناریو 4: بدون completed search

1. run با search running
2. GET search-results
3. 404 No completed search

قالب API

Swagger

get:
  summary: نتایج جستجو
  responses:
    200:
      description: عملیات موفق
    401:
      description: احراز هویت نامعتبر یا ناقص

نمونه ورودی

curl -X GET "http://localhost:8000/api/v1/invention-cases/{invention_case_id}/prior-art/runs/{run_id}/search-results/" \
  -H "Authorization: Bearer <access>" \
  -H "Content-Type: application/json"

نمونه خروجی

{
  "success": true,
  "data": {
    "run_id": "...",
    "search_execution_id": "...",
    "reference_count": 18,
    "references": [
      {
        "publication_number": "US20240123456A1",
        "title": "Thermal management system",
        "url": "https://patents.google.com/...",
        "relevance_score": 0.87,
        "abstract": "A battery pack comprising..."
      }
    ]
  }
}

Status Codes

• 200: عملیات موفق
• 401: احراز هویت نامعتبر یا ناقص

نتیجه مورد انتظار

در صورت موفقیت، پاسخ JSON استاندارد با کد وضعیت مناسب برای GET برگردانده می‌شود.

روال صحت‌سنجی

1. بررسی 200
2. بررسی حداکثر ۲۵ reference
3. بررسی abstract ≤ 1000 chars
4. بررسی 404 اگر search هنوز completed نشده

توضیحات

• مسیر باید با پیاده‌سازی فعلی urls.py هم‌خوان باشد