الراتنا (الأحجار العلاجية)

الراتنا (रत्न) حجر علاجي لكوكب ما. تسعة أحجار، navaratna، حجر لكل واحد من الغراها التسعة. سؤال “أي حجر ألبس” يبدو بسيطًا، لكن الإجابة تتوقف على المدرسة، والمدرستان الشائعتان تعطيان محظورات مختلفة. لذلك يأخذ /v1/vedic/gemstones المدرسة كمعامل، ويذكر في الاستجابة دائمًا بأي مدرسة أجرى الحساب.

مدرستان

المدرسة	ما توصي به	ما تحظره
`lagna-lord` (افتراضيًا)	أحجار حكام البيوت الأول والتاسع والخامس: حجر الحياة وحجر الحظ وحجر الخير	لا شيء تقريبًا: فقط الغراها التي تحكم بيوت dusthana حصرًا
`functional-benefic`	الأحجار الثلاثة نفسها، لكن اليوغاكاراكا تأتي أولًا إن وُجدت	أحجار جميع الكواكب المؤذية وظيفيًا (functional malefic) لهذا اللاغنا

الأحجار الموصى بها متطابقة في المدرستين، وليس ذلك مصادفة: الكوكب النافع وظيفيًا يُعرَّف بأنه الغراها التي تحكم بيت trikona، وحكام بيوت trikona هم أنفسهم حكام 1 و5 و9. لم نفترض ذلك بل تحققنا منه بتشغيل على اللاغنات الاثني عشر كلها، وثبّتناه باختبار.

الفرق يقع حيث يهم المشتري: قائمة المحظورات. للاغنا الأسد تستبعد functional-benefic الزمرد والألماس والياقوت الأزرق، بينما لا تستبعد lagna-lord أيًا منها. إذا كان منجمك يعمل بمدرسة وأعطيت عميلك إجابة الأخرى، فسيكون الاختلاف هنا بالذات.

نقاط النهاية

نقطة النهاية	الأرصدة	ما تعيده
`POST /v1/vedic/gemstones`	20	توصية بحسب الخريطة: ثلاثة أحجار مع دور كل منها، قائمة المحظورات، التحذيرات، حالة الكواكب
`GET /v1/vedic/gemstones/navaratna`	5	جدول مرجعي للأحجار التسعة بلا خريطة

مثال

curl -X POST https://api.astroway.info/v1/vedic/gemstones \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52,
    "school": "functional-benefic"
  }'

const r = await fetch('https://api.astroway.info/v1/vedic/gemstones', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-05-15', time: '14:30:00', timezoneOffset: 3,
    latitude: 50.45, longitude: 30.52, school: 'functional-benefic',
  }),
});
const { data } = await r.json();
console.log(`Lagna ${data.lagna.signName}, school ${data.school}`);
for (const g of data.recommended) console.log(`  ${g.role}: ${g.gem}`);
for (const g of data.avoid) console.log(`  avoid ${g.gem} (${g.basis})`);

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/vedic/gemstones',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-05-15', 'time': '14:30:00', 'timezoneOffset': 3,
        'latitude': 50.45, 'longitude': 30.52, 'school': 'functional-benefic',
    },
)
d = r.json()['data']
print(f"Lagna {d['lagna']['signName']} ({d['school']})")
for g in d['recommended']:
    w = g['wearing']
    print(f"  {g['gem']:16s} {w['day']:10s} {w['finger']:14s} {w['minWeight']['carats']} ct")

مثال على الاستجابة

{
  "type": "gemstone-recommendation",
  "school": "functional-benefic",
  "ayanamsa": 23.7225,
  "lagna": { "sign": 4, "signName": "Leo", "lord": 0, "lordName": "Sun" },
  "recommended": [
    {
      "role": "yogakaraka (primary)",
      "graha": 4, "grahaName": "Mars",
      "gem": "Red coral", "gemSanskrit": "Moonga",
      "mineral": "Corallium rubrum",
      "housesOwned": [4, 9],
      "basis": "owns the 4th (kendra) and the 9th (trikona)",
      "substitutes": ["Carnelian", "Red jasper"],
      "wearing": {
        "day": "Tuesday",
        "finger": "Ring finger",
        "metals": ["Gold", "Copper"],
        "minWeight": { "ratti": [6, 9], "grams": [0.729, 1.094], "carats": [3.65, 5.47] },
        "mantra": "Om Kraam Kreem Kraum Sah Bhaumaya Namah",
        "japaCount": 10000
      }
    }
  ],
  "avoid": [
    { "gem": "Blue sapphire", "basis": "owns the 6th and no trikona" },
    { "gem": "Emerald", "basis": "owns the 11th and no trikona" }
  ],
  "condition": {
    "Sun": { "signName": "Taurus", "house": 10, "dignity": "neutral", "isCombust": false }
  },
  "disclaimer": "Traditional Jyotish remedy, informational only..."
}

ما الذي يُعاد بالضبط

basis على كل حجر ليس ملصقًا بل تتبّع: أي البيوت تحكمها الغراها ولماذا يعطيها ذلك هذا الدور. يمكن التحقق من التوصية دون تصديقنا على كلمتنا.
wearing: اليوم، الإصبع، المعادن، الوزن بالـ ratti مع التحويل إلى غرامات وقراريط، مانترا البيجا وعدد مرات الجابا. يُعطى الوزن كنطاق والإصبع كقائمة خيارات، لأن المراجع تختلف.
substitutes (upa-ratna): البديل العملي لياقوت أزرق طبيعي بوزن 5 قراريط ليس “بلا علاج”، بل بديل أرخص. من يحسب تكلفة التوصية يجب أن يرى الخيارين.
condition: الكرامة، الاحتراق، التراجع لكل غراها. هذا سياق وليس قاعدة: المدرستان كلتاهما تصفان الحجر بحسب حكم البيوت، والقول بغير ذلك يعني اختراع مدرسة ثالثة.
nodesNote: راهو وكيتو لا يحكمان أي برج، لذا لا تصل أي من المدرستين من اللاغنا إلى الغوميد وعين القط. نكتب ذلك صراحة بدل أن نعيد بصمت سبعة أحجار من تسعة.

الدقة والمصادر

مطابقة الحجر للغراها: Garuda Purana (Acharakhanda، باب ratna-pariksha) وVarahamihira، Brihat Samhita، الفصل 80. يعطي النصان المجموعة نفسها من الأحجار التسعة.
قاعدة الأحجار الثلاثة (الحياة، الحظ، الخير) هي الممارسة الحديثة المعيارية.
التصنيف الوظيفي: Bepin Behari، Fundamentals of Vedic Astrology. أما قاعدة اليوغاكاراكا نفسها فمصدرها BPHS: الغراها التي تحكم بيت kendra وبيت trikona معًا.
كيف تحققنا. هذه ليست تقنية رقمية، ولا يوجد هنا ما ينحرف عن الـ ephemeris. التحقق الوحيد الممكن: يجب أن تعيد القواعد إنتاج الوصفات المنشورة دون ترميزها في أي مكان. السداسية الكلاسيكية لليوغاكاراكا (زحل للثور والميزان، المريخ للسرطان والأسد، الزهرة للجدي والدلو) تنتج من قاعدة حكم البيوت بنفسها، وكذلك قوائم المحظورات المعروفة للحمل والثور والسرطان والأسد. كل واحد من هذه الادعاءات اختبار.
اللاغنا فلكي (sidereal)، مشتق عبر الـ ayanamsa. الطالع الاستوائي يكون عادة منزاحًا برجًا كاملًا، وهذا كان سيغيّر كل حجر في الاستجابة.
بروتوكول اللبس (اليوم، الإصبع، المعدن، الوزن، المانترا) ممارسة حديثة وليس شاسترا. لذلك نقدّم خيارات ونطاقًا، لا رقمًا واحدًا يُقدَّم على أنه قانون.