# التطبيقات الجاهزة

كل من الثلاثة هو تطبيق عامل، وليس جزءًا من الكود: نموذج، خادم، رسم، واستجابة API. استنسخ، ضع المفتاح في `.env`، ثم شغّل. الكود تحت ترخيص MIT، لذا يمكنك أخذه إلى منتجك بدون شروط.

جميع الثلاثة مبنية بنفس الطريقة: Vite في الواجهة الأمامية وخادم Node صغير واحد تمر عبره الاستدعاءات. لا يمكن للمتصفح الوصول إلى API مباشرة، لذا يبقى المفتاح على الخادم ولا يصل إلى الصفحة.

```bash
git clone https://github.com/astroway/starter-human-design
cd starter-human-design && npm install
cp .env.example .env     # ваш ключ сюди
npm run dev
```

ستحصل على المفتاح في [لوحة التحكم](https://api.astroway.info/dashboard/sign-up). أثناء البناء، استخدم المفتاح التجريبي `aw_test_*`: إنه لا يستهلك أرصدة.

## التصميم البشري

تاريخ ووقت ومكان الميلاد كمدخل، وخريطة الجسم (bodygraph) وتحليلها كمخرج. استدعاء واحد `POST /v1/human-design` يعيد النوع، الاستراتيجية، السلطة، الملف الشخصي، التعريف، صليب التجسيد، المراكز التسعة مع البوابات النشطة، جميع القنوات المحددة، وكلا مجموعتي التنشيط. يرسم التطبيق خريطة الجسم (bodygraph) على SVG وجدول التنشيطات. 50 رصيدًا لكل قراءة، أي 200 قراءة على الخطة المجانية.

<CardGrid>
  <LinkCard title="عرض حي" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="الكود على GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="النشر على Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## با تسي

أركان القدر الأربعة ودورة الحظ. `POST /v1/bazi/chart` يعيد الأركان مع السيقان المخفية، على الين ومرحلة الاثني عشر مرحلة، سيد اليوم، توازن العناصر، حكم القوة مع الشرح، النجوم الرمزية، وجميع تركيبات وتصادمات الفروع. `POST /v1/bazi/luck-pillars` يعيد الدا يون: الاتجاه، عمر البداية، وعشرة أركان كل عشر سنوات. يتم إجراء كلا الاستدعاءين بالتوازي، 30 رصيدًا لكل قراءة.

<CardGrid>
  <LinkCard title="عرض حي" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="الكود على GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="النشر على Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## لوحة تقارير

للممارس: بيانات العميل كمدخل، وملف PDF جاهز بعلامتك التجارية كمخرج. ستة عشر تقريرًا تحت بادئة واحدة `POST /v1/reports/<type>`، كل منها يقبل كتلة `whitelabel`، لذا فإن الملف الذي يتلقاه العميل يحمل اسمك، وليس اسمنا. خمسة عشر تقريرًا تكلف 5000 رصيد، والتاروت 100.

<CardGrid>
  <LinkCard title="عرض حي" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="الكود على GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="النشر على Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
العروض التجريبية محدودة حسب العنوان وتعمل بمفاتيحها الخاصة مع الوصول إلى نقاط النهاية الخاصة بها فقط. يعرض العرض التجريبي للوحة التقارير التاروت فقط، لأن صفحة على الإنترنت المفتوح تقوم بإنشاء تقرير بقيمة 5000 رصيد لكل شخص ستستهلك الخطة المجانية الشهرية بنقرتين. نسختك تعرض جميع الستة عشر.
</Aside>

## النشر

يقرأ زر Render ملف `render.yaml` في المستودع: خدمة ويب واحدة على Node ضمن الخطة المجانية، يتم تجميعها وتشغيلها بواسطة السكريبتات من package.json. عند الإنشاء، سيطلب Render مفتاح API. أي استضافة تعمل عليها Node 22 مناسبة بنفس الطريقة: تجميع، تشغيل، تعيين المفتاح.