For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/tanstack/feature-flags.md (or send Accept: text/markdown).
Фичефлаги и анонсы
Выкатывайте втёмную, гейтуйте по workspace и рассылайте участникам.
Прохождение для начинающих
Предварительные требования: прочтите два приведенных ниже руководства для начинающих, завершите локальную веб-настройку и откройте этот монорепозиторий в корневой папке вашего редактора. Веб-настройки принадлежат apps/web-tanstack/.env.local; TanStack Start не читает корень .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/; проверьте точные исходные файлы, указанные здесь; список файлов и проверки перед редактированием; сохранять права собственности на рабочую область и секреты, доступные только серверу; и покажу вам разницу. Сообщите ему желаемое поведение, поля ввода и вывода, разрешенные роли, ожидаемые успехи и ошибки, а также тестовую учетную запись, поставщика или устройство. Используйте выборочные значения; никогда не вставляйте настоящий секрет.
Настройте флаги в администраторе
/admin/flags и feature-flags.ts обеспечивают путь управления/оценки флагов комплекта. Настройка флага принадлежит администратору платформы; пользовательский интерфейс продукта может реагировать на разрешенную функцию, не получая полномочий на изменение флага.
Проверьте включенное и отключенное поведение
Тестируйте настройки по умолчанию, отсутствующие флаги, обновления, отказ в роли и защищённые флагами серверные функции. Сохраняйте проверки доступа к рабочей области при добавлении логики развертывания.
Настройка и конфигурация
feature-flag-runtime разрешает флаги для контекста вызывающего: несконфигурированные флаги по умолчанию выключены, а посегментные переопределения целятся в конкретные workspace или пользователей. Отсутствующий флаг никогда не может тихо включить поверхность.
Платформенные анонсы (announcement-actions) рассылают in-app уведомления через ту же поверхность уведомлений, которую участники уже читают, — listActiveAnnouncements питает баннер, dismissAnnouncementAction фиксирует скрытие.
await isFeatureEnabled(flag, { workspaceId })
await resolveFeatureFlags(context)
listActiveAnnouncements()
dismissAnnouncementAction(formData)Рабочий процесс внедрения
Выкатывайте код втёмную: мержите за флагом, включайте для своего workspace, затем расширяйте. Убирайте флаг, когда поверхность становится постоянной, — протухший флаг это второй источник правды.
Проверяйте флаг на серверной границе И в навигации: скрытая ссылка с открытым маршрутом — не гейтированная функция. Держите анонсы вне пути транзакционной почты — это продуктовые новости, а не квитанции.
Проверка и устранение неполадок
Проверьте, что выключенный флаг скрывает навигацию, маршрут и действие端到端; что переопределение разрешается только для своей цели; и что очищенный флаг возвращается к значению по умолчанию. Тестируйте, что доставка анонсов достигает нужных workspace и что скрытие сохраняется.