complexqa_frontend_core 1.18.7 → 1.19.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "complexqa_frontend_core",
-  "version": "1.18.7",
+  "version": "1.19.2",
   "description": "core of web ",
   "type": "module",
   "exports": {

package/publish/api/bug_relation_api.js

@@ -0,0 +1,18 @@
+import { ApiAbstractElementClass } from './api_abstract_element_class.js';
+import { typeBugRelation } from '../types/family_relation/typeBugRelation.js';
+
+/**
+ * CRUD / Search для bug_relation.
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class BugRelationApi extends ApiAbstractElementClass
+{
+	module_prefix = 'bug_relation';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeBugRelation);
+	}
+}

package/publish/api/index.js

@@ -12,6 +12,7 @@ import { UserProfileApi } from "./user_profile_api.js";
 import { TaskApi } from "./task_api.js";
 import { TestAccountApi } from "./test_account_api.js";
 import { BugApi } from "./bug_api.js";
+import { BugRelationApi } from "./bug_relation_api.js";
 import { ContextBrowserApi } from "./context/context_browser_api.js";
 import { ContextDeploymentTargetApi } from "./context/context_deployment_target_api.js";
 import { ContextDevicesApi } from "./context/context_devices_api.js";
@@ -154,6 +155,7 @@ export class Api
 		this.task              = new TaskApi(payload);
 		this.test_account      = new TestAccountApi(payload);
 		this.bug               = new BugApi(payload);
+		this.bug_relation      = new BugRelationApi(payload);
 		this.execution_context = new ExecutionContextApi(payload);
 
 		this.reference = this.bootstrap_reference(payload)

package/publish/app_configuration/table/helpers/table_element_models.js

@@ -2,6 +2,7 @@ import { typeTestCase } from '../../../types/family_elements/typeTestCase.js';
 import { typeProject } from '../../../types/family_elements/typeProject.js';
 import { typeTestRun } from '../../../types/family_elements/typeTestRun.js';
 import { typeBug } from '../../../types/family_elements/typeBug.js';
+import { typeBugRelation } from '../../../types/family_relation/typeBugRelation.js';
 import { typeTestRunResult } from '../../../types/family_elements/typeTestRunResult.js';
 import { typeTestAccount } from '../../../types/family_elements/typeTestAccount.js';
 import { typeExecutionContext } from '../../../types/family_context/typeExecutionContext.js';
@@ -26,6 +27,7 @@ export const TABLE_ELEMENT_MODELS = {
 	project        : typeProject,
 	test_run       : typeTestRun,
 	bug            : typeBug,
+	bug_relation   : typeBugRelation,
 	test_run_result: typeTestRunResult,
 	test_account      : typeTestAccount,
 	execution_context : typeExecutionContext,

package/publish/app_configuration/table/sections/bug_relation.js

@@ -0,0 +1,57 @@
+import { typeBugRelation } from '../../../types/family_relation/typeBugRelation.js';
+import { typeTestCase } from '../../../types/family_elements/typeTestCase.js';
+import { UserService } from '../../../services/UserService.js';
+import { createColumn, createGoToColumn } from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+/**
+ * Колонки связанных тест-кейсов на странице bug/details.
+ * Поля совпадают с test_case × listing, данные — через hydrate element_id.
+ *
+ * @param {string} locale
+ * @returns {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]}
+ */
+function build_bug_relation_test_cases_columns(locale)
+{
+	const relation_model = new typeBugRelation();
+	const test_case_model = new typeTestCase();
+	const columns = [];
+
+	const tcColumn = (field, overrides = {}) => createColumn(relation_model, locale, `element_id.${ field }`, {
+		header_field        : field,
+		header_element_type : 'test_case',
+		is_editable         : false,
+		...overrides,
+	});
+
+	columns.push(tcColumn('test_case_id', { width: '60', default_sort: 'desc' }));
+	columns.push(tcColumn('test_case_title', {
+		width       : '480',
+		is_required : true,
+		is_title    : true,
+	}));
+	columns.push(tcColumn('assigned_to', { width: '220' }));
+	columns.push(tcColumn('test_case_time_to_execute', { width: '80', is_required: true }));
+	columns.push(tcColumn('test_case_complexity', { width: '80', is_required: true }));
+	columns.push(tcColumn('test_case_importance', { width: '80', is_required: true }));
+	columns.push(tcColumn('test_case_status', { width: '150', is_required: true }));
+	columns.push(createGoToColumn(test_case_model, locale, { field: 'element_id' }));
+
+	return columns;
+}
+
+
+/**
+ * Секции `bug_relation`: `test_cases`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
+export function bootstrap_bug_relation(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'bug_relation', 'test_cases', build_bug_relation_test_cases_columns(locale), {
+		for: createListingFor([ 'bug_id', 'relation_type' ], { add: [ 'elements' ] }),
+	});
+}

package/publish/app_configuration/table/table_configuration.js

@@ -1,5 +1,6 @@
 import { abstractAppConfiguration } from '../abstract_app_configuration.js';
 import { bootstrap_bug } from './sections/bug.js';
+import { bootstrap_bug_relation } from './sections/bug_relation.js';
 import { bootstrap_test_case } from './sections/test_case.js';
 import { bootstrap_test_case_step } from './sections/test_case_step.js';
 import { bootstrap_test_run } from './sections/test_run.js';
@@ -106,6 +107,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		}
 
 		bootstrap_bug(this.config);
+		bootstrap_bug_relation(this.config);
 		bootstrap_test_case(this.config);
 		bootstrap_test_case_step(this.config);
 		bootstrap_test_run(this.config);

package/publish/index.js

@@ -16,6 +16,9 @@ export { typeTestRunResult } from './types/family_elements/typeTestRunResult.js'
 export { typeTestAccount } from './types/family_elements/typeTestAccount.js'
 export {typeBug} from './types/family_elements/typeBug.js';
 
+export { familyRelation } from './types/core/1_familyRelation.js';
+export { typeBugRelation } from './types/family_relation/typeBugRelation.js';
+
 export { familyContext } from './types/core/1_familyContext.js';
 export { typeBrowserContext } from './types/family_context/typeBrowserContext.js';
 export { typeOsContext } from './types/family_context/typeOsContext.js';

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

@@ -0,0 +1,83 @@
+import { familyGeneralElement } from './0_familyGeneralElement.js';
+
+/**
+ * Базовое семейство junction-типов (связи N-к-ко-многим между main elements).
+ *
+ * Каждый наследник описывает свой домен (bug↔TMS, bug↔context, …),
+ * без единого god-type для всех связей.
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class familyRelation extends familyGeneralElement
+{
+	/**
+	 * FK на «главный» элемент связи (у typeBugRelation — bug_id).
+	 *
+	 * @type {string|false}
+	 */
+	source_key = false;
+
+	/**
+	 * Polymorphic target id (обычно element_id).
+	 *
+	 * @type {string}
+	 */
+	target_key = 'element_id';
+
+	/**
+	 * Enum-поле типа цели (relation_type, …).
+	 *
+	 * @type {string}
+	 */
+	relation_type_key = 'relation_type';
+
+
+	constructor(data = false)
+	{
+		super();
+	}
+
+
+	/**
+	 * @returns {string[]}
+	 */
+	static get_relation_type_values()
+	{
+		return [];
+	}
+
+
+	/**
+	 * @returns {Object<string, { type_token: string, primary_key: string, api_key: string }>}
+	 */
+	static get_relation_target_map()
+	{
+		return {};
+	}
+
+
+	/**
+	 * @param {string} relation_type
+	 * @returns {object|false}
+	 */
+	static resolve_relation_target(relation_type)
+	{
+		const map = this.get_relation_target_map();
+
+		return map?.[ relation_type ] || false;
+	}
+
+
+	get_element_name()
+	{
+		const relation_type = this?.[ this.relation_type_key ];
+		const element_id    = this?.[ this.target_key ];
+
+		if (relation_type && element_id)
+		{
+			return `${ relation_type }:${ element_id }`;
+		}
+
+		return String(this?.[ this.get_primary_key() ] ?? '');
+	}
+}

package/publish/types/family_relation/typeBugRelation.js

@@ -0,0 +1,122 @@
+import { is_object } from '../../utils/utils.js';
+import _ from 'underscore';
+import { familyRelation } from '../core/1_familyRelation.js';
+
+/**
+ * Связь бага с сущностью TMS: test case, test run, test run result.
+ *
+ * @see docs/Relations/bug-relation-docs.MD
+ *
+ * @version			v.0.1 (13/06/2026)
+ */
+export class typeBugRelation extends familyRelation
+{
+	bug_relation_id;
+	bug_id;
+	relation_type;
+	element_id;
+
+	source_key        = 'bug_id';
+	target_key        = 'element_id';
+	relation_type_key = 'relation_type';
+
+	primary_key = 'bug_relation_id';
+	api_key     = 'bug_relation';
+
+	static relation_target_map = {
+		test_case_id      : { type_token: 'typeTestCase', primary_key: 'test_case_id', api_key: 'test_case' },
+		test_run_id       : { type_token: 'typeTestRun', primary_key: 'test_run_id', api_key: 'test_run' },
+		test_run_result_id: { type_token: 'typeTestRunResult', primary_key: 'test_run_result_id', api_key: 'test_run_result' },
+	};
+
+	structure_scheme = {
+		bug_relation_id: 'integer | require',
+		bug_id         : 'integer | typeBug | require',
+		relation_type  : 'string | enum | require',
+		element_id     : 'integer | require',
+	};
+
+	create_scheme = [
+		'bug_id',
+		'relation_type',
+		'element_id',
+	];
+
+	available_enum_values = {
+		relation_type: typeBugRelation.get_relation_type_values(),
+	};
+
+	enum_value_translate_matrix = {
+		relation_type: {
+			en: {
+				test_case_id      : 'Test case',
+				test_run_id       : 'Test run',
+				test_run_result_id: 'Test run result',
+			},
+			ru: {
+				test_case_id      : 'Тест-кейс',
+				test_run_id       : 'Прогон',
+				test_run_result_id: 'Результат прогона',
+			},
+		},
+	};
+
+	attribute_name_translate_matrix = {
+		en: {
+			bug_relation_id: 'ID',
+			bug_id         : 'Bug',
+			relation_type  : 'Relation type',
+			element_id     : 'Linked element',
+		},
+		ru: {
+			bug_relation_id: 'ID',
+			bug_id         : 'Баг',
+			relation_type  : 'Тип связи',
+			element_id     : 'Связанный элемент',
+		},
+	};
+
+
+	static get_relation_type_values()
+	{
+		return Object.keys(typeBugRelation.relation_target_map);
+	}
+
+
+	static get_relation_target_map()
+	{
+		return typeBugRelation.relation_target_map;
+	}
+
+
+	/**
+	 * @param {object|false|undefined} data
+	 * @returns {typeBugRelation}
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this[ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 * @returns {object|false}
+	 */
+	get_relation_target_meta()
+	{
+		return typeBugRelation.resolve_relation_target(this.relation_type);
+	}
+}