1. Общая характеристика архитектуры
«IDV CMS» является веб-приложением с серверной частью: системой управления содержимым сайтов. Программа выполняется на сервере заказчика под управлением php-fpm, принимает запросы от веб-сервера nginx, хранит данные в PostgreSQL и в каталоге файлов на диске. Пользователи работают с сайтом и панелью управления в обычном браузере.
Архитектура модульная: небольшое ядро (каталог src) и подключаемые модули (каталог modules). Каждый модуль описывает себя (метод info()) и при загрузке регистрирует свои права, пункты меню, маршруты, страницы настроек, задания планировщика, команды командной строки и блоки страниц. Обязательны два модуля: система и содержимое сайта; остальные администратор может выключить в панели управления.
2. Основные программные компоненты
| Компонент | Назначение |
|---|---|
| public/index.php | единственная точка входа веб-сервера; запускает ядро |
| Ядро (src, пространство имён Cms) | загрузка настроек и модулей, маршрутизация запросов, работа с базой данных (PDO, PostgreSQL), сессии, проверка прав, журнал действий, настройки, отправка почты, обработка изображений, очистка HTML от редактора, шаблонизатор на PHP, многоязычность публичной части |
| Миграции (migrations, modules/*/migrations) | файлы SQL с изменениями структуры базы данных; применяются командой idv-cms migrate |
| Модуль «Система» | вход, пользователи и роли, настройки, журнал действий, библиотека файлов |
| Модуль «Содержимое сайта» | разделы, виды материалов, блоки страниц, версии, публикация, поиск, переадресация |
| Модули «Формы и обращения», «Личный кабинет посетителя» | формы, обращения, согласия, кабинет посетителя |
| Модули «Доступность», «Поисковая оптимизация», «Сервисы и согласие на cookie» | версия для слабовидящих, проверка доступности, sitemap и robots, микроразметка, подключаемые российские сервисы |
| Модули «Программный интерфейс», «Перенос содержимого», «Отраслевые наборы» | JSON-интерфейс, загрузка из CSV и WordPress, готовые структуры сайтов |
| Модули «Резервные копии», «Справка и руководства» | резервное копирование и восстановление; встроенная справка, руководства и программа испытаний |
| Проверка лицензии (src/License.php) | редакции «Старт», «Бизнес», «Корпорация»; разбор и проверка электронной подписи лицензионного ключа открытым ключом, хранящимся в программе, срок действия, привязка к сайту; включение и выключение возможностей платных редакций. Расширение PHP sodium нужно только для проверки ключа |
| Утилита командной строки (bin/idv-cms) | самопроверка, миграции, планировщик, пользователи, резервные копии, перенос содержимого |
| Установщик (installer) | первичная настройка сервера (idv-cms-setup), установка из архива (install.sh), шаблоны настроек nginx, php-fpm и планировщика |
| Тема сайта (templates, public/assets) | шаблоны страниц, стили и сценарии без сторонних библиотек и шрифтов |
3. Технологическая схема работы
Запрос посетителя или сотрудника поступает в nginx. Статические файлы (стили, сценарии, загруженные изображения) nginx отдаёт сам. Остальные запросы передаются php-fpm в файл public/index.php. Ядро загружает настройки установки и подключает модули, определяет маршрут и проверяет права сотрудника (адреса /admin доступны только вошедшему сотруднику, каждый запрос изменения данных в панели управления проверяется токеном формы). Обработчик читает и записывает данные в PostgreSQL, формирует страницу из шаблона и возвращает ответ. Посетителю публичной части куки и сессия не ставятся.
Задания планировщика (публикация и снятие с публикации по времени, очистка корзины, повторная отправка писем, резервная копия по расписанию, удаление обращений с истёкшим сроком хранения и другие) выполняет команда idv-cms cron, которую cron или таймер systemd запускают каждые пять минут от имени пользователя веб-сервера.
4. Хранение данных
| Что | Где |
|---|---|
| Текст лицензионного ключа (если установлен) | настройки сайта в базе данных PostgreSQL |
| Настройки установки (подключение к базе данных, секретный ключ) | файл /etc/idv-cms/config.php (доступ только владельцу и группе веб-сервера) |
| Содержимое сайта, пользователи, обращения, настройки, журнал действий, очередь писем | база данных PostgreSQL; таблицы создаются миграциями |
| Загруженные файлы и уменьшенные копии изображений | каталог /var/lib/idv-cms/uploads |
| Закрытые файлы (вложения обращений) | каталог данных, вне корня сайта, выдаются только через программу |
| Резервные копии, сессии, журналы, письма для проверки | каталоги backups, sessions, log, mail внутри /var/lib/idv-cms |
Журнал действий хранится в таблице, которая принимает только добавление записей: триггеры базы данных отклоняют изменение, удаление и очистку записей. Пароли сотрудников хранятся в виде необратимого хеша.
5. Инфраструктурные программные средства
| Параметр | Описание для IDV CMS |
|---|---|
| Средства хранения данных | PostgreSQL версии 13 и новее; файловый каталог данных на сервере |
| Облачное хранилище | Не используется. Все данные хранятся на сервере заказчика. |
| Веб-сервер | nginx; допускается другой веб-сервер с поддержкой FastCGI |
| Сервер приложений | php-fpm (PHP 8.2 и новее) |
| Балансировщик и прокси-сервер | Не требуются; программа работает и за обратным прокси (режим настраивается в файле настроек). |
| Кэш и очереди | Не используются как отдельные службы; очередь писем и состояние заданий хранятся в базе данных. |
| Реализация | PHP, SQL, JavaScript без сборки и без сторонних библиотек |
| Контейнеризация | Не требуется; поставка пакетами для установки на сервер. |
| Расширение PHP sodium | Нужно для проверки подписи лицензионного ключа редакций «Бизнес» и «Корпорация»; редакция «Старт» работает без ключа. |
6. Внешние обращения
Программа не обращается к внешним адресам: нет автообновления и телеметрии. Редакция «Старт» работает без ключа. Редакции «Бизнес» и «Корпорация» включаются лицензионным ключом. Ключи формируются правообладателем на территории Российской Федерации, проверяются программой локально электронной подписью, без обращения к сети; программа не передаёт сведений о ключе. Единственное исходящее соединение, которое устанавливает сервер, это отправка почты через SMTP-сервер, указанный администратором (или передача письма почтовой службе этого же сервера). Российские сервисы (Яндекс Метрика, Яндекс Карты, ВКонтакте, виджет ПОС Госуслуг) подключаются только в браузере посетителя и только если администратор включил их в настройках. Наличие обращений к внешним адресам проверяют скрипт сборки и команда idv-cms check.
7. Развёртывание и использование
Программа распространяется в виде пакетов idv-cms_1.0.0_all.deb и idv-cms-1.0.0-1.noarch.rpm и архива idv-cms-1.0.0.tar.gz. Пакет копирует программу в каталог /opt/idv-cms (только чтение), команда idv-cms-setup создаёт базу данных, администратора, настройки nginx и php-fpm и задание планировщика. Окружение (PHP, PostgreSQL, nginx) берётся из репозитория операционной системы и в поставку не входит. Подробный порядок приведён в инструкции по установке.
8. Заключение
Техническая архитектура «IDV CMS» соответствует типу программного обеспечения «система управления содержимым»: серверная часть на PHP с базой данных PostgreSQL, модульное построение, отсутствие сторонних компонентов и внешних зависимостей при установке и работе.