cohorta/HANDOVER.md

Cohorta — Session Handover

Стан проекту

Production: https://cohorta.ai-impress.com
Repo: git@git.ai-impress.com:Aimpress/cohorta.git (branch: main)
Stack: React 18 + Vite + TypeScript / Quart (Python async) / MongoDB / Docker + Traefik на OVH (57.128.160.249, ssh alias: aimpress, port 1220)

Deploy: ssh aimpress "bash /opt/03-business/cohorta/deploy-cohorta.sh" (тягне git pull + docker build + up)
Push: через HTTPS-токен — git remote set-url origin https://vadym:<TOKEN>@git.ai-impress.com/Aimpress/cohorta.git

---

Що зроблено в цій сесії

Epic	Статус
Epic 1 — OG-image + базовий SEO	✅
Epic 2 — Pricing з admin panel	✅
Epic 3 — Form redesign: SyntheticUsers	✅
Epic 4 — Form redesign: FocusGroups + rewrite текстів	✅
Epic 5 — i18n EN/uk/ru + LanguageSwitcher	✅ повністю
Epic 6 — SEO full: helmet, JSON-LD, robots, sitemap, llms.txt	✅
Epic 7 — AI Admin: model catalog tab	✅
Full report export (GET /api/focus-groups/{id}/report/download)	✅
Code audit + bug fixes	✅
Docker .dockerignore + npm overrides fix	✅

---

Активне завдання: ЗАВЕРШЕНО

Epic 5 (i18n) повністю реалізований. Всі app pages + лендінг переведені. LanguageSwitcher у AppLayout. Tooltip в Pricing пофіксовано.

Наступні кроки

• Деплой: ssh aimpress "bash /opt/03-business/cohorta/deploy-cohorta.sh"
• Можливі покращення: Zod validation messages в Login/Register (низький пріоритет)

---

Що зроблено в Epic 5 (i18n)

Проблема

Лендінг і auth частково перекладені, але:

1. App pages (після логіну) — 0% перекладу, весь контент хардкодований англійською
2. Переключатель мови відсутній у app layout (є тільки в Header на лендінгу)

Архітектура i18n (вже налаштована)

src/i18n/index.ts          — i18next init, detection: localStorage(cohorta_lang) → navigator → 'en'
src/i18n/locales/en/common.json   — source of truth
src/i18n/locales/uk/common.json
src/i18n/locales/ru/common.json
src/components/LanguageSwitcher.tsx  — 3 pill-кнопки EN/UA/RU (вже є)

Поточні namespace в common.json: nav, hero, pricing, auth, language

Що потрібно зробити (пріоритет)

1. Додати LanguageSwitcher до app layout

Файл: src/components/layout/AppLayout.tsx або src/pages/* — знайти де рендериться header для авторизованих сторінок і додати <LanguageSwitcher />.

2. Лендінг — компоненти (0% i18n)

• src/components/landing/FAQ.tsx — 7 Q&A
• src/components/landing/HowItWorks.tsx — 3 кроки
• src/components/landing/Comparison.tsx — таблиця
• src/components/landing/Testimonials.tsx — відгуки
• src/components/landing/FeatureGrid.tsx — фічі
• src/components/landing/TrustBar.tsx — мітки
• src/components/layout/Footer.tsx — секції + tagline

3. App pages — хардкод

• src/pages/Dashboard.tsx — заголовки, мітки
• src/pages/Admin.tsx — таби, описи
• src/pages/MyUsage.tsx — статистика мітки
• src/pages/SyntheticUsers.tsx — toast, placeholder пошуку
• src/pages/FocusGroups.tsx — toast, placeholder
• src/pages/FocusGroupSession.tsx — 15+ toast, placeholders select-ів
• src/pages/Billing.tsx — toast ("Payment successful!", "Credits added…")

4. Форми

• src/pages/Login.tsx + src/pages/Register.tsx — Zod validation messages

Нові namespace для common.json

faq, how_it_works, comparison, testimonials, features, footer,
dashboard, admin, usage, focus_groups, focus_group_session, billing, synthetic_users

Повний список поточних ключів

Читай src/i18n/locales/en/common.json — він source of truth.

---

Інші відкриті питання

AdGuard DNS (WiFi недоступність)

AdGuard має wildcard: *.ai-impress.com → 192.168.1.225 (локальний Forgejo). cohorta.ai-impress.com потрібно додати override: 57.128.160.249.

Конфіг на PVE: ssh pve "pct exec 102 -- nano /opt/services/adguard/conf/AdGuardHome.yaml" Або UI: http://192.168.1.225:8053 → Filters → DNS Rewrites → Add: cohorta.ai-impress.com → 57.128.160.249 Після змін: ssh pve "pct exec 102 -- docker restart adguard"

Деплой через SSH-ключ (не налаштовано)

id_rsa (SHA256:UWsx6bkp) додано в Forgejo але SSH push не працює. Зараз push через HTTPS токен. Токен: efde233ee0e4f77116cbd663755e9f23e5e463c5

---

Файлова структура (ключові файли)

src/
  i18n/
    index.ts
    locales/en/common.json   ← source of truth
    locales/uk/common.json
    locales/ru/common.json
  components/
    LanguageSwitcher.tsx      ← вже є, додати в app layout
    layout/Header.tsx         ← має LanguageSwitcher (лендінг)
    landing/                  ← потрібен i18n
    focus-group-session/SetupTab.tsx  ← переписано в Epic 4
  pages/
    Dashboard.tsx, Admin.tsx, MyUsage.tsx  ← потрібен i18n
    Billing.tsx, FocusGroups.tsx, SyntheticUsers.tsx  ← потрібен i18n
    FocusGroupSession.tsx     ← потрібен i18n (найбільший)
backend/
  app/routes/focus_groups.py  ← додано /report/download endpoint
  prompts/report-executive-summary.md  ← новий промпт для звіту
I18N_TODO.md                  ← детальний список що хардкодовано

---

Як почати нову сесію

Продовжуємо роботу над Cohorta. 
Прочитай HANDOVER.md в корені проекту і I18N_TODO.md.
Активне завдання: реалізуй i18n для всіх app pages і додай LanguageSwitcher в app layout.
Почни з: 1) знайти де рендериться layout для авторизованих сторінок, 2) додати switcher, 3) Dashboard.tsx.