feat: двотрекова документація в адмінці (/admin/docs)

docs/admin-panel/manager/01-osnovy/01-vstup.md

@@ -0,0 +1,85 @@
+---
+title: Вступ
+description: Що таке платформа «Залізна Зміна», з чого вона складається і як користуватись цією документацією
+---
+
+Вітаємо в документації адміністративної панелі навчальної платформи «Залізна Зміна». Цей розділ допоможе вам швидко зорієнтуватися: що взагалі є на платформі, хто нею користується і де шукати відповіді на конкретні питання.
+
+## Що таке платформа
+
+«Залізна Зміна» — це навчальна платформа, на якій учасники проходять курси, складають тести й отримують сертифікати. Усім вмістом ви керуєте через адмін-панель за адресою `/admin`.
+
+Основні складові платформи:
+
+| Складова | Що це |
+| --- | --- |
+| **Курси** | Навчальні матеріали, розбиті на кроки: текстові уроки, відео з YouTube, файли (PDF, презентації). Учасник проходить кроки по черзі. |
+| **Тести** | До курсу можна додати тест із питаннями та варіантами відповідей. Тест може бути умовою завершення курсу. |
+| **Сертифікати** | Коли учасник завершує курс (усі кроки + тест, якщо він є), він може завантажити PDF-сертифікат із QR-кодом для перевірки справжності. |
+| **XP та рейтинг** | За кожен пройдений крок і складений тест учасник отримує бали досвіду (XP). З них будується рейтинг учасників на сайті. |
+| **Публікації** | Блог платформи: новини, статті, анонси. |
+| **Сторінки** | Довільні сторінки сайту (наприклад, «Про нас»), які збираються з готових блоків. |
+| **Коментарі та лайки** | Учасники можуть коментувати курси й публікації, відповідати одне одному та ставити лайки. |
+
+## Хто користується платформою
+
+На платформі є дві ролі:
+
+| Роль | Хто це | Що може |
+| --- | --- | --- |
+| **Адміністратор** (`admin`) | Ви та ваші колеги, що керують контентом | Повний доступ до адмін-панелі: створення курсів, публікацій, сторінок, керування користувачами та коментарями |
+| **Учасник** (`learner`) | Усі, хто зареєструвався на сайті | Бачить лише сайт: записується на курси, проходить кроки, складає тести, коментує, отримує сертифікати. В адмін-панель зайти не може |
+
+Кожен новий користувач, що реєструється на сайті, автоматично стає **Учасником**. Адміністратором можна стати лише за запрошенням — як це зробити, описано в статті [Вхід та облікові записи](/admin/docs/manager/osnovy/vkhid-ta-oblikovi-zapysy).
+
+## Що вміє адмін-панель
+
+Через адмін-панель ви можете:
+
+- **Створювати та редагувати курси**: кроки, тести, обкладинки, категорії — див. розділ [Створення курсу](/admin/docs/manager/kursy/stvorennia-kursu).
+- **Імпортувати вміст курсу з JSON**, згенерованого AI-асистентом (ChatGPT, Claude) — див. [Імпорт кроків і тесту з JSON](/admin/docs/manager/kursy/import-json).
+- **Переглядати прогрес учасників**: хто на які курси записаний, скільки кроків пройшов, як склав тест — див. [Записи учасників](/admin/docs/manager/kursy/zapysy-uchasnykiv).
+- **Вести блог**: публікації з категоріями, зображеннями та SEO-налаштуваннями.
+- **Керувати сторінками сайту**, меню (хедер і футер) та календарем змін на головній.
+- **Модерувати коментарі**: редагувати або видаляти небажані.
+- **Запрошувати нових адміністраторів** і переглядати список користувачів.
+- **Керувати медіафайлами**: зображення для курсів і публікацій, файли курсів.
+
+Уміст платформи ведеться двома мовами — українською (основна) та англійською. Як працює перемикач мов, описано в статті [Огляд адмін-панелі](/admin/docs/manager/osnovy/ohliad-adminky).
+
+## Як користуватись цією документацією
+
+Документація складається з **двох розділів**:
+
+### Менеджерський розділ (ви зараз тут)
+
+Написаний для контент-менеджерів. Без технічних деталей і коду — лише покрокові інструкції, пояснення наслідків дій і відповіді на питання «що буде, якщо…». Починається зі сторінки [Вступ](/admin/docs/manager/osnovy/vstup).
+
+### Технічний розділ
+
+Призначений для розробників: архітектура, модель даних, бізнес-логіка, точні назви полів і файлів коду. Знаходиться за адресою `/admin/docs/technical`. Якщо у статті менеджерського розділу ви бачите посилання на кшталт «технічні деталі — тут», воно веде саме туди. Читати технічний розділ необовʼязково, але він корисний, коли треба зрозуміти, чому система поводиться саме так.
+
+:::tip Порада
+Якщо ви шукаєте відповідь на конкретне питання («як додати тест до курсу?»), не читайте все підряд — скористайтеся пошуком.
+:::
+
+### Пошук по документації
+
+Натисніть **⌘K** (на Mac) або **Ctrl+K** (на Windows) у будь-якому місці документації — відкриється вікно пошуку по всіх статтях обох розділів. Почніть вводити запит, і результати зʼявляться одразу.
+
+### Зміст статті
+
+Праворуч від тексту кожної статті показується **зміст** — список її заголовків. Клікніть на пункт, щоб перейти одразу до потрібного розділу. На вузьких екранах зміст може ховатися.
+
+## З чого почати
+
+Рекомендований порядок знайомства для нового менеджера:
+
+1. [Вхід та облікові записи](/admin/docs/manager/osnovy/vkhid-ta-oblikovi-zapysy) — як увійти і як влаштовані ролі.
+2. [Огляд адмін-панелі](/admin/docs/manager/osnovy/ohliad-adminky) — що де знаходиться.
+3. [Створення курсу](/admin/docs/manager/kursy/stvorennia-kursu) — головний робочий процес платформи.
+4. [Редагування опублікованого курсу](/admin/docs/manager/kursy/redahuvannia-opublikovanoho) — **обовʼязково** прочитайте перед тим, як змінювати курс, на який уже записані учасники.
+
+:::warning Найважливіше правило
+Зміни в опублікованому курсі впливають на прогрес учасників, сертифікати та XP. Перш ніж видаляти кроки, вимикати тест або видаляти курс — прочитайте статтю [Редагування опублікованого курсу](/admin/docs/manager/kursy/redahuvannia-opublikovanoho).
+:::

docs/admin-panel/manager/01-osnovy/02-vkhid-ta-oblikovi-zapysy.md

@@ -0,0 +1,82 @@
+---
+title: Вхід та облікові записи
+description: Як увійти в адмін-панель, як запросити нового адміністратора і чим відрізняються ролі
+---
+
+Ця стаття пояснює, як потрапити в адмін-панель, як влаштовані облікові записи та ролі, і як додати до команди нового адміністратора.
+
+## Вхід в адмін-панель
+
+Адмін-панель знаходиться за адресою `/admin`. Якщо ви не авторизовані, вас зустріне сторінка входу.
+
+### Вхід за email і паролем
+
+1. Введіть свій **email** і **пароль**.
+2. Натисніть кнопку входу.
+
+Якщо пароль забули — на сторінці входу на сайті є відновлення пароля: на email надійде код підтвердження, що діє 5 хвилин.
+
+### Вхід через Google
+
+Кнопка «продовжте через Google» доступна **лише на робочому (продакшн) сайті**. На тестових і локальних версіях платформи її немає — там працює лише вхід за email і паролем.
+
+:::info Google і адмін-доступ
+Вхід через Google сам по собі не робить вас адміністратором. Роль привʼязана до облікового запису, а не до способу входу: якщо ваш акаунт має роль «Адміністратор», ви потрапите в адмінку будь-яким способом входу.
+:::
+
+### Тривалість сесії
+
+Сесія діє **7 днів**. Якщо ви користуєтесь панеллю регулярно, сесія автоматично продовжується — виходити й заходити щотижня не доведеться. Після 7 днів повної неактивності потрібно буде увійти знову.
+
+## Ролі: Адміністратор і Учасник
+
+Кожен користувач має роль, яка визначає його можливості:
+
+| | **Адміністратор** | **Учасник** |
+| --- | --- | --- |
+| Вхід в адмін-панель `/admin` | Так | Ні |
+| Створення і редагування курсів, публікацій, сторінок | Так | Ні |
+| Перегляд усіх записів на курси і спроб тестів | Так | Лише своїх |
+| Керування користувачами | Так | Ні |
+| Редагування і видалення будь-яких коментарів | Так | Лише видалення власних |
+| Проходження курсів, тести, сертифікати, коментарі на сайті | Так | Так |
+
+Кожен, хто самостійно реєструється на сайті, отримує роль **Учасник**. Роль **Адміністратор** видається лише через запрошення (див. нижче).
+
+:::danger Адміністратор — це повний доступ
+Адміністратор може редагувати й видаляти будь-який контент платформи, включно з курсами, користувачами та записами учасників. Запрошуйте в адміністратори лише тих, кому довіряєте керування всією платформою.
+:::
+
+## Як запросити нового адміністратора
+
+1. В адмін-панелі відкрийте розділ **Користувачі** (група «Автентифікація» в меню ліворуч).
+2. Над списком користувачів знайдіть **кнопку запрошення** і натисніть її.
+3. У вікні запрошення вкажіть **email** майбутнього адміністратора і виберіть роль.
+4. Далі є два способи передати запрошення:
+   - **Згенерувати посилання** — скопіюйте його і передайте людині будь-яким зручним каналом (месенджер тощо).
+   - **Надіслати лист** — людина отримає email із темою **«Запрошення до панелі адміністратора — Залізна Зміна»** з кнопкою-посиланням.
+5. Перейшовши за посиланням, людина створює обліковий запис і одразу отримує вибрану роль.
+
+:::warning Якщо лист не надходить
+Надсилання листів працює лише тоді, коли на платформі налаштований поштовий сервіс. Якщо лист не вдалося надіслати, ви побачите повідомлення про помилку — у такому разі скористайтеся варіантом із посиланням.
+:::
+
+### Чому не можна просто «підняти» роль існуючому користувачу
+
+Список користувачів у розділі **Користувачі** показує всіх — і адміністраторів, і учасників. Редагування чужих облікових записів навмисно обмежене з міркувань безпеки: стандартний шлях надати комусь адмін-доступ — саме запрошення.
+
+## Що бачать учасники
+
+Учасники не мають доступу до `/admin` взагалі — при спробі зайти вони не пройдуть далі сторінки входу. На самому сайті учасник бачить:
+
+- каталог опублікованих курсів і публікацій;
+- власний профіль, прогрес, сертифікати (`/certificates`);
+- рейтинг учасників (XP);
+- коментарі та лайки.
+
+Чернетки курсів, публікацій і сторінок на сайті для неавторизованих відвідувачів не показуються — див. подробиці про чернетки у статті [Створення курсу](/admin/docs/manager/kursy/stvorennia-kursu).
+
+## Повʼязані статті
+
+- [Огляд адмін-панелі](/admin/docs/manager/osnovy/ohliad-adminky) — що знаходиться в меню після входу.
+- Технічні деталі автентифікації (сесії, коди підтвердження, захист від зловживань) — у технічному розділі: [Користувачі та автентифікація](/admin/docs/technical/model-danykh/users-i-auth).