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

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

Technika, kterou astrologové používají k nápravě tohoto problému, se nazývá rektifikace – obnovení pravděpodobného času narození z významných událostí života. Tradičně jde o hodiny manuální práce. AstroWay nabízí dva algoritmické endpointy, které ji automatizují.

V tomto příspěvku se dozvíš, kdy použít rektifikaci, jak algoritmy fungují 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í:

• Významných událostí života (svatba, děti, změna kariéry, úmrtí)
• Fyzických charakteristik (klasická astrologie mapuje znamení ascendentu na typy těla)
• Úhlových pozic planet při narození

Výsledkem je upřesněný čas narození, obvykle v rozmezí ±5 minut od skutečného času.

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

Jak to funguje:

1. Zadáš přibližné datum narození
2. Vypočítáš rozmezí dat početí (260–290 dní předem)
3. Pro každé kandidátské datum početí zkontroluješ, zda pozice Měsíce při narození odpovídá ascendentu/descendentu v okamžiku početí
4. Vrátíš seznam kandidátských časů narození seřazených podle „fit“

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

const result = await client.rectificationTrutine({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '12:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
});

console.log(`Nejlepší kandidát: ${result.bestTime}`);
console.log(`Spolehlivost: ${result.confidence}`);

Algoritmický přístup založený na několika událostech života. Jde o náročnější variantu (až 120 sekund na požadavek).

Vstup:

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

Algoritmus:

1. Generuje kandidátské časy narození uvnitř zadaného rozmezí (obvykle po 1 minutě)
2. Pro každého kandidáta spočítá natalní mapu
3. Ohodnotí každého podle toho, jak dobře se události shodují s předpokládanými astrologickými vzorci (progrese, direktivy, transity)
4. Vrátí top kandidáty s hodnocením spolehlivosti

const result = await client.rectification({
  date: '1990-07-14',
  timeRange: { start: '06:00:00', end: '18:00:00' },
  latitude: 50.4501,
  longitude: 30.5234,
  timezoneOffset: 3,
  events: [
    { date: '2015-06-20', type: 'marriage' },
    { date: '2018-03-12', type: 'firstChild' },
    { date: '2020-09-05', type: 'careerChange' },
  ],
});

console.log(`Rektifikovaný čas: ${result.bestTime}`);
console.log(`Kandidáti: ${result.candidates.length}`);

Rektifikace je cenná pro:

• Aplikace s uživateli, kteří neznají přesný čas — nabídni rektifikaci jako prémiovou funkci
• Profesionální nástroje astrologa — ušetří hodiny manuální práce na každého klienta
• HD aplikace — Human Design je velmi citlivý na čas; rektifikace výrazně zlepšuje přesnost
• Výzkumné aplikace — validovat historické mapy, kde jsou záznamy času nepřesné

Není užitečná pro:

• Aplikace, kde uživatel již zná čas s přesností ±5 minut (žádný užitek)
• Kvalitativní horoskopové aplikace, 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

Jde o nejnáročnější endpointy v API. Pokud nabízíš rektifikaci jako funkci — oceň ji odpovídajícím způsobem: jde o prémiovou operaci, 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í — nezablokuj požadavek; zařaď ho do fronty a ukaž průběh
• Indikátor průběhu — úplný endpoint trvá až 120 sekund; 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('Probíhá rektifikace (může trvat až 2 minuty)...');

  try {
    const result = await client.rectification(input);
    setResult(result);
    setStatus(`Hotovo. Upřesněný čas: ${result.bestTime} (spolehlivost ${result.confidence}%)`);
  } catch (err) {
    setStatus(`Chyba: ${err.message}`);
  } finally {
    setLoading(false);
  }
}

Typický flow rektifikace v aplikaci:

1. Uživatel zadá přibližná data narození + životní události
2. Aplikace nejprve zavolá /v1/rectification/trutine (levné, rychlé), aby zužilo okno
3. Poté zavolá /v1/rectification (úplné) s upřesněným oknem pro přesnost
4. Aplikace výsledky ukládá do cache a používá upřesněný čas pro všechny budoucí výpočty
5. Budoucí volání jsou označena značkou „rektifikováno z přibližného“

Tento kombinovaný přístup stojí ~750 kreditů za celý cyklus, ale poskytuje nejlepší přesnost.

Rektifikace nikdy nedává 100% přesnost. I profesionální astrologové se rozcházejí v odhadech 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 uživatelům ukazuj hodnocení spolehlivosti a dej jim možnost ho překontrolovat, pokud mají lepší informace.

Algoritmy jsou hledáním vzorců. Zkušený astrolog bere v úvahu kontext, který je těžké zakódovat: „Byla svatba uspěchaná?“ „Byla změna kariéry dobrovolná?“ Pro mapy s vysokými sázkami kombinuj:

1. Algoritmickou rektifikaci — aby se zužilo okno
2. Ruční přezkum astrologem — pro finální upřesnění

Tvá aplikace může toto nabídnout jako prémiovou konzultaci.

• API reference — najdi endpointy rectification a rectification/trutine
• Ceník — cena v kreditech podle plánu
• Rychlý start — získej API klíč