> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Фичефлаги и анонсы

Выкатывайте втёмную, гейтуйте по workspace и рассылайте участникам.

## Прохождение для начинающих

Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат `apps/web/.env.local`; Next.js не читает корень `.env`. `/dashboard` в поддельном режиме по умолчанию представляет собой демонстрацию без базы данных; `/auth` требуется перенесенная база данных.

Вкратце: рабочее пространство — это отдельные пользователи, данные и настройки одной команды. Сервер является доверенным сервером; не допускайте попадания ключей провайдера в код браузера и телефона. Миграция — это изменение версии базы данных, при котором создаются или обновляются таблицы. Модель ИИ — это механизм, который отвечает; Каталог моделей — это список доступных идентификаторов моделей и цен на сервере. Поставщик — это внешняя служба, такая как служба искусственного интеллекта, электронной почты или службы выставления счетов. Право — это грант, который позволяет рабочей области использовать функцию. Вебхук — это сообщение, которое одна служба отправляет на URL другой службы.

1. Войдите в систему как администратор платформы и откройте `/admin/flags`; создайте или выберите один тестовый флаг и явно установите для него значение «включено», а затем отключено.

2. Обновите поверхность продукта, на которой читается флаг, и подтвердите изменения его представления.

3. Роли и права по-прежнему должны защищать действия сервера, когда флаг включен. Если API остается доступным, когда он отключен, добавьте проверку флага на стороне сервера там, где это необходимо.

Для пользовательского кода начните с предоставленного `prompts/README.md` и скопируйте ближайшее приглашение: `prompts/new-app-screen.md` для экрана приложения или `prompts/new-landing-page.md` для общедоступной страницы. Для работы с сервером, базой данных или провайдером дайте своему агенту кодирования задание из этого руководства и попросите его прочитать `AGENTS.md`, `.ai/PROJECT_CONTEXT.md` и соответствующие зеркала `.ai/`; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.

[Прежде чем начать](https://supastack.dev/ru/docs/web/before-you-start.md)

[Основные сведения о терминале](https://supastack.dev/ru/docs/web/terminal-basics.md)

[Локальная веб-настройка](https://supastack.dev/ru/docs/web/ship-in-5-minutes.md)

[Подсказки агента и память проекта](https://supastack.dev/ru/docs/web/agents.md)


## Настройте флаги в администраторе

`/admin/flags` и `feature-flags.ts` обеспечивают путь управления/оценки флагов комплекта. Настройка флага принадлежит администратору платформы; пользовательский интерфейс продукта может реагировать на разрешенную функцию, не получая полномочий на изменение флага.


## Держите авторизацию отдельно

Флаг включает поведение продукта, а роли и права авторизуют вызывающую сторону. Проверьте оба, где это необходимо. Отключенная навигационная ссылка не препятствует прямому вызову API.


## Проверьте включенное и отключенное поведение

Тестируйте настройки по умолчанию, отсутствующие флаги, обновления, отказ в роли и действия сервера с флагами. Сохраняйте проверки доступа к рабочей области при добавлении логики развертывания.

[Роли платформы](https://supastack.dev/ru/docs/web/admin.md)

[Платный доступ](https://supastack.dev/ru/docs/web/setup-payments.md)


## Настройка и конфигурация

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

Платформенные анонсы (announcement-actions) рассылают in-app уведомления через ту же поверхность уведомлений, которую участники уже читают, — listActiveAnnouncements питает баннер, dismissAnnouncementAction фиксирует скрытие.

```
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)

listActiveAnnouncements()
dismissAnnouncementAction(formData)
```


## Рабочий процесс внедрения

Выкатывайте код втёмную: мержите за флагом, включайте для своего workspace, затем расширяйте. Убирайте флаг, когда поверхность становится постоянной, — протухший флаг это второй источник правды.

Проверяйте флаг на серверной границе И в навигации: скрытая ссылка с открытым маршрутом — не гейтированная функция. Держите анонсы вне пути транзакционной почты — это продуктовые новости, а не квитанции.


## Проверка и устранение неполадок

Проверьте, что выключенный флаг скрывает навигацию, маршрут и действие端到端; что переопределение разрешается только для своей цели; и что очищенный флаг возвращается к значению по умолчанию. Тестируйте, что доставка анонсов достигает нужных workspace и что скрытие сохраняется.


## Вперёд

[Безопасность и приватность](https://supastack.dev/ru/docs/web/security.md)