complexqa_frontend_core 1.0.9 → 1.0.10

package/publish/types/family_elements/typeFunctionalGroup.js

@@ -0,0 +1,95 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+
+/**
+ * @version			v.0.2 (25/01/2025)
+ */
+export class typeFunctionalGroup extends familyGeneralElement
+{
+	functional_group_id;
+	project_id;							// foreign key
+	team_id;							// foreign key
+	parent_id;							// для организации вложенности
+	functional_group_name;
+	functional_group_description;
+	//functional_group_status;			// enum (active + archive ??)
+	created_at;
+	updated_at;
+
+	primary_key = 'functional_group_id';
+
+	structure_scheme = {
+		functional_group_id         : 'integer | require',
+		functional_group_name       : 'string | max:90 | require',
+		functional_group_description: 'string | max:250 | optional',
+		project_id                  : 'integer | require',
+		team_id                     : 'integer | require',
+		parent_id                   : 'integer | optional',
+		functional_group_status     : 'integer | enum | require',
+		created_at       : 'timestamp | require',
+		updated_at       : 'timestamp | optional',
+	};
+
+	available_enum_values = {
+		functional_group_status: [ 'не идей. нужен ли тут статус' ]
+	};
+
+
+	/**
+	 *
+	 * @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;
+	}
+
+
+	/******************************************************************************************/
+	/*********************************** general **********************************************/
+
+	/******************************************************************************************/
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async create()
+	{}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async update()
+	{
+
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async delete()
+	{
+
+	}
+
+
+}

package/publish/types/family_elements/typeMilestone.js

@@ -0,0 +1,93 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+/**
+ *
+ * @version			v.0.2 (15/06/2024)
+ */
+export class typeMilestone extends familyGeneralElement
+{
+	milestone_id;				// primary AI
+	milestone_name;
+	milestone_description;
+	milestone_status;			// enum
+	milestone_start_date;
+	milestone_end_date;
+	team_id;					// foreign key
+	project_id;					// foreign key
+
+
+	primary_key = 'milestone_id';
+
+	structure_scheme = {
+		milestone_id         : 'integer | require',
+		milestone_name       : 'string | require',
+		milestone_description: 'string | optional',
+		milestone_status     : 'string | enum | require',
+		company_id           : 'integer | require',
+		milestone_start_date : 'date | require',
+		milestone_end_date   : 'date | optional',
+		project_id           : 'integer | require',
+	};
+
+	available_enum_values = {
+		milestone_status: [ 'ACTUAL', 'COMPLETED', 'PLANNED' ]
+	};
+
+	/**
+	 *
+	 * @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;
+	}
+
+
+	/******************************************************************************************/
+	/*********************************** general **********************************************/
+
+	/******************************************************************************************/
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async create()
+	{}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async update()
+	{
+
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async delete()
+	{
+
+	}
+
+
+}

package/publish/types/family_elements/typeProject.js

@@ -0,0 +1,114 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { echo, is_object } from "../../utils/utils";
+import { MockDataTypeProject } from "./mock_data/mock_data_typeProject";
+
+
+/**
+ *
+ * @version			v.0.2 (15/06/2024)
+ */
+export class typeProject extends familyGeneralElement
+{
+	project_id;					// primary
+	project_name;
+	project_description;		// some comment
+	project_status; 			// enum
+	team_id; 					// foreign key + owner
+	reference_document_ids;		// IDS документов по функционалу (к примеру confluence)
+	// хосты/домены будут отдельно храниться, их может быть множество
+
+	primary_key = 'project_id';
+	api_key     = 'project';
+
+	structure_scheme = {
+		project_id            : 'integer | require',
+		project_name          : 'string | require',
+		project_description   : 'string | optional',
+		project_status        : 'string | enum | require',
+		company_id            : 'integer | require',
+		reference_document_ids: 'array | reference | optional',
+	};
+
+	available_enum_values = {
+		project_status: [ 'OPEN', 'CLOSED', 'PLANNED' ]
+	};
+
+
+	/**
+	 *
+	 * @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;
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (02/07/2024)
+	 * @returns {array<typeProject>}
+	 * @param {number} count
+	 */
+	get_random_demo_data(count)
+	{
+		// @todo validations
+		let response = [];
+
+		for (let i = 0; i < count; i++)
+		{
+			response.push(new MockDataTypeProject());
+		}
+
+
+		return response;
+	}
+
+
+	/******************************************************************************************/
+	/******************************************************************************************/
+
+	/******************************************************************************************/
+
+
+	/**
+	 *
+	 * @version			v.0.1 (05/06/2025)
+	 *
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.project_name;
+	}
+
+
+	/******************************************************************************************/
+	/**************************** работа с участниками проекта ********************************/
+	/******************************************************************************************/
+
+	// member = user + role
+
+	member_add() {}
+
+	member_update() {}
+
+	member_delete() {}
+
+	member_get() {}
+
+
+}

package/publish/types/family_elements/typeProjectDocument.js

@@ -0,0 +1,80 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+/**
+ * (идея) - у проекта должна быть тестовая документация
+ *
+ * @see https://vladislaveremeev.gitbook.io/qa_bible/testovaya-dokumentaciya-i-artefakty-test-deliverablestest-artifacts/vidy-testovoi-dokumentacii
+ *
+ * @version			v.0.2 (07/07/2024)
+ */
+export class typeProjectDocument extends familyGeneralElement
+{
+	project_document_id;
+	project_id;
+	project_document_type;
+	// где и как храним файлы?
+	// nextcloud integration?
+
+
+
+	available_enum_values = {
+		project_document_type: [ 'QUALITY_POLICY', 'TEST_POLICY', 'PROJECT_DESCRIPTION', 'TEST_PLAN', 'DOCUMENT' ],
+	};
+
+
+	/**
+	 *
+	 * @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;
+	}
+
+
+	/******************************************************************************************/
+	/*********************************** general **********************************************/
+
+	/******************************************************************************************/
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async create()
+	{}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async update()
+	{
+
+	}
+
+
+	/**
+	 *
+	 * @version			v.0.1 (07/07/2024)
+	 */
+	async delete()
+	{
+
+	}
+}

package/publish/types/family_elements/typeProjectTestAccount.js

@@ -0,0 +1,59 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+/**
+ * Тестовые аккаунты
+ *
+ * У каждого проекта свои коллекции
+ * (идея)
+ *
+ * @version			v.0.1 (30/06/2024)
+ */
+export class typeProjectTestAccount extends familyGeneralElement
+{
+	test_account_id;
+	project_id;
+	site;
+	authentication_type;
+	login;
+	password; // как будем хранить?
+	comment;
+
+	primary_key = 'test_account_id';
+
+	structure_scheme = {
+		test_account_id    : 'integer | require',
+		project_id         : 'integer | require',
+		authentication_type: 'enum | require',
+		site               : 'string | require',
+		login              : 'string | require',
+		password           : 'string | optional',
+		comment            : 'string | optional',
+	};
+
+	available_enum_values = {
+		authentication_type: [ 'FORMS' ] // другие пока нет автоматизации не особо нужны
+	};
+
+	/**
+	 *
+	 * @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_elements/typeProjectTestData.js

@@ -0,0 +1,43 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+/**
+ * Тестовые данные
+ * Какая-то коллекция, созданная для тестирования и ввода
+ *
+ * У каждого проекта свои коллекции
+ *
+ * (идея)
+ * @version			v.0.1 (30/06/2024)
+ */
+export class typeProjectTestData extends familyGeneralElement
+{
+	// как храним? json или какие-то структуры? [key->value] ?
+	test_data_id;
+	project_id;
+
+
+	primary_key = 'test_data_id';
+
+	/**
+	 *
+	 * @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_elements/typeProjectUserRole.js

@@ -0,0 +1,55 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+/**
+ * Роли в проекте
+ * @version			v.0.1 (07/07/2024)
+ */
+export class typeProjectUserRole extends familyGeneralElement
+{
+	// строго определенный список
+	// без возможности создания иных
+	// если роль не указана - то ADMINISTRATOR
+
+	role_slug;
+	role_description;
+	project_id;
+	user_id;
+
+	primary_key = 'role_slug';
+
+	structure_scheme = {
+		role_slug       : 'string | require',
+		role_description: 'string | optional',
+		project_id      : 'integer | require',
+		user_id         : 'integer | require',
+	};
+
+	available_enum_values = {
+		role_slug: [ 'ROOT', 'ADMINISTRATOR', 'LEAD', 'QA_ENGINEER' ]
+		// ?? Системные администраторы, Разработчики, Тестировщики
+	};
+
+
+	/**
+	 *
+	 * @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_elements/typeTask.js

@@ -0,0 +1,78 @@
+import { familyGeneralElement } from "./0_familyGeneralElement";
+import { is_object } from "../../utils/utils";
+
+
+/**
+ * @version			v.2.0 (07/07/2024)
+ */
+export class typeTask extends familyGeneralElement
+{
+	task_id;
+	team_id;					// foreign key
+	task_performer_id;			// foreign key	// @todo переименовать с общепринятой практикой
+	task_initiator_id;			// foreign key // @todo переименовать с общепринятой практикой
+	task_type;					// enum => сделать тест, выполнить тест, итд (!не дублирует предмет задания - тут тип + действие)
+	task_status;				// enum
+	project_id;					// foreign key (денормализация) (а надо ли)
+	task_subject_element_type;	// предмет задания
+	task_subject_id;			// ID предмета задания (изначально его может не быть)
+
+
+	primary_key = 'task_id';
+
+	structure_scheme = {
+		task_id                  : 'integer | require',
+		team_id                  : 'integer | require',
+		task_performer_id        : 'integer | require',
+		task_initiator_id        : 'integer | require',
+		task_type                : 'string | enum | require',
+		task_status              : 'string | enum | require',
+		project_id               : 'integer | require',
+		task_subject_element_type: 'string | enum | require',
+		task_subject_id          : 'integer | optional',
+	};
+
+	available_enum_values = {
+		task_status: [ 'OPEN', 'IN_PROGRESS', 'DONE', 'CANCELLED' ],
+		// тут будет много, все надо перечислить, чтобы просто по каждой описать свой код
+		// и не все комбинации action + element доступны и могут существовать
+		task_type  : [
+			'CREATE_PROJECT_DOCUMENT',
+			'CREATE_FUNCTIONAL',
+			'CREATE_TESTCASE',
+			'CREATE_TEST_RUN',
+			'RUN_TEST_RUN'
+		],
+		task_subject_element_type: [
+			'PROJECT',
+			'PROJECT_DOCUMENT',
+			'TEST_SUITE',
+			'TEST_CASE',
+			'TEST_RUN',
+			'TEST_RESULT',
+		],
+	};
+
+
+	/**
+	 *
+	 * @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;
+	}
+}