작업 일자: 2026. 02. 18. ~ 02. 23 주요 목표: v3.5 스포츠클럽 모드 도입 이후, 실제 수업 환경(CLASS 모드)에서의 사용성을 극대화하기 위한 대규모 UI 다이어트 및 랭킹 시스템 정교화.

🚀 주요 업데이트 내역 (Changelog)

1. 평가 시스템 밸런스 조정 (Assessment Ranking)

• 명칭 변경: 수행평가 랭킹 ➔ 개인별 스탯 랭킹 (서브 타이틀: 경기 스탯 및 참여도 기반 학생 랭킹 확인)
• 우수 학생 부문 가중치 조정 (더블 카운팅 방지): 득점(1.5➔1점), 서브 에이스(3➔2점), 스파이크/블로킹(2점 유지)
• 노력 학생 부문 가중치 하향 (인플레이션 방지): 노력상(10➔2점), 디그(2➔1점), 리시브/서브In(1.5➔0.5점), 어시스트(1➔0.5점)
• UI 포맷팅: 소수점 첫째 자리(.toFixed(1)) 렌더링 적용.

2. 모드별 맞춤형 UI 분리 (조건부 렌더링 최적화)

• CLASS 모드 시 다음 항목 숨김 처리:
  • 선수 기록 상세 모달: [세트(1,2...)], [전체보기] 탭
  • 선수 기록 분석 탭: [연습 경기], [대회 경기] 필터
  • 상단 탭 메뉴: [전략 메모] 탭 (코칭 로그만 노출)

3. 스코어보드 & 라이브 중계 편의성 개선

• 채팅 제어: mode === 'CLASS' 진입 시 라이브 채팅(isChatEnabled) 기본값을 false로 강제 설정.
• 전광판 복구: CLASS 모드에서도 대회 전광판 모드 토글이 노출되도록 조건 수정.
• 학생 뷰 리액션 보장: isTournamentMode 활성화 시에도 아나운서(학생) 화면의 이모지 버튼(👏🔥🏐) 렌더링 보장.

4. 기타 설정 및 팀 관리 UX

• 베타 팝업 추가: 브라우저 Alert 차단을 우회하기 위해 useEffect와 커스텀 React Modal을 활용한 스포츠클럽 모드 베타 팝업 구축.
• 팀 관리 필터 복구: CLASS 모드에서 4팀제 필터 복구. 팀 색상 중복 경고 Alert 로직 제거.

🎬 트러블슈팅 및 개발 비하인드 (Developer's Note)

• 팀 이름 변경 탭 이벤트 충돌 (Event Swallowing) 및 롤백: 팀 관리에서 탭 이름을 직접 수정하는 기능을 구현하려 했으나, 기존 커스텀 Tab 컴포넌트가 내부적으로 클릭 이벤트를 강제 흡수(Event Swallowing)하여 프롬프트 창 호출 및 상태 업데이트가 무시되는 현상 발생. 억지로 우회 로직을 구성할 경우 UI 일관성이 깨지고 앱 안정성에 리스크가 생길 것으로 판단하여 해당 업데이트는 과감히 롤백함. (교훈: 핵심 기능의 안정성이 최우선)
• 브라우저 팝업 차단 우회 (Custom Modal): 모드 전환 시 window.alert()를 사용했으나, 최신 브라우저 정책상 렌더링 도중 발생하는 Alert가 스팸으로 간주되어 강제 블로킹됨. 이를 해결하기 위해 z-index 최상단의 React 커스텀 모달 컴포넌트를 직접 렌더링하는 방식으로 전환하여 확실한 메시지 전달 및 상용 앱 수준의 UX를 확보함.
• 과도한 조건부 렌더링 부작용 해결: 수업 모드 다이어트 과정 중 !isTournamentMode 등의 조건을 광범위하게 적용하다 보니 학생 조작용 리액션 버튼까지 사라지는 사이드 이펙트 발생. 컴포넌트 트리를 분리하고 렌더링 예외를 확실히 명시하여 기능 복구 완료.