# API آزمایشی کتاب‌فروشی برگ سبز

> **همه داده‌ها ساختگی‌اند.** «کتاب‌فروشی برگ سبز» کسب‌وکار ساختگی آکادمی است. این API فقط روی کامپیوتر خودت (`127.0.0.1`) اجرا می‌شود و به اینترنت وصل نیست.

- **اجرا:** `python barg-sabz-mock-api.py` (Python 3.9 یا بالاتر، بدون نصب بسته). نشانی: `http://127.0.0.1:8787`.
- **کلید:** هدر `Authorization: Bearer local-demo-token`. مقدار نمایشی است، نه راز؛ با متغیر محیطی `MOCK_API_TOKEN` عوضش کن.
- **نقطه‌های پایانی:** فهرست کامل و رفتار هرکدام در توضیح بالای فایل آمده است: سفارش‌ها با صفحه‌بندی، ثبت تیکت با `Idempotency-Key`، نقطه‌های ناپایدار (`/flaky`)، محدود (`/limited`) و کند (`/slow`)، و یک «مدل آزمایشی» سازگار با OpenAI در `/v1/chat/completions` که با قاعده‌های کلیدواژه‌ای کار می‌کند و هوش مصنوعی نیست.
- **متغیرهای محیطی:** `MOCK_API_TOKEN` (کلید)، `MOCK_LLM_FAIL_EVERY` (مثلاً ۴: هر چهارمین فراخوانی مدل آزمایشی 503 می‌گیرد).
- **درس‌هایی که از آن استفاده می‌کنند:** دوره AUT-201 (همه درس‌ها) و دوره‌های بعدی مسیر خودکارسازی و ایجنت.
- **حالت:** تیکت‌ها و کلیدهای ایدمپوتنسی فقط در حافظه‌اند و با بستن برنامه پاک می‌شوند.
- **دسترسی از n8n داخل Docker:** کانتینر به `127.0.0.1` کامپیوتر تو دسترسی ندارد. API را با `--host 0.0.0.0` اجرا کن (فقط روی شبکه مطمئن، چون روی شبکه محلی دیده می‌شود) و در n8n نشانی `http://host.docker.internal:8787` را بزن. در Linux، n8n را با گزینه `--add-host=host.docker.internal:host-gateway` اجرا کن.
- **دو حالت مدل آزمایشی:** اگر پیام سیستمی کلمه `JSON` یا `classif` داشته باشد، خروجی طبقه‌بندی JSON (هم‌شکل `ticket-schema.json`) می‌دهد؛ وگرنه «حالت گفتگو» است و در پاسخ می‌گوید چند پیام گرفته و اولین و آخرین پیام کاربر چه بوده، تا حافظه و جدایی نشست‌ها را بیازمایی. پیام شامل `BROKEN` خروجی خراب و `RATE_LIMIT` پاسخ 429 می‌گیرد.
