---

[I128-2828] Расширить Flags для системных feature flags и rollout policy

---

НАЧАЛО >> Оглавление >> Общее описание >> История изменений >> Что нового в проекте I128 >> Версия 2026.3 >> [I128-2828] Расширить Flags для системных feature flags и rollout policy📄 Скачать в DOCX

---

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

Компоненты: ИРБИС 128. Модуль Flags - Подсистема флагов

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

1. Цель

Нужно расширить Flags как системный механизм feature flags и rollout policy для промышленных модулей ИРБИС 128. Механизм должен позволять включать функции по инстансу, host, модулю, проекту, роли, пользователю, проценту rollout, canary-группе и окружению.

Tasks, Workflow*, TaskPortal и другие модули не должны заводить собственные частные переключатели. Они должны обращаться к общему Flags contract.

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

• Описать flag definition: key, owner module, purpose, default state, scope, rollout strategy, allowed overrides, expiry/review date, dependencies, kill switch, audit и diagnostic policy.

• Поддержать resolution flag value для UI, API, Workflow*, Queue и публичных страниц с учетом host, project, user, role, environment и canary policy.

• Поддержать staged rollout, canary, emergency disable, dryrun изменения, whereused, affected scope и конфликт overrides.

• Добавить аудит изменения flags: кто, когда, почему и какой affected scope.

• Добавить HealthCheck-проверки expired flags, missing dependencies, unsafe defaults, conflicting overrides и флагов без owner/review.

• Передавать safe signals в Observability и не раскрывать чувствительные детали target audience в публичном контексте.

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

• Flags владеет определением, resolution, audit, rollout policy, expiry и diagnostics feature flags.

• Security владеет правами изменения и видимости flags; HealthCheck диагностирует нарушение policy; доменные модули только объявляют свои flag keys и потребляют результат resolution.

• Feature flag не должен подменять права доступа Security и не должен использоваться для хранения доменной конфигурации workflow-проекта.

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

• Администратор может включить, выключить и ограничить feature flag по допустимым scope.

• Resolution одинаково работает для UI, API, Queue и публичных страниц.

• Default state не меняет старое поведение до явного включения.

• Dry-run показывает affected scope, конфликты и зависимости.

• HealthCheck находит expired flags, missing dependencies и unsafe defaults.

  1. TestA и Help

• TestA должен покрыть resolution, rollout, canary, kill switch, audit, HealthCheck и запрет частных переключателей в Tasks.

• Help должен описать настройку feature flags, rollout policy и диагностику.

-

I128-2828: первый кодовый срез модуля Flags для системных feature flags и rollout policy.

Что сделано:

• модуль Flags переведен на ObjectModule без загрузки БД в PostInit, чтобы сохранить легкий runtime-характер;
• старые файловые операции SetFlag, IsExists, GetFlagData, IsNewer и KillFlag вынесены в __call и сохранены совместимыми;
• добавлен системный JSON-контракт feature flags: scope types, rollout strategies, override levels, decision statuses и системные определения;
• добавлены функции GetSystemFlagDefinitions, NormalizeFlagDefinition, NormalizeFlagContext, ResolveFeatureFlag, PlanFlagChange и HealthCheckFeatureFlagsDefinition;
• добавлены настройки модуля Flags, Helpраздел Flags/FeatureFlags и TestAсценарий Flags.module.featureflagscontract.

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

• Flags владеет registry, resolution, rollout policy, dryrun, audit envelope и локальной диагностикой собственного JSONконтракта;
• Security, HealthCheck, TestA, Observability и доменные модули остаются внешними контрактами;
• Tasks, Workflow*, TaskPortal и AI-срезы только потребляют общий Flags contract и не получают частных переключателей внутри этого PR.

Проверки:

• PHP lint для modules/Flags/api.php, __call/*.inc и Tests/Module.inc;
• JSON parse modules/Flags/system/featureflagscontract.json;
• runtime smoke: legacy SetFlag/GetFlagData/IsExists/KillFlag и ResolveFeatureFlag;
• TestA Flags.module.featureflagscontract: passed 9/9, failed 0;
• Chrome readback: http://irbis128.local/?id=Help/Show&m=Flags/FeatureFlags, HTTP 200, console errors отсутствуют;
• поиск признаков поврежденной кодировки и прямых runtime-вызовов Tasks/TaskPortal/Security/HealthCheck/EventBus/Queue/Observability в modules/Flags.

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

1.1. 🔗 blocks: I128-2833

1.2. 🔗 blocks: I128-2836

1.3. 🔗 blocks: I128-2838

1.4. 🔗 blocks: I128-2840

1.5. 🔗 blocks: I128-2797

1.6. 🔗 blocks: I128-2798

1.7. 🔗 blocks: I128-2799