Точність - це те, за чим користувач мовчки перевіряє тебе на Astrodienst. Якщо натальна карта розійшлась на кутову хвилину, скарга прилетить швидко. І найгірше в цьому те, що точність легко зламати непомітно: один рефакторинг у коді ефемерид, і половина ендпоінтів тихо поїхала на секунди дуги.
Ось як ми не даємо цьому статися.
Одне ядро на два середовища
Section titled “Одне ядро на два середовища”Планетні позиції рахує Swiss Ephemeris, скомпільований у WASM. Ключове: це те саме ядро і в браузері нашого застосунку, і на сервері API. Одна кодова база core/, підтягнута в бекенд через cross-repo alias і вбудована в бандл на білді. Немає «браузерної» та «серверної» реалізації, які можуть розійтися - розходитися нічому.
Для дат поза основним діапазоном ефемерид є аналітичний fallback (Moshier), трохи грубший, але без розривів на межах. Свідома чесність: конкретну версію рушія ми публічно не заявляємо, бо реальна версія ядра нижча за найновіший upstream, і писати гучну цифру було б брехнею.
Заморожені снапшоти
Section titled “Заморожені снапшоти”Кожен розрахунковий ендпоінт має набір заморожених снапшотів - 873 JSON-фікстур на момент цього білда. Раннер проганяє ендпоінт на еталонних картах і побайтово (в межах толерансу) звіряє з фікстурою. Будь-яке відхилення планетної довготи більше ніж 5e-5° (0.18″) валить тест.
Еталонні карти підібрані так, щоб бити по краях, а не тільки по «зручному» центру:
- Monroe, Diana, Einstein, Bowie - історичні карти з відомими даними народження
- полярна широта - де системи домів вироджуються
- екваторіальна - де вони поводяться інакше
- південна півкуля - перевірка дзеркальності
Граничні випадки ловлять саме ті регресії, які не видно на карті умовного киянина.
Триангуляція проти зовнішніх джерел
Section titled “Триангуляція проти зовнішніх джерел”Снапшоти ловлять регресії відносно самих себе. Щоб перевіряти абсолютну правду, кожен реліз звіряється з незалежними джерелами:
| Проти чого | Що перевіряє | Розходження |
|---|---|---|
| swetest CGI (Astrodienst) | планетні довготи, куспіди домів | 0.000″ |
| Kerykeion (Python, pyswisseph) | незалежна реалізація SwEph | < 0.2″ |
| Prokerala (sidereal Lahiri) | сайдеричні позиції | 8-17″, системна різниця формули аянамші, не рушія |
| NASA 5-Millennium Eclipse Catalog | час і тип затемнень | < 1 хв |
Розходження з Prokerala - не помилка: це різні реалізації формули Lahiri, і ми документуємо це явно, а не ховаємо. З swetest, який є еталоном індустрії, дрейф нульовий.
Астрокартографічні лінії окремо перевіряються геометрично - точність на екваторі краща за 1.5 км.
Що гоняється на кожному PR
Section titled “Що гоняється на кожному PR”Точність - це CI-gate, а не разова перевірка:
api-accuracy.yml- на кожен PR у бекенд-код проганяє весь набір снапшотів + триангуляцію. Червоний тест блокує merge.check-eclipse-accuracy.yml- раз на рік звіряє затемнення з каталогом NASA; розходження понад поріг автоматично заводить issue.check-sweph-updates.yml- щотижня стежить за upstream Swiss Ephemeris і WASM-пакетом; нова версія - issue на ревʼю, без автомерджу (оновлення рушія ефемерид - надто чутлива штука для авто-апдейту).
Що це дає інтегратору
Section titled “Що це дає інтегратору”Гарантія проста: планетні позиції в межах < 0.1 кутової секунди від еталонного Swiss Ephemeris, і ця межа захищена автоматикою, а не обіцянкою в README. Якщо колись зʼявиться регресія, вона впаде в наш CI, а не у скарзі твого користувача.
Публічна версія цих цифр, з таблицею розходжень по конкретних картах, живе на сторінці Точність.
Той самий Swiss Ephemeris, що й у Solar Fire - у 4 рядках коду.
Безкоштовний ключ без картки. 5 000 викликів на місяць до першої оплати.