complexqa_frontend_core 1.14.5 → 1.15.2

package/package.json

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

package/publish/api/bug_api.js

@@ -0,0 +1,18 @@
+import { ApiAbstractElementClass } from "./api_abstract_element_class";
+import { typeBug } from "../types/family_elements/typeBug.js";
+
+
+/**
+ *
+ * @version			v.0.1 (01/06/2026)
+ */
+export class BugApi extends ApiAbstractElementClass
+{
+	module_prefix = 'bug';
+
+	constructor(options)
+	{
+		super(options);
+		this.set_element_class_instance(typeBug);
+	}
+}

package/publish/api/index.js

@@ -11,6 +11,7 @@ import { TestRunResultApi } from "./test_run_result_api.js";
 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";
 
 /**
  * Обертка над axios
@@ -118,7 +119,7 @@ export class Api
 
 	/**
 	 *
-	 * @version			v.0.2 (06/07/2025)
+	 * @version			v.1.1 (01/06/2026)
 	 */
 	#bootstrap()
 	{
@@ -145,6 +146,7 @@ export class Api
 		this.user_profile    = new UserProfileApi(payload);
 		this.task            = new TaskApi(payload);
 		this.test_account    = new TestAccountApi(payload);
+		this.bug             = new BugApi(payload);
 
 
 	}

package/publish/index.js

@@ -14,6 +14,7 @@ export { typeTestCaseStep } from './types/family_elements/typeTestCaseStep.js';
 export { typeTestRun } from './types/family_elements/typeTestRun.js'
 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 { typeUser } from './types/family_elements/typeUser.js';
 export { typeTeam } from './types/family_elements/typeTeam.js';

package/publish/types/family_elements/typeBug.js

@@ -0,0 +1,397 @@
+import { familyTestDocumentation } from "./1_familyTestDocumentation.js";
+import { is_object } from "../../utils/utils.js";
+
+/**
+ * Баг / дефект — сущность баг-трекера внутри TMS.
+ *
+ * @see docs/bug_docs.MD
+ *
+ * @version			v.0.3 (01/06/2026)
+ */
+export class typeBug extends familyTestDocumentation
+{
+	bug_id;
+
+	// --- scope (Jira project, GitHub repo, YouTrack project, TestRail project) ---
+	project_id;
+	team_id;
+
+
+	// --- core content ---
+	bug_title;
+	bug_description;
+	bug_reproduction_steps;			// ADO Microsoft.VSTS.TCM.ReproSteps
+	bug_expected_result;
+	bug_actual_result;
+
+	// --- classification ---
+	bug_type;							// Jira issue type / YouTrack Type
+	bug_status;							// Jira status / GitHub state / Bugzilla status / YouTrack State
+	bug_resolution;						// Jira/Bugzilla resolution / GitHub state_reason (при закрытии)
+	bug_priority;						// порядок исправления (Jira, Bugzilla, ADO Priority)
+	bug_severity;						// степень влияния (ADO Severity, Bugzilla severity)
+
+	// --- people ---
+	reporter_id;						// Jira reporter / GitHub creator / Bugzilla creator
+	assigned_to;						// Jira assignee / GitHub assignees / ADO AssignedTo
+
+	// --- TMS links (TestRail defects ↔ test result, refs ↔ test case) ---
+	// move into another type
+	// make pseudo?
+	// test_case_id;
+	// test_run_id;
+	// test_run_result_id;
+
+	// --- environment & versions ---
+	//bug_environment;					// Jira environment // тут надо подумать как лучше
+	bug_build_version;					// TestRail version / Bugzilla version
+	bug_affected_version;				// Jira/YouTrack Affected versions
+	bug_fixed_version;					// Jira/YouTrack Fix versions
+
+
+	// --- relations ---
+	// related_bug_ids; // pseudo — Bugzilla depends_on / blocks (many-to-many) в развитие
+	duplicate_of_id;					// Jira/GitHub Duplicate
+
+	// bug_labels;		// штука хорошая, но в развитие
+
+	created_at;
+	updated_at;
+	completed_at;						// resolved / closed (YouTrack resolved, GitHub closed_at)
+
+
+	primary_key = 'bug_id';
+	api_key     = 'bug';
+
+	/**
+	 * Схема данных бага.
+	 *
+	 * Принципы проектирования:
+	 * 1. status и resolution разделены — паттерн Jira/Bugzilla (status = workflow, resolution = исход закрытия).
+	 * 2. priority и severity разделены — паттерн Azure DevOps/Bugzilla (priority = очередь, severity = impact).
+	 * 3. TMS-связи (test_case_id, test_run_result_id) — паттерн TestRail defects/refs + закомментированный
+	 * reference_defects_ids в typeTestRunResult.
+	 * 4. external_* — для двусторонней интеграции с внешними трекерами без дублирования их полной модели.
+	 */
+	structure_scheme = {
+
+		// --- identifiers ---
+		bug_id: 'integer | require',
+
+		// --- scope ---
+		project_id: 'integer | require',
+		team_id   : 'integer | require',
+
+		// --- core content (Jira summary+description, GitHub title+body, Bugzilla summary) ---
+		bug_title             : 'string | max:255 | require',
+		bug_description       : 'string | StringHtml | optional',
+		bug_reproduction_steps: 'string | StringHtml | optional',				// ADO ReproSteps
+		bug_expected_result   : 'string | StringHtml | optional',
+		bug_actual_result     : 'string | StringHtml | optional',
+
+		// --- classification ---
+		bug_type      : 'string | enum | require',				// BUG, REGRESSION, PERFORMANCE, SECURITY, ...
+		bug_status    : 'string | enum | require',				// OPEN, IN_PROGRESS, RESOLVED, CLOSED, REOPENED, ...
+		bug_resolution: 'string | enum | optional',			// FIXED, WONT_FIX, DUPLICATE, CANNOT_REPRODUCE, ... (только при
+	                                                           // закрытии)
+		bug_priority: 'string | enum | require',				// CRITICAL, HIGH, NORMAL, LOW (Jira/ADO 1-4, Bugzilla P1-P5)
+		bug_severity: 'string | enum | require',				// BLOCKER, CRITICAL, MAJOR, MINOR, TRIVIAL (ADO/Bugzilla)
+
+		// --- people ---
+		reporter_id: 'integer | require',					// кто нашёл / создал
+		assigned_to: 'integer | optional',				// кто исправляет
+
+		// --- TMS links ---
+		// move into another type
+		// test_case_id      : 'integer | optional',				// TestRail refs, источник дефекта
+		// test_run_id       : 'integer | optional',
+		// test_run_result_id: 'integer | optional',				// TestRail defects (failed result)
+		// functional_id       : 'integer | optional',				// Jira component / functional area
+
+		// --- planning ---
+		// milestone_id        : 'integer | optional',				// GitHub milestone, TestRail milestone
+
+		// --- environment & versions ---
+		// bug_environment - это отдельный слой, где хранятся окружения
+		//bug_environment     : 'string | optional',					// Jira environment (staging, prod, ...)
+		bug_build_version   : 'string | optional',					// TestRail version, Bugzilla version
+		bug_affected_version: 'string | optional',					// Jira/YouTrack Affected versions
+		bug_fixed_version   : 'string | optional',					// Jira/YouTrack Fix versions
+
+		// в развитие, когда будем связывать и интегрировать
+		// bug_platform        : 'string | optional',					// Bugzilla platform (All, Web, Mobile, ...)
+		// bug_operating_system: 'string | optional',					// Bugzilla op_sys
+
+		//external_tracker: 'string | enum | optional',			// JIRA, GITHUB, YOUTRACK, AZURE_DEVOPS, BUGZILLA
+		//external_id     : 'string | optional',					// ID во внешнем трекере
+		//external_url    : 'string | optional',					// URL issue во внешнем трекере
+
+		// --- relations ---
+		duplicate_of_id: 'integer | optional',				// Jira/GitHub Duplicate
+		// related_bug_ids   : 'array | reference | optional',		// Bugzilla depends_on / blocks
+
+
+		// --- timestamps ---
+		created_at  : 'timestamp | require',
+		updated_at  : 'timestamp | optional',
+		completed_at: 'timestamp | optional',				// resolved / closed
+	};
+
+	create_scheme = [
+		'project_id',
+		//'bug_title',
+	];
+
+	available_enum_values = {
+		bug_type        : [ 'BUG', 'REGRESSION', 'PERFORMANCE', 'SECURITY', 'USABILITY', 'COMPATIBILITY', 'DOCUMENTATION', 'OTHER' ],
+		bug_status      : [ 'OPEN', 'TRIAGE', 'IN_PROGRESS', 'ON_HOLD', 'RESOLVED', 'CLOSED', 'REOPENED' ],
+		bug_resolution  : [ 'FIXED', 'WONT_FIX', 'DUPLICATE', 'CANNOT_REPRODUCE', 'WORKS_AS_DESIGNED', 'DEFERRED', 'NOT_A_BUG' ],
+		bug_priority    : [ 'CRITICAL', 'HIGH', 'NORMAL', 'LOW' ],
+		bug_severity    : [ 'BLOCKER', 'CRITICAL', 'MAJOR', 'MINOR', 'TRIVIAL' ],
+		external_tracker: [ 'JIRA', 'GITHUB', 'YOUTRACK', 'AZURE_DEVOPS', 'BUGZILLA', 'LINEAR', 'REDMINE', 'MANTIS', 'OTHER' ],
+	};
+
+	enum_value_translate_matrix = {
+		bug_type        : {
+			en: {
+				BUG          : 'Bug',
+				REGRESSION   : 'Regression',
+				PERFORMANCE  : 'Performance',
+				SECURITY     : 'Security',
+				USABILITY    : 'Usability',
+				COMPATIBILITY: 'Compatibility',
+				DOCUMENTATION: 'Documentation',
+				OTHER        : 'Other',
+			},
+			ru: {
+				BUG          : 'Баг',
+				REGRESSION   : 'Регрессия',
+				PERFORMANCE  : 'Производительность',
+				SECURITY     : 'Безопасность',
+				USABILITY    : 'Юзабилити',
+				COMPATIBILITY: 'Совместимость',
+				DOCUMENTATION: 'Документация',
+				OTHER        : 'Other',
+			},
+		},
+		bug_status      : {
+			en: {
+				OPEN       : 'Open',
+				TRIAGE     : 'Triage',
+				IN_PROGRESS: 'In progress',
+				ON_HOLD    : 'On hold',
+				RESOLVED   : 'Resolved',
+				CLOSED     : 'Closed',
+				REOPENED   : 'Reopened',
+			},
+			ru: {
+				OPEN       : 'Открыт',
+				TRIAGE     : 'Триаж',
+				IN_PROGRESS: 'В работе',
+				ON_HOLD    : 'На паузе',
+				RESOLVED   : 'Исправлен',
+				CLOSED     : 'Закрыт',
+				REOPENED   : 'Переоткрыт',
+			},
+		},
+		bug_resolution  : {
+			en: {
+				FIXED            : 'Fixed',
+				WONT_FIX         : "Won't fix",
+				DUPLICATE        : 'Duplicate',
+				CANNOT_REPRODUCE : 'Cannot reproduce',
+				WORKS_AS_DESIGNED: 'Works as designed',
+				DEFERRED         : 'Deferred',
+				NOT_A_BUG        : 'Not a bug',
+			},
+			ru: {
+				FIXED            : 'Исправлено',
+				WONT_FIX         : 'Не будет исправлено',
+				DUPLICATE        : 'Дубликат',
+				CANNOT_REPRODUCE : 'Не воспроизводится',
+				WORKS_AS_DESIGNED: 'Работает как задумано',
+				DEFERRED         : 'Отложено',
+				NOT_A_BUG        : 'Не баг',
+			},
+		},
+		bug_priority    : {
+			en: {
+				CRITICAL: 'Critical',
+				HIGH    : 'High',
+				NORMAL  : 'Normal',
+				LOW     : 'Low',
+			},
+			ru: {
+				CRITICAL: 'Критический',
+				HIGH    : 'Высокий',
+				NORMAL  : 'Нормальный',
+				LOW     : 'Низкий',
+			},
+		},
+		bug_severity    : {
+			en: {
+				BLOCKER : 'Blocker',
+				CRITICAL: 'Critical',
+				MAJOR   : 'Major',
+				MINOR   : 'Minor',
+				TRIVIAL : 'Trivial',
+			},
+			ru: {
+				BLOCKER : 'Блокер',
+				CRITICAL: 'Критический',
+				MAJOR   : 'Серьёзный',
+				MINOR   : 'Незначительный',
+				TRIVIAL : 'Тривиальный',
+			},
+		},
+		external_tracker: {
+			en: {
+				JIRA        : 'Jira',
+				GITHUB      : 'GitHub',
+				YOUTRACK    : 'YouTrack',
+				AZURE_DEVOPS: 'Azure DevOps',
+				BUGZILLA    : 'Bugzilla',
+				LINEAR      : 'Linear',
+				REDMINE     : 'Redmine',
+				MANTIS      : 'Mantis',
+				OTHER       : 'Other',
+			},
+			ru: {
+				JIRA        : 'Jira',
+				GITHUB      : 'GitHub',
+				YOUTRACK    : 'YouTrack',
+				AZURE_DEVOPS: 'Azure DevOps',
+				BUGZILLA    : 'Bugzilla',
+				LINEAR      : 'Linear',
+				REDMINE     : 'Redmine',
+				MANTIS      : 'Mantis',
+				OTHER       : 'Другое',
+			},
+		},
+	};
+
+	attribute_name_translate_matrix = {
+		en: {
+			bug_id                : 'ID',
+			bug_key               : 'Key',
+			project_id            : 'Project',
+			team_id               : 'Team',
+			bug_title             : 'Title',
+			bug_description       : 'Description',
+			bug_reproduction_steps: 'Reproduction steps',
+			bug_expected_result   : 'Expected result',
+			bug_actual_result     : 'Actual result',
+			bug_type              : 'Type',
+			bug_status            : 'Status',
+			bug_resolution        : 'Resolution',
+			bug_priority          : 'Priority',
+			bug_severity          : 'Severity',
+			reporter_id           : 'Reporter',
+			assigned_to           : 'Assignee',
+			test_case_id          : 'Test case',
+			test_run_id           : 'Test run',
+			test_run_result_id    : 'Test run result',
+			functional_id         : 'Functional area',
+			milestone_id          : 'Milestone',
+			due_at                : 'Due date',
+			bug_environment       : 'Environment',
+			bug_build_version     : 'Build version',
+			bug_affected_version  : 'Affected version',
+			bug_fixed_version     : 'Fixed version',
+			bug_platform          : 'Platform',
+			bug_operating_system  : 'Operating system',
+			parent_bug_id         : 'Parent bug',
+			duplicate_of_id       : 'Duplicate of',
+			external_tracker      : 'External tracker',
+			external_id           : 'External ID',
+			external_url          : 'External URL',
+			created_at            : 'Created at',
+			updated_at            : 'Updated at',
+			completed_at          : 'Completed at',
+		},
+		ru: {
+			bug_id                : 'ID',
+			bug_key               : 'Ключ',
+			project_id            : 'Проект',
+			team_id               : 'Команда',
+			bug_title             : 'Название',
+			bug_description       : 'Описание',
+			bug_reproduction_steps: 'Шаги воспроизведения',
+			bug_expected_result   : 'Ожидаемый результат',
+			bug_actual_result     : 'Фактический результат',
+			bug_type              : 'Тип',
+			bug_status            : 'Статус',
+			bug_resolution        : 'Резолюция',
+			bug_priority          : 'Приоритет',
+			bug_severity          : 'Серьёзность',
+			reporter_id           : 'Автор',
+			assigned_to           : 'Исполнитель',
+			test_case_id          : 'Тест-кейс',
+			test_run_id           : 'Тестовый прогон',
+			test_run_result_id    : 'Результат прогона',
+			functional_id         : 'Функциональная область',
+			milestone_id          : 'Веха',
+			due_at                : 'Срок',
+			bug_environment       : 'Окружение',
+			bug_build_version     : 'Версия сборки',
+			bug_affected_version  : 'Затронутая версия',
+			bug_fixed_version     : 'Версия исправления',
+			bug_platform          : 'Платформа',
+			bug_operating_system  : 'ОС',
+			parent_bug_id         : 'Родительский баг',
+			duplicate_of_id       : 'Дубликат',
+			external_tracker      : 'Внешний трекер',
+			external_id           : 'Внешний ID',
+			external_url          : 'Внешняя ссылка',
+			created_at            : 'Создано',
+			updated_at            : 'Обновлено',
+			completed_at          : 'Закрыто',
+		},
+	};
+
+	status_color = {
+		OPEN       : '#C4B040',
+		TRIAGE     : '#4D92FA',
+		IN_PROGRESS: '#009688',
+		ON_HOLD    : '#FD9A4F',
+		RESOLVED   : '#009688',
+		CLOSED     : '#E0E0E0',
+		REOPENED   : '#E66565',
+	};
+
+
+	/**
+	 *
+	 * @param {object|false|undefined} data
+	 * @returns {typeBug}
+	 */
+	constructor(data = false)
+	{
+		super();
+
+		if (data && is_object(data))
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (01/06/2026)
+	 *
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.bug_title;
+	}
+}

package/publish/types/family_elements/typeFunctional.js

@@ -27,7 +27,7 @@ export class typeFunctional extends familyTestDocumentation
 		functional_group_id   : 'integer | require',
 		team_id               : 'integer | require',
 		functional_name       : 'string | max:90 | require',
-		functional_description: 'string | max:2500 | optional',
+		functional_description: 'string | StringHtml | max:2500 | optional',
 		reference_document_ids: 'array | reference | optional',
 		created_at            : 'timestamp | require',
 		updated_at            : 'timestamp | optional',

package/publish/types/family_elements/typeFunctionalGroup.js

@@ -23,7 +23,7 @@ export class typeFunctionalGroup extends familyTestDocumentation
 	structure_scheme = {
 		functional_group_id         : 'integer | require',
 		functional_group_name       : 'string | max:90 | require',
-		functional_group_description: 'string | max:250 | optional',
+		functional_group_description: 'string | StringHtml | max:250 | optional',
 		project_id                  : 'integer | require',
 		team_id                     : 'integer | require',
 		parent_id                   : 'integer | optional',

package/publish/types/family_elements/typeMilestone.js

@@ -22,7 +22,7 @@ export class typeMilestone extends familyGeneralElement
 	structure_scheme = {
 		milestone_id         : 'integer | require',
 		milestone_name       : 'string | require',
-		milestone_description: 'string | optional',
+		milestone_description: 'string | StringHtml | optional',
 		milestone_status     : 'string | enum | require',
 		company_id           : 'integer | require',
 		milestone_start_date : 'date | require',

package/publish/types/family_elements/typeProject.js

@@ -23,7 +23,7 @@ export class typeProject extends familyGeneralElement
 	structure_scheme = {
 		project_id         : 'integer | require',
 		project_name       : 'string | require',
-		project_description: 'string | optional',
+		project_description: 'string | StringHtml | optional',
 		project_status     : 'string | enum | require',
 		team_id            : 'integer | require',
 		//reference_document_ids: 'array | reference | optional',

package/publish/types/family_elements/typeProjectUserRole.js

@@ -20,7 +20,7 @@ export class typeProjectUserRole extends familyGeneralElement
 
 	structure_scheme = {
 		role_slug       : 'string | require',
-		role_description: 'string | optional',
+		role_description: 'string | StringHtml | optional',
 		project_id      : 'integer | require',
 		user_id         : 'integer | require',
 	};

package/publish/types/family_elements/typeTestAccount.js

@@ -29,7 +29,7 @@ export class typeTestAccount extends familyGeneralElement
 		resource                : 'string | require',
 		login                   : 'string | require',
 		password                : 'string | optional',
-		test_account_description: 'string | optional',
+		test_account_description: 'string | StringHtml | optional',
 		updated_at  : 'timestamp | optional',
 		completed_at: 'timestamp | optional',
 	};

package/publish/types/family_elements/typeTestCase.js

@@ -45,7 +45,7 @@ export class typeTestCase extends familyTestDocumentation
 		functional_id            : 'integer | optional',
 		test_case_status         : 'string | enum | require',
 		test_case_title          : 'string | optional',
-		test_case_descriptions   : 'string | optional',
+		test_case_descriptions   : 'string | StringHtml | optional',
 		test_case_time_to_execute: 'integer |  optional',
 		test_case_complexity     : 'string | enum | optional',
 		test_case_importance     : 'string | enum | optional',

package/publish/types/family_elements/typeTestRun.js

@@ -35,7 +35,7 @@ export class typeTestRun extends familyTestDocumentation
 		test_run_name       : 'string | optional',
 		project_id          : 'integer | require',
 		team_id             : 'integer | require',
-		test_run_description: 'string | optional',
+		test_run_description: 'string | StringHtml | optional',
 		assigned_to         : 'integer | optional',
 		test_case_ids       : 'array | optional',
 		test_run_status     : 'string | enum |  require',

package/publish/types/family_elements/typeTestSuite.js

@@ -27,7 +27,7 @@ export class typeTestSuite extends familyTestDocumentation
 		parent_test_suite_id   : 'integer | optional',
 		//functional_id         : 'integer | optional',
 		test_suite_name       : 'string | optional',
-		test_suite_description: 'string |  optional',
+		test_suite_description: 'string | StringHtml |  optional',
 		team_id               : 'integer | require',
 		created_at            : 'timestamp | require',
 		updated_at            : 'timestamp | optional',