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

content/iptvc/dev/arch.md

@@ -30,11 +30,13 @@ iptvc/
 │   ├── check.go             # команда check
 │   ├── serve.go             # команда serve
 │   ├── flags.go             # общие флаги check/serve
+│   ├── flags_test.go        # тесты применения CLI-переопределений
 │   └── version.go           # команда version
 ├── app/
 │   ├── app.go               # глобальные переменные: Args, Config, Cache
 │   ├── config/
-│   │   └── config.go        # Config, Init(), validate(), IntRange, UserAgents
+│   │   ├── config.go        # Config, Init(), validate(), IntRange, UserAgents
+│   │   └── config_test.go   # тесты конфигурации
 │   ├── checker/
 │   │   └── checker.go       # CheckPlaylists(), CheckChannels(), OnPlaylistChecked
 │   ├── playlist/
@@ -52,7 +54,16 @@ iptvc/
 │   └── web/
 │       ├── server.go        # Server, Start(), StartBackgroundChecker()
 │       ├── handlers.go      # HTTP-обработчики
+│       ├── views.go         # PlaylistView, ChannelView, PageData
+│       ├── views_test.go    # тесты представлений
 │       ├── templates.go     # TemplateManager, //go:embed
+│       ├── templates_test.go # тесты шаблонов
+│       ├── openapi.go       # OpenAPI-спецификация, Swagger UI
+│       ├── openapi_test.go  # тесты OpenAPI
+│       ├── details_test.go  # тесты страницы деталей плейлиста
+│       ├── testdata/         # тестовые фикстуры
+│       ├── swagger/         # встроенные файлы Swagger UI
+│       ├── static/          # встроенные статические файлы (CSS, JS)
 │       └── views/           # HTML-шаблоны
 │           ├── base.html
 │           ├── list.html
@@ -66,7 +77,8 @@ iptvc/
 ### `app`
 
 Глобальный контейнер: `Args` (CLI-флаги), `Config` (конфигурация), `Cache` (Redis-клиент).
-`Init()` загружает конфигурацию, инициализирует логгер и подключение к кешу.
+`Init()` загружает конфигурацию и инициализирует логгер.
+`InitCache()` подключается к KeyDB/Redis, если кеш включён.
 
 ### `app.config`
 
@@ -86,8 +98,8 @@ iptvc/
 Содержит логику проверки:
 
 - **`PrepareListsToCheck(files, urls, codes)`** — формирует список плейлистов из файлов, URL и кодов ini-файла.
-- **`CheckPlaylists(lists)`** — параллельная проверка плейлистов (семфор `per-routine`), загрузка, парсинг, вызов `CheckChannels` для каждого.
-- **`CheckChannels(pls)`** — параллельная проверка каналов (семфор `per-routine`), HTTP-запрос с `Range` header.
+- **`CheckPlaylists(lists)`** — параллельная проверка плейлистов (семфор `max-routines`), загрузка, парсинг, вызов `CheckChannels` для каждого.
+- **`CheckChannels(pls)`** — параллельная проверка каналов (семфор `max-routines`), HTTP-запрос с `Range` header.
 - **`OnPlaylistChecked`** — глобальный callback, вызывается после проверки каждого плейлиста. Используется веб-сервером для обновления in-memory кеша.
 - **`cachePlaylist(pls)`** — сохранение результата в Redis (если включён).
 
@@ -108,7 +120,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):
 
@@ -152,9 +164,8 @@ StartBackgroundChecker:
                         → check status + content type
                → OnPlaylistChecked(pls) → memCache update
                → one-cooldown sleep
-           → all-cooldown sleep
-    sleep(every)
-    if repeat > 0 && iteration >= repeat: stop
+     → all-cooldown sleep
+     if repeat > 0 && iteration >= repeat: stop
 ```
 
 ## CLI-флаги
@@ -191,14 +202,16 @@ StartBackgroundChecker:
 
 ### Глобальные (`cmd/root.go`)
 
-| Флаг            | Поле              | Описание          |
-| --------------- | ----------------- | ----------------- |
-| `--config`      | `Args.ConfigPath` | Путь к config.yml |
-| `-v, --verbose` | `Args.Verbose`    | Подробный лог     |
+| Флаг            | Поле              | Описание            |
+| --------------- | ----------------- | ------------------- |
+| `--config`      | `Args.ConfigPath` | Путь к config.yml   |
+| `-v, --verbose` | `Args.Verbose`    | Подробный лог       |
+| `--debug`       | `Args.Debug`      | Режим отладки       |
+| `--log-level`   | `Args.LogLevel`   | Уровень логирования |
 
 ## Конфигурация
 
-Подробное описание параметров — в разделе [config.yml](../../common/config/config.md).
+Подробное описание параметров — в разделе [config.yml](../../ref/config.md).
 
 Приоритет: Defaults < `config.yml` < Env < CLI-флаги.