Human Design API: ابنِ تطبيقات HD على 12 نقطة نهاية

🕓 تدوينة بتاريخ 2026-04-14، حُدّثت في 2026-05-09. مكتبات TS / Python / PHP SDK متاحة الآن في السجلات العامة: @astroway/sdk (npm)، astroway (PyPI)، astroway/sdk (Packagist). التفاصيل في سجل التغييرات.

تحوّل Human Design من نظام باطني محدود الانتشار في تسعينيات القرن الماضي إلى إطار شائع للتطوير الذاتي. جعلته تطبيقات يستخدمها الملايين أمرًا مألوفًا، وصار المطورون يسألون: كيف نحسب خريطة Human Design برمجيًا؟

في هذه التدوينة نتناول الجانب التقني: ما هي حسابات HD، وأي واجهات API تدعمها، وكيف تدمج ميزة HD في تطبيقك.

يقوم Human Design على ثلاثة أنظمة كلاسيكية:

• علم التنجيم الغربي: مواقع الكواكب لحظة الولادة
• I Ching: 64 سداسية (هكساغرام) مربوطة بـ 64 “بوابة”
• نظام الشاكرات: تسعة “مراكز” (عقد طاقية)

يأخذ الحساب بيانات الولادة ويُخرج bodygraph، وهي خريطة مرئية تتضمن:

• Type (Manifestor، Generator، Manifesting Generator، Projector، Reflector): البصمة الطاقية
• Strategy: كيف تتخذ القرارات
• Authority: أي مركز تثق به عند اتخاذ القرار (Sacral، Emotional، Splenic وغيرها)
• Profile: تركيبة من الخطوط (1/3، 4/6 وغيرها)
• Channels: الروابط بين المراكز التي تشكّل الشخصية
• Incarnation Cross: الغاية من الحياة، مشتقة من أربعة مواقع أساسية

في الداخل، تقابل كل بوابة من البوابات الـ 64 نطاقًا من خط الطول البروجي (الإكليبتيكي). يُربط خط طول كواكبك عند الولادة ببوابات محددة (وبخطوط داخلها). أما حساب “Design” فيخص لحظة كانت فيها الشمس قبل موقعها عند الولادة بـ 88°، أي قبل الولادة بنحو 3 أشهر.

يستخدم Human Design لحظتين للولادة:

1. Personality: وقت الولادة الفعلي. هذا هو الجانب “الواعي”.
2. Design: اللحظة التي كانت فيها الشمس على بعد 88° قبل موقعها عند الولادة. هذا هو الجانب “اللاواعي”.

كل تفعيل لبوابة ينتمي إلى إحدى الخريطتين. الخريطة الكاملة فيها 13 + 13 = 26 تفعيلًا.

وهذا بالضبط ما يجعل حسابات HD أثقل من الخريطة الفلكية المعتادة: أنت في الواقع تحسب خريطتين.

معظم واجهات API الفلكية إما لا تدعم HD إطلاقًا، وإما تدعمه دعمًا سطحيًا (type و strategy فقط). التطبيق الكامل لـ HD يتطلب:

• ربط 64 بوابة (جدول بحث)
• 6 خطوط لكل بوابة (384 خلية)
• 9 مراكز مع منطق defined/open
• 36 قناة (كل منها تصل بين مركزين)
• حساب Incarnation Cross
• استنتاج Profile من خط بوابة الشمس وخط بوابة الأرض (Personality و Design)

واجهات API التي تنجز كل ذلك نادرة جدًا. يقدّم AstroWay API 12 نقطة نهاية لـ HD، وهي أعمق تغطية رأيناها في API تجاري.

تخيّل أنك تضيف HD إلى تطبيق فلكي قائم. ابدأ بنقطة النهاية الرئيسية:

import { Astroway } from '@astroway/sdk';

const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const hd = await client.humanDesign.compute({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Type: ${hd.type}`);         // e.g. "Generator"
console.log(`Strategy: ${hd.strategy}`); // e.g. "To Respond"
console.log(`Authority: ${hd.authority}`); // e.g. "Sacral"
console.log(`Profile: ${hd.profile.profile}`);   // e.g. "1/3"
console.log(`Defined channels: ${hd.channels.length}`);

شكل الاستجابة:

{
  "type": "Generator",
  "strategy": "To Respond",
  "notSelfTheme": "Frustration",
  "authority": "Sacral",
  "profile": "1/3",
  "definition": "single",
  "cross": {
    "name": "Right Angle Cross of the Sphinx",
    "quarter": "Civilization",
    "gates": [1, 2, 7, 13]
  },
  "centers": [
    { "name": "Sacral", "defined": true },
    ...
  ],
  "channels": [
    { "gate1": 34, "gate2": 20, "name": "Channel of Charisma", "type": "Generated" }
  ],
  "personalityActivations": [...],
  "designActivations": [...]
}

Penta تقنية لفهم ديناميكيات الفريق في مجموعات من 3–5 أشخاص. إنها نادرة، فمعظم حاسبات HD لا توفرها. لكنها كنز لمنصات HR-tech والكوتشينغ وتطبيقات بناء الفرق.

const penta = await client.hd.penta({
  inputs: [
    { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    { date: '1988-03-10', time: '08:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
    { date: '1985-11-22', time: '18:00:00', timezoneOffset: -5, latitude: 40.71, longitude: -74.00 },
  ],
});

console.log(`Members: ${penta.memberCount}`);
console.log(`Channels in the group: ${penta.channels.length}`);

خرائط HD حساسة لوقت الولادة. خطأ بعشر دقائق قد يغيّر Profile (مثلًا من 1/3 إلى 1/4). للمستخدمين الذين لا يعرفون وقت ولادتهم بدقة، شغّل تحليل الحساسية:

const sensitivity = await client.hd.sensitivity({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

// sensitivity tells you which fields change if time shifts ±5/15/30 min

استخدم ذلك لتنبيه المستخدم: “بهذه الدقة قد يتغير الـ profile لديك. فكّر في تصحيح وقت الولادة (rectification)”.

إذا كنت تبني تطبيقًا يركز على HD:

• مستخدم أساسي: خريطة HD واحدة عند التسجيل، مخزّنة مؤقتًا إلى الأبد = 50 رصيدًا لمرة واحدة
• مستخدم نشط: عبورات دورية + compatibility = نحو 200 رصيد/شهر
• 100 مستخدم نشط يوميًا (DAU) باستخدام معتدل لـ HD: نحو 110 000 رصيد/شهر، وخطة Starter ($19/شهر) تغطي ذلك بسهولة
• 1 000 DAU: نحو 150 000 رصيد/شهر، أي Pro ($59/شهر)

طلبات compatibility هي الأثقل (100 رصيد). خزّن النتيجة لكل زوج من المستخدمين إلى الأبد (فهي لا تتغير).

يُرسم الـ bodygraph تقليديًا بـ SVG. تُرجع الـ API بيانات المراكز والقنوات، وأنت ترسم الشكل. مثال:

function Bodygraph({ hd }: { hd: HDChart }) {
  return (
    <svg viewBox="0 0 400 600">
      {hd.centers.map(c => (
        <polygon
          key={c.name}
          points={CENTER_COORDS[c.name]}
          fill={c.defined ? CENTER_COLORS[c.name] : 'white'}
          stroke="black"
        />
      ))}
      {hd.channels.map(ch => (
        <line
          key={`${ch.gate1}-${ch.gate2}`}
          x1={GATE_COORDS[ch.gate1].x}
          y1={GATE_COORDS[ch.gate1].y}
          x2={GATE_COORDS[ch.gate2].x}
          y2={GATE_COORDS[ch.gate2].y}
          stroke="#d4a84c"
          strokeWidth="3"
        />
      ))}
    </svg>
  );
}

الإحداثيات قالب ثابت (كل bodygraph فيه المراكز التسعة نفسها والبوابات الـ 64 نفسها في المواقع ذاتها).

• Human Design API: صفحة المنتج مع القائمة الكاملة لنقاط النهاية
• مثال: Human Design: شرح تفصيلي خطوة بخطوة لـ /v1/human-design
• البدء السريع: احصل على مفتاح API مجاني (حتى 200 خريطة HD شهريًا في خطة Free)