Как редактировать инструкцию PCA
Пошагово для администратора (не для гостя с паролем «только просмотр»).
1. Войти как администратор
1. Откройте сайт PCA в браузере. 2. Введите **пароль администратора** (тот же, что для Дашборда и Настроек). 3. Если у вас пароль гостя (viewer) — редактирование недоступно, только чтение `/guide`.
2. Открыть редактор
- На странице **📖 Инструкция** (`/guide`) нажмите **«✏️ Редактировать инструкцию»**,
- Сразу откройте **`/guide/edit`**.
**или**
3. Выбрать главу
Слева список глав. Нажмите нужную — справа откроются поля:
| Поле | Что делать | |------|------------| | **Заголовок** | Название главы в оглавлении | | **Картинка (URL)** | Путь вида `/static/guide/screens/имя.png` | | **Вступление** | Один абзац на строку | | **Разделы и шаги (JSON)** | Структура подсказок и шагов (как в исходной инструкции) |
Кнопка **«+ Глава»** добавляет новую главу (латинский `id` вроде `my-chapter`).
4. Загрузить фото, GIF или видео
1. В блоке **«Медиа»** нажмите **«Выберите файл»**. 2. Поддерживаются: PNG, JPG, WebP, GIF, MP4, WebM. 3. Нажмите **«Загрузить»** — появится URL (`/static/guide/...`). 4. **«Вставить URL»** подставит ссылку в поле картинки или скопирует в буфер.
Куда кладётся файл на сервере:
- PNG/JPG/WebP → `static/guide/screens/`
- GIF → `static/guide/gifs/`
- MP4/WebM (ручная загрузка) → `static/guide/media/`
- Ролики инструкции (автозахват) → `static/guide/videos/` — manifest `server/guide/videos.json`, пересъёмка: `./scripts/ku-guide-sync.sh --videos`
В тексте главы укажите этот URL в поле **«Картинка»** или в JSON раздела (`"image": "/static/guide/..."`).
5. Сохранить
- **«Сохранить главу»** — записывает текущую главу и весь комплект на сервер.
- **«Сохранить всё»** — то же после правки JSON.
- **«Предпросмотр»** — показать главу как на `/guide`, без выхода из редактора.
Данные хранятся в файле на сервере: `server/data/guide_chapters.json` (путь может отличаться, если задан другой `DATA_DIR`).
6. PDF (по желанию)
На `/guide` кнопка **«Скачать полную инструкцию (PDF)»** собирает PDF из **текущих** сохранённых глав. После правок в редакторе сначала сохраните, затем скачайте PDF.
7. Деплой
После обновления кода на VPS перезапустите сервис PCA. Загруженные картинки лежат в `static/guide/` — при деплое не перезаписывайте эту папку, если там уже есть ваши файлы.
---
**Кратко:** `/guide` → войти admin → **Редактировать** → глава → текст / загрузка медиа → **Сохранить** → проверить на `/guide`.