Адмін-панель — довідка

Адмін-панель — одне місце, звідки адміністратор переносить контент: з Artwork (картинки й фрази) у Voices (звуки), а звідти разом — у Kids Telling. Тут же випуск нової версії, публікація та журнал усього, що відбувалося.

Ніщо не відбувається само. Кожен крок запускається лише після вашого підтвердження й спершу показує, що саме зміниться. Потік можна призупинити, поки ви щось виправляєте.

1. Вхід

Під час першого відкриття панель просить придумати пароль (щонайменше 8 символів); він зберігається лише на цьому комп'ютері. Далі — вхід паролем. Поле «Ваше ім'я» необов'язкове: воно потрапляє в журнал, щоб було видно, хто що запускав. Після п'яти помилок поспіль треба зачекати хвилину.

2. Що є на екрані

1 2 3 4 5 6 7

1

Мова панелі: UK, PL, RU; запам'ятовується.

2

Довідка — ця сторінка.

3

Вихід.

4

Вкладки «Імпорт» і «Журнал».

5

Налаштування: ключ Artwork.

6

Кружечок кроку: виділений — де ви зараз.

7

Стан кроку: «не почато», «✓ готово», «! є проблеми».

3. Кроки й кружечки

Вкладка «Імпорт» — це п'ять кроків згори донизу, з'єднаних лінією: 1 Artwork → Voices, 2 генерація звуків, 3 перевірка, 4 перенесення в Kids Telling, 5 випуск.

1. Зелений кружечок з кільцем — крок, який ви виконали останнім: тут ви зараз.
2. Зелений — уже виконаний крок.
3. Сірий — ще не виконаний або поки недоступний.

Праворуч у картці — стан: «не почато», «✓ готово» з часом, «! є проблеми». Будь-який виконаний крок можна запустити знову.

4. Крок 1: Artwork → Voices

1. Натисніть кнопку з круглою стрілкою — перегляд. Нічого не змінюється.
2. Зеленим — що нового або зміненого прийде з Artwork (змінені тексти позначено «(змінено)»).
3. Червоним — фрази, які зникнуть з Voices при «Оновити»: змінені або зняті з перевірки в Artwork. Окремо — що ще додатково прибере лише «Замінити все» (картинки, яких уже немає в Artwork).
4. У таблиці «Фраз після» видно, як виходить результат, наприклад 27 (+13 −12) = 28; наведіть мишку — підказка пояснить.
5. Кнопка з шестернею у стрілках — «Оновити з Artwork»; з двома прямокутниками — «Замінити все» (треба ввести REPLACE). Якщо змін немає, обидві сірі.
6. Звуки в базі Voices не видаляються ніколи. Після перенесення перегляд оновлюється сам.

5. Крок 2: генерація звуків

Потрібно, щоб Voices був запущений локально (npm run dev у kids-voices) — інакше панель про це скаже.

1. Кругла стрілка — показати, скільки фраз ще без звуку, по мовах.
2. Хвилька — згенерувати звук для фраз, де його ще немає. Звуки звучать за правилами Kids Telling (VOICE_FIXES.md) і не затверджуються. Прогрес рухається після кожного звуку; на сайті Voices угорі видно червоне «Генерація NN%».
3. Динамік — відкрити Voices, прослухати й затвердити звуки (або «✓ Затвердити все» там, з попередженням).

6. Крок 3: перевірка перед перенесенням

Оберіть, куди переносити: Kids Telling: тестова копія (develop) або Kids Telling (main, pre-prod), і натисніть «Перевірити». Нічого не змінюється. Перевіряється:

1. чи Voices збігається із затвердженим Artwork (якщо ні — спершу повторіть крок 1);
2. чи в кожної фрази (українська, польська, російська) є обраний і затверджений звук.

Проблеми показано списком («RU: лежит»). Далі вирішуєте ви: «Затвердити наявні», «Згенерувати відсутні й затвердити» або «Призупинити потік» з причиною (червона плашка вгорі; «Продовжити» знімає паузу). Після рішення перевірка запускається знову сама, а коли все гаразд — сторінка переходить до кроку 4.

7. Крок 4: Artwork + Voices → Kids Telling

Доступний лише після перевірки без проблем і коли потік не на паузі. У картці написано, куди буде перенесення (те, що обрано на перевірці).

1. Оберіть, як: «Оновити» або «Замінити все», і натисніть «Перенести в Kids Telling».
2. Переносяться картинки й речення з Artwork, а кожен звук Kids Telling (разом із коротким реченням кожної картинки) — затверджений звук з Voices. Kids Telling сам нічого не генерує.
3. Версія застосунку підвищується, щоб нові картинки й звуки підтягнулися (оновіть гру через Ctrl+F5).
4. Після успіху праворуч з'являється «Перейти у Kids Telling ↗».
5. Якщо якогось звуку немає, крок зупиняється червоним з причиною й підказкою, що робити.

8. Крок 5: випуск і публікація

1. Кнопки цього кроку доступні завжди (крім часу, коли щось виконується); наведіть мишку — підказка пояснить, що робить кожна.
2. «Злити develop у main» (введіть MERGE) — звичайний випуск: тестова копія (закомічена) переходить в основну гру, оновлюється pre-prod, збирається APK.
3. «Зберегти develop» — тести, коміт і push тестової копії в гілку develop (main не чіпається). Робиться перед «Злити develop у main».
4. «Зібрати APK» — Android APK з основної гри (main), будь-коли.
5. «Опублікувати main напряму» (PUBLISH) — лише у виняткових випадках, оминаючи develop.
6. «Опублікувати Voices» — викладає сайт Voices в інтернет (kids-voices.pages.dev): тести, коміт, push, деплой. Потрібно, щоб нові фрази й звуки з'явилися на робочому сайті Voices.

9. Прогрес і помилки

Поки щось виконується, усі кнопки сірі й неактивні, а в кроці видно прогрес-бар з відсотками («Звуки: 12 з 28 (43%)»). Після успіху «готово» показується кілька секунд і зникає. Помилка лишається червоною з причиною вашою мовою. Повний текст — у журналі.

10. Журнал

На вкладці «Журнал» записано все: кожен імпорт, генерацію, перевірку, паузу, випуск, вхід і вихід — коли почалося й скільки тривало, хто запустив, результат (✓ або ✕) і короткий підсумок. Натисніть рядок — відкриється весь текст. Пошук шукає в усьому: дії, імені, помилці, фразі. «Завантажити журнал» зберігає його в текстовий файл. Журнал є лише на цьому комп'ютері.

11. Ключі й API

Ключ Artwork. У Artwork відкрийте API / Swagger і створіть ключ лише для читання; вставте його в «Налаштування: ключ Artwork» угорі вкладки «Імпорт» — він збережеться для Voices і для Kids Telling.

API Voices. Kids Telling бере звуки з Voices через API лише для читання (панель робить це сама на кроці 4). Опис і спроба — Voices → API / Swagger (локальний ключ local-export-key-0123456789).