멤버 / 그룹 동기화

멤버 한 명의 정보가 여러 파일에 흩어져 있어, 한 곳만 고치면 조용히 깨진다. (예: dart 카탈로그에만 추가하면 푸시 알림에서 멤버 이름이 안 나온다.)

멤버 추가/수정 시 반드시 함께 고칠 곳

1. lib/controllers/global_controller.dart — honeyzMembers / acaxiaMembers 정적 카탈로그. Member(key, name, group, chzzkBroadcastId, youtubeChannelId).
   • key: Firestore 문서 키이자 shared_preferences 최애 저장 키 (변경 시 기존 최애 데이터 무효화 주의)
   • chzzkBroadcastId: 치지직 채널 ID (라이브 폴링용)
   • youtubeChannelId: UC... 형식 (RSS 피드용)
2. functions/index.js — MEMBER_CATALOG 배열 (key/name/group/ broadcastId). 스케줄 푸시(MEMBER_NAMES는 여기서 파생)와 서버 라이브 폴링([[chzzk-live-polling]])이 함께 쓴다. dart 카탈로그의 key/name/group/ chzzkBroadcastId와 정확히 일치해야 한다. 수정 후 재배포 필요: firebase deploy --only functions.
3. Firestore 데이터 — 멤버 프로필 문서(honeyz/{key} 또는 acaxia/{key})와 스케줄 문서(schedule/{key} 또는 schedule_acaxia/{key}). 콘솔/Admin SDK로 추가. 자세한 스키마는 [[firestore-data]] 참고.
4. 에셋 — 프로필 이미지가 필요하면 assets/honeyz/ 등에 추가하고 pubspec.yaml의 assets 목록 확인.

그룹 자체를 추가할 때 (위 항목 + 아래)

• firestore.rules — 새 그룹의 프로필/스케줄 컬렉션 경로에 allow read: if true; allow write: if false; 규칙 추가. 규칙 없는 경로는 기본 차단된다. 수정 후 배포: firebase deploy --only firestore:rules.
• functions/index.js — GROUP_LABELS 맵과 스케줄 쓰기 트리거 대상 추가.
• global_controller.dart의 membersOf(group) 등 그룹 분기 로직 확인.

검증

수정 후 반드시 [[flutter-check]]로 정적분석/테스트를 돌린다. 멤버 수가 바뀌면 test/global_controller_test.dart, test/youtube_controller_test.dart의 멤버 수·첫 멤버 key 기대값도 함께 갱신해야 한다.