Rectification API: korekce času narození pro vývojáře

Většina uživatelů astrologie zná datum narození, ale nezná přesný čas. Rozdíl 30 minut může posunout ascendent o 5+ stupňů – a to mění postavení domů a aspekty. Pro seriózní astrologickou práci je to důležité.

Technika, kterou astrologové toto opravují, se nazývá rektifikace – obnovení pravděpodobného času narození z známých životních událostí. Tradičně to jsou hodiny ruční práce. AstroWay nabízí dva algoritmické endpointy, které ji automatizují.

V tomto příspěvku – kdy rektifikaci aplikovat, jak fungují algoritmy a jak ji integrovat do své aplikace.

Rektifikace je korekce času narození. Začínáš s přibližným časem (například “ráno” nebo “kolem 14:00”) a zužuješ ho pomocí:

• Důležité životní události (sňatek, děti, změna kariéry, úmrtí)
• Fyzické charakteristiky (klasická astrologie mapuje znamení ascendentu na typy těla)
• Úhlové pozice planet při narození

Na výstupu – upřesněný čas narození, obvykle v rozmezí ±5 minut od skutečného.

Klasická metoda, připisovaná Hermovi Trismegistovi. Využívá souvislost mezi pozicí Měsíce v okamžiku narození a ascendentem / descendentem v okamžiku početí (~9 měsíců dříve).

Jak to funguje:

1. Vezmeme přibližné datum narození
2. Vypočítáme rozsah dat početí (260–290 dní dříve)
3. Pro každé kandidátní datum početí ověříme, zda pozice Měsíce při narození odpovídá ascendentu / descendentu v okamžiku početí
4. Vrátíme seznam kandidátních časů narození, seřazených podle fitu

Rychlé, ale méně přesné. Dobré pro zúžení širokého okna (například “ráno” → 2hodinové okno).

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

console.log(`Suggested ascendant: ${result.suggestedAsc.toFixed(2)}°`);
console.log(`Moon above the horizon at conception: ${result.moonAboveHorizon}`);

Algoritmický přístup založený na několika životních událostech. Toto je náročná varianta (až 120 s na požadavek).

Vstup:

• Přibližný čas narození (rozsah)
• Seznam životních událostí s daty a typy
• Volitelně: fyzický popis

Algoritmus:

1. Generuje kandidátní časy narození uvnitř rozsahu (obvykle s krokem 1 minuta)
2. Pro každého kandidáta vypočítá natální mapu
3. Ohodnotí každého, nakolik události odpovídají předpokládaným astrologickým vzorcům (progrese, direkce, tranzity)
4. Vrátí top kandidáty s hodnocením spolehlivosti

const result = await client.rectification.compute({
  baseInput: {
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  },
  events: [
    // type picks which significators are checked; weight is 1-3 importance
    { date: '2015-06-20', type: 'marriage', description: 'married', weight: 3 },
    { date: '2018-03-12', type: 'child', description: 'first child', weight: 2 },
    { date: '2020-09-05', type: 'career', description: 'career change', weight: 2 },
  ],
  searchRangeMinutes: 120,
  stepMinutes: 5,
});

const best = result.candidates[0];
console.log(`Best candidate: ${best.timeFormatted}, score ${best.score.toFixed(2)}, ${result.count} candidates scored`);
console.log(`Candidates: ${result.candidates.length}`);

Rektifikace je cenná pro:

• Aplikací s uživateli, kteří neznají čas: nabízej rektifikaci jako premium funkci
• Profesionálních astrologických nástrojů: šetří hodiny ruční práce na každého klienta
• HD-aplikací: Human Design je velmi citlivý na čas; rektifikace výrazně zlepšuje přesnost
• Výzkumných aplikací: validovat historické mapy, kde jsou záznamy času nepřesné

Není užitečná pro:

• Aplikací, kde uživatel již zná čas s přesností na ±5 min (žádný přínos)
• Neformálních horoskopických aplikací, kde přesnost času neovlivňuje výstup (denní sun sign ji nepotřebuje)

• Trutine: 250 kreditů: ~1–2 sekundy na požadavek
• Plná rektifikace: 500 kreditů: až 120 sekund

Toto jsou nejnáročnější endpointy v API. Pokud nabízíš rektifikaci jako funkci – tarifuj ji odpovídajícím způsobem: je to prémiová operace, která ospravedlňuje vyšší tarif předplatného nebo jednorázový nákup.

Plánování rozpočtu:

• 100 rektifikací měsíčně: ~50 000 kreditů = plán Pro ($59) s rezervou na další volání
• 1 000 rektifikací měsíčně: 500 000 kreditů = Enterprise

Rektifikace zabere čas. UI by mělo:

• Asynchronní zpracování: neblokuj požadavek; zařaď ho do fronty, ukaž průběh
• Indikátor průběhu: plný endpoint pracuje až 120 s; uživatel potřebuje zpětnou vazbu
• Zobrazení výsledku: upřesněný čas, úroveň spolehlivosti, možnost restartu, pokud jsou události nepřesné

async function handleRectify(input: RectifyInput) {
  setLoading(true);
  setStatus('Running rectification (this may take up to 2 minutes)...');

  try {
    const result = await client.rectification.compute(input);
    setResult(result);
    const best = result.candidates[0];
    setStatus(`Done. Refined time: ${best.timeFormatted} (score ${best.score.toFixed(2)} of ${result.count})`);
  } catch (err) {
    setStatus(`Error: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Typický flow rektifikace v aplikaci:

1. Uživatel zadá přibližné údaje o narození + životní události
2. Aplikace nejprve zavolá /v1/rectification/trutine (levně, rychle), aby zúžila okno
3. Poté zavolá /v1/rectification (plná) s upřesněným oknem pro přesnost
4. Aplikace cachuje výsledek a používá upřesněný čas pro všechny budoucí výpočty
5. Budoucí volání jsou označena štítkem “rectified from approximate”

Takový kombinovaný přístup – ~750 kreditů na plný cyklus, ale poskytuje nejlepší přesnost.

Rektifikace nikdy neposkytuje 100% přesnost. I profesionální astrologové se v odhadech rozcházejí o 5–10 minut.

Algoritmus AstroWay je zaměřen na relativní přesnost – zužuje okno, ale výstup je vždy prezentován jako “nejlepší kandidát”, nikoli jako zaručená pravda. Vždy ukazuj uživatelům hodnocení spolehlivosti a dej jim možnost přepsat, pokud mají lepší informace.

Algoritmy jsou hledání vzorců. Zkušený astrolog zohledňuje kontext, který je obtížné zakódovat: “Byl sňatek uspěchaný?” “Byla změna kariéry dobrovolná?” Pro mapy s vysokými sázkami kombinuj:

1. Algoritmickou rektifikaci: pro zúžení okna
2. Ruční kontrolu astrologem: pro finální upřesnění

Tvá aplikace to může nabízet jako prémiovou konzultaci.

• API reference: najdi endpointy rectification a rectification/trutine
• Ceny: cena v kreditech dle plánu
• Rychlý start: získej API klíč