Почему после правки products.yml не меняется главная страница?#

Портал — статический сайт Hugo. Нужна пересборка data/portal/public/ (локально, init.sh или CI).

Можно ли обойтись без HTTPS?#

Поставка ориентирована на HTTPS (tls internal или ваш сертификат). Для особых случаев за внешним TLS-прокси потребуется правка Caddyfile.

Где взять доверие к сертификату при tls internal?#

Корневой сертификат Caddy хранится в томе данных Caddy; его можно извлечь из контейнера и распространить внутри организации. Альтернатива — свой CA или Let’s Encrypt.

Нужна ли база данных?#

Нет. Все данные — файлы в data/ и конфигурация Caddy.

Как добавить новый продукт?#

Опубликуйте статику через publish-api: из CI после Hugo отправьте ZIP на POST /v1/publish (см. CONFIGURATION.md и ci-templates/). Локально для отладки можно скопировать файлы в data/<slug>/<тип>/, править products.yml и пересобрать портал.

Главная документации открывается, а внутренние ссылки — 404#

Статика собрана с другим baseURL, чем путь на хабе. На хабе URL вида /docs/<slug>/<section>/.... В HTML должны быть ссылки с тем же /docs/<slug>/<section>/. Пересоберите Hugo с --baseURL https://<домен>/docs/<slug>/<section>/, совпадающим с полями product_slug и section в API. Подробнее — раздел HTTP API публикации.