ATP - نمایش معماری سرویس (GET /architecture/)

Endpoint

GET /architecture/

هدف آزمون

نمایش مستند زنده معماری با جدول اجزا و نمودارهای Mermaid.

شرایط آزمون

• سرویس info-extraction در حال اجرا باشد
• دسترسی به CDN jsdelivr برای رندر Mermaid (مرورگر)
• نیازی به احراز هویت نیست

فرآیند آزمون

1. ارسال درخواست GET به /architecture/
2. دریافت HTML فارسی
3. بررسی جدول اجزا و بخش‌های platform-boundary، async-path، intake-graph
4. بررسی وجود بلوک‌های pre.mermaid

معرفی ویژگی

صفحه معماری پیاده‌سازی‌شده: مرز سرویس در پلتفرم Patent Genie، قرارداد RabbitMQ، خط لوله LangGraph intake و استقرار Docker Compose.

• جدول اجزا: core-api، info-extraction، worker، RabbitMQ، Object Storage، OCR
• ۵ بخش Mermaid: platform-boundary، async-path، intake-graph، http-path، docker-compose
• مرز مسئولیت: بدون chunking، embedding یا Milvus
• مسیر dev: POST /api/v1/dev/ingest/extract در نمودار http-path

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

سناریو 1: مسیر موفق — همه بخش‌های معماری

1. ارسال GET /architecture/
2. دریافت کد 200
3. بررسی عنوان «معماری سرویس استخراج اطلاعات»
4. بررسی idهای platform-boundary، intake-graph و document.extraction.requested
5. بررسی script بارگذاری mermaid.esm.min.mjs

سناریو 2: خطا — CDN در دسترس نیست

1. باز کردن صفحه در محیط بدون دسترسی اینترنت
2. مشاهده HTML خام بخش‌های Mermaid
3. در صورت خطای JS، پیام «خطا در رندر نمودار» نمایش داده می‌شود

سناریو 3: بررسی جدول اجزای اصلی

1. ارسال GET /architecture/
2. بررسی وجود info-extraction، extraction-worker و LangGraph intake pipeline در جدول
3. بررسی queue: document.extraction.requested در ستون رابط

قالب API

Swagger

get:
  summary: Architecture documentation page (not in OpenAPI)
  responses:
    200:
      description: HTML architecture page returned

نمونه ورودی

curl -X GET "http://127.0.0.1:8000/architecture/" \
  -H "Accept: text/html"

نمونه خروجی

<section id="platform-boundary">
  <h2>مرز سرویس در پلتفرم</h2>
  <pre class="mermaid">flowchart TB ...</pre>
</section>
<section id="intake-graph">...</section>

Status Codes

• 200: صفحه معماری HTML برگردانده شد

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

HTML فارسی با جدول اجزا، ۵ section با نمودار Mermaid و یادداشت محدودیت سرویس.

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

1. بررسی کد 200
2. بررسی وجود class="mermaid"
3. بررسی متن «بدون chunking» یا «Milvus» در محدودیت‌ها
4. بررسی لینک بازگشت به /

توضیحات

• داده‌های صفحه از src/api/architecture/diagrams.py تغذیه می‌شود
• ATP مرتبط: dev-ingest-extract برای مسیر HTTP همزمان intake
• در info-extraction از کلمه رزرو شده graph به‌عنوان id نود Mermaid استفاده نکنید