Підтримка мов

AstroWay будує multilingual API — текстові інтерпретації, репорти і daily horoscope доступні мовою користувача. Канонічний список — 21 мова, побудована на дослідженні попиту astrology-ринку (search volume, competitor coverage, revenue potential).

Поточний статус

Дві осі: Quality tier (готовність перекладу) × Demand score (пріоритет ринку, 48–95+).

#	Code	Мова	Q-tier	Demand	Reports	Site
1	`uk`	Українська	✅ Master	—	✅ Full	✅
2	`en`	English	✅ T0	95+	✅ Full	✅
3	`de`	Deutsch	✅ T0	72	✅ Full	📋
4	`ru`	Русский	✅ T0	70	✅ Full	📋
5	`pl`	Polski	🚧 T1	64	🚧 Beta	📋
6	`es`	Español	🚧 T1	88	🚧 Beta	📋
7	`pt`	Português	🚧 T1	84	🚧 Beta	📋
8	`hi`	हिन्दी	🚧 T1	81	🚧 Beta	📋
9	`fr`	Français	🚧 T1	78	🚧 Beta	📋
10	`ko`	한국어	🚧 T1	77	🚧 Beta	📋
11	`it`	Italiano	📋 T2	73	📋	📋
12	`ja`	日本語	📋 T2	67	📋	📋
13	`id`	Bahasa Indonesia	📋 T2	62	📋	📋
14	`tr`	Türkçe	📋 T2	60	📋	📋
15	`nl`	Nederlands	📋 T3	58	📋	📋
16	`cs`	Čeština	📋 T3	56	📋	📋
17	`ro`	Română	📋 T3	54	📋	📋
18	`vi`	Tiếng Việt	📋 T3	53	📋	📋
19	`ar`	العربية	📋 T3	52	📋	📋
20	`el`	Ελληνικά	📋 T3	50	📋	📋
21	`hu`	Magyar	📋 T3	48	📋	📋

Легенда:

✅ Full / ✅ — production-ready, повний охоплення
🚧 Beta / 🚧 — AI-переклад у роботі, глосарій під ревью, можуть бути неточності у складних термінах
📋 — planned, ще не запущено

Quality Tier — що це означає

T0 (Master + Manual) — кожен рядок репорту, кожна інтерпретація має ручний переклад з ревізією професійних астрологів. Глосарій (≈800 термінів) перевірений expert-носієм мови. Це baseline якості.
T1 (AI Beta) — переклад через AI (Gemini Flash / Claude Haiku) з консистентним глосарієм. Ручний review на найбільш чутливих частинах (Lal Kitab, Vedic Sanskrit, Hellenistic Greek). Якість 85–92% vs T0.
T2 / T3 (Planned) — у roadmap, чекають glossary-bootstrap для конкретної мови. Запуск пакетами по 3–4 мови, з найвищим demand score першим.

Demand Score — як рахується

Композитний індекс з:

Google Trends 12-month volume на ключові слова astrology у країні
Доступність у топ-5 конкурентів (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
Estimated population × estimated paid-app penetration
Revenue-per-user delta (PPP-adjusted)

Не точна метрика, а ranked priority — нам важливо вирішувати “що наступне” обʼєктивно, а не за враженням.

Як викликати

curl -X POST https://api.astroway.info/v1/interpret/aspects \
  -H "Authorization: Bearer aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "lang": "es",
    "aspects": [
      { "body1": "Sun", "body2": "Moon", "type": "conjunction", "orb": 2.1 }
    ]
  }'

Reply (приклад для lang=es):

{
  "ok": true,
  "data": {
    "interpretation": "El aspecto Sol-Luna en conjunción simboliza...",
    "lang": "es",
    "tier": "T1-Beta"
  }
}

Поле tier у відповіді явно повідомляє про статус — використовуй для UX-індикатора у твоєму застосунку (“Beta translation” badge).

Якщо потрібна мова не в списку

Напиши на hello@astroway.info з підтвердженням попиту (приклади користувачів, потенційний обсяг). Ми переглядаємо список щоквартально — мова з реальним зовнішнім попитом може бути додана у Tier 4 (opt-in).

Деякі мови у короткому списку скіпнуто назавжди — da, fi, no, bg, sk, hr, zh-CN, fa, tl — через малий ринок або відсутність astrology-traditions. ?lang=X для них повертає 400 Invalid lang.

Translation pipeline

T1 переклади йдуть через dashboard glossary editor (за прикладом astroway.info WP-плагіна). Workflow:

AI-провайдер (Gemini Flash 2.5 / Claude Haiku 4.5) перекладає на target lang з контекстом глосарію
Cache у astroway_dbapp.translations_cache (TTL 90 днів, invalidate при зміні джерела)
Ручний review у dashboard /dashboard/admin/translations для високо-чутливих рядків
Експорт у reports-renderer.ts I18N constant і api-calc/src/locales/*.json

Дивіться план реалізації: docs/LANGUAGE-PLAN.md.

Пов’язане

Точність розрахунків — числові розрахунки мова-нейтральні, локалізується тільки текст
Reports — multilingual PDF-репорти
Idempotency — кеш-знижки працюють незалежно від lang

Корисно?

Запропонувати правку

Останнє оновлення: 11 трав. 2026 р.