Dignity & functional nature

GET /v1/vedic/charts/{id}/dignity

Classifies each classical planet (Sun..Saturn, Rahu, Ketu) into one of 9 strength buckets based on its sign placement:

• exaltation, mooltrikona, own_sign
• great_friend, friend, neutral, enemy, great_enemy
• debilitation

Algorithm: Parashara's combined natural + temporal friendship rule. The classifier picks the first matching tier from most-favourable downward.

{
  "chart_id": "01HKD…",
  "entries": [
    {"planet": "sun", "sign": "aries", "strength": "exaltation", "sign_lord": "mars"},
    {"planet": "moon", "sign": "taurus", "strength": "exaltation", "sign_lord": "venus"},
    {"planet": "saturn", "sign": "libra", "strength": "exaltation", "sign_lord": "venus"},
    "…"
  ]
}

GET /v1/vedic/charts/{id}/functional-nature

Per-ascendant role of each planet:

• lagnesha — owns the 1st house.
• yoga_karaka — owns both a kendra (1/4/7/10) and trikona (5/9).
• benefic, malefic, neutral — per BPHS canonical table.

Priority: Lagnesha > Yoga-karaka > table-based role.

{
  "chart_id": "01HKD…",
  "lagna": "taurus",
  "entries": [
    {"planet": "venus", "role": "lagnesha"},
    {"planet": "saturn", "role": "yoga_karaka"},
    {"planet": "jupiter", "role": "malefic"},
    "…"
  ]
}