Пřesnost - це той аспект, який користувач мовчки перевіряє тебе на AstroWay. Якщо натальна карта розійшлася на кутову хвилину, скарга прилетить швидко. І найгірше в цьому те, що точність легко зламати непомітно: один рефакторинг у коді ефемерид, і половина ендпоінтів тихо поїхала на секунди дуги.
Ось як ми не даємо цьому статися.
Одне ядро на два середовища
Section titled “Одне ядро на два середовища”Планетні позиції рахує Swiss Ephemeris, скомпільований у WASM. Ключове: це те саме ядро і в браузері нашого застосунку, і на сервері API. Одна кодова база core/, підтягнута в бекенд через cross-repo alias і вбудована в бандл на білді. Немає «браузерної» та «серверної» реалізації, які можуть розійтися - розходитися нічому.
Для дат поза основним діапазоном ефемерид є аналітичний fallback (Moshier), трохи грубший, але без розривів на межах. Свідома чесність: конкретну версію рушія ми публічно не заявляємо, бо реальна версія ядра нижча за найновіший upstream, і писати гучну цифру було б брехнею.
Заморожені снапшоти
Section titled “Заморожені снапшоти”Кожен розрахунковий ендпоінт має набір заморожених снапшотів - 873 JSON-фікстур на момент цього білда. Раннер проганяє ендпоінт на еталонних картах і побайтово (в межах толерансу) звіряє з фікстурою. Будь-яке відхилення планетної довготи більше ніж 5e-5° (0.18″) валить тест.
Еталонні карти підібрані так, щоб бити по краях, а не тільки по «зручному» центру:
- Монро, Діана, Ейнштейн, Бові - історичні карти з відомими даними народження
- полярна широта - де системи домів вироджуються
- екваторіальна - де вони поводяться інакше
- південна півкуля - перевірка дзеркальності
Граничні випадки ловлять саме ті регресії, які не видно на карті умовного киянина.
Триангуляція проти зовнішніх джерел
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 कॉल प्रति माह।