# التركيبات الجاهزة - معرض

## عشرة مشاريع جاهزة للنماذج الشائعة

كل وصفة عبارة عن ملف واحد، بدون خطوات بناء. ضع مفتاح الـAPI الخاص بك → شغّل `npx tsx` أو `python` → يعمل فورًا.

جميع الوصفات أدناه جاهزة للاستخدام الفوري: المفتاح عبر الـ`X-Api-Key` header، الطلبات عبر `fetch` أو `requests` القياسية. من المخطط إصدار SDKs بلغة TypeScript / Python — يكفي هذا في الوقت الحالي.

## ما في المعرض

| # | الوصفة | الستاك | الحالة الاستخدام |
|---|---|---|---|
| 1 | البرج اليومي عبر SMS | Twilio + Node.js | cron يرسل البرج اليومي للمستخدمين عبر SMS |
| 2 | بوت Discord `/chart` | discord.js | أمر slash — أي شخص في الدردشة يمكنه إنشاء خريطة ميلاد |
| 3 | استدعاء وظائف OpenAI | openai + Node.js | GPT يستدعي الخرائط تلقائيًا عبر استدعاء الأداة |
| 4 | بوت Slack `/synastry` | @slack/bolt | أمر الفريق لفحص التوافق بكتابة سطر واحد |
| 5 | إثراء Notion | @notionhq/client | تاريخ الميلاد في قاعدة البيانات → خريطة ميلاد كاملة تلقائيًا |
| 6 | تخزين مؤقت لـ Cloudflare Worker | CF Workers KV | تخزين مؤقت للطلبات المتطابقة لمدة 30 يومًا |
| 7 | أدوات Claude MCP | @astroway/mcp | Claude Desktop / Code يستدعي الـAPI كأداة أصلية |
| 8 | تصدير التنبؤات إلى CSV | Python + pandas | تنبؤ لمدة 12 شهرًا → CSV لـ BI / Tableau |
| 9 | واجهة مستخدم لتصحيح الوقت في Streamlit | Python + Streamlit | واجهة تفاعلية لتصحيح وقت الميلاد |
| 10 | خدمة توافق على FastAPI | Python + FastAPI | خدمة HTTP لتطبيقات المواعدة: خريطتين → درجة تقييم |

## كيفية الاستخدام

1. انسخ الملف المطلوب إلى مشروعك.
2. ثبّت الاعتماديات المذكورة في رأس الملف (`npm install ...` أو `pip install ...`).
3. عيّن المتغيرات البيئية (الحد الأدنى هو `ASTROWAY_API_KEY`).
4. شغّل.

## أنماط في المعرض

- **نص برمجي لمرة واحدة** (1، 5، 8) — معالجة دفعية على نمط cron.
- **بوت دائم** (2، 4) — اتصال دائم، يستمع لأوامر slash.
- **خدمة HTTP** (10) — REST جاهز تحت تصرفك مع نظام التحقق الخاص بك.
- **دالة Edge** (6) — طبقة تخزين مؤقت بين العميل وAPI.
- **تكامل أدوات نماذج اللغة الكبيرة** (3، 7) — تقديم الـendpoints كأدوات للذكاء الاصطناعي.
- **واجهة مستخدم** (9) — واجهات أمامية تفاعلية.

## لم يتم تغطيته بعد

إذا لم يكن سيناريواك في القائمة (على سبيل المثال: بوت Telegram، سير عمل n8n، إجراء Zapier، عنصر مدمج على الموقع) — **اكتب لنا على [api@astroway.info](mailto:api@astroway.info?subject=Integration%20recipe)** مع وصف. نضيف الوصفات بناءً على الطلبات الحقيقية، لا نخمن.