KKNK PlatformDocs
KNK Platform v1.40.0

Документация по развёртыванию и эксплуатации

Пошаговые инструкции для основной платформы, CRM, склада и закупок, Module Hub, Telegram Relay и публичного демо.

Начать установкуНа сайт
01 · Быстрый старт

Порядок развёртывания

1

DNS и 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 · Модули

Установка и лицензии

  1. Получить ZIP и лицензионный ключ.
  2. Открыть «Модули и лицензии» в админке.
  3. Загрузить ZIP и выполнить проверку манифеста.
  4. Вставить ключ, выпущенный для домена установки.
  5. Установить и включить модуль.
Закрытый 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.
Проверяйте журналы, очереди и статус сервисов.