﻿---
title: Управление фича-флагами
description: "Панель флагов на Laravel + Filament: состояние флагов по окружениям, процентная раскатка, аварийное отключение, устаревшие флаги и журнал изменений."
---

## Что это за сервис

Панель управления фича-флагами для инженеров, дежурных и продакт-менеджеров. Она показывает, какие флаги существуют, где и на какую долю пользователей включена функциональность, кто отвечает за флаг и когда его пора удалить из кода.

Без панели флаги живут в переменных окружения, конфигах, комментариях в коде и, возможно, в стороннем сервисе, и каноничного состояния нет. Чтобы открыть функцию десяти процентам пользователей, нужен деплой или задача платформенной команде. На вопрос «эта функция включена в ЕС?» три инженера дают три ответа. После запусков копятся забытые флаги и мёртвые ветки кода, а во время инцидента нет быстрого способа выключить флаг сразу везде.

## Что он делает

- **Показывает все флаги по окружениям.** Для каждого флага видно состояние и долю раскатки в каждом окружении, владельца и дату последнего изменения.
- **Меняет раскатку без деплоя.** Процент пользователей, сегменты и включение по окружению меняются в панели, приложение читает новое состояние.
- **Выключает флаг аварийно.** Одно действие отключает флаг во всех окружениях; доступно только ролям с правом и попадает в журнал.
- **Находит устаревшие флаги.** Флаги без изменений дольше заданного срока попадают в список на удаление с владельцем.
- **Отвечает продукту без инженеров.** Продакт-менеджер видит, что где включено, в режиме только для чтения.

## Нюансы и особенности

- **Готовый сервис часто лучше.** LaunchDarkly, Unleash, Flagsmith или GrowthBook дают SDK, сегментацию, эксперименты и отказоустойчивую доставку. Для Laravel есть пакет Laravel Pennant. Если нужны только включение флага и процентная раскатка внутри одного приложения, Pennant с простым экраном управления в Filament закрывает задачу. Собственная панель оправдана, когда флагов много в разных сервисах, а готовый продукт не подходит по цене или требованиям к хранению данных.
- **Панель — это управление, а не вычисление.** Приложение хранит состояние флагов и отдаёт его сервисам; решение «включено ли для этого пользователя» принимает сам сервис. Раздача состояния должна переживать недоступность панели: сервис кеширует последнее известное значение и имеет безопасное значение по умолчанию.
- **Окружение — обязательное измерение.** Плоский глобальный список флагов вводит в заблуждение. Состояние хранится и показывается отдельно для каждого окружения.
- **Каждое изменение — в журнал.** Переключение и смена процента пишутся с автором, временем, прежним и новым значением. Без этого разбор инцидента не ответит, когда именно поменялось поведение.
- **Права различаются по окружениям.** Весь коллектив меняет флаги в разработке и на стейдже, продакшен доступен старшим инженерам и дежурным. Ограничение действует на сервере, скрытая кнопка его не заменяет.
- **Удаление флага — задача в коде.** Панель находит устаревшие флаги, но убрать ветку из кода может только разработчик. Поэтому у флага есть владелец и срок жизни, а список на удаление видит тимлид.
- **Импорт существующих флагов.** Текущие флаги загружают из выгрузки стороннего сервиса, YAML или JSON, а не заводят заново вручную.

## Как сгенерировать через ИИ-агентов

Промпты рассчитаны на AI-агента (Claude Code, Cursor и аналоги) в Laravel-проекте с установленным **Filament 4.x**. Отправляйте их по одному и проверяйте результат перед следующим шагом.

### 1. Данные и модели

```text
Создай модели и миграции для фича-флагов: Flag (ключ, описание, владелец,
тип, планируемая дата удаления), Environment (название, признак
продакшена), FlagState (флаг, окружение, включён, процент раскатки,
сегменты, время изменения), FlagChange (флаг, окружение, поле, старое
и новое значение, автор, время, причина). Пара флаг и окружение
уникальна. Добавь фабрики и импорт флагов из JSON или YAML.
```

### 2. Список флагов и карточка

```text
Сгенерируй Filament-ресурс для Flag. В таблице покажи ключ, владельца,
состояние в каждом окружении компактными значками и дату последнего
изменения; добавь фильтры по окружению, владельцу и «Устаревшие».
В карточке выведи состояния по окружениям с правкой процента раскатки
и журнал FlagChange через relation manager.
```

### 3. Аварийное отключение и журнал

```text
Добавь действие «Выключить везде» с подтверждением и обязательной
причиной: оно выключает флаг во всех окружениях одной транзакцией
и пишет изменения в журнал. Любое изменение состояния флага через панель
тоже пиши в FlagChange с прежним и новым значением.
```

Проверьте, что после аварийного отключения в журнале есть запись по каждому окружению с автором и причиной.

### 4. Отдача состояния сервисам и устаревшие флаги

```text
Сделай защищённый токеном эндпоинт только для чтения, который отдаёт
состояние флагов окружения с версией и поддерживает кеширование
по ETag. Сделай задачу по расписанию, которая помечает флаги
без изменений дольше срока из конфига (по умолчанию 30 дней)
и уведомляет владельца.
```

### 5. Роли

```text
Настрой роли: разработчик меняет флаги в окружениях разработки и стейджа,
старший инженер и дежурный — ещё и в продакшене, продакт-менеджер
видит всё только для чтения. Проверка прав выполняется на сервере
для каждого окружения. Добавь виджет с числом устаревших флагов
по владельцам.
```

## Похожие сценарии

- [Журнал деплоев по окружениям](https://wpcraft.ru/kb/stacks/filament/use-cases/engineering/deployment-tracker.md) — что выкачено, в отличие от того, что включено.
- [Готовность релиза: чек-лист гейтов](https://wpcraft.ru/kb/stacks/filament/use-cases/engineering/release-readiness-checklist.md) — флаги как один из гейтов выпуска.
- [Штаб управления инцидентом](https://wpcraft.ru/kb/stacks/filament/use-cases/engineering/incident-command-center.md) — где нужен аварийный выключатель.

## Материалы и источники

- [Refine: Feature Flag Manager](https://refine.dev/use-cases/engineering/feature-flag-manager/)
- [Laravel Pennant](https://laravel.com/docs/pennant)
- [Filament 4.x: ресурсы](https://filamentphp.com/docs/4.x/resources/overview)
- [Filament 4.x: действия](https://filamentphp.com/docs/4.x/actions/overview)
- [Filament 4.x: импорт](https://filamentphp.com/docs/4.x/actions/import)