complexqa_frontend_core 1.17.12 → 1.18.1

package/package.json

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

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

@@ -1,5 +1,9 @@
 import { typeTableColumn } from '../../../types/family_service/typeTableColumn.js';
 
+/**
+ * Значения по умолчанию для data-колонок.
+ * @type {Partial<import('../../../types/family_service/typeTableColumn.js').typeTableColumn>}
+ */
 const COLUMN_DEFAULTS = {
 	width       : '120',
 	sort_order  : '1',
@@ -15,13 +19,42 @@ const COLUMN_DEFAULTS = {
 	header_element_type: false,
 };
 
+/**
+ * @typedef {Object} ColumnOverrides
+ * @property {string} [header_field] Атрибут для перевода заголовка (по умолчанию = `field`).
+ * @property {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} [header_model]
+ *   Модель перевода при bootstrap (по умолчанию = `model`). Итоговый заголовок — в `get_config(lang)`.
+ * @property {string} [header_name] Явный заголовок; обычно не нужен — достаточно `header_field`.
+ * @property {string|false} [header_element_type] Ключ модели перевода, если ≠ element_type секции.
+ * @property {string|number} [width]
+ * @property {string|number} [sort_order]
+ * @property {boolean} [is_sortable]
+ * @property {boolean} [is_filter]
+ * @property {boolean} [is_hide]
+ * @property {boolean} [is_editable]
+ * @property {boolean} [is_required]
+ * @property {boolean} [is_title]
+ * @property {''|'asc'|'desc'} [default_sort]
+ * @property {string} [cell_classes]
+ */
+
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {string} field
- * @param {object} overrides
+ * Data-колонка с переводимым заголовком и сохранённым `header_field`.
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
+ *   Модель сущности секции.
+ * @param {string} locale Локаль bootstrap (для первичного `header_name`; актуальная — в `get_config`).
+ * @param {string} field Поле строки (`test_case_status`, `user_id.first_name`, …).
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
+ *
+ * @example
+ * createColumn(model, locale, 'test_case_id.test_case_title', {
+ *   header_field: 'test_case_title',
+ *   header_element_type: 'test_case',
+ *   width: '480',
+ * });
  */
 export function createColumn(model, locale, field, overrides = {})
 {
@@ -39,9 +72,10 @@ export function createColumn(model, locale, field, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {object} overrides
+ * Колонка множественного выбора строк (`column_kind: row_select`).
+ * Без `header_field` — не локализуется. В web_app: pinned left, чекбоксы.
+ *
+ * @param {Partial<typeTableColumn>} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createRowSelectColumn(overrides = {})
@@ -61,9 +95,12 @@ export function createRowSelectColumn(overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
- * @param {string} locale
- * @param {object} overrides
+ * Колонка перехода к деталям (`column_kind: goto`).
+ * Заголовок в UI — через `translateGoToHeader` в web_app, не через ядро.
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
+ * @param {string} locale Не используется; сохранён для единообразия API фабрик.
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createGoToColumn(model, locale, overrides = {})
@@ -85,9 +122,11 @@ export function createGoToColumn(model, locale, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
+ * Колонка primary key (часто скрытая в listing, видимая в todo).
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
  * @param {string} locale
- * @param {object} overrides
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createPrimaryKeyColumn(model, locale, overrides = {})
@@ -104,10 +143,12 @@ export function createPrimaryKeyColumn(model, locale, overrides = {})
 
 
 /**
- * @param {familyGeneralElement} model
+ * Колонка для таблиц details: без сортировки и фильтра ag-grid.
+ *
+ * @param {import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement} model
  * @param {string} locale
  * @param {string} field
- * @param {object} overrides
+ * @param {ColumnOverrides} [overrides={}]
  * @returns {typeTableColumn}
  */
 export function createDetailsColumn(model, locale, field, overrides = {})

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

@@ -3,10 +3,15 @@ import { typeTableConfiguration } from '../../../types/family_service/typeTableC
 import { TABLE_ELEMENT_MODELS } from './table_element_models.js';
 
 /**
+ * Применяет локаль к заголовку одной data-колонки.
+ *
+ * Колонки без `header_field` (ручные, goto, row_select, copy) возвращаются без изменений.
+ * Модель перевода: `TABLE_ELEMENT_MODELS[header_element_type || element_type]`.
+ *
  * @param {typeTableColumn} column
- * @param {string} element_type
- * @param {string} lang
- * @returns {typeTableColumn}
+ * @param {string} element_type Ключ сущности секции (`test_case`, `bug`, …).
+ * @param {string} lang Код локали (`en`, `ru`, …).
+ * @returns {typeTableColumn} Новый экземпляр с обновлённым `header_name` или исходная колонка.
  */
 export function localizeTableColumn(column, element_type, lang)
 {
@@ -47,9 +52,14 @@ export function localizeTableColumn(column, element_type, lang)
 
 
 /**
- * @param {{ config: typeTableConfiguration }} section
+ * Возвращает копию секции с локализованными заголовками всех data-колонок.
+ *
+ * Вызывается из `TableConfiguration.get_config` — не мутирует кеш bootstrap.
+ *
+ * @param {{ config: typeTableConfiguration }} section Зарегистрированная секция из `static.config`.
  * @param {string} element_type
  * @param {string} lang
+ * @returns {{ config: typeTableConfiguration }}
  */
 export function localizeTableSection(section, element_type, lang)
 {

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

@@ -2,13 +2,27 @@ import { typeTableConfiguration } from '../../../types/family_service/typeTableC
 import { typeFOR } from '../../../types/family_service/typeFOR.js';
 import { typeFilter } from '../../../types/family_service/typeFilter.js';
 
+/**
+ * @typedef {Object} RegisterSectionOptions
+ * @property {typeFOR|false} [for=false] Шаблон поиска для листинга.
+ * @property {string|false} [contained_element_type=false] Контекст вложенной сущности.
+ * @property {{ description: (string|false), link: (string|false) }} [documentation]
+ */
 
 /**
- * @param {object} config
- * @param {string} element_type
- * @param {string} section
- * @param {typeTableColumn[]} columns
- * @param {object} options
+ * Регистрирует секцию таблицы в реестре `TableConfiguration.config`.
+ *
+ * @param {Object<string, Object<string, { config: typeTableConfiguration }>>} config Ссылка на `TableConfiguration.config`.
+ * @param {string} element_type Ключ сущности.
+ * @param {string} section Имя секции (`listing`, `todo`, `details`, …).
+ * @param {import('../../../types/family_service/typeTableColumn.js').typeTableColumn[]} columns
+ * @param {RegisterSectionOptions} [options={}]
+ * @returns {void}
+ *
+ * @example
+ * registerSection(config, 'bug', 'listing', build_bug_listing_columns(locale), {
+ *   for: createListingFor(['project_id']),
+ * });
  */
 export function registerSection(config, element_type, section, columns, options = {})
 {
@@ -31,8 +45,10 @@ export function registerSection(config, element_type, section, columns, options
 
 
 /**
- * @param {string} attribute
- * @returns {typeFilter}
+ * Фильтр-заготовка для runtime-подстановки значения в web_app.
+ *
+ * @param {string} attribute Имя атрибута (`project_id`, `test_case_id`, …).
+ * @returns {typeFilter} `operator: EQUAL`, `value: false` до гидратации.
  */
 export function createRuntimeFilter(attribute)
 {
@@ -45,9 +61,14 @@ export function createRuntimeFilter(attribute)
 
 
 /**
- * @param {string[]} filter_attributes
- * @param {object|false} for_options
+ * Строит шаблон `typeFOR` для листинговых таблиц.
+ *
+ * @param {string[]} [filter_attributes=['project_id']] Атрибуты, которые web_app заполнит из `filterValues`.
+ * @param {Object<string, *>|false} [for_options=false] Доп. опции API (`add: ['users']` и т.д.).
  * @returns {typeFOR}
+ *
+ * @example
+ * createListingFor(['project_id', 'test_case_id'], { add: ['users'] });
  */
 export function createListingFor(filter_attributes = [ 'project_id' ], for_options = false)
 {

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

@@ -4,13 +4,22 @@ import { typeTestRun } from '../../../types/family_elements/typeTestRun.js';
 import { typeBug } from '../../../types/family_elements/typeBug.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';
 import { typeTeamMember } from '../../../types/family_elements/typeTeamMember.js';
 import { typeTestCaseStep } from '../../../types/family_elements/typeTestCaseStep.js';
 import { typeUser } from '../../../types/family_elements/typeUser.js';
 import { typeTeam } from '../../../types/family_elements/typeTeam.js';
 
 /**
- * Модели сущностей для таблиц (row id, перевод заголовков колонок).
+ * Реестр классов моделей по ключу `element_type`.
+ *
+ * Используется для:
+ * - `TableBaseConfig.getRowNodeId` — primary key строки;
+ * - `localizeTableColumn` — `get_attribute_name_translate(header_field, lang)`.
+ *
+ * При добавлении новой таблицы сущности — зарегистрировать класс здесь.
+ *
+ * @type {Object<string, typeof import('../../../types/core/0_familyGeneralElement.js').familyGeneralElement>}
  */
 export const TABLE_ELEMENT_MODELS = {
 	test_case      : typeTestCase,
@@ -18,8 +27,9 @@ export const TABLE_ELEMENT_MODELS = {
 	test_run       : typeTestRun,
 	bug            : typeBug,
 	test_run_result: typeTestRunResult,
-	test_account   : typeTestAccount,
-	team_member    : typeTeamMember,
+	test_account      : typeTestAccount,
+	execution_context : typeExecutionContext,
+	team_member       : typeTeamMember,
 	test_case_step : typeTestCaseStep,
 	user           : typeUser,
 	team           : typeTeam,

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

@@ -85,6 +85,12 @@ function build_bug_details_columns(locale)
 }
 
 
+/**
+ * Секции `bug`: `listing`, `todo`, `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_bug(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -0,0 +1,78 @@
+import { typeExecutionContext } from '../../../types/family_context/typeExecutionContext.js';
+import { UserService } from '../../../services/UserService.js';
+import { createColumn, createGoToColumn, createPrimaryKeyColumn } from '../helpers/column_factory.js';
+import { createListingFor, registerSection } from '../helpers/section_registry.js';
+
+const FK_FIELDS = [
+	'browser_context_id',
+	'os_context_id',
+	'screen_resolution_context_id',
+	'device_context_id',
+	'locale_context_id',
+	'deployment_target_context_id',
+	'test_account_id',
+];
+
+function build_execution_context_listing_columns(locale)
+{
+	const model = new typeExecutionContext();
+
+	return [
+		createPrimaryKeyColumn(model, locale, { is_editable: false }),
+		createColumn(model, locale, 'context_title', { width: '420', is_editable: true, is_required: false }),
+		...FK_FIELDS.map((field) => createColumn(model, locale, field, { width: '200', is_editable: false })),
+		createColumn(model, locale, 'protocol', { width: '120', is_editable: true }),
+		createColumn(model, locale, 'host', { width: '200', is_editable: true }),
+		createColumn(model, locale, 'build_version', { width: '160', is_editable: true }),
+		createColumn(model, locale, 'created_at', { width: '170' }),
+		createGoToColumn(model, locale),
+	];
+}
+
+
+function build_execution_context_details_columns(locale)
+{
+	const model  = new typeExecutionContext();
+	const fields = [
+		'execution_context_id',
+		'project_id',
+		'team_id',
+		'context_title',
+		...FK_FIELDS,
+		'protocol',
+		'host',
+		'base_url',
+		'build_version',
+		'context_snapshot',
+		'custom_field_values',
+		'created_at',
+		'updated_at',
+	];
+
+	const editableFields = new Set([ 'context_title', 'protocol', 'host', 'base_url', 'build_version' ]);
+
+	return fields.map((field, index) => createColumn(model, locale, field, {
+		sort_order : String(index + 1),
+		is_editable: editableFields.has(field),
+		is_sortable: false,
+		is_filter  : false,
+	}));
+}
+
+
+/**
+ * Секции `execution_context`: `listing`, `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
+export function bootstrap_execution_context(config)
+{
+	const locale = UserService.get_current_language();
+
+	registerSection(config, 'execution_context', 'listing', build_execution_context_listing_columns(locale), {
+		for: createListingFor([ 'project_id' ]),
+	});
+
+	registerSection(config, 'execution_context', 'details', build_execution_context_details_columns(locale));
+}

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

@@ -50,6 +50,12 @@ function build_project_todo_column(locale)
 }
 
 
+/**
+ * Секции `project`: `domains` (ручные колонки без перевода), `todo_column`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_project(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -33,6 +33,12 @@ function build_team_total_statistic_columns(locale)
 }
 
 
+/**
+ * Секции `team`: `profile`; `team_total_statistic`: `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_team(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -33,6 +33,12 @@ function build_team_member_listing_columns(locale)
 }
 
 
+/**
+ * Секция `team_member`: `listing`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_team_member(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -56,6 +56,12 @@ function build_test_account_details_columns(locale)
 }
 
 
+/**
+ * Секции `test_account`: `listing`, `details` (в details — колонка `copy`).
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_account(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -48,6 +48,12 @@ function build_test_case_todo_columns(locale)
 }
 
 
+/**
+ * Секции `test_case`: `listing`, `todo`, `picker`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_case(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -45,6 +45,12 @@ function build_test_case_presteps_columns(locale)
 	return build_test_case_step_shared_columns(locale);
 }
 
+/**
+ * Секции `test_case_step`: `steps`, `presteps` (шаги и престепы тест-кейса).
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_case_step(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -59,6 +59,12 @@ function build_test_run_todo_columns(locale)
 }
 
 
+/**
+ * Секции `test_run`: `listing`, `todo`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_run(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -74,6 +74,12 @@ function build_test_run_result_details_columns(locale)
 }
 
 
+/**
+ * Секции `test_run_result`: `listing`, `todo`, `details`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_test_run_result(config)
 {
 	const locale = UserService.get_current_language();

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

@@ -17,6 +17,12 @@ function build_user_profile_columns(locale)
 }
 
 
+/**
+ * Секция `user`: `profile`.
+ *
+ * @param {Object<string, Object<string, { config: import('../../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>} config
+ * @returns {void}
+ */
 export function bootstrap_user(config)
 {
 	const locale = UserService.get_current_language();

package/publish/app_configuration/table/table_base_config.js

@@ -3,16 +3,27 @@ import { LOCALE_AG_GRID_EG } from '../table_locale_ar.js';
 import { TABLE_ELEMENT_MODELS } from './helpers/table_element_models.js';
 
 /**
- * Базовые опции ag-grid, общие для всех таблиц.
+ * Базовые опции ag-grid Community, общие для всех таблиц приложения.
  *
- * @version			v.0.2 (12/06/2026)
+ * Не содержит columnDefs — они строятся в web_app из `TableConfiguration`.
+ * Дополняет грид: `defaultColDef`, `rowSelection`, `localeText`, `getRowNodeId`.
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.3 (12/06/2026)
  */
 export class TableBaseConfig
 {
 	/**
-	 * @param {string} element_type
-	 * @param {string} section
-	 * @param {string} lang
+	 * Возвращает копию общих gridOptions для ag-grid.
+	 *
+	 * @param {string} element_type Ключ сущности — для `getRowNodeId` (primary key модели).
+	 * @param {string} section Имя секции (зарезервировано; сейчас не влияет на ответ).
+	 * @param {string} [lang='en'] Локаль UI ag-grid. Для `ru` и `ar` добавляется `localeText`.
+	 * @returns {Object} GridOptions-совместимый объект (без привязки к Vue).
+	 *
+	 * @example
+	 * const { getRowNodeId, localeText, defaultColDef, ...gridOptions } =
+	 *   TableBaseConfig.get_config('bug', 'listing', 'ru');
 	 */
 	static get_config(element_type, section, lang)
 	{
@@ -33,8 +44,11 @@ export class TableBaseConfig
 
 
 	/**
-	 * @param lang
-	 * @returns {{}}
+	 * Словарь ag-grid localeText для меню колонок и системных строк.
+	 *
+	 * @private
+	 * @param {string} lang
+	 * @returns {Object<string, string>}
 	 */
 	static #localeText(lang)
 	{
@@ -54,8 +68,11 @@ export class TableBaseConfig
 
 
 	/**
-	 * @param element_type
-	 * @returns {function(*): number}
+	 * Фабрика `getRowNodeId`: возвращает id строки по primary key сущности.
+	 *
+	 * @private
+	 * @param {string} element_type
+	 * @returns {function(Object): number}
 	 */
 	static #getRowNodeId(element_type)
 	{
@@ -80,6 +97,10 @@ export class TableBaseConfig
 	}
 
 
+	/**
+	 * Статические опции ag-grid по умолчанию.
+	 * @type {Object}
+	 */
 	static config = {
 		defaultColDef            : {
 			filter    : true,

package/publish/app_configuration/table/table_configuration.js

@@ -5,6 +5,7 @@ import { bootstrap_test_case_step } from './sections/test_case_step.js';
 import { bootstrap_test_run } from './sections/test_run.js';
 import { bootstrap_test_run_result } from './sections/test_run_result.js';
 import { bootstrap_test_account } from './sections/test_account.js';
+import { bootstrap_execution_context } from './sections/execution_context.js';
 import { bootstrap_team_member } from './sections/team_member.js';
 import { bootstrap_user } from './sections/user.js';
 import { bootstrap_team } from './sections/team.js';
@@ -12,21 +13,37 @@ import { bootstrap_project } from './sections/project.js';
 import { localizeTableSection } from './helpers/column_locale.js';
 
 /**
- * Реестр конфигураций таблиц (ag-grid).
+ * Реестр конфигураций таблиц ag-grid.
  *
- * @version			v.0.2 (12/06/2026)
+ * Хранит колонки (`typeTableColumn`), шаблон поиска (`for`) и метаданные по парам
+ * `element_type` × `section` (например `test_case` × `listing`).
+ *
+ * Заголовки data-колонок локализуются при каждом вызове `get_config`, а не при bootstrap.
+ * Представление ячеек (renderer/editor) — в web_app (`ColumnFactory`).
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.3 (12/06/2026)
  */
 export class TableConfiguration extends abstractAppConfiguration
 {
+	/**
+	 * Внутренний реестр: `config[element_type][section] → { config: typeTableConfiguration }`.
+	 * @type {Object<string, Object<string, { config: import('../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }>>}
+	 */
 	static config = {};
 
+	/**
+	 * @type {{ loaded: boolean }}
+	 */
 	static state = {
 		loaded: false
 	}
 
 
 	/**
-	 * @param init_options
+	 * Синглтон: при первом создании вызывает `bootstrap()`.
+	 *
+	 * @param {boolean|object} [init_options=false]
 	 */
 	constructor(init_options = false)
 	{
@@ -44,10 +61,18 @@ export class TableConfiguration extends abstractAppConfiguration
 
 
 	/**
-	 * @param {string} element_type
-	 * @param {string} section
-	 * @param {string} lang
+	 * Возвращает конфигурацию секции таблицы с заголовками колонок для запрошенной локали.
+	 *
+	 * @param {string} element_type Ключ сущности (`bug`, `test_case`, `test_run`, …).
+	 * @param {string} section Имя секции (`listing`, `todo`, `details`, `steps`, `presteps`, …).
+	 * @param {string} [lang='en'] Код локали (`en`, `ru`, `ar`). Передаётся из web_app (`getLocale()`).
+	 * @returns {{ config: import('../../types/family_service/typeTableConfiguration.js').typeTableConfiguration }|false}
+	 *   Объект с полем `config` или `false`, если секция не зарегистрирована.
 	 *
+	 * @example
+	 * const section = TableConfiguration.get_config('test_case', 'listing', 'ru');
+	 * const columns = section.config.columns;
+	 * const forTemplate = section.config.for;
 	 */
 	static get_config(element_type, section, lang = 'en')
 	{
@@ -67,6 +92,12 @@ export class TableConfiguration extends abstractAppConfiguration
 	}
 
 
+	/**
+	 * Однократная загрузка всех секций из `sections/*` в `static.config`.
+	 * Повторный вызов — no-op.
+	 *
+	 * @returns {void}
+	 */
 	static bootstrap()
 	{
 		if (this.state.loaded)
@@ -80,6 +111,7 @@ export class TableConfiguration extends abstractAppConfiguration
 		bootstrap_test_run(this.config);
 		bootstrap_test_run_result(this.config);
 		bootstrap_test_account(this.config);
+		bootstrap_execution_context(this.config);
 		bootstrap_team_member(this.config);
 		bootstrap_user(this.config);
 		bootstrap_team(this.config);

package/publish/types/family_context/typeExecutionContext.js

@@ -16,6 +16,9 @@ export class typeExecutionContext extends familyGeneralElement
 	project_id;
 	team_id;
 
+	context_title;
+	context_description;
+
 	browser_context_id;
 	os_context_id;
 	screen_resolution_context_id;
@@ -42,6 +45,8 @@ export class typeExecutionContext extends familyGeneralElement
 		execution_context_id        : 'integer | require',
 		project_id                  : 'integer | require',
 		team_id                     : 'integer | require',
+		context_title               : 'string | optional',
+		context_description         : 'string | StringHtml | optional',
 		browser_context_id          : 'integer | optional',
 		os_context_id               : 'integer | optional',
 		screen_resolution_context_id: 'integer | optional',
@@ -84,6 +89,8 @@ export class typeExecutionContext extends familyGeneralElement
 	attribute_name_translate_matrix = {
 		en: {
 			execution_context_id        : 'ID',
+			context_title               : 'Title',
+			context_description         : 'Description',
 			project_id                  : 'Project',
 			team_id                     : 'Team',
 			browser_context_id          : 'Browser',
@@ -104,6 +111,8 @@ export class typeExecutionContext extends familyGeneralElement
 		},
 		ru: {
 			execution_context_id        : 'ID',
+			context_title               : 'Название',
+			context_description         : 'Описание',
 			project_id                  : 'Проект',
 			team_id                     : 'Команда',
 			browser_context_id          : 'Браузер',
@@ -145,4 +154,13 @@ export class typeExecutionContext extends familyGeneralElement
 
 		return this;
 	}
+
+
+	/**
+	 * @returns {string}
+	 */
+	get_element_name()
+	{
+		return this.context_title || String(this.execution_context_id ?? '');
+	}
 }

package/publish/types/family_service/typeTableColumn.js

@@ -1,63 +1,116 @@
-import { familyService } from "./familyService";
-
-/**
- *
- * @version			v.0.1 (26/04/2025)
- */
-export class typeTableColumn extends familyService
-{
-	header_name;
-	field;
-	width;
-	sort_order;
-	cell_classes;
-	default_sort;
-	is_sortable;
-	is_filter;
-	is_hide;
-	is_editable;
-
-	/**
-	 * Семантический тип колонки для фабрики ColDef (этап 3).
-	 * @type {'data'|'row_select'|'goto'|'sort_action'|'copy'}
-	 */
-	column_kind = 'data';
-
-	/**
-	 * Обязательное поле при создании/редактировании строки.
-	 */
-	is_required = false;
-
-	/**
-	 * Поле-заголовок сущности (например test_case_title).
-	 */
-	is_title = false;
-
-	/**
-	 * Тип сущности для перевода header_name, если отличается от основной.
-	 */
-	header_element_type = false;
-
-	/**
-	 * Имя атрибута для перевода заголовка (если отличается от field).
-	 */
-	header_field = false;
-
-
-	constructor(data = false)
-	{
-		super();
-		if (data && typeof data === 'object')
-		{
-			_.mapObject(data, (value, key) =>
-			{
-				if (this.hasOwnProperty(key))
-				{
-					this [ key ] = value;
-				}
-			});
-		}
-
-		return this;
-	}
-}
+import { familyService } from "./familyService";
+
+/**
+ * Описание одной колонки таблицы ag-grid.
+ *
+ * Ядро хранит структуру и флаги; web_app (`ColumnFactory`) маппит в `ColDef`
+ * и подбирает cellRenderer / cellEditor по `field` и `column_kind`.
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.2 (12/06/2026)
+ */
+export class typeTableColumn extends familyService
+{
+	/**
+	 * Отображаемый заголовок колонки.
+	 * Для `column_kind: 'data'` пересчитывается в `TableConfiguration.get_config` по `header_field` и `lang`.
+	 * @type {string|undefined}
+	 */
+	header_name;
+
+	/**
+	 * Имя поля в данных строки (ColDef.field).
+	 * @type {string|undefined}
+	 */
+	field;
+
+	/**
+	 * Ширина колонки в пикселях (строка для совместимости с конфигами).
+	 * @type {string|number|undefined}
+	 */
+	width;
+
+	/**
+	 * Порядок колонки (меньше — левее). Сортируется в ColumnFactory перед сборкой ColDef.
+	 * @type {string|number|undefined}
+	 */
+	sort_order;
+
+	/**
+	 * CSS-классы ячейки.
+	 * @type {string|undefined}
+	 */
+	cell_classes;
+
+	/**
+	 * Начальная сортировка: `''`, `'asc'` или `'desc'`.
+	 * @type {''|'asc'|'desc'|string|undefined}
+	 */
+	default_sort;
+
+	/** @type {boolean|undefined} */
+	is_sortable;
+
+	/** @type {boolean|undefined} */
+	is_filter;
+
+	/** @type {boolean|undefined} */
+	is_hide;
+
+	/** @type {boolean|undefined} */
+	is_editable;
+
+	/**
+	 * Семантический тип колонки для фабрики ColDef в web_app.
+	 * @type {'data'|'row_select'|'goto'|'sort_action'|'copy'}
+	 */
+	column_kind = 'data';
+
+	/**
+	 * Обязательное поле при создании/редактировании строки (метаданные для UI).
+	 * @type {boolean}
+	 */
+	is_required = false;
+
+	/**
+	 * Поле-заголовок сущности в строке (например `test_case_title` в todo).
+	 * Влияет на multiline / flex в ColumnFactory.
+	 * @type {boolean}
+	 */
+	is_title = false;
+
+	/**
+	 * Ключ модели для перевода заголовка, если отличается от `element_type` секции.
+	 * Пример: `test_case` для колонки `test_case_id.test_case_title` в `test_run_result`.
+	 * @type {string|false}
+	 */
+	header_element_type = false;
+
+	/**
+	 * Имя атрибута в `attribute_name_translate_matrix` для заголовка.
+	 * Задаётся в `createColumn`; если `false` — заголовок не локализуется при `get_config`.
+	 * @type {string|false}
+	 */
+	header_field = false;
+
+
+	/**
+	 * @param {Partial<typeTableColumn>|false} [data=false]
+	 */
+	constructor(data = false)
+	{
+		super();
+		if (data && typeof data === 'object')
+		{
+			_.mapObject(data, (value, key) =>
+			{
+				if (this.hasOwnProperty(key))
+				{
+					this [ key ] = value;
+				}
+			});
+		}
+
+		return this;
+	}
+}

package/publish/types/family_service/typeTableConfiguration.js

@@ -1,33 +1,40 @@
 import { typeAppConfiguration } from "./typeAppConfiguration";
 
 /**
- * Настройки таблиц (aggrid)
+ * Конфигурация одной секции таблицы (набор колонок + поиск).
  *
- * @version			v.0.1 (26/04/2025)
+ * Регистрируется через `registerSection` в `sections/*`.
+ * Потребляется web_app: `useTableConfig` → `ColumnFactory` + `buildSearchPayload`.
+ *
+ * @see docs/App Configuration/table.MD
+ * @version v.0.2 (12/06/2026)
  */
 export class typeTableConfiguration extends typeAppConfiguration
 {
 	/**
-	 * @type {array<typeTableColumn>}
+	 * Список колонок секции.
+	 * @type {import('./typeTableColumn.js').typeTableColumn[]|undefined}
 	 */
 	columns;
 
 	/**
-	 * @type {array<typeFOR>}
+	 * Шаблон объекта поиска (`typeFOR`) для листингов.
+	 * Фильтры с `value: false` гидратируются в web_app через `buildSearchPayload`.
+	 * @type {import('./typeFOR.js').typeFOR|false|undefined}
 	 */
 	for;
 
 
 	/**
-	 * Элемент, в составе
-	 * надо ли
+	 * Тип вложенной сущности для контекстных таблиц (например todo внутри project).
+	 * @type {string|false|undefined}
 	 */
 	contained_element_type;
 
 
 
 	/**
-	 * под развитие
+	 * Ссылки на внешнюю документацию секции (зарезервировано).
 	 * @type {{link: false|string, description: false|string}}
 	 */
 	documentation = {
@@ -37,6 +44,9 @@ export class typeTableConfiguration extends typeAppConfiguration
 
 
 
+	/**
+	 * @param {Partial<typeTableConfiguration>|false} [data=false]
+	 */
 	constructor(data = false)
 	{
 		super();
@@ -53,4 +63,4 @@ export class typeTableConfiguration extends typeAppConfiguration
 
 		return this;
 	}
-}
+}