# تطبيقات علم التنجيم

بناء تطبيق Astro يشبه Co-Star أو Sanctuary أو The Pattern أو Chani أو Costar Compat؟ واجهة برمجة تطبيقات AstroWay تغنيك عن الحاجة لترخيص Solar Fire ($495) أو كتابة محرك الإِفِيمِيرِيس الخاص بك: {siteMeta.endpoints} من النِهايات (خرائط الميلاد، السيناستري، الترانزيت، التصميم البشري، تفسيرات الذكاء الاصطناعي)، مواصفات OpenAPI 3.1 لتوليد عملاء مُصنَّفة (TS / Python SDK في الخطة)، ودقة Swiss Ephemeris — نفس المحرك المستخدم في Astrodienst وKepler.

## البنية النمطية النموذجية

```
المستخدم (متصفح / جوال)
     ↓
الخلفية الخاصة بك (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
استجابة JSON → عرض في واجهة المستخدم الخاصة بك
```

<Aside type="caution">
لا تضع مطلقًا مفتاح API في الكود الأمامي. يجب أن تمر طلبات واجهة برمجة تطبيقات AstroWay عبر خلفيتك أو وظائف الخادم (مسارات API في Next.js، وظائف Vercel، AWS Lambda).
</Aside>

## النِهايات الرئيسية لتطبيق الفلك

### MVP (المنتج الأدنى القابل للتطبيق)

| النهاية | الاعتمادات | الاستخدام |
|---|---|---|
| `/v1/chart` | 20 | إنشاء خريطة الميلاد |
| `/v1/synastry` | 50 | توافق شخصين |
| `/v1/horoscope/daily` | 20 | الأبراج اليومية |

ثلاث نِهايات، وأنت تملك منتجًا عاملًا مع خريطة الميلاد والتوافق والمحتوى اليومي.

### المنتج المتقدم

| النهاية | الاعتمادات | الاستخدام |
|---|---|---|
| `/v1/transits` | 50 | الترانزيت الحالي على خريطة الميلاد |
| `/v1/solar-return` | 50 | السولار (الخريطة السنوية) |
| `/v1/progressions` | 50 | التقدمات الثانوية |
| `/v1/interpret/natal` | 50 | تفسير خريطة الميلاد بواسطة الذكاء الاصطناعي |
| `/v1/transit-calendar` | 100 | تقويم أحداث الترانزيت |
| `/v1/human-design` | 50 | خريطة التصميم البشري |

### الميزات المتميزة

| النهاية | الاعتمادات | الاستخدام |
|---|---|---|
| `/v1/rectification` | 500 | تصحيح وقت الميلاد |
| `/v1/acg` | 50 | خرائط التوزيع الجغرافي الفلكي (أين تعيش بشكل أفضل) |
| `/v1/forecast-calendar` | 100 | خريطة التنبؤ السنوي |
| `/v1/group-synastry` | 100 | توافق المجموعات |

## تقدير الميزانية

### السيناريو: 100 مستخدم نشط يوميًا (DAU)

نفترض أن المستخدم المتوسط يقوم بـ3 إجراءات يوميًا:

| الإجراء | النهاية | الاعتمادات | طلبات/يوم | اعتمادات/يوم |
|---|---|---|---|---|
| عرض الخريطة | `/v1/chart` | 20 | 100 | 2,000 |
| الأبراج اليومية | `/v1/horoscope/daily` | 20 | 100 | 2,000 |
| التوافق | `/v1/synastry` | 50 | 30 | 1,500 |
| **الإجمالي** | | | **230** | **5,500/يوم** |

**~165,000 اعتمادات/شهر** (5,500 × 30) → سعر **Starter ($19/شهر، 200,000 اعتمادات)** مع هامش 21%، أو **Indie ($5/شهر، 50,000)** مع دفع ~$5 مقابل الاعتمادات الإضافية 110K.

### السيناريو: MVP مع 20 DAU

| الإجراء | اعتمادات/يوم |
|---|---|
| 20 خريطة | 400 |
| 20 أبراج يومية | 400 |
| 5 توافقات | 250 |
| **الإجمالي** | **1,050/يوم** |

**~31,500 اعتمادات/شهر** → سعر **Indie ($5/شهر، 50,000 اعتمادات)**.

## نصائح

- **اِخزِن خرائط الميلاد مؤقتًا** — المدخلات ثابتة (تاريخ الميلاد لا يتغير)، لذا يمكنك تخزين النتيجة إلى الأبد في قاعدة بياناتك
- **اِخزِن الأبراج اليومية مؤقتًا** — الأبراج اليومية نفسها لجميع الأشخاص من نفس البرج، احصل عليها مرة واحدة ووزعها
- **مفاتيح Sandbox** (`aw_test_*`) — للتطوير، لا تستهلك الاعتمادات
- **إنشاء الكود من OpenAPI 3.1** — ضع `/v1/openapi.json` في `openapi-typescript` أو `openapi-python-client` واحصل على عميل مُصنَّف (SDKs جاهزة في الخطة)

<CardGrid>
  <LinkCard title="البدء السريع →" href="/getting-started/" description="أول طلب في 5 دقائق" />
  <LinkCard title="API خريطة الميلاد" href="/products/birth-chart-api/" description="تفاصيل حول خريطة الميلاد" />
  <LinkCard title="الأسعار" href="/pricing/" description="من مجاني إلى المؤسسة" />
</CardGrid>