Приложение 1. Книга 5. Правила нумерации версий программного обеспечения

Приложение 1
к Регламенту обновления
автоматизированных
информационных систем
Федеральной налоговой службы,
утвержденному
28 июля 2017 г.

Выполнение работ, оказание услуг по разработке проектных решений, вводу в действие и сопровождению подсистем АИС "Налог-3" на объектах территориальных органов ФНС России для совершенствования налогового администрирования

Государственный контракт от 13 сентября 2010 г. N 5-6-02/113

п.п. 4.2.1.6.1.1. Разработка стандартов по ведению разработки АИС "Налог-3"

Книга 5.
Правила нумерации версий программного обеспечения

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

Документ предназначен для описания правил нумерации версий программных компонентов, применяемый при разработке АИС Налог 3.

2. Термины и сокращения

ЕХИК	Единое хранилище исходных кодов, используемое для хранения, сборки и валидации исходных кодов всех подсистем АИС Налог 3 и всего продукта в целом.
Задача	Часть подсистемы, разработка которой осуществляется самостоятельно. По своей сути задача может являться подсистемой, но в связи с крупным делением АИС Налог 3 входит в одну из подсистем. (Пример: задача "Обмен с УФК" входящая в состав подсистемы "ЦВЛС").
Контрактная часть задачи/подсистемы	Часть задачи/подсистемы, содержащая определения контрактов, используемых внешними подсистемами для взаимодействия с данной задачей/подсистемой.
Подсистема	Часть АИС Налог 3, выделенная при проектировании и описанная в техническом задании. Одной из особенностей подсистем является то, что они разрабатываются различными группами разработчиков.
Продукт	Совокупность разрабатываемых в рамках проекта модернизации архитектуры ФНС России прикладных и сервисных подсистем. Продукт характеризуется набором готовых программных компонентов (клиентского и серверного ПО), баз данных, готовых к установке на контур эксплуатации.
Реализационная часть задачи/подсистемы	Часть задачи/подсистемы, содержащая реализацию логики задачи/подсистемы, в том числе реализацию контрактов, определенных в контрактной части.
Релиз подсистемы	Понятие, определяющее зафиксированный набор ключевых требований к реализации подсистемы. К таким ключевым требованиям могут относиться: - Требование к использованию определенных версий инструментальных средств, к которым относятся среды и библиотеки разработки сторонних производителей, - Требование к использованию определенных версий (а точнее релизов) инфраструктурных подсистем, таких как КПИ, СИИВ и т.п. - Требование к реализации или использованию определенных версий контрактов из состава релиза служебной подсистемы "Портфель сервисов", - Требование к выполнению доработки (реализации определенного функционала) подсистемы, как правило, меняющей или добавляющей новую ключевую логику в работу подсистемы, а также меняющей совместимость по данным с другими подсистемами.
Релиз продукта	Понятие, определяющее зафиксированный набор релизов всех прикладных и служебных подсистем, включенных в релиз продукта.

3. Правила нумерации версий

Введение единообразной практики нумерации версий в рамках проекта по модернизации информационной системы ФНС России (АИС Налог 3) позволит:

- Организовать общие подходы к изменению номеров версий по мере развития системы

- Контролировать состав дистрибутива конечного продукта

- Однозначно определять исходный код компонента по версии файла компонента

- Осуществлять проверку совместимости компонентов на основе номеров версий

- Выявлять ошибки развертывания продукта на ранней стадии и организовать верификацию рабочего окружения пользователей и служб

Для ведения данной практики предлагается использование следующих уровней нумерации версий:

- Номер версии релиза продукта (PRV). Идентифицирует версию релиза продукта как зафиксированный набор версий релизов всех подсистем, включенных в релиз продукта. В рамках одной версии релиза продукта может быть выпущено со временем несколько версий продукта (подробнее о версии продукта см. ниже).

Версия релиза продукта также используется для нумерации ветки командного проекта для сборки всего продукта в рамках общего хранилища исходных кодов системы (подробнее об этом см. в документе "Инфраструктура контроля качества").

- Номер версии продукта (PV). Идентифицирует версию продукта как определенный набор версий прикладных подсистем, включенных в версию продукта (в рамках своего релиза продукта).

- Номер версии релиза подсистемы (SSRV). Идентифицирует версию релиза подсистемы (определение релиза подсистемы см. разделе Определения). В рамках одной версии релиза подсистемы может быть выпущено со временем несколько версий подсистемы.

Версия релиза подсистемы также используется для нумерации веток командного проекта подсистемы в рамках общего хранилища исходных кодов системы (подробнее об этом см. в документе "Инфраструктура контроля качества").

- Номер версии подсистемы (SSV). Идентифицирует версию подсистемы, как набора всех компонентов подсистемы, передаваемых для сборки и выпуска версии продукта.

Примечание: взаимосвязи между PRV, PV, SSRV и SSV проиллюстрированы на рисунке ниже:

- Номер версии контракта (сборки контракта) подсистемы (CAV). Идентифицирует версию контракта из состава контрактной части подсистемы.

- Номер версии файла сборки контракта подсистемы (CFV). Идентифицирует версию файла сборки контракта из состава контрактной части подсистемы.

- Номер версии сборки реализационной части (RAV). Идентифицирует версию сборки из состава реализационной части подсистемы.

- Номер версии файла сборки реализационной части (RFV). Идентифицирует версию файла сборки из состава реализационной части подсистемы.

Примечание: правила ведения не перечисленных выше видов версий не регламентируются и определяются потребностями разработчика.

Номера всех версий кроме версий релизов формируются по следующему шаблону: [major].[minor].[build].[revision]

Номера версий релизов формируются по следующему шаблону: [major].[minor]

Ниже приведена таблица, в которой перечислены шаблоны различных видов версий, определяющие правила их формирования.

Наименование версии	Шаблон версии				Кем, когда и где определяется, где используется
	major	minor	build	revision
PRV (версия релиза продукта)	= последним 2 цифрам года создания релиза Диапазон значений (10..ХХ)	= порядковому номеру версии в году Диапазон значений (1..ХХ) Сбрасывается в 1 при смене PRV[major]	-	-	Определяется разработчиком, ответственным за создание релиза продукта (включающем разработку ПО, для сборки продукта). Новая версия релиза продукта создаётся: - при изменении набора версий релизов подсистем, включаемых в состав релиза продукта. Новый номер версии релиза продукта регистрируется в реестре версий на портале ЕРП вместе с соответствующим описанием к нему. Используется: - в рамках ЕХИК для именования ветки исходных кодов, соответствующей версии релиза продукта, - как составная часть версии продукта (PV)
PV (версия продукта)	= 3 (из аббревиатуры АИС Налог 3)	= PRV[major]	= PRV[minor]	= номеру билда продукта, автоматически формируемому при сборке. Диапазон значений (1..ХХ)	[major].[minor].[build]-часть формируется разработчиком, ответственным за создание релиза продукта, при создании релиза продукта. [revision]-часть формируется автоматически при сборке продукта в рамках соответствующего релиза продукта путём инкрементации значения PRV[revision] предыдущего билда. При сборке также автоматически формируется сводка о составе и версиях подсистем, включенных в состав версии продукта. Номер официально выпускаемой версии продукта регистрируется в реестре версий на портале ЕРП вместе с соответствующим описанием к нему. Используется: - в сопроводительной документации к версии как официальная версия продукта АИС Налог 3
SSRV (версия релиза подсистемы)	= последним 2 цифрам года создания релиза Диапазон значений (10..ХХ)	= порядковому номеру версии в году Диапазон значений (1..ХХ) Сбрасывается в 1 при смене SSRV[major]	-	-	Определяется разработчиком, ответственным за создание релиза подсистемы. Новая версия релиза подсистемы создаётся: - при изменении хотя бы одного требования из набора ключевых требований, определяющих предыдущую версию релиза подсистемы, - при необходимости формирования нового релиза в соответствии с планом (внешним или внутренним) выпуска релизов подсистемы. Новый номер версии релиза продукта регистрируется в реестре версий на портале ЕРП вместе с соответствующим описанием к нему. Используется: - в рамках ЕХИК для именования ветки исходных кодов, соответствующей версии релиза подсистемы, - как со