Описание технических средств программы «IDV CMS»

1. Общие сведения

Настоящий документ содержит описание технических средств хранения исходного текста и объектного кода программы для ЭВМ «IDV CMS», а также описание технических средств сборки исходного текста в распространяемые установочные пакеты.

Программа для ЭВМ «IDV CMS» представляет собой систему управления содержимым сайтов (CMS): веб-приложение с серверной частью на языке PHP и базой данных PostgreSQL. Сторонних библиотек в составе программы нет.

PHP является интерпретируемым языком, поэтому компиляции исходного текста в машинный код нет. Объектным кодом в понимании настоящего документа являются установочные пакеты и архив, формируемые скриптом сборки из исходного текста: они содержат тот же исходный текст в подготовленном для установки виде.

2. Технические средства хранения исходного текста

Исходный текст программы хранится в электронном виде в виде файлов PHP, SQL, JavaScript, CSS, шаблонов страниц, файлов конфигурации и сборки, документации и автоматических испытаний.

Основное хранение исходного текста осуществляется в Git-репозитории правообладателя на сервере gitlab.itdevlink.ru (https://gitlab.itdevlink.ru/Anvar/idv-cms) и в локальном рабочем каталоге разработки. Репозиторий содержит структуру проекта, исходные файлы, файл version.json со сведениями о версии, документацию, скрипты сборки и историю изменений. Сервер размещён в дата-центре на территории Российской Федерации; справка о расположении сервера приложена к заявлению.

Для резервного хранения исходного текста правообладатель использует архив проекта в формате tar.gz, размещаемый на технических средствах правообладателя.

3. Технические средства хранения объектного кода

Установочные пакеты формируются в каталоге dist: архив idv-cms-1.0.0.tar.gz, пакет для Astra Linux, Debian и Ubuntu idv-cms_1.0.0_all.deb, пакет для РЕД ОС и ALT idv-cms-1.0.0-1.noarch.rpm и файл контрольных сумм SHA256SUMS. Распространяемые файлы размещаются на странице правообладателя https://itdevlink.ru/products/idv-cms и хранятся на технических средствах правообладателя.

Идентификация распространяемой версии осуществляется по идентификатору программы idv-cms, номеру версии 1.0.0, файлу version.json в составе пакета, именам файлов пакетов и их контрольным суммам SHA-256.

4. Технические средства сборки

Сборка выполняется скриптом tools/build/build.sh на машине сборки правообладателя под управлением Linux. Скрипт использует стандартные средства: bash, GNU tar, gzip, dpkg-deb (для пакета deb), rpmbuild (для пакета rpm), sha256sum и php (для формирования перечня состава программы). Сеть при сборке не используется, загрузки зависимостей нет.

Сборка воспроизводима: одинаковые права, владельцы, порядок и время файлов, поэтому повторная сборка из того же исходного текста даёт те же контрольные суммы (режим --repro-check скрипта сборки проверяет это автоматически).

Лицензионные ключи редакций «Бизнес» и «Корпорация» формируются правообладателем на его технических средствах на территории Российской Федерации скриптом tools/license/issue.php (электронная подпись, закрытый ключ подписи хранится только у правообладателя). Скрипт и закрытый ключ в поставку не входят. Редакция «Старт» работает без ключа. Редакции «Бизнес» и «Корпорация» включаются лицензионным ключом. Ключи формируются правообладателем на территории Российской Федерации, проверяются программой локально электронной подписью, без обращения к сети; программа не передаёт сведений о ключе.

Перед выпуском запускается скрипт проверок tools/build/audit.sh: он убеждается, что в поставке нет упоминаний зарубежных ресурсов и сторонних компонентов, и проверяет состав архива и пакетов.

Для разработки и проверки установки правообладатель использует стенд на основе контейнера с Debian 12 на рабочей машине разработчика. Стенд является средством разработки, в поставку не входит и для работы программы не требуется.

5. Перечень технических средств

Техническое средство Назначение
Локальный рабочий каталог правообладателя Хранение исходного текста, конфигурационных файлов и документации проекта.
Git-репозиторий проекта (gitlab.itdevlink.ru) Контроль версий, хранение истории изменений и структуры исходного текста.
Архив проекта tar.gz Резервное хранение исходного текста и материалов проекта.
PHP и PostgreSQL на стенде разработки Выполнение автоматических испытаний и самопроверки.
tools/build/build.sh Формирование архива, пакетов deb и rpm и файла контрольных сумм.
tools/build/audit.sh Проверки поставки перед выпуском.
tools/license/issue.php и закрытый ключ подписи Формирование лицензионных ключей; хранятся у правообладателя, в поставку не входят.
dpkg-deb, rpmbuild, GNU tar, gzip, sha256sum Средства формирования пакетов и контрольных сумм.
Установочные пакеты (idv-cms-1.0.0.tar.gz, idv-cms_1.0.0_all.deb, idv-cms-1.0.0-1.noarch.rpm) Хранение и передача распространяемой версии.

6. Порядок воспроизведения сборки

  1. Получить исходный текст программы из Git-репозитория или резервного архива проекта.
  2. Подготовить машину сборки: Linux с bash, GNU tar, gzip, dpkg-deb, rpmbuild, sha256sum и php.
  3. Выполнить проверки: tools/build/audit.sh.
  4. Выполнить сборку: tools/build/build.sh (результат в каталоге dist).
  5. Сверить контрольные суммы в файле SHA256SUMS (sha256sum -c SHA256SUMS).
tools/build/audit.sh
tools/build/build.sh
cd dist && sha256sum -c SHA256SUMS

7. Заключение

Указанные технические средства обеспечивают хранение исходного текста программы, хранение установочных пакетов и воспроизводимую подготовку распространяемой версии программы для ЭВМ «IDV CMS».