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 /ko/docs/web/notifications.md (or send Accept: text/markdown).

알림

인앱 알림, 사용자별 설정, 관리자 공지.

이 가이드에 대해 질문하기

초보자 연습

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

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

1. 테스트 회원으로 로그인하고 설정 → 알림을 열어 사용 가능한 채널 기본 설정을 검토하세요.

2. 하나의 작업 공간에서 두 명의 테스트 멤버를 사용하고 EMAIL_PROVIDER=local를 사용하여 초대와 같은 로컬 테스트 이벤트를 트리거합니다.

3. 자격을 갖춘 회원과 활성화된 채널만 앱이나 로컬 발신함에서 알림을 받는지 확인합니다. 실제 회원에게 테스트 메시지를 보내지 마세요.

사용자 정의 코드의 경우 제공된 prompts/README.md로 시작하고 가장 가까운 프롬프트(앱 화면의 경우 prompts/new-app-screen.md, 공개 페이지의 경우 prompts/new-landing-page.md)를 복사합니다. 서버, 데이터베이스 또는 공급자 작업의 경우 코딩 에이전트에게 이 가이드의 작업을 제공하고 AGENTS.md, .ai/PROJECT_CONTEXT.md 및 일치하는 .ai/ 미러를 읽도록 요청하세요. 여기에 이름이 지정된 정확한 소스 파일을 검사하십시오. 편집하기 전에 파일을 나열하고 확인합니다. 작업 공간 소유권과 서버 전용 비밀을 보존합니다. 차이점을 보여주세요. 원하는 동작, 입력 및 출력 필드, 허용된 역할, 예상되는 성공 및 오류, 테스트 계정, 공급자 또는 장치를 알려주십시오. 샘플 값을 사용하십시오. 절대 진짜 비밀을 붙여넣지 마세요.

제품 이벤트 파이프라인 사용

notification-events.ts는 청구, 예산, 초대, 멤버십 및 연결된 계정 이벤트를 현지화된 사본 및 회원별 전달 계획에 매핑합니다. API 및 앱 클라이언트는 로그인된 작업 영역의 알림을 읽습니다. 기본 설정은 적격 채널을 제어합니다.

일부 이벤트는 의도적으로 앱 내에 유지됩니다. 예를 들어 연결된 계정 새로 고침 실패로 인해 토큰 세부 정보가 노출되거나 원치 않는 이메일이 트리거되어서는 안 됩니다.

수령인 선호도 존중

모든 회원에게 독립적으로 메시지를 보내는 대신 기존 전달 계획, 기본 기본 설정 및 행위자 제외 옵션을 사용하세요. 거래 이메일은 계속해서 구성된 공급자를 사용하며 자체 전달 결과를 기록합니다.

수신자 및 상태 확인

비활성화된 기본 설정, 제외된 행위자, 제거된 멤버, 읽지 않음/읽음 동작 및 다른 작업 영역을 테스트합니다. 동적 업데이트에 대한 액세스를 유지하고 현지화된 메시지를 확인하세요.

설치 및 설정

알림 서비스(notification-service.ts)는 워크스페이스 스코프의 인앱 레코드를 저장합니다. GET /api/notifications가 로그인한 멤버의 목록을 반환하고 mark-read 라우트가 상태를 업데이트합니다. 사용자별 설정 플래그가 제품 업데이트나 보안 경고 같은 카테고리를 제어합니다.

멤버는 /settings/notifications에서 설정을 관리합니다. 플랫폼 공지는 announcement-actions로 작성되어 같은 파이프라인으로 전달됩니다.

GET   /api/notifications
PATCH /api/notifications   (mark-read)

Emitted on mutations, e.g.:
  member.left
  member.role_changed

구현 워크플로

알림은 성공한 뮤테이션 후에 발행하세요 — 쓰기가 커밋되기 전이 아니라. 페이로드를 구조화(타입, 워크스페이스, 참조)해 UI가 산문을 파싱하지 않고 렌더링·라우팅할 수 있게 하세요.

비활성화 가능한 카테고리를 전달하기 전에 설정 플래그를 확인하고, 보안 관련 알림(새 세션, 키 변경)은 필수로 유지하세요.

검증 및 문제 해결

비활성화된 설정이 전달을 억제하는지, mark-read가 세션 간에 유지되는지, 다른 워크스페이스가 레코드를 나열할 수 없는지, 공지가 의도된 멤버에게 도달하는지 확인합니다. 볼륨이 커져도 알림 팬아웃은 요청의 크리티컬 패스 밖에 두세요.

알림