Добавить сервис FAQ (mkdocs + nginx) для faq.khap.ru

Статический сайт документации Королевский Хап, ранее хостившийся на GitHub Pages (faq.wb10.ru). Контент перенесён из faq-master.zip. - MkDocs (Material theme) собирает статику в Dockerfile (python:3.11-slim) - nginx:alpine отдаёт сайт на порту 80 (хост 8094) - CI: сборка образа + SSH-деплой на khap.ru
2026-08-09 22:22:57 +03:00
parent 1f6ad4439c
commit 2ee71e633e
38 changed files with 680 additions and 2 deletions
@@ -0,0 +1,56 @@
+name: Create and publish a Docker image
+
+on:
+  push:
+    branches: [ "master" ]
+
+env:
+  REGISTRY: gitea.yandex5.ru
+  IMAGE_NAME: monster/faq-khap-ru
+
+jobs:
+  build-and-push-image:
+    runs-on: ubuntu-latest
+    if: ${{ github.server_url != 'https://github.com' }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Log in to the Container registry
+        uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+        with:
+          registry: ${{ env.REGISTRY }}
+          username: ${{ vars.REGISTRY_USERNAME }}
+          password: ${{ secrets.REGISTRY_TOKEN }}
+
+      - name: Extract metadata (tags, labels) for Docker
+        id: meta
+        uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
+        with:
+          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+
+      - name: Build and push Docker image
+        uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+        with:
+          context: .
+          push: true
+          tags: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}:${{ github.ref_name }}
+          labels: ${{ steps.meta.outputs.labels }}
+
+      - name: Install SSH Key
+        uses: shimataro/ssh-key-action@v2
+        with:
+          key: ${{ secrets.SSH_GITEA_PRIVATE_KEY }}
+          known_hosts: 'just-a-placeholder-so-we-dont-get-errors'
+
+      - name: Adding Known Hosts
+        run: ssh-keyscan -p ${{ vars.SSH_PORT }} -H ${{ vars.SSH_HOST }} >> ~/.ssh/known_hosts
+
+      - name: "Deploy to server"
+        run: ssh monster@${{ vars.SSH_HOST }} -p ${{ vars.SSH_PORT }} 'cd docker.services/${{ github.event.repository.name }} && git pull && docker login ${{ env.REGISTRY }} -u ${{ vars.REGISTRY_USERNAME }} --password ${{ secrets.REGISTRY_TOKEN }} && docker compose pull && docker compose build && docker compose up -d && docker system prune --force'
+
+      - name: Send message to Telegram
+        uses: Lukasss93/telegram-action@v2
+        env:
+          TELEGRAM_TOKEN: ${{ vars.TELEGRAM_TOKEN }}
+          TELEGRAM_CHAT: 123622180
@@ -0,0 +1,5 @@
+.env
+__pycache__/
+*.pyc
+site/
+.DS_Store
@@ -0,0 +1,52 @@
+# faq-khap-ru
+
+FAQ Королевский Хап — сайт документации по боту «Королевский Хап», отдаётся как статический сайт по адресу https://faq.khap.ru.
+
+## Стек
+
+- **MkDocs + Material theme** — исходники документации в `docs/` (markdown + картинки), конфиг `mkdocs.yml`.
+- **Docker multi-stage** (`Dockerfile`): стадия `build` на `python:3.11-slim` собирает статику (`mkdocs build`), финальный образ — `nginx:alpine`, отдаёт собранный сайт из `/usr/share/nginx/html`.
+- **docker-compose** — прод-запуск: сервис `faq`, образ `gitea.yandex5.ru/monster/faq-khap-ru:master`, порт хоста `8094` → контейнера `80`.
+
+## Точки входа
+
+- Локально: `python3 -m venv .venv && .venv/bin/pip install mkdocs-material mkdocs_pymdownx_material_extras && .venv/bin/mkdocs serve`.
+- Проверка сборки: `.venv/bin/mkdocs build --site-dir /tmp/faq-site`.
+- Прод: Docker-образ по `Dockerfile`, поднимается сервисом `faq` в `docker-compose.yaml` (порт `8094:80`).
+- CI/CD: `.github/workflows/docker-image.yml` — на push в `master` собирает и пушит образ в `gitea.yandex5.ru/monster/faq-khap-ru`, затем по SSH деплоит на khap.ru (порт 221, папка `docker.services/faq-khap-ru`).
+
+## Конфигурация
+
+- `mkdocs.yml` — конфиг MkDocs: тема material, навигация (`nav`), markdown-расширения (pymdownx и др.), плагин `search` (ru/en). `site_url: https://faq.khap.ru`.
+- Внешняя маршрутизация: `faq.khap.ru` проксируется nginx на khap.ru на контейнер (порт `8094`).
+- Переменные окружения не требуются — сайт полностью статический.
+
+## Структура директорий
+
+```
+faq-khap-ru/
+├── mkdocs.yml                # конфиг MkDocs (тема, nav, расширения)
+├── docs/                     # markdown-исходники документации
+│   ├── *.md                  # страницы (rules, payment, content, gatekeeper, knopka, autobot_*, app, review, index)
+│   └── img/                  # картинки страниц
+├── theme/                    # кастомные css/js для темы material
+├── Dockerfile                # multi-stage: mkdocs build → nginx
+├── docker-compose.yaml       # сервис faq, порт 8094:80
+├── .github/workflows/docker-image.yml  # CI: сборка образа + SSH-деплой на khap.ru
+├── .gitignore
+├── README.md
+└── AGENTS.md
+```
+
+## Паттерны добавления функциональности
+
+- Новая страница FAQ: добавить `docs/<name>.md` и прописать её в `nav` в `mkdocs.yml`.
+- Новые картинки: класть в `docs/img/`, ссылаться относительными путями.
+- Изменения в теме: править файлы в `theme/` (подключены через `custom_dir` в `mkdocs.yml`).
+
+## Известные особенности
+
+- **Ранее хостился на GitHub Pages** (`faq.wb10.ru`, репозиторий `korolevskiyhap/faq`, деплой через `mkdocs gh-deploy`). Перенесён в отдельный сервис `monster/faq-khap-ru` на khap.ru, домен `faq.khap.ru`.
+- Контент последний раз обновлялся 06.10.2022 (по датам файлов в архиве) — актуальность информации требуется подтверждать у владельца.
+- Сайт статический, поиск работает только на клиентской стороне (плагин `search` MkDocs).
+- В `docs/` есть картинки с пробелами в именах файлов (`img/visual/pic 3.jpg`) — в ссылках markdown используются URL-encoded пути, при переносе файлов не переименовывать.
@@ -0,0 +1,3 @@
+# faq-khap-ru
+
+See [AGENTS.md](./AGENTS.md) for service architecture and documentation.
@@ -0,0 +1,17 @@
+FROM python:3.11-slim AS build
+
+WORKDIR /build
+
+RUN pip install --no-cache-dir mkdocs-material mkdocs_pymdownx_material_extras
+
+COPY mkdocs.yml ./
+COPY docs ./docs
+COPY theme ./theme
+
+RUN mkdocs build
+
+FROM nginx:alpine
+
+COPY --from=build /build/site /usr/share/nginx/html
+
+EXPOSE 80
@@ -1,3 +1,7 @@
-# faq
+# faq-khap-ru

-FAQ Королевский Хап — сайт документации (mkdocs static, nginx)
+FAQ Королевский Хап — сайт документации по боту «Королевский Хап». Отдаётся как статический сайт по адресу https://faq.khap.ru.
+
+Исходники документации — markdown в `docs/`, собираются в статику через MkDocs (Material theme) и раздаются nginx внутри Docker-контейнера.
+
+Подробности — в [AGENTS.md](./AGENTS.md).
@@ -0,0 +1,13 @@
+version: '3.7'
+services:
+  faq:
+    build: ./
+    image: gitea.yandex5.ru/monster/faq-khap-ru:master
+    container_name: faq
+    restart: always
+    ports:
+      - "8094:80"
+    logging:
+      driver: json-file
+      options:
+        max-size: 50m
@@ -0,0 +1,32 @@
+## Где скачать приложение?
+Актуальные версии:  
+Версия 1.0.30 - https://t.me/c/1525409337/266222 - Исправление для BY  
+Версия 2.0.30 - https://t.me/c/1525409337/266222 - Исправление для BY  
+
+
+ 
+Старые версии приложений:  
+Версия 2.0.29 - https://t.me/c/1525409337/254577 - Исправление для KZ  
+Версия 2.0.28 - https://t.me/c/1525409337/236633 - Оплата с баланса.  
+Версия 2.0.27 - https://t.me/c/1525409337/233233 - Переход на новый запрос списка заказов.   
+Версия 2.0.26 - https://t.me/c/1525409337/194435 - Исправление по изменениям ВБ со список заказов.  
+Версия 2.0.23 - https://t.me/c/1525409337/170182  
+Версия 2.0.21 - https://t.me/c/1525409337/164909 - исправлен список заказов с дробной ценой.  
+Версия 2.0.19 - https://t.me/c/1525409337/160704 - исправлен сломанный ВБ список заказов  
+Версия 2.0.18 - https://t.me/c/1525409337/150454 (Версия 1.0.16 теперь в ветке 2 (2.0.18) с мелкими исправлениями по профилю ВБ.)  
+  
+Версия 1.0.29 - https://t.me/c/1525409337/254577 - Исправление для KZ  
+Версия 1.0.28 - https://t.me/c/1525409337/236633 - Оплата с баланса.  
+Версия 1.0.27 - https://t.me/c/1525409337/233233 - Переход на новый запрос списка заказов.   
+Версия 1.0.26 - https://t.me/c/1525409337/194435 - Исправление по изменениям ВБ со список заказов.  
+Версия 1.0.23 - https://t.me/c/1525409337/170182  
+Версия 1.0.21 - https://t.me/c/1525409337/164909 - исправлен список заказов с дробной ценой.  
+Версия 1.0.19 - https://t.me/c/1525409337/160703 - исправлен сломанный ВБ список заказов  
+Версия 1.0.18 - https://t.me/c/1525409337/150453 (Портировал размеры и возможность отмены в версию 1.0 — продолжение линейки 1.0.14 теперь в версии 1).  
+Версия 1.0.16 - https://t.me/c/1525409337/150170 (Добавлена возможность отменять заказы в пути).
+Версия 1.0.14 - https://t.me/c/1525409337/123918  
+Версия 1.0.12 - https://t.me/c/1525409337/124668  
+
+## Как установить на Huawei
+Установленное на телефоны марки HUAWEI приложение не проходит авторизацию, потому что ему не хватает гугл-сервисов.  
+Для установки можно клонированить приложение в GSpace и запустить приложение там.
@@ -0,0 +1,79 @@
+## Автовыкуп FAQ - настройка правил
+
+ 1. Несколько совпадений (перечислений или же набора товара) не работает  
+    Например: ```*спортивный костюм*костюм с начесом*костюм спортивный*```
+
+    Это не 3 правила как бы хотелось для бота это запрос и на месте * могут быть доп слова, но покупать будет при точном совпадении слов
+
+ 2. Выбор размеров это ПОЖЕЛАНИЕ, это не фильтр и не поиск и не список отсечения, если ваш размер будет в наличии - постарается купить его, если нет - любой
+
+ 3. Товар ищется по полному совпадению пример со звездочками названия 
+    - ```костюм спортивный```
+        Покупка только строгое название «костюм спортивный», если в названии будет «костюм спортивный женский» бот даже пробовать покупать не будет  
+    - ```*костюм спортивный```
+        Звездочка перед словом костюм спортивный означает что вначале могут быть какие-то символы или слова  
+        То есть будет покупать «чёрный костюм спортивный»  
+        «Женский костюм спортивный»  
+        На месте * любое слово и сочетание слов  
+        Но не купит «женский костюм спортивный чёрный»  
+    - ```костюм спортивный*```
+        Звездочка вконце заменяет любые слова
+        То есть будет покупать костюм спортивный женский, костюм спортивный детский и так далее
+        Не купится: женский костюм спортивный на ребёнка 
+
+    - ```*костюм спортивный*```
+        Звездочки с обоих сторон означает что до «костюм спортивный» и после могут быть символы
+        Например: красивый костюм спортивный женский
+        Стильный костюм спортивный на ребёнка
+
+        Не купится если костюм женский спортивный 
+
+    - ```*костюм*спортивный*```
+        Будет покупаться любой товар в котором есть слово костюм спортивный именно в сочетании сначала костюм потом спортивный 
+        Красивый костюм на девочку спортивный
+
+4. Цена пишется только цифрой без *  
+То есть ```100*``` или ```*100``` неверно  
+
+5. От повторной покупки товар блокируется на 5 минут, если через 5 минут товар прилетит еще раз то он снова будет куплен.
+
+6. Приложение и автовыкуп никак между собой не связаны!  
+Приложение - это просто приложение.  
+Автовыкуп - это просто автовыкуп  
+
+7. [@king_fisher_bot](http://t.me/king_fisher_bot) - после переезда на нового ловца ОБЯЗАТЕЛЬНА его активация. Без активации нового ловца правила действовать не будут.
+
+8. Бот не будет искать товары под Ваши правила сам, он только проверяет те товары, что отправляет в телеграм (и то что до телеграма могло не дойти).
+
+9. !!! Пожалуйста, НЕ СТАВЬТЕ несколько звездочек подряд (```**костюм****```) — НЕ ПРАВИЛЬНО. Это бесполезно замедляет обработку правил. Одной звездочки достаточно (```*костюм*``` - правильно).
+
+10. #категорииавтовыкупа по этому хештегу в чате можно найти картинку как искать ЦИФЕРНУЮ категорию, если вас не устраивает автоопределение
+11. Если у Вас два правила на одну группу товаров, например ```*куртка*``` и ```куртка кожанная``` то игнорировать один и тот-же плохой товар придется дважды, потому что список игнорирования настраивается НА ПРАВИЛО.
+
+## Склады
+При указании склада они отсекаются лишь верхнеуровнево. 
+!!! Не выбирайте ОБА склада - просто снимите с них галочки, если хотите убрать фильтрацию.  
+Пример: Вы указали склад продавца, в автовыкуп прилетел товар со склада ВБ+склад продавца.  
+Правило сработает и может купить Вам товар со склада вб ИЛИ со склада продавца.  
+Но Если товар будет только со склада продавца, а в правиле только склад ВБ - попытки выкупа не будет.  
+
+## Что обозначают символы подстановки?
+```*``` - не строгий символ заменяет кучку символов или просто не используется  
+```?``` - заменяет ОДИН символ всегда и обязательно
+
+## Учитывая что участились "а-а-а-а-а оно все скупает" предупреждаю еще раз: 
+ПРАВИЛА ДЕЙСТВУЮТ В МОМЕНТ ИХ РЕДАКТИРОВАНИЯ!  
+Обновление правил минимум 1-2 минуты!  
+Думайте во время редактирования правил!  
+
+## У меня нет кнопки Магия в настройках.
+У вас тариф без кнопки купить. Вы можете докупить кнопку к Вашему текущему тарифу из рассчета 8р за каждый оставшийся день подписки.  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Тарифы -> Кнопка
+
+## Как узнать идентификатор поставщика?
+Просто - никак, сложный путь такой:  
+https://card.wb.ru/cards/detail?appType=64&lang=ru&locale=ru&nm=43086895&pricemarginCoeff=1&pricemarginMax=0&pricemarginMin=0&reg=0&regions=1,4,22,30,31,33,38,40,48,64,66,68,69,70,71,75,80,83&spp=0&version=3
+В этой ссылке: 43086895 - артикул товара.  
+В полученном ответе supplierId - это и есть искомый идентификатор поставщика.  
+https://www.wildberries.ru/seller/32477 - все товары поставщика
+
@@ -0,0 +1,38 @@
+!!!АВТОВЫКУП!!!
+
+
+Всем привет!
+
+**функционал доступен на тарифе с кнопкой**
+
+У нас появился новый функционал и называется он автопокупка ботом, без вашего вмешательства!
+
+
+❌ Сразу оговоримся на данный функционал мы подсказывать и поддерживать не будем - он просто есть - кому нужно берите и пользуйтесь на свой страх и риск!!!
+
+Это единственное сообщение об этом функционале о котором мы пишем.
+
+Автопокупка работает на ВСЕ товары, которые видит бот, эти товары по тем или иным причинам могут не долететь до телеграмма/приложения, но купиться автопокупкой.
+Следить/отменять хлам если он купится - все остаётся за вами.
+
+Повторюсь ещё раз - мы этот функционал поддерживать и проверять не будем, претензии так же не принимаем.
+Если вы настроите что-то неверно и у вас не постоплата, а оплата картой или лимит постоплаты закончится и будут списываться деньги - мы за это ответственности не несём, поэтому подходите к настройки правил с умом и осторожностью.
+
+Настроить правило под себя можно так:
+
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Магия
+
+Тыкаем - ознакамливаемся - настраиваем и пользуемся для кого это актуально :)
+
+Для добавления правила нужно нажать кнопку "Новое правило" и отправить ссылку на товар, на основе которого будет сформировано правило.  
+По умолчанию правило создается на один конкретный товар, но это не оптимально. Ваша задача подредактировать правило так, чтобы под него попадало как можно меньше нежелательного товара и как можно больше желательного Вам.  
+Описание как настраивать правила можно прочитать [тут](/autobot_faq/).  
+
+[@king_fisher_bot](http://t.me/king_fisher_bot) - после переезда на нового ловца ОБЯЗАТЕЛЬНА его активация отправкой команды /start. **Без активации нового ловца правила действовать не будут**.
+
+P.S. Порядок оформления заказов для пользователей абсолютно случайный, никакого приоритета ни у кого нет и даже за доп.плату не может быть!
+
+
+P.S2: Настроить автовыкуп количеством товара больше 1 штуки нельзя - мы это прописали программно
+
+P.S3: Лимит 50 правил, больше телеграмм не выдерживает
@@ -0,0 +1,100 @@
+# Автовыкуп лайт версия
+Мы, как и прежде, **не оказываем помощь с настройкой автовыкупа**, но вместе с тем, хотели бы попробовать упросить жизнь, и вам, и нам посредством графической подачи информации. Данная ветка FAQ должна помочь лучше разобраться тем, кто только к нам присоединился и, возможно тем, кто с нами уже давно. Автовыкуп в лайт версии является урезанным, но как только вы поймете логику, то смело можете переходить к более расширенной настройке, описанной здесь [тык](/autobot_faq/). А пока приступим?
+
+## Как настроить автовыкуп? С чего начать?
+## Шаг 1. Зайти в королевского стражника и прислать ему ссылку
+У нас есть бот - его зовут Королевский стражник [тык на стражника](https://t.me/king_gatekeeper_bot), в нем хранится вся информация и настройки для Вашего аккаунта. Для того, чтобы добавить правило автовыкупа нам нужно перейти Настройки-> Магия->Новое правило (смотри Рисунок 1)
+
+![Рисунок 1](img/visual/pushremoveoneone.png)  
+Рисунок 1
+
+Сегодня мы будем создавать и рассматривать правило автовыкупа на спортивный костюм.
+Прежде всего, нам необходимо в поиске на сайте wildberries ввести словосочетание "спортивный костюм" [тык](https://www.wildberries.ru/catalog/0/search.aspx?sort=popular&search=%D1%81%D0%BF%D0%BE%D1%80%D1%82%D0%B8%D0%B2%D1%8B%D0%BD%D0%B9+%D0%BA%D0%BE%D1%81%D1%82%D1%8E%D0%BC) и открыть совершенно любую карточку, которая выпала в поиске. Обратите внимание, что ссылка должна быть не на все костюмы, которые открылись по поиску, а только на один нами выбранный [тык](https://www.wildberries.ru/catalog/23408032/detail.aspx?targetUrl=GP). Мы копируем ссылку и отправляем ее стражнику [тык на стражника](https://t.me/king_gatekeeper_bot), затем нажимаем кнопку назад.
+Мы вернулись назад и видим перед собой только что созданное правило автопокупки (смотри Рисунок 2), но его нужно доработать.
+
+![Рисунок 2](img/visual/rules.jpg)  
+Рисунок 2
+
+## Шаг 2. Называем правило
+Сначала нажимаем на кнопку "Название правила" и называем наше правило так, как будет удобнее нам в дальнейшем найти его среди других нами созданных правил. Обратите внимание, что название правила не влияет на автопокупку, вы можете обозвать правило как угодно.
+
+## Шаг 3. Указываем или не указываем бренд
+Нажимаем на кнопку "Бренд". Если вам необходимо, что бы при автопокупке выкупалась определенная марка/бренд костюма, то вписываем необходимый бренд, если же нет, то ставим ```*```  
+Символ ```*``` обозначает то, что выкупаться будет любой бренд.
+
+## Шаг 4. Прописываем название товара
+Название товара. Нажимаем на кнопку "Название товара". Название товара напрямую ВЛИЯЕТ на автопокупку, в лайт версии FAQ мы рассмотрим четыре варианта написания правила (в полной версии их несколько больше )
+
+
+### Вариант 1. Название товара в правиле - ```Костюм спортивный```
+![suit_1](img/visual/suit_1.jpg)  
+
+### Вариант 2. Название товара в правиле  - ``` *костюм спортивный* ```
+![suit_2](img/visual/suit_2.jpg)  
+
+### Вариант 3. Название товара в правиле - ``` *костюм спортивный```
+![suit_3](img/visual/suit_3.jpg)  
+
+### Вариант 4. Название товара в правиле - ```Костюм спортивный* ```
+![suit_4](img/visual/suit_4.jpg)  
+
+Не забывайте о том, что на совершение ботом автопокупки влияет так же бренд, если он был выбран, категория, цена и склад
+
+## Шаг 5. Категория товара
+Нажимаем на кнопку "Категория товара". По умолчанию, стражник сам определяет верную категорию, если вы правильно выслали ему ссылку на Шаге 1 и менять ее необходимости нет, но если вы считаете, что категория не нужна вообще - ставим ```*```. Обратите внимание, указывая символ ```*``` в правиле, что в данном случае обозначает "любая категория", "все категории", вы даете стражнику указание выкупать товар из всех категории, которые будут подходить под название товара, стоимость, бренд и склад, если таковые были прописаны.
+
+## Шаг 6. Проставляем цену
+Нажимаем на кнопку "Цена". Необходимый ценовой диапазон вы определяете самостоятельно, он начинается от 0 и задается цифрой. НЕ нужно в правиле прописывать цену таким образом: 500 рублей - рубли по умолчанию опускаются. Цена пишется только цифрой без ```*```, то есть ```100*``` или ```*100``` неверно
+
+## Шаг 7. Выбор размера
+Нажимаем на кнопку "Размеры". Выбор размеров это ПОЖЕЛАНИЕ, это не фильтр и не поиск и не список отсечения, если ваш размер будет в наличии - бот постарается купить его, если нет - будет выкуплен любой размер
+
+## Шаг 8. Выбор склада
+Нажимаем на кнопку "Склад". Вы можете указать приоритет выкупа - со склада wildberries или со склада продавца. Не выбирайте ОБА склада - просто снимите с них галочки, если хотите убрать фильтрацию совсем
+
+## Шаг 9. Нажать на кнопку включить
+После всех настроек вашего правила, не забудьте включить автовыкуп, нажав на кнопку "Включить"(смотри Рисунок 3). По умолчанию автовыкуп выключен
+
+![кнопки два](img/visual/pushremove.png)  
+Рисунок 3
+
+***Категории поставщик и артикул в версии лайт настраивать не нужно, пока вы не разберетесь с базовой настройкой***
+
+## Королевский ловец
+Для вашего удобства мы создали бота, который будет в отдельный чат присылать оповещения при автовыкупе [ссылка на бот](https://t.me/king_fisher_bot). Королевский стражник и королевский ловец это разные боты :). Для запуска необходимо отправить следующее сообщение королевскому ловцу: /start (смотри Рисунок 4)
+
+![рисунок 4](img/visual/pic%203.jpg)  
+Рисунок 4
+
+## Игнорировать, проверить товар и отменить товар
+Когда ваше правило автовыкупа сработает и бот попытается выкупить товар, то вы увидите перед собой две кнопки - Проверить и Игнорировать товар
+
+Рисунок 5, как это будет примерно выглядеть.
+
+![Рисунок 5](img/visual/ignor.jpeg)  
+Рисунок 5
+
+Если при нажатии кнопки "Проверить" вы получите сообщение, что "Заказ не найден":-повторите нажатие через 10-20 секунд-если повторно выдаст такое же сообщение "заказ не найден"-это означает, что товара нет в доставках - проверяйте раздел "покупки", вероятнее всего, товар в статусе "отмена магазином"
+
+
+Если появилась кнопка "Отменить" - Ваш заказ принят системой wildberries в обработку, если кнопки нет - вероятнее всего Ваш заказ отменен магазином или в статусе ожидается
+
+Кнопка "Игнорировать товар" отвечает за перенос артикула товара в список игнорирования, т.е товар не будет куплен повторно, если он появится вновь в боте.
+Обратите внимание, бот выкупит такой же товар, если на wildberries он был указан под другим артикулом.
+Пример: у платья размерной сетки от XS до L указан артикул 0000 - мы нажали кнопку игнорировать товар, через час в боте появилось это же платье размера XL c артикулом 0001 - бот выкупит этот товар.
+
+
+Если вы случайно нажали на кнопку "игнорировать", то товар можно удалить из этого списка, только удалив правило и добавив его заново, будьте внимательны!
+
+## Пример рабочего правила
+Напоследок, покажем вам верное, рабочее правило - оно не обязательно у вас должно быть точно такое же: на свое усмотрение вы можете менять цену, название правила, название товара, склад и указывать или не указывать бренд. Смотри Рисунок 6
+
+![рисунок 5](img/visual/full_working_rule.jpg)  
+Рисунок 6
+
+
+
+Все :)
+Вы прошли обучение лайт версии настройки автовыкупа. Вы прекрасны!
+
+Автор текста @richerries.
@@ -0,0 +1,18 @@
+Функция Лист Ожидания  
+  
+Бот мониторит прописанные артикулы и если они появляются в наличии - осуществляет попытку покупки  
+  
+К примеру хотите вы очень купить корм собачий:  
+  
+https://www.wildberries.ru/catalog/13171524/detail.aspx  
+
+![Рисунок 1](img/autobuy_lo.jpg)  
+
+Создаёте правило как на картинке.  
+Бот не будет ждать пока корм появится в выдаче, а будет мониторить его появление сам и как только появится если он пройдёт по цене то будет попытка покупки товаров.  
+  
+Артикулов можно указать много, цену можно указать только общую для всех (цена максимальная для артикула то есть указывая 500 или любую другую сумму каждый из артикулов до этой цены будет покупаться).  
+  
+Артикулы указываются через , (запятую)  
+  
+Максимальное количество артикулов ограничено только 4096 символами телеграмма сколько влезет - пока не понятно :) но как только вы не сможете редактировать правило - всё, лимит.  
@@ -0,0 +1,38 @@
+## Инфографика - расшифровка значков в боте
+
+🔥 Важные - с большой вероятностью "Хап".  
+🔄 Обновление цены - товары цена на которые была снижена продавцом  
+🚚 - склад wb  
+🐷 - склад продавца  
+🔺 - Цена товара ВЫШЕ чем минимальная по графику ВБ,   
+🔺🔺 - цена товара ВЫШЕ чем максимальная по графику ВБ  
+🔻 - цена товара ниже минимальной по графику ВБ   
+🔻🔻 - цена товара сильно ниже минимальной по графику вб.  
+
+Названия складов:  
+KLD - Коледино  
+ELS - Электросталь  
+POD - Подольск  
+BDA - Белая Дача
+
+NSB - Новосибирск  
+KHV - Хабаровск  
+KRR - Краснодар  
+KR2 - Краснодар-2  
+EKB - Екатеринбург  
+SPB - Санкт-Петербург  
+KZN - Казань  
+
+DMD - Домодедово  
+NKH - Николо-Хаванское  
+PSK - Пушкино  
+KRK - Крекшино  
+ALX - Алексин  
+WBS - Неизвестный склад WB
+
+## Почему бот выдает товары которых уже нет в наличии?
+Товар успели выкупить другие подписчики, под каждым товаром отображается с какого склада и какое количество товара было в наличии.
+
+## Планируете ли Вы добавление других маркетплейсов?
+Нет, добавление других маркетплейсов пока не планируется.  
+Сделать хорошо с оформлением заказов это долго и дорого, делать просто отправку товаров не интересно.
@@ -0,0 +1,18 @@
+## Я оплатил подписку но не получаю ссылок со скидками
+Для получения новой ссылки перейдите в меню:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Моя подписка -> Получить ссылки приглашения -> Королевский Хап  
+После этого в открывшемся окне нажмите кнопку Начать\\Старт\\Start или напишите /start
+
+## Я не могу войти по ссылке в болталку (устарела или потерялась)
+Для получения новой ссылки перейдите в меню:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Моя подписка -> Получить ссылки приглашения
+
+## Как пригласить знакомого
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Реф программа.
+Скопировать Вашу реф. ссылку знакомому, попросить его перейти по ней и **нажать старт** (если не нажать старт ДНИ за рефералла начислены **не будут**)
+
+## У меня знакомая подключилась по моей ссылке. Как проверить засчитали ли доп.дни за неё?
+Вам должно прийти сообщение после подписки Вашего рефералла.  
+Проверить оставшиеся дни подписки можно тут:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Моя подписка
+
@@ -0,0 +1,9 @@
+Привет.  
+Мы рады что ты с нами.  
+Тут мы собрали ответы на самые частые вопросы по боту.  
+Слева есть меню навигации по разделам - выбирай нужный и ищи свой вопрос.
+
+## Подборка хапов от подписчиков
+Телеграмм: https://t.me/hap_king  
+Вк: https://vk.com/king_wildberries  
+Добавить свой хваст можно [вот так](/review/). 
@@ -0,0 +1,53 @@
+## Я оплатил тариф с кнопкой, но кнопки купить нет.
+Для начала использования кнопки её нужно настроить:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Назад -> Настройки -> Кнопка купить -> отправить номер телефона сообщением -> отправить код из приложения\смс сообщением.   
+После этого советуем проверить выбранную карту и ПВЗ в настройках. Должны быть галочки ✅.
+
+## Как временно отключить и включить обратно кнопку
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Назад -> Настройки -> Кнопка купить -> Включена\Выключена.
+
+## Я изменил ПВЗ в приложении WildBerries но бот все равно оформляет заказ в старый ПВЗ.
+Нужно изменить ПВЗ в боте: [@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Кнопка купить -> Смена пвз
+
+## Мой адрес ПВЗ не находит в боте
+Добавить с ПОЛНОЙ версии сайта WildBerries Ваш новый ПВЗ, оформить заказ, после этого выбрать в боте:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Кнопка купить -> Смена пвз
+
+## Я изменил карту в приложении WildBerries но бот все равно оформляет заказ со старой картой.
+Нужно изменить карту в боте: [@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Кнопка купить -> Смена карты
+
+## Как изменить карту или ПВЗ, если я из страны отличной от России
+В этом случае ПВЗ и карта меняются через поддержку: [@king_supports](http://t.me/king_supports)
+
+## Если у вас ошибка оформления 3DS и ссылка
+Такое сообщение вб отдаёт когда банк, выпустивший карту запрашивает подтверждение по смс.
+
+Может быть в нескольких случаях:  
+1. В стражнике указана не та карта (самый простой вариант).  
+	Проверяем так: [@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Кнопка купить -> Смена карты
+	Ваша карта должна иметь галочку ✅  
+2. Карта пустая, вб просит подтверждение, но все равно оформляет заказ (нужно проверить на любом не хаповом товаре)  
+3. Если есть SberPay - попробуйте выбрать его в списке карт (смена карты по инструкции из пункта 1) и оформить заказ спустя несколько минут.  
+4. Карта не пустая, но привязана не до конца (удаляем карту, через ПОЛНУЮ ВЕРСИЮ вб добавляем, вводим код подтверждения, оформляем заказ через мобильное приложение - если код просит, вводим, отменяем заказ, еще раз оформляем через приложение - код должно перестать просить, выбираем в стражнике верную карту).  
+5. Прошлый пункт проделан, но код все равно просит - тут уже только привязывать другую карту.  
+
+## Я покупаю товар через кнопку, но заказ отменён.
+Я перехожу по ссылке и вижу товар в наличии.  
+Так может быть по нескольким причинам:  
+1. Не верно выбрана карта в стражнике (@king_gatekeeper_bot - Настройки - Кнопка купить - смена карты), при этом обычно пишет в уведомлениях что платеж не удался и товар возвращен в корзину.  
+2. Товар был выкуплен автовыкупом и отменен другими подписчиками - между этими событиями вы пытались совершить покупку по кнопке. Проверяется отправкой ссылки на любой товар с сайта боту - он формирует карточку, вы нажимаете купить и проверяете что товар успешно оформился.  
+3. Иногда путают товары оформленные руками и через кнопку, потом на разборе претензии оказывается что товар выкупленный через кнопку в статусе оформлен, а тот который куплен руками отменён.  
+4. Когда проверяете руками - обязательно оформить заказ(просто в карточке товара и в корзине данные о наличии неправильные - кэш вб).  
+5. Проверьте карту и оформление других товаров, если другой товар оформился - то с кнопкой всё ок.  
+
+## Ошибка оформления заказа: Выбранный адрес не существует
+Выбран не верный или закрывшийся ПВЗ. Измените ПВЗ на другой:  
+[@king_gatekeeper_bot](http://t.me/king_gatekeeper_bot) -> Настройки -> Кнопка купить -> Смена пвз
+
+## Авторизация была сброшена, но я НЕ отключал бота в приложении.
+‼️‼️‼️‼️ ДЛЯ ТЕХ У КОГО НЕ РАБОТАЕТ КНОПКА (Сброшена авторизация).  
+1. Авторизовываетесь в приложении wb (если уже авторизованы то выйти и зайти снова)  
+2. Авторизовываетесь в боте  
+3. Никуда не тыкая идём в мобильное приложение в раздел «активные сеансы»  
+4. В мобильном приложении тыкаем на кнопку «подтвердить обладание аккаунтом»  
+5. Вводите код  
@@ -0,0 +1,12 @@
+## Оплата для РБ
+К сожалению прямаю оплата картой для РБ не работает из-за санкций.  
+Оплатить бота можно с подтвержденного кошелька ЮМани. 
+  
+Завести его можно по следующей инструкции:  
+![payment1](img/payment/1.jpg)
+
+![payment2](img/payment/2.jpg)
+
+И пополнять кошелек не через кошелек заходить в Сбербанк,  а наоборот,  из своего онлайн банкинга пополнять.
+
+За инструкцию спасибо [@Coiath555](https://t.me/Coiath555)
@@ -0,0 +1,20 @@
+## Отзывы/Хвасты
+Так как яМы устали от того что Саша тормозит с отзывами теперь их будет принимать Стражник.
+
+Для того чтобы Ваш отзыв был принят ботом нужно В ОДНО СООБЩЕНИЕ:  
+ 1. (Опционально) написать текст отзыва.  
+ 2. Добавить в текст отзыва хештег #хваст  
+ 3. Добавить одну или несколько фотографий. Очень желательно с реальным фото товара и скриншотом цены покупки в боте, совместить можно через приложения типа GridArt).  
+ 4. Поставить галочку "сжать изображение" (чтобы картинки были прямо в сообщении, а не файлами)  
+ 5. Отправить отзыв в канал или в личку стражнику  
+  
+После отправки должна быть надпись "Спасибо! Ваш хваст принят!".
+
+## Правила начисления подписки за #хваст
+‼️‼️‼️ ХВАСТЫ ‼️‼️‼️  
+  
+1. Хвасты отправляются или стражнику @king_gatekeeper_bot или в болталку обязательно хештег #хваст  
+2. Хваст должен быть действительно ХАПовым и выгодным товаром, несколько товаров в одном сообщении!  
+3. Обязательно реальное фото товара и цена (скрин) стоимости  
+4. Все ваши хвасты проходят модерацию и могут быть не опубликованы  
+5. За правильный хваст, мы даём бонус или не выдаем бонус - на усмотрение администрации, во избежании попыток накрутки подписки хвастами.  
@@ -0,0 +1,11 @@
+## Правила проекта\чата:
+1. Запрещено оскорбление других участников, переход на личности.  
+2. Запрещена любая реклама: намёками, картинками, ссылками, пересылом, и.т.д.  
+3. Запрещено упоминание других ботов, групп, проектов, каналов, и.т.д (исключение: мамский чат).  
+4. Запрещена дедовщина в любых её проявлениях, деление на старичков и новичков отныне вне правил.  
+5. Запрещено "раскачивать лодку", санкции будут применены ко всем участвующим без разбора. Не согласны с решениями по проекту - welcome в личку.  
+  
+- Разрешено и приветствуется скидывать ссылки на товары с ВБ и других интернет-магазинов, интересные акции и скидки.  
+  
+Нарушившим указанные выше правила будет сразу выдан мут на неделю. При повторном нарушении срок будет увеличен вдвое.  
+ВСЕ вопросы про баны\муты в личке будут игнорироваться после выдачи наказания.  
@@ -0,0 +1,98 @@
+site_name: Королевский Хап FAQ
+site_description: Ответы на частые вопросы по боту Королевский Хап
+site_url: https://faq.khap.ru
+
+theme:
+  name: material
+  #custom_dir: theme
+  icon:
+    logo: material/book-open-page-variant
+  palette:
+    scheme: dracula
+    primary: deep purple
+    accent: deep purple
+  #font:
+  #  text: Roboto
+  #  code: Roboto Mono
+  # features:
+  #   - navigation.tabs
+
+nav:
+  - Правила: rules.md
+  - Оплата: payment_sanctions.md
+  - Товары: content.md
+  - Стражник: gatekeeper.md
+  - Кнопка: knopka.md
+  - Автовыкуп: 
+    - Начальная настройка: autobot_visual.md
+    - Описание запуска: autobot_intro.md
+    - Составление правил: autobot_faq.md
+    - Лист ожидания: autobuy_lo.md
+  - Приложение: app.md
+  - Хвасты: review.md
+
+markdown_extensions:
+  - markdown.extensions.toc:
+      slugify: !!python/name:pymdownx.slugs.uslugify
+      permalink: ""
+  - markdown.extensions.admonition:
+  - markdown.extensions.smarty:
+      smart_quotes: false
+  - pymdownx.betterem:
+  - markdown.extensions.attr_list:
+  - markdown.extensions.def_list:
+  - markdown.extensions.tables:
+  - markdown.extensions.abbr:
+  - markdown.extensions.footnotes:
+  - markdown.extensions.md_in_html:
+  - pymdownx.superfences:
+  - pymdownx.highlight:
+      extend_pygments_lang:
+        - name: php-inline
+          lang: php
+          options:
+            startinline: true
+        - name: pycon3
+          lang: pycon
+          options:
+            python3: true
+  - pymdownx.inlinehilite:
+  - pymdownx.magiclink:
+      repo_url_shortener: true
+      repo_url_shorthand: true
+      social_url_shorthand: true
+      user: facelessuser
+      repo: MarkdownPreview
+  - pymdownx.tilde:
+  - pymdownx.caret:
+  - pymdownx.smartsymbols:
+  - pymdownx.emoji:
+      emoji_index: !!python/name:materialx.emoji.twemoji
+      emoji_generator: !!python/name:materialx.emoji.to_svg
+  - pymdownx.escapeall:
+      hardbreak: true
+      nbsp: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
+  - pymdownx.arithmatex:
+  - pymdownx.mark:
+  - pymdownx.striphtml:
+  - pymdownx.snippets:
+      base_path: docs/src/markdown/_snippets
+  - pymdownx.keys:
+      separator: "\uff0b"
+  - pymdownx.details:
+  - pymdownx.tabbed:
+  - pymdownx.saneheaders:
+
+extra:
+  social:
+    - icon: fontawesome/brands/github
+      link: https://github.com/korolevskiyhap/faq/
+
+plugins:
+  - search:
+      lang:
+        - en
+        - ru
+  - mkdocs_pymdownx_material_extras
@@ -0,0 +1 @@
+!function(){"use strict";var e=function(e,t,n){for(var o=function(e){for(var t="",n=0;n<e.childNodes.length;n++){var o=e.childNodes[n];if("code"===o.tagName.toLowerCase())for(var a=0;a<o.childNodes.length;a++){var i=o.childNodes[a];if("#text"===i.nodeName&&!/^\s*$/.test(i.nodeValue)){t=i.nodeValue;break}}}return t},a=function(e){return e.textContent||e.innerText},i=document.querySelectorAll("article"),r=document.querySelectorAll("pre.".concat(t,",div.").concat(t)),d=void 0===n?{}:n,c=0;c<r.length;c++){var l=r[c],s=document.createElement("div");s.className=t,s.style.visibility="hidden",s.style.position="absolute";var u="pre"===l.tagName.toLowerCase()?o(l):a(l);i[0].appendChild(s);e.parse(u).drawSVG(s,d),s.style.visibility="visible",s.style.position="static",l.parentNode.insertBefore(s,l),l.parentNode.removeChild(l)}};!function(e){document.addEventListener?document.addEventListener("DOMContentLoaded",e):document.attachEvent("onreadystatechange",function(){"interactive"===document.readyState&&e()})}(function(){"undefined"!=typeof flowchart&&e(flowchart,"uml-flowchart"),"undefined"!=typeof Diagram&&e(Diagram,"uml-sequence-diagram",{theme:"simple"})})}();
				`@@ -0,0 +1 @@`
				!function(){"use strict";var e=function(e,t,n){for(var o=function(e){for(var t="",n=0;n<e.childNodes.length;n++){var o=e.childNodes[n];if("code"===o.tagName.toLowerCase())for(var a=0;a<o.childNodes.length;a++){var i=o.childNodes[a];if("#text"===i.nodeName&&!/^\s*$/.test(i.nodeValue)){t=i.nodeValue;break}}}return t},a=function(e){return e.textContent\|\|e.innerText},i=document.querySelectorAll("article"),r=document.querySelectorAll("pre.".concat(t,",div.").concat(t)),d=void 0===n?{}:n,c=0;c<r.length;c++){var l=r[c],s=document.createElement("div");s.className=t,s.style.visibility="hidden",s.style.position="absolute";var u="pre"===l.tagName.toLowerCase()?o(l):a(l);i[0].appendChild(s);e.parse(u).drawSVG(s,d),s.style.visibility="visible",s.style.position="static",l.parentNode.insertBefore(s,l),l.parentNode.removeChild(l)}};!function(e){document.addEventListener?document.addEventListener("DOMContentLoaded",e):document.attachEvent("onreadystatechange",function(){"interactive"===document.readyState&&e()})}(function(){"undefined"!=typeof flowchart&&e(flowchart,"uml-flowchart"),"undefined"!=typeof Diagram&&e(Diagram,"uml-sequence-diagram",{theme:"simple"})})}();