KNK Platform v1.40.0Документация по развёртыванию и эксплуатации
Пошаговые инструкции для основной платформы, CRM, склада и закупок, Module Hub, Telegram Relay и публичного демо.
01 · Быстрый стартПорядок развёртывания
1DNS и HTTPS
Создайте A-записи для основного домена и поддоменов. Выпустите SSL-сертификаты.
2Основная платформа
Распакуйте файлы в корень домена, назначьте Document Root на public_html, создайте MySQL-БД.
3Установщик
Откройте /install.php, задайте бренд, БД, администратора, правила и Module Hub.
4Фоновые задания
Добавьте cron для очередей, MAX worker, напоминаний, резервных копий и сброса демо.
demo.knkplatform.ru → публичная демо-среда
app.knkplatform.ru → рабочая установка владельца
hub.knkplatform.ru → модули и лицензии
relay.knkplatform.ru → внешний Telegram Relay
02 · АрхитектураКак связаны сервисы
KNK Platform Coreпользователи · клиенты · права · события
LoyaltyCRMOrdersAnalyticsTelegram / MAXModules
Ядро хранит общие сущности. Модули добавляют собственные таблицы, страницы и маршруты. Module Hub выдаёт каталог, ZIP-пакеты и подписанные лицензии.
03 · Telegram и MAXПодключение каналов
Telegram
- создать бота через BotFather;
- добавить токен и webhook secret;
- использовать Direct или внешний Relay;
- при необходимости добавить бота администратором канала.
MAX
- создать корпоративного бота в кабинете партнёра;
- добавить токен, webhook и публичную ссылку;
- настроить watchdog и cron worker;
- для проверки канала добавить бота администратором.
04 · МодулиУстановка и лицензии
- Получить ZIP и лицензионный ключ.
- Открыть «Модули и лицензии» в админке.
- Загрузить ZIP и выполнить проверку манифеста.
- Вставить ключ, выпущенный для домена установки.
- Установить и включить модуль.
Закрытый RSA-ключ хранится только на hub.knkplatform.ru. В клиентские установки передаётся публичный ключ.
05 · Склад и закупкиУстановка и начало работы
Перед установкой
- получите ZIP-пакет
KNK_Inventory_Module_v1.0.1.zip; - для рабочей установки выпустите лицензию
inventory на домен клиента; - сделайте резервную копию базы данных;
- проверьте, что версия платформы не ниже 1.40.0.
После установки
- создайте склады или точки хранения;
- добавьте поставщиков и товарные категории;
- загрузите товары, артикулы и нормы запаса;
- проведите начальный приход или первую инвентаризацию.
Главный принцип: все изменения остатка проводятся документами — приходом, списанием, приёмкой закупки, перемещением, резервом или инвентаризацией. Благодаря этому сохраняется полная история движений.
Админка → Модули и лицензии
→ загрузить ZIP + лицензию
→ Склад и закупки → Склады
→ Поставщики → Товары → Остатки
06 · ДемоПубличная демонстрация
Демо устанавливается в отдельную БД. Пользователь demo@example.com работает в режиме просмотра. Сброс данных запускается отдельным cron.
10 4 * * * /usr/bin/php /path/demo.knkplatform.ru/public_html/cron/reset_demo.php
07 · БезопасностьОбязательные меры
Публичной должна быть только папка public_html.После установки удалите или переименуйте install.php.Храните Module Hub и закрытый ключ отдельно от клиентских архивов.Настройте резервные копии БД, uploads и конфигурации.Используйте разные БД и пароли для demo и app.Проверяйте журналы, очереди и статус сервисов.