Актуализация страниц о деплое и разработке + мелочи по оформлению

content/common/config/config.md

@@ -44,7 +44,6 @@ site:
   page-size: 0
   favicon:
   header:
-    title: IPTV Checker
     menu:
       - title: Документация
         url: /docs
@@ -225,7 +224,7 @@ cache:
 Мета-теги `<meta name="description">` и `<meta name="keywords">` для HTML-шаблонов.
 
 | Поле          | Переменная окружения    | Описание                     |
-| --- | --- | --- |
+| ------------- | ----------------------- | ---------------------------- |
 | `description` | `SITE_META_DESCRIPTION` | Описание сайта в meta-тегах  |
 | `keywords`    | `SITE_META_KEYWORDS`    | Ключевые слова через запятую |
 
@@ -240,15 +239,6 @@ cache:
 
 ---
 
-### `site.header.title` { id=site-header-title }
-
-<!-- md:default IPTV Checker -->
-
-Заголовок сайта, отображается в `<title>` и в navbar.
-Переопределяется переменной окружения `SITE_TITLE` (см. [`site.title`](#site-title)).
-
----
-
 ### `site.header.menu` { id=site-header-menu }
 
 Массив элементов [`Link`](#link) в шапке сайта.

content/iptvc/commands/serve.md

@@ -366,11 +366,12 @@ iptvc serve --check --debug \
 ## Веб-маршруты
 
 | Метод | Путь                             | Описание                                 |
-| --- | --- | --- |
+| ----- | -------------------------------- | ---------------------------------------- |
 | GET   | `/`                              | Главная страница со списком плейлистов   |
 | GET   | `/page/{N}`                      | Страница N списка плейлистов             |
 | GET   | `/{code}`                        | Редирект на прямую ссылку плейлиста      |
-| GET | `/{code}.m3u[8]` | Редирект на прямую ссылку плейлиста |
+| GET   | `/{code}.m3u`                    | Редирект на прямую ссылку плейлиста      |
+| GET   | `/{code}.m3u8`                   | Редирект на прямую ссылку плейлиста      |
 | GET   | `/{code}/details`                | Страница с описанием плейлиста           |
 | GET   | `/api`                           | Редирект на `/api/` (Swagger UI)         |
 | GET   | `/api/`                          | Swagger UI с описанием REST API          |

content/iptvc/dev/arch.md

@@ -52,7 +52,11 @@ iptvc/
 │   └── web/
 │       ├── server.go        # Server, Start(), StartBackgroundChecker()
 │       ├── handlers.go      # HTTP-обработчики
+│       ├── views.go         # PlaylistView, ChannelView, PageData
 │       ├── templates.go     # TemplateManager, //go:embed
+│       ├── openapi.go       # OpenAPI-спецификация, Swagger UI
+│       ├── swagger/         # встроенные файлы Swagger UI
+│       ├── static/          # встроенные статические файлы (CSS, JS)
 │       └── views/           # HTML-шаблоны
 │           ├── base.html
 │           ├── list.html
@@ -66,7 +70,8 @@ iptvc/
 ### `app`
 
 Глобальный контейнер: `Args` (CLI-флаги), `Config` (конфигурация), `Cache` (Redis-клиент).
-`Init()` загружает конфигурацию, инициализирует логгер и подключение к кешу.
+`Init()` загружает конфигурацию и инициализирует логгер.
+`InitCache()` подключается к KeyDB/Redis, если кеш включён.
 
 ### `app.config`
 
@@ -86,8 +91,8 @@ iptvc/
 Содержит логику проверки:
 
 - **`PrepareListsToCheck(files, urls, codes)`** — формирует список плейлистов из файлов, URL и кодов ini-файла.
-- **`CheckPlaylists(lists)`** — параллельная проверка плейлистов (семфор `per-routine`), загрузка, парсинг, вызов `CheckChannels` для каждого.
+- **`CheckPlaylists(lists)`** — параллельная проверка плейлистов (семфор `max-routines`), загрузка, парсинг, вызов `CheckChannels` для каждого.
-- **`CheckChannels(pls)`** — параллельная проверка каналов (семфор `per-routine`), HTTP-запрос с `Range` header.
+- **`CheckChannels(pls)`** — параллельная проверка каналов (семфор `max-routines`), HTTP-запрос с `Range` header.
 - **`OnPlaylistChecked`** — глобальный callback, вызывается после проверки каждого плейлиста. Используется веб-сервером для обновления in-memory кеша.
 - **`cachePlaylist(pls)`** — сохранение результата в Redis (если включён).
 
@@ -108,7 +113,7 @@ iptvc/
 - **`Server`** — структура: конфиг, кеш, шаблоны, in-memory кеш (`memCache` с `sync.RWMutex`).
 - **`Start()`** — запуск HTTP-сервера.
 - **`StartBackgroundChecker(opts)`** — фоновая проверка в отдельной горутине.
-- **`CheckOptions`** — параметры: Every, Repeat, Random, Files, Urls, Codes.
+- **`CheckOptions`** — параметры: Repeat, Random, Files, Urls, Codes.
 
 Маршруты (Go 1.22 patterns):
 
@@ -153,7 +158,6 @@ StartBackgroundChecker:
                → OnPlaylistChecked(pls) → memCache update
                → one-cooldown sleep
      → all-cooldown sleep
-    sleep(every)
      if repeat > 0 && iteration >= repeat: stop
 ```
 
@@ -192,9 +196,11 @@ StartBackgroundChecker:
 ### Глобальные (`cmd/root.go`)
 
 | Флаг            | Поле              | Описание            |
-| --------------- | ----------------- | ----------------- |
+| --------------- | ----------------- | ------------------- |
 | `--config`      | `Args.ConfigPath` | Путь к config.yml   |
 | `-v, --verbose` | `Args.Verbose`    | Подробный лог       |
+| `--debug`       | `Args.Debug`      | Режим отладки       |
+| `--log-level`   | `Args.LogLevel`   | Уровень логирования |
 
 ## Конфигурация
 

content/iptvc/dev/compile.md

@@ -18,12 +18,15 @@ make linux
 ## Доступные рецепты Makefile
 
 | Команда          | Назначение                                                    |
-| -------------- | ------------------------------------------------------------- |
+| ---------------- | ------------------------------------------------------------- |
 | `make linux`     | Сборка под Linux (amd64 по умолчанию)                         |
 | `make win`       | Сборка под Windows                                            |
 | `make darwin`    | Сборка под macOS                                              |
 | `make release`   | Сборка под все платформы (linux/windows/darwin × amd64/arm64) |
-| `make clean`   | Удаление скомпилированных бинарников                          |
+| `make test`      | Запуск всех тестов                                            |
+| `make clear`     | Удаление скомпилированных бинарников                          |
+| `make image`     | Сборка Docker-образа для текущей платформы                    |
+| `make image-all` | Сборка и отправка multi-arch манифеста в registry             |
 | `make help`      | Вывод списка доступных рецептов                               |
 
 ## Управление архитектурой

content/iptvc/dev/docker.md

@@ -8,22 +8,32 @@ tags: ["iptvc", "docker"]
 
 ## Сборка
 
-Образ собирается из [Dockerfile](https://git.axenov.dev/IPTV/iptvc/src/branch/master/Dockerfile) — multi-stage сборка на базе `golang:1.25-alpine` с финальным образом `alpine:3.22`.
+Образ собирается из [Dockerfile](https://git.axenov.dev/IPTV/iptvc/src/branch/master/Dockerfile) на базе `alpine:3.22.5`.
+
+Бинарный файл должен быть предварительно собран через `make linux` — Dockerfile берёт уже готовый бинарь из `bin/linux_${TARGETARCH}/iptvc`.
 
 ```bash
-docker build -t iptvc ./iptvc
+# Сборка бинарного файла и образа
+make image
+
+# Сборка с указанием архитектуры
+make image GOARCH=arm64
+
+# Сборка с указанием тега
+make image IMAGE_TAG=v1.1.3
 ```
 
-Можно передать версию через build-arg:
+Целевая архитектура задаётся через `GOARCH`:
 
 ```bash
-docker build --build-arg IPTVC_VERSION=1.1.3 -t iptvc:v1.1.3 ./iptvc
+make linux GOARCH=arm64
+make image GOARCH=arm64
 ```
 
-Целевая платформа и архитектура задаются через `GOOS` и `GOARCH`:
+Для публикации multi-arch манифеста в registry:
 
 ```bash
-docker build --build-arg GOOS=linux --build-arg GOARCH=arm64 -t iptvc:linux-arm64 ./iptvc
+make image-all
 ```
 
 ## Запуск
@@ -33,13 +43,13 @@ docker build --build-arg GOOS=linux --build-arg GOARCH=arm64 -t iptvc:linux-arm6
 docker run --rm \
     -v ./playlists.ini:/app/playlists.ini \
     -v ./channels.json:/app/channels.json \
-    iptvc check -i playlists.ini --repeat 0 --playlists-all-cooldown 60
+    git.axenov.dev/iptv/iptvc:latest check -i playlists.ini --repeat 0 --playlists-all-cooldown 60
 
 # Веб-сервер с фоновой проверкой
 docker run --rm -p 8800:8800 \
     -v ./playlists.ini:/app/playlists.ini \
     -v ./channels.json:/app/channels.json \
-    iptvc serve -i playlists.ini -p 8800 --check
+    git.axenov.dev/iptv/iptvc:latest serve -i playlists.ini -p 8800 --check
 ```
 
 ## Использование в compose

content/iptvc/install.md

@@ -25,7 +25,7 @@ tags: ["iptvc"]
 
 ## Запуск релизного образа
 
-Релизные docker-образы строятся для платформы `linux` и архитектуры `amd64`.
+Релизные docker-образы строятся для платформы `linux` и архитектур `amd64` и `arm64`.
 
 Найти их можно здесь: <https://git.axenov.dev/IPTV/-/packages/container/iptvc>
 

content/iptvc/site/deploy.md

@@ -110,28 +110,28 @@ docker compose down
 
 ## Сборка образа iptvc { id="image" }
 
-Для публикации образа используйте скрипт `iptvc/build-docker-image.sh`.
+Для сборки и публикации образа используйте цели Makefile в каталоге `iptvc/`:
-
-Скрипт вычисляет версию из Git, собирает образы с тегами `iptvc:<тег>` и `git.axenov.dev/iptv/iptvc:<тег>`, а затем отправляет registry-тег в registry:
 
 ```bash
 cd iptvc
-./build-docker-image.sh latest
+
+# Сборка одноархитектурного образа (linux/amd64 по умолчанию)
+make image
+
+# Сборка под arm64
+make image GOARCH=arm64
+
+# Сборка с указанием тега
+make image IMAGE_TAG=v1.2.3
 ```
 
-Для публикации релизного тега:
+Для публикации multi-arch манифеста (linux/amd64 + linux/arm64):
 
 ```bash
-./build-docker-image.sh v1.2.3
+make image-all
 ```
 
-По умолчанию скрипт собирает Linux-образ для `amd64`.
+Цель `image-all` всегда отправляет образ в registry — это ограничение `docker buildx`: multi-arch манифест нельзя загрузить в локальный Docker daemon.
-
-Платформу можно изменить переменными окружения:
-
-```bash
-GOOS=linux GOARCH=arm64 ./build-docker-image.sh v1.2.3
-```
 
 Перед публикацией войдите в registry, если это требуется вашей настройкой:
 
@@ -140,8 +140,8 @@ docker login git.axenov.dev
 ```
 
 !!! warning "Рабочее дерево Git"
-    Скрипт переключается на Git-тег, переданный первым аргументом, или на тег, возвращённый `git describe`.
+    Версия и коммит вшиваются в бинарь из `git describe` и `git rev-parse` на хосте в момент запуска `make`.
-    Перед запуском сохраните локальные изменения и убедитесь, что нужный тег существует.
+    Перед сборкой убедитесь, что рабочая копия чистая и находится на нужном теге или коммите.
 
 ## Обновление { id="update" }
 

content/iptvc/site/first-steps.md

@@ -404,7 +404,7 @@ docker compose up -d
 ## Краткая шпаргалка
 
 | Задача                        | Как                                                  |
-| ----------------------------- | ------------------------------------------------------- |
+| ----------------------------- | ---------------------------------------------------- |
 | Запустить сайт                | `./iptvc serve`                                      |
 | С проверкой плейлистов        | `./iptvc serve --check`                              |
 | На другом порту               | `./iptvc serve -p 3000`                              |