ATP - ایجاد/اطمینان پیش‌نویس patent application (POST /api/v1/invention-cases/{invention_case_id}/draft-documents/ensure-patent-application/)

Endpoint

POST /api/v1/invention-cases/{invention_case_id}/draft-documents/ensure-patent-application/

هدف آزمون

ایجاد یا بازگرداندن draft patent application با sectionهای قالب published.

شرایط آزمون

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

فرآیند آزمون

1. آماده‌سازی case با context آماده
2. POST ensure-patent-application
3. دریافت draft با sections از template
4. بررسی idempotency در فراخوانی مجدد

معرفی ویژگی

این endpoint عملیات «ایجاد/اطمینان پیش‌نویس patent application» را در API Patent Genie انجام می‌دهد.

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

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

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

1. ارسال POST /api/v1/invention-cases/{invention_case_id}/draft-documents/ensure-patent-application/
2. دریافت پاسخ موفق
3. بررسی ساختار پاسخ

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

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

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

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

سناریو 4: خطا — منبع یافت نشد

1. استفاده از UUID نامعتبر یا متعلق به کاربر دیگر
2. دریافت کد 404
3. بررسی پیام خطای استاندارد API

قالب API

Swagger

post:
  summary: ایجاد/اطمینان پیش‌نویس patent application
  responses:
    201:
      description: منبع ایجاد شد
    400:
      description: داده ورودی نامعتبر
    401:
      description: احراز هویت نامعتبر

نمونه ورودی

curl -X POST "http://localhost:8000/api/v1/invention-cases/{invention_case_id}/draft-documents/ensure-patent-application/" \
  -H "Authorization: Bearer <access>" \
  -H "Content-Type: application/json"

نمونه خروجی

{
  "success": true,
  "data": {}
}

Status Codes

• 201: منبع ایجاد شد
• 400: داده ورودی نامعتبر
• 401: احراز هویت نامعتبر

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

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

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

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

توضیحات

• ADR-0009 versioned drafting templates
• اگر draft موجود باشد همان برگردانده می‌شود