> ## 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

# 기능 플래그와 공지

다크로 출시하고, 워크스페이스별로 게이트하고, 멤버에게 브로드캐스트.

## 초보자 연습

전제 조건: 아래 두 개의 초보자 가이드를 읽고, 웹 로컬 설정을 완료하고, 편집기의 루트에서 이 모노레포를 엽니다. 웹 설정은 `apps/web/.env.local`에 속합니다. Next.js는 ​​루트 `.env`를 읽지 않습니다. 기본 가짜 모드의 `/dashboard`는 데이터베이스가 없는 데모입니다. `/auth`에는 마이그레이션된 데이터베이스가 필요합니다.

빠른 용어: 작업 영역은 한 팀의 별도 사용자, 데이터 및 설정입니다. 서버는 신뢰할 수 있는 백엔드입니다. 제공업체 키를 브라우저 및 전화 코드에 보관하세요. 마이그레이션은 테이블을 생성하거나 업데이트하는 버전이 지정된 데이터베이스 변경입니다. AI 모델은 응답하는 엔진입니다. 모델 카탈로그는 서버의 사용 가능한 모델 ID 및 가격 목록입니다. 공급자는 AI, 이메일, 청구 서비스와 같은 외부 서비스입니다. 자격은 작업 영역에서 기능을 사용할 수 있도록 하는 부여입니다. 웹훅은 한 서비스가 다른 서비스의 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/ko/docs/web/before-you-start.md)

[단말기 기본사항](https://supastack.dev/ko/docs/web/terminal-basics.md)

[웹 로컬 설정](https://supastack.dev/ko/docs/web/ship-in-5-minutes.md)

[에이전트 프롬프트 및 프로젝트 메모리](https://supastack.dev/ko/docs/web/agents.md)


## 관리에서 플래그 구성

`/admin/flags` 및 `feature-flags.ts`는 키트의 플래그 관리/평가 경로를 제공합니다. 플래그 구성은 플랫폼 관리자에게 속합니다. 제품 UI는 플래그 변경 권한을 얻지 않고도 허용된 기능에 반응할 수 있습니다.


## 승인을 별도로 유지

플래그는 제품 동작을 활성화하고 역할과 자격은 호출자에게 권한을 부여합니다. 필요한 경우 두 가지를 모두 확인하세요. 비활성화된 탐색 링크는 직접 API 호출을 방해하지 않습니다.


## 활성화 및 비활성화된 동작 확인

기본값, 누락된 플래그, 업데이트, 역할 거부 및 플래그 지정 서버 작업을 테스트합니다. 롤아웃 로직을 추가할 때 작업공간 액세스 확인을 유지합니다.

[플랫폼 역할](https://supastack.dev/ko/docs/web/admin.md)

[유료](https://supastack.dev/ko/docs/web/setup-payments.md)


## 설치 및 설정

feature-flag-runtime은 호출자 컨텍스트에 대해 플래그를 해석합니다: 설정되지 않은 플래그는 기본 off이고, 플래그별 오버라이드는 특정 워크스페이스나 사용자를 대상으로 합니다. 없는 플래그가 조용히 표면을 활성화하는 일은 없습니다.

플랫폼 공지(announcement-actions)는 멤버가 이미 읽는 같은 알림 표면을 통해 인앱 공지를 브로드캐스트합니다 — listActiveAnnouncements가 배너를 공급하고 dismissAnnouncementAction이 닫음을 기록합니다.

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

listActiveAnnouncements()
dismissAnnouncementAction(formData)
```


## 구현 워크플로

코드를 다크로 출시하세요: 플래그 뒤에 머지하고, 자기 워크스페이스에서 활성화한 뒤 넓히세요. 표면이 영구화되면 플래그를 제거하세요 — 오래된 플래그는 두 번째 진실의 원천입니다.

서버 경계와 내비게이션 모두에서 플래그를 확인하세요: 링크를 숨겨도 라우트가 열려 있으면 게이트된 기능이 아닙니다. 공지는 트랜잭셔널 이메일 경로에서 빼세요 — 제품 뉴스지 영수증이 아닙니다.


## 검증 및 문제 해결

비활성 플래그가 내비·라우트·액션을 끝까지 숨기는지, 오버라이드가 대상에게만 해석되는지, 지워진 플래그가 기본값으로 돌아가는지 확인하세요. 공지 전달이 의도된 워크스페이스에 도달하고 닫음이 유지되는지 테스트하세요.


## 다음

[보안과 프라이버시](https://supastack.dev/ko/docs/web/security.md)