ATP - لیست پرونده‌های اختراع (GET /api/v1/invention-cases/)

Endpoint

GET /api/v1/invention-cases/

هدف آزمون

لیست caseهای قابل دسترس.

شرایط آزمون

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

فرآیند آزمون

1. ورود با access token
2. ارسال GET با فیلتر اختیاری workspace_id
3. دریافت لیست paginated پرونده‌ها
4. بررسی فقط پرونده‌های قابل دسترس کاربر

معرفی ویژگی

این endpoint عملیات «لیست پرونده‌های اختراع» را در API Patent Genie انجام می‌دهد.

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

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

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

1. ارسال GET /api/v1/invention-cases/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

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

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

سناریو 3: خطا — بدون احراز هویت

1. ارسال درخواست بدون هدر Authorization
2. دریافت کد 401
3. بررسی عدم برگرداندن داده محافظت‌شده

سناریو 4: خطا — توکن منقضی

1. استفاده از access token منقضی‌شده
2. دریافت کد 401
3. تازه‌سازی توکن با endpoint refresh

قالب API

Swagger

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

نمونه ورودی

curl -X GET "http://localhost:8000/api/v1/invention-cases/" \
  -H "Authorization: Bearer <access>" \
  -H "Content-Type: application/json"

نمونه خروجی

{
  "success": true,
  "data": {
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "case_code": "IC-2026-001",
        "title": "Smart valve assembly",
        "current_stage": "information_collection",
        "status": "active"
      }
    ]
  }
}

Status Codes

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

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

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

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

1. بررسی کد وضعیت HTTP
2. بررسی فیلد success در بدنه
3. بررسی عدم افشای داده حساس

توضیحات

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