---

[I128-2825] Расширить FieldConfiguration как реестр полей workflow-проектов

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2825] Расширить FieldConfiguration как реестр полей workflow-проектов📄 Скачать в DOCX

---

Тип	Версия	Статус	Приоритет	Исполнитель
⚙️ Новые возможности	2026.3	🔘 Завершено	Средний	Ilya Mikhaylenko

Компоненты: ИРБИС 128. Модуль FieldConfiguration - Настройки поля

Завершено: 08.09.2026 13:43

1. Цель

Нужно расширить FieldConfiguration как общесистемный source of truth для семантики полей recordbased модулей и workflowпроектов. Код Tasks, WorkflowScreen, WorkflowView, WorkflowFilter и публичных форм не должен зависеть от физических номеров полей и подполей.

FieldConfiguration должен описывать стабильные field keys, типы данных, ввод, отображение, поиск, экспорт, API, подсказки и связь с ws/he3/he2.

1. Состав работ

• Добавить реестр полей для типа записи, проекта и workflow-контекста: stable field key, physical field/subfield binding, тип значения, cardinality, required policy, default policy, input method, display formatter, search/index profile, export/API profile и help hints.

• Поддержать system JSON definitions и copy/customization model для пользовательских проектов.

• Интегрировать field keys с WorkflowScreen, WorkflowView, WorkflowFilter, he3/ws, публичным renderer, API, export и Security field rules.

• Обеспечить diagnostics: missing binding, duplicated key, incompatible type, broken ws/he3 binding, unindexed searchable field, unsafe public field, конфликт system/user override.

• Добавить API получения metadata field registry для UI, API, TestA и HealthCheck.

• Не дублировать права внутри FieldConfiguration: field access decision должен выполняться через Security по общему permission contract.

  1. Границы ответственности

• FieldConfiguration владеет metadata полей и stable field keys.

• Security владеет разрешениями на чтение/изменение полей; WorkflowScreen/WorkflowView используют registry, но не хранят физические номера как source of truth; Tasks хранит только доменные значения в записи.

• he3/ws остаются механизмом редактирования, но получают семантические настройки поля из registry.

  1. Критерии приемки

• Администратор может описать поле через stable key и связать его с физическим полем/подполем записи.

• WorkflowScreen/View/Filter и публичный renderer работают через field keys.

• Изменение физического номера поля требует правки конфигурации, а не кода Tasks или Workflow*.

• HealthCheck находит конфликтные, отсутствующие и небезопасные настройки полей.

• Экспорт и API используют единые field keys и типы данных.

  1. TestA и Help

• TestA должен покрыть resolution field key, ws/he3 binding, Security integration, фильтрацию, API/export metadata, system JSON и HealthCheck diagnostics.

• Help должен описать настройку field registry, типы полей и правила миграции физических полей.

-

I1282825: реализован первый кодовый срез расширения FieldConfiguration как общего реестра полей workflowпроектов. PR не переносит в FieldConfiguration исполнение прав, фильтров, экранов, списков, Workflow-переходов или доменную логику Tasks: модуль хранит и нормализует field metadata, а потребители используют ее через стабильный fieldKey.

Куда смотреть:

• В интерфейсе изменений минимум: расширен редактор записей FieldConfiguration новыми секциями "Реестр поля", "Физическая привязка хранения", "Профиль ввода", "Отображение, поиск, API и права", "Где используется" и "Набор полей".
• Техническая точка: FieldConfiguration теперь дает recordbacked DTO для FieldDefinition и FieldPack, нормализацию JSON/array описаний, разрешение поля по контексту, whereused diagnostics, системный JSON и HealthCheck/TestA-контракт.
• Настройки стенда не требуются; системные seed-описания лежат в modules/FieldConfiguration/system/field*configuration*registry_definitions.json.
• Help: добавлены страницы FieldConfiguration/AdminGuide, FieldConfiguration/DeveloperGuide, FieldConfiguration/Runbook; обновлены Root и Purpose.
• Для PRволны: ветка `feature/I1282825fieldconfiguration-registryсоздана от актуальногоdevelop; PR направлен вdevelop`.

Изменения по файлам:

modules/FieldConfiguration/api.php

• Добавлены ObjectDataFieldConfigurationDefinition и ObjectDataFieldConfigurationPack поверх ObjectDataRecord.
• В FieldConfiguration оставлены системные методы модуля, hooks сохранения и PHPDoc @method для публичных __call-операций.
• Сохранен совместимый legacyexport для существующего he2, но новый registryконтракт не завязан на сериализованные файлы.

modules/FieldConfiguration/__call/*.inc

• Основной код публичных функций вынесен в __call: NormalizeFieldDefinition, NormalizeFieldPack, ResolveFieldDefinition, BuildWhereUsedReport, GetSystemDefinitions, HealthCheckDefinition, ApplyRecordIndexes, RecordToFieldDefinition, RecordToFieldPack, ExportLegacyConfiguration, GetBySid.
• Variables обновлен как редактор legacyполей и нового registryконтракта.

modules/FieldConfiguration/system/field*configuration*registry_definitions.json

• Добавлен системный JSON первого среза: базовые field packs и field definitions для workflow/task контекста.

modules/FieldConfiguration/Formats/brief.pft128

• Исправлена битая кодировка и старый вызов GetSubDField.
• Добавлено краткое отображение для FieldPack и новых fieldKey-описаний.

modules/FieldConfiguration/Tests/Module.inc

• Добавлен TestA safe-read тест FieldConfiguration.module.registry.
• Проверяет нормализацию field definitions, packs, выбор поля по контексту, whereused diagnostics, legacyexport dryrun, системный JSON, HealthCheckописание и owner boundary.

Проверки:

• PHP lint: api.php, все __call/*.inc, Tests/Module.inc, Formats/brief.pft128.
• JSON parse: field*configuration*registry_definitions.json.
• TestA: UseModule('TestA')~~>RunModule('FieldConfiguration', array('levels' => 'safe~~read')) -> 1 passed, 0 failed.
• Owner boundary: в коде FieldConfiguration нет прямых UseModule на Tasks, Workflow*, Security, FieldHistory.
• git diff --check без ошибок.

1. Связанные задачи

1.1. 🔗 blocks: I128-2800

1.2. 🔗 blocks: I128-2830

1.3. 🔗 blocks: I128-2831

1.4. 🔗 blocks: I128-2834

1.5. 🔗 blocks: I128-2838

1.6. 🔗 blocks: I128-2839

1.7. 🔗 blocks: I128-2840

1.8. 🔗 blocks: I128-2790

1.9. 🔗 blocks: I128-2791

1.10. 🔗 blocks: I128-2797

1.11. 🔗 blocks: I128-2798

1.12. 🔗 blocks: I128-2799