complexqa_frontend_core 1.15.2 → 1.16.2

package/publish/types/core/1_familyContext.js

@@ -0,0 +1,144 @@
+import { familyGeneralElement } from "./0_familyGeneralElement.js";
+
+
+/**
+ * Семейство справочников осей окружения (context catalogs).
+ *
+ * Строки справочника: system (seed сервиса) и project (свои записи команды).
+ * Стабильный код автоматизации: context_key. Отображение: context_name.
+ *
+ * @see typeExecutionContext — снимок FK на момент бага / прогона / автотеста
+ *
+ * @version			v.0.1 (03/06/2026)
+ */
+export class familyContext extends familyGeneralElement
+{
+	context_key;
+	context_name;
+	context_scope;
+	project_id;
+	parent_context_id;
+	sort_order;
+	is_active;
+	meta;
+	created_at;
+	updated_at;
+
+	/**
+	 * Ось справочника (browser, os, …) — переопределяется в наследниках.
+	 *
+	 * @type {string|false}
+	 */
+	context_axis = false;
+
+	available_enum_values = familyContext.get_base_available_enum_values();
+
+	enum_value_translate_matrix = familyContext.get_base_enum_value_translate_matrix();
+
+	attribute_name_translate_matrix = familyContext.get_catalog_attribute_name_translate_matrix();
+
+
+	/**
+	 * @returns {object}
+	 */
+	static get_base_available_enum_values()
+	{
+		return {
+			context_scope: [ 'SYSTEM', 'PROJECT' ],
+		};
+	}
+
+
+	/**
+	 * @returns {object}
+	 */
+	static get_base_enum_value_translate_matrix()
+	{
+		return {
+			context_scope: {
+				en: {
+					SYSTEM : 'System',
+					PROJECT: 'Project',
+				},
+				ru: {
+					SYSTEM : 'Системный',
+					PROJECT: 'Проекта',
+				},
+			},
+		};
+	}
+
+
+	/**
+	 * @returns {string|false}
+	 */
+	get_context_axis()
+	{
+		return this.context_axis || false;
+	}
+
+
+	/**
+	 * Общие поля записи справочника (добавляются в structure_scheme наследников).
+	 *
+	 * @returns {object}
+	 */
+	static get_catalog_base_structure_scheme()
+	{
+		return {
+			context_key       : 'string | max:128 | require',
+			context_name      : 'string | max:255 | require',
+			context_scope     : 'string | enum | require',
+			project_id        : 'integer | optional',
+			parent_context_id : 'integer | optional',
+			sort_order        : 'integer | optional',
+			is_active         : 'boolean | optional',
+			meta              : 'object | optional',
+			created_at        : 'timestamp | require',
+			updated_at        : 'timestamp | optional',
+		};
+	}
+
+
+	/**
+	 * @returns {{ en: object, ru: object }}
+	 */
+	static get_catalog_attribute_name_translate_matrix()
+	{
+		return {
+			en: {
+				context_key       : 'Key',
+				context_name      : 'Name',
+				context_scope     : 'Scope',
+				project_id        : 'Project',
+				parent_context_id : 'Parent',
+				sort_order        : 'Sort order',
+				is_active         : 'Active',
+				meta              : 'Meta',
+				created_at        : 'Created at',
+				updated_at        : 'Updated at',
+			},
+			ru: {
+				context_key       : 'Ключ',
+				context_name      : 'Название',
+				context_scope     : 'Область',
+				project_id        : 'Проект',
+				parent_context_id : 'Родитель',
+				sort_order        : 'Порядок',
+				is_active         : 'Активен',
+				meta              : 'Мета',
+				created_at        : 'Создано',
+				updated_at        : 'Обновлено',
+			},
+		};
+	}
+
+
+	/**
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+}

package/publish/types/core/1_familyTestAutomation.js

@@ -0,0 +1,20 @@
+import { familyGeneralElement } from "./0_familyGeneralElement.js";
+
+
+/**
+ * Семейство типов, относящееся к модулю автоматического тестирования
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class familyTestAutomation extends familyGeneralElement
+{
+
+	/**
+	 *
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+}

package/publish/types/core/1_familyTestDocumentation.js

@@ -0,0 +1,21 @@
+import { familyGeneralElement } from "./0_familyGeneralElement.js";
+
+
+/**
+ * Семейство типов, относящееся к модулю тестовой документации
+ *
+ * @version			v.0.1 (29/11/2025)
+ */
+export class familyTestDocumentation extends familyGeneralElement
+{
+
+	/**
+	 *
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+
+}

package/publish/types/family_context/0_familyContext.js

@@ -0,0 +1,144 @@
+import { familyGeneralElement } from "../family_elements/0_familyGeneralElement.js";
+
+
+/**
+ * Семейство справочников осей окружения (context catalogs).
+ *
+ * Строки справочника: system (seed сервиса) и project (свои записи команды).
+ * Стабильный код автоматизации: context_key. Отображение: context_name.
+ *
+ * @see typeExecutionContext — снимок FK на момент бага / прогона / автотеста
+ *
+ * @version			v.0.1 (03/06/2026)
+ */
+export class familyContext extends familyGeneralElement
+{
+	context_key;
+	context_name;
+	context_scope;
+	project_id;
+	parent_context_id;
+	sort_order;
+	is_active;
+	meta;
+	created_at;
+	updated_at;
+
+	/**
+	 * Ось справочника (browser, os, …) — переопределяется в наследниках.
+	 *
+	 * @type {string|false}
+	 */
+	context_axis = false;
+
+	available_enum_values = familyContext.get_base_available_enum_values();
+
+	enum_value_translate_matrix = familyContext.get_base_enum_value_translate_matrix();
+
+	attribute_name_translate_matrix = familyContext.get_catalog_attribute_name_translate_matrix();
+
+
+	/**
+	 * @returns {object}
+	 */
+	static get_base_available_enum_values()
+	{
+		return {
+			context_scope: [ 'SYSTEM', 'PROJECT' ],
+		};
+	}
+
+
+	/**
+	 * @returns {object}
+	 */
+	static get_base_enum_value_translate_matrix()
+	{
+		return {
+			context_scope: {
+				en: {
+					SYSTEM : 'System',
+					PROJECT: 'Project',
+				},
+				ru: {
+					SYSTEM : 'Системный',
+					PROJECT: 'Проекта',
+				},
+			},
+		};
+	}
+
+
+	/**
+	 * @returns {string|false}
+	 */
+	get_context_axis()
+	{
+		return this.context_axis || false;
+	}
+
+
+	/**
+	 * Общие поля записи справочника (добавляются в structure_scheme наследников).
+	 *
+	 * @returns {object}
+	 */
+	static get_catalog_base_structure_scheme()
+	{
+		return {
+			context_key       : 'string | max:128 | require',
+			context_name      : 'string | max:255 | require',
+			context_scope     : 'string | enum | require',
+			project_id        : 'integer | optional',
+			parent_context_id : 'integer | optional',
+			sort_order        : 'integer | optional',
+			is_active         : 'boolean | optional',
+			meta              : 'object | optional',
+			created_at        : 'timestamp | require',
+			updated_at        : 'timestamp | optional',
+		};
+	}
+
+
+	/**
+	 * @returns {{ en: object, ru: object }}
+	 */
+	static get_catalog_attribute_name_translate_matrix()
+	{
+		return {
+			en: {
+				context_key       : 'Key',
+				context_name      : 'Name',
+				context_scope     : 'Scope',
+				project_id        : 'Project',
+				parent_context_id : 'Parent',
+				sort_order        : 'Sort order',
+				is_active         : 'Active',
+				meta              : 'Meta',
+				created_at        : 'Created at',
+				updated_at        : 'Updated at',
+			},
+			ru: {
+				context_key       : 'Ключ',
+				context_name      : 'Название',
+				context_scope     : 'Область',
+				project_id        : 'Проект',
+				parent_context_id : 'Родитель',
+				sort_order        : 'Порядок',
+				is_active         : 'Активен',
+				meta              : 'Мета',
+				created_at        : 'Создано',
+				updated_at        : 'Обновлено',
+			},
+		};
+	}
+
+
+	/**
+	 * @param {any} data
+	 */
+	constructor(data = false)
+	{
+		super();
+	}
+}

package/publish/types/family_context/typeBrowserContext.js

@@ -0,0 +1,59 @@
+import { familyContext } from "../core/0_familyContext.js";
+import { is_object } from "../../utils/utils.js";
+
+
+/**
+ * Справочник браузеров (Chromium-family, Firefox, WebKit, …).
+ *
+ * Ориентиры: Playwright browserName, Selenium capabilities, TestRail/Jira custom «Browser».
+ * meta: engine, playwright_browser, min_version (под seed и runner).
+ *
+ * @version			v.0.1 (03/06/2026)
+ */
+export class typeBrowserContext extends familyContext
+{
+	browser_context_id;
+	browser_vendor;
+
+	context_axis = 'browser';
+
+	primary_key = 'browser_context_id';
+	api_key     = 'browser_context';
+
+	structure_scheme = {
+		browser_context_id: 'integer | require',
+		browser_vendor    : 'string | max:64 | optional',
+		...familyContext.get_catalog_base_structure_scheme(),
+	};
+
+	attribute_name_translate_matrix = (() =>
+	{
+		let base = familyContext.get_catalog_attribute_name_translate_matrix();
+		return {
+			en: { ...base.en, browser_context_id: 'ID', browser_vendor: 'Vendor' },
+			ru: { ...base.ru, browser_context_id: 'ID', browser_vendor: 'Вендор' },
+		};
+	})();
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_context/typeDeploymentTargetContext.js

@@ -0,0 +1,98 @@
+import { familyContext } from "../core/0_familyContext.js";
+import { is_object } from "../../utils/utils.js";
+
+
+/**
+ * Справочник цели развёртывания / среды (Jira Environment, staging vs prod).
+ *
+ * Не путать с URL: host/base_url задаётся в typeExecutionContext.
+ * deployment_tier — укрупнённый tier для отчётов и политик.
+ *
+ * @version			v.0.1 (03/06/2026)
+ */
+export class typeDeploymentTargetContext extends familyContext
+{
+	deployment_target_context_id;
+	deployment_tier;
+
+	context_axis = 'deployment_target';
+
+	primary_key = 'deployment_target_context_id';
+	api_key     = 'deployment_target_context';
+
+	structure_scheme = {
+		deployment_target_context_id: 'integer | require',
+		deployment_tier               : 'string | enum | optional',
+		...familyContext.get_catalog_base_structure_scheme(),
+	};
+
+	available_enum_values = {
+		...familyContext.get_base_available_enum_values(),
+		deployment_tier: [ 'LOCAL', 'DEVELOPMENT', 'QA', 'STAGING', 'UAT', 'PRODUCTION', 'DR', 'OTHER' ],
+	};
+
+	enum_value_translate_matrix = {
+		...familyContext.get_base_enum_value_translate_matrix(),
+		deployment_tier: {
+			en: {
+				LOCAL      : 'Local',
+				DEVELOPMENT: 'Development',
+				QA         : 'QA',
+				STAGING    : 'Staging',
+				UAT        : 'UAT',
+				PRODUCTION : 'Production',
+				DR         : 'Disaster recovery',
+				OTHER      : 'Other',
+			},
+			ru: {
+				LOCAL      : 'Локальная',
+				DEVELOPMENT: 'Разработка',
+				QA         : 'QA',
+				STAGING    : 'Staging',
+				UAT        : 'UAT',
+				PRODUCTION : 'Продакшен',
+				DR         : 'DR',
+				OTHER      : 'Другое',
+			},
+		},
+	};
+
+	attribute_name_translate_matrix = (() =>
+	{
+		let base = familyContext.get_catalog_attribute_name_translate_matrix();
+		return {
+			en: {
+				...base.en,
+				deployment_target_context_id: 'ID',
+				deployment_tier               : 'Tier',
+			},
+			ru: {
+				...base.ru,
+				deployment_target_context_id: 'ID',
+				deployment_tier               : 'Уровень',
+			},
+		};
+	})();
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_context/typeDeviceContext.js

@@ -0,0 +1,86 @@
+import { familyContext } from "../core/0_familyContext.js";
+import { is_object } from "../../utils/utils.js";
+
+
+/**
+ * Справочник класса устройства / form-factor.
+ *
+ * Ориентиры: W3C media features, TestRail device, mobile vs desktop testing.
+ * Отдельно от OS и viewport: «phone» vs «1920×1080».
+ *
+ * @version			v.0.1 (03/06/2026)
+ */
+export class typeDeviceContext extends familyContext
+{
+	device_context_id;
+	device_class;
+
+	context_axis = 'device';
+
+	primary_key = 'device_context_id';
+	api_key     = 'device_context';
+
+	structure_scheme = {
+		device_context_id: 'integer | require',
+		device_class     : 'string | enum | require',
+		...familyContext.get_catalog_base_structure_scheme(),
+	};
+
+	available_enum_values = {
+		...familyContext.get_base_available_enum_values(),
+		device_class: [ 'DESKTOP', 'MOBILE', 'TABLET', 'TV', 'WATCH', 'OTHER' ],
+	};
+
+	enum_value_translate_matrix = {
+		...familyContext.get_base_enum_value_translate_matrix(),
+		device_class: {
+			en: {
+				DESKTOP: 'Desktop',
+				MOBILE : 'Mobile',
+				TABLET : 'Tablet',
+				TV     : 'TV',
+				WATCH  : 'Watch',
+				OTHER  : 'Other',
+			},
+			ru: {
+				DESKTOP: 'Настольный',
+				MOBILE : 'Мобильный',
+				TABLET : 'Планшет',
+				TV     : 'ТВ',
+				WATCH  : 'Часы',
+				OTHER  : 'Другое',
+			},
+		},
+	};
+
+	attribute_name_translate_matrix = (() =>
+	{
+		let base = familyContext.get_catalog_attribute_name_translate_matrix();
+		return {
+			en: { ...base.en, device_context_id: 'ID', device_class: 'Device class' },
+			ru: { ...base.ru, device_context_id: 'ID', device_class: 'Класс устройства' },
+		};
+	})();
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}