다크 모드
샘플 룹 관리
정보
샘플 룹은 신규 사용자에게 룹의 사용 사례를 보여주기 위해, 실제 룹을 샘플로 등록하여 노출하는 기능입니다.
동작 규칙
규칙 1: 샘플 룹 등록
- 관리자가 기존 룹의 초대 링크(또는 초대 토큰)를 입력합니다.
- 시스템이 초대 토큰을 검증하고(원본 룹이 존재하며 취소되지 않았는지 확인), 원본 룹 정보(제목, 상태, 참여자 수)를 미리보기로 표시합니다.
- 확인 후 표시 순서, 대상 조건, 활성화 여부를 설정하여 샘플 룹으로 등록합니다.
규칙 2: 대상 조건
샘플 룹이 노출되는 대상을 지정할 수 있습니다.
| 조건 | 설명 |
|---|---|
| 룹 없는 사용자만 | 아직 룹이 없는 신규 사용자에게만 노출 |
| 모든 사용자 | 모든 사용자에게 노출 |
규칙 3: 샘플 룹 목록 관리
- 등록된 샘플 룹 목록을 조회할 수 있습니다.
- 각 샘플 룹의 표시 순서, 대상 조건, 활성화 상태를 수정할 수 있습니다.
- 더 이상 필요 없는 샘플 룹을 삭제할 수 있습니다.
규칙 4: 활성화/비활성화
- 비활성화된 샘플 룹은 사용자에게 노출되지 않습니다.
- 등록 시 기본적으로 활성 상태입니다.
규칙 5: 클라이언트 앱에서의 노출
- 사용자의 룹 목록에서 샘플 룹이 자동으로 표시됩니다.
- 사용자가 참여 중인 룹이 0개일 때, 목록 첫 페이지에 샘플 룹이 추가됩니다.
- 대상 조건이 "모든 사용자"인 샘플 룹은 룹 개수와 무관하게 표시됩니다.
- 샘플 룹에는 구분 표시가 포함되어 일반 룹과 시각적으로 구분됩니다.
- 샘플 룹의 상세 화면은 해당 룹의 참여자가 아니어도 조회할 수 있습니다(대상 조건 충족 시).
규칙 6: 상호작용 차단
- 샘플 룹은 읽기 전용으로, 다음 동작이 모두 차단됩니다:
- 룹 수정
- 룹 삭제
- 미디어 처리
- 포스터 생성
- 초대 링크 생성
- 룹 참여
- 일정 응답
- 차단된 동작을 시도하면 "허용되지 않는 동작" 오류가 표시됩니다.
규칙 7: 중복 등록 불가
- 이미 샘플 룹으로 등록된 원본 룹은 다시 등록할 수 없습니다.
- 중복 등록을 시도하면 충돌 오류가 발생합니다.
사용자 흐름
초대 링크 입력
관리자가 샘플로 등록할 룹의 초대 링크를 붙여넣습니다.
원본 룹 확인
시스템이 초대 토큰을 검증하고, 원본 룹의 제목, 상태, 참여자 수를 미리보기로 표시합니다.
옵션 설정
표시 순서, 대상 조건(룹 없는 사용자만 / 모든 사용자), 활성화 여부를 설정합니다.
등록 완료
샘플 룹이 목록에 추가되고, 조건에 맞는 사용자에게 노출됩니다.
관리
필요에 따라 설정을 수정하거나 삭제합니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 | 관련 PR |
|---|---|---|
| 2026-03-16 | 클라이언트 노출 규칙, 상호작용 차단 규칙, 중복 등록 불가 규칙 추가 | — |
| 2026-03-16 | 최초 작성 | — |