# AGENTS.md — khap-landing

Статический продающий лендинг «Королевский Хап» — единственная HTML-страница, отдаётся на корне `https://khap.ru/` (главная страница домена). Презентует продукт (Telegram-бот, находящий ценовые ошибки и скидки на Wildberries), реальные тарифы подписки и ведёт пользователя оформить подписку в боте «Стражник» (`https://t.me/king_gate_keeper_bot`).

## Стек

- Один файл `index.html` — вся страница: инлайновые `<style>`/`<script>`, SVG-иконки, без внешних хотлинков на картинки. Единственная внешняя зависимость — шрифты Google Fonts (Cinzel + Manrope).
- **Docker**: `Dockerfile` — `FROM nginx:alpine`, копирует `index.html` в `/usr/share/nginx/html/`. Без стадии сборки — контент готов как есть.
- **docker-compose** — прод-запуск: сервис `khap-landing`, образ `gitea.yandex5.ru/monster/khap-landing:master`, порт хоста `5060` → контейнера `80`.

## Точки входа

- Локально: открыть `index.html` прямо в браузере, либо `docker build -t khap-landing:test . && docker run --rm -p 5060:80 khap-landing:test` → `http://localhost:5060/`.
- Прод: Docker-образ по `Dockerfile`, поднимается сервисом `khap-landing` в `docker-compose.yaml` (порт `5060:80`).
- CI/CD: `.github/workflows/docker-image.yml` — на push в `master` собирает и пушит образ в `gitea.yandex5.ru/monster/khap-landing`, затем по SSH деплоит на 192.168.1.41 (папка `docker.services/khap-landing`).

## Конфигурация

- Переменные окружения не требуются — сайт полностью статический, без бэкенда и без обращений к MongoDB в проде.
- Тарифы (`7/14/30/60 дней`, цены, описание) зашиты в `index.html` как снапшот коллекции `subscription.fare` (MongoDB `king-mongo`) на момент публикации. Источник правды по тарифам — сама БД; при изменении тарифов карточки в `index.html` нужно обновить вручную.
- Ссылка на бота (`https://t.me/king_gate_keeper_bot`) захардкожена во всех CTA-кнопках `index.html`.
- Внешняя маршрутизация: nginx на прод-хосте 192.168.1.41 отдаёт этот сервис по точному `location = /` для домена `khap.ru` (не catch-all!) — конфиг nginx живёт вне репозитория, на хосте (`docker.services/nginx/nginx/settings/site-confs/khap.ru.conf`).

## Структура директорий

```
khap-landing/
├── index.html                          # вся страница лендинга
├── Dockerfile                          # nginx:alpine + COPY index.html
├── docker-compose.yaml                 # сервис khap-landing, порт 5060:80
├── .github/workflows/docker-image.yml  # CI: сборка образа + SSH-деплой на 192.168.1.41
├── .gitignore
├── README.md
└── AGENTS.md
```

## Паттерны добавления функциональности

- Правки контента/дизайна — прямо в `index.html` (секции: hero, "как это работает", возможности, тарифы, соц.доказательство, FAQ, футер).
- Обновление тарифов — синхронизировать секцию `#pricing` в `index.html` с актуальными данными коллекции `subscription.fare` в MongoDB (`king-mongo`, 192.168.1.43, база `subscription`).

## Известные особенности

- **Важно при изменении nginx-маршрутизации**: `location = /` на прод-хосте — точное совпадение по пути запроса, без учёта query-строки. Реальные return/callback-URL платёжных провайдеров (ЮMoney/ЮKassa/Qiwi, обрабатываются `bot/gatekeeper`/`bot/gatekeeper-payment`) используют только префикс `/payments/...`, поэтому этот сервис не пересекается с платёжными флоу. Не менять этот `location` на нестрогий/regex-catch-all — это заберёт себе трафик `/payments/*`, `/success.html`, `/donate.html` и т.п., которые должны оставаться на `gatekeeper-payment`.
- Юзернейм бота "Стражник" — `@king_gate_keeper_bot` (проверено вручную в Telegram: живой бот "Королевский Стражник" с фото и описанием). Ранее в других частях платформы (FAQ, `bot/wbproductinfo`, и др.) местами был указан ошибочный `@king_gatekeeper_bot` (без второго подчёркивания) — расхождение исправлено.