Документация, содержащая описание технических средств хранения исходного текста и объектного кода программного обеспечения, а также технических средств компиляции исходного текста в объектный код программного обеспечения

Титульные данные

1. Назначение документа

Настоящий документ подготовлен в соответствии с п. 1.2 и п. 2.1.2.1 методических рекомендаций по работе с ФГИС «Реестры программ для ЭВМ и баз данных» и содержит описание:

• технических средств хранения исходного текста программного обеспечения Inventions;
• технических средств хранения объектного кода;
• технических средств компиляции (трансляции) исходного текста в объектный код;
• адреса нахождения указанных технических средств на территории Российской Федерации.

Документ одновременно выполняет функцию письма правообладателя с описанием места хранения исходных материалов разработки (программирование, конфигурирование, документирование) и средств сборки, как того требует п. 2.1.2.1 методических рекомендаций.

2. Общие сведения о программном обеспечении

2.1. Характер компиляции

Исходный текст ПО Inventions написан преимущественно на языке TypeScript. В отличие от программ, исходный текст которых исполняется напрямую (например, чистый JavaScript или PHP без этапа трансляции), для Inventions предусмотрен обязательный этап трансляции (компиляции) исходного текста в объектный код JavaScript с последующей упаковкой в Docker-образы.

Компиляция (трансляция) исходного кода выполняется на серверах непрерывной интеграции и сборки, расположенных на территории Российской Федерации (см. раздел 7).

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

3.1. Место и способ хранения

Исходные тексты хранятся на собственном или арендованном сервере системы контроля версий (GitLab). Сгенерированные артефакты (node_modules/, dist/, .next/, .env) в репозиторий не включаются (см. .gitignore).

3.2. Программное обеспечение серверов хранения исходного кода

3.3. Состав и форматы исходных текстов

3.4. Идентификация версий исходного текста

• Git-коммиты и теги;
• ветки разработки и релизные ветки по внутреннему регламенту ООО «ДИТЕКС»;
• контроль целостности — криптографические хеши коммитов Git.

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

Под объектным кодом понимаются исполняемые артефакты, полученные в результате трансляции исходного текста, а также готовые к эксплуатации Docker-образы.

4.1. Промежуточные артефакты сборки

Промежуточные артефакты создаются при сборке и не хранятся в Git.

4.2. Основное хранилище объектного кода поставки

Готовые Docker-образы публикуются в реестре контейнеров (переменная HUB):

Теги формируются в GitLab CI (.gitlab-ci.yml): CI_COMMIT_REF_NAME, latest.

4.3. Хранение на узле эксплуатации

При развёртывании (docker compose pull && docker compose up) объектный код хранится в локальном хранилище Docker на хосте заказчика или экспертной организации.

5. Технические средства компиляции исходного текста в объектный код

5.1. Перечень программных средств компиляции (трансляции)

5.2. Последовательность компиляции

1. pnpm install — установка зависимостей по pnpm-lock.yaml.
2. pnpm turbo build — сборка shared-пакетов, затем backend и frontend.
3. Backend: nest build → каталог dist/.
4. Frontend: next build → каталог .next/ (режим standalone).
5. Dockerfile.backend / Dockerfile.frontend — упаковка объектного кода в образы.
6. GitLab CI (Kaniko) — публикация образов в реестр HUB.

Подробные команды локальной сборки — в разделе 8.

5.3. Лицензионные ключи средств разработки и сборки

Для компиляции используются свободно распространяемые инструменты (Node.js, TypeScript, pnpm, Turbo, NestJS CLI, Next.js, Docker) на основании открытых лицензий (MIT, Apache 2.0 и аналогичные). Отдельные коммерческие лицензионные ключи для этапа компиляции не требуются.

Хранение лицензионных ключей разработческих сред (при использовании коммерческих IDE) осуществляется в контуре ООО «ДИТЕКС» и к исходному коду в репозитории не относится.

6. Схема потоков хранения и компиляции

7. Адрес нахождения технических средств (территория Российской Федерации)

Примечание. При использовании облачной инфраструктуры серверы должны быть расположены на территории Российской Федерации (п. 2.1.2.1 методических рекомендаций). К настоящему документу прилагается подтверждающий документ по выбору правообладателя (договор аренды, лицензионное соглашение с адресом размещения серверов и т.п.).

8. Локальная сборка (воспроизведение процесса компиляции)

pnpm install
pnpm build
pnpm turbo build --filter=inventions-backend
pnpm turbo build --filter=web
docker build -f Dockerfile.backend -t inventions-backend:local .
docker build -f Dockerfile.frontend -t inventions-frontend:local .

9. Соответствие составу материалов для экспертизы

Документ подготовлен ООО «ДИТЕКС» по состоянию монорепозитория Inventions. Адреса и реквизиты подтверждающих документов в разделе 7 заполняются перед подачей заявления в реестр.