LogBible - 프로젝트 타임라인

## 수정된 기능
- 3-tier 레이아웃 폭 시스템: narrow(672px) / default(896px) / wide(1152px)
- 기존 max-w-2xl(672px) 기본값 → max-w-4xl(896px)로 확대
- 20개 뷰 파일 정리 (중복 max-w 제거, content_for 통합)

## 변경 파일 (19개)
- layouts/application.html.erb (3-tier 시스템)
- 기본 폭 10개: qt/sessions/5, qt/themes/show, prayer_partners/2, bible_highlights, group_qt_sessions/new
- narrow 4개: settings/show, profiles/show, groups/edit, groups/new
- wide 5개: stats/index, tongtok/index, groups/show, groups/index, attendance_stats/show

## UX/UI 검토 결과
- 전체 평가: 통과
- Minor: attendance_stats/show의 content_for 위치 (기능 영향 없음)

## 테스트/보안 검증 결과
- bin/rails test: 679 runs, 1697 assertions, 0 failures, 0 errors
- 보안: CSS 클래스만 변경, 영향 없음

## 특수 페이지 (변경 없음 확인)
- privacy/terms (max-w-3xl), attendances (max-w-md), group_joins (max-w-lg), tongtok/read (max-w-lg)

## 변경 파일 (8개 수정)\n\n### Narrow 선언 (4개)\n- `app/views/settings/show.html.erb` — max-w-2xl mx-auto px-4 py-8 제거 + narrow 선언\n- `app/views/profiles/show.html.erb` — max-w-2xl mx-auto px-4 py-8 제거 + narrow 선언\n- `app/views/groups/edit.html.erb` — max-w-2xl mx-auto 제거 + narrow 선언\n- `app/views/groups/new.html.erb` — max-w-2xl mx-auto 제거 + narrow 선언\n\n### Wide 선언 (4개, tongtok은 layout-dev가 이미 수정)\n- `app/views/stats/index.html.erb` — wide 선언 추가\n- `app/views/groups/show.html.erb` — max-w-4xl mx-auto 제거 + wide 선언\n- `app/views/groups/index.html.erb` — max-w-4xl mx-auto 제거 + wide 선언\n- `app/views/attendance_stats/show.html.erb` — max-w-4xl mx-auto 제거 + wide 선언\n- (tongtok/index.html.erb — layout-dev가 이미 content_for(:layout_width, 'wide')로 교체 완료)\n\n### 특수 페이지 점검 (5개, 수정 없음)\n- pages/privacy.html.erb — max-w-3xl 유지 ✓\n- pages/terms.html.erb — max-w-3xl 유지 ✓\n- attendances/show.html.erb — max-w-md 유지 ✓\n- group_joins/show.html.erb — max-w-lg 유지 ✓\n- tongtok/read.html.erb — max-w-lg 유지 ✓\n\n## 테스트 결과\n679 runs, 1697 assertions, 0 failures, 0 errors

## 변경 파일 (12개)

### 1단계: 3-tier 레이아웃 시스템
- `app/views/layouts/application.html.erb` — `content_for?(:wide_layout)` 이진 분기 → `content_for(:layout_width)` 3-tier 시스템 (narrow=max-w-2xl, default=max-w-4xl, wide=max-w-6xl)

### 2단계: 기본 폭 뷰 정리 (10개)
- `app/views/qt/sessions/show.html.erb` — `max-w-2xl mx-auto px-4 py-6` 제거
- `app/views/qt/sessions/edit.html.erb` — 동일
- `app/views/qt/sessions/members.html.erb` — 동일
- `app/views/qt/sessions/rankings.html.erb` — 동일
- `app/views/qt/sessions/shared_meditations.html.erb` — 동일
- `app/views/qt/themes/show.html.erb` — 동일
- `app/views/prayer_partners/search.html.erb` — `max-w-2xl mx-auto` 제거
- `app/views/prayer_partners/index.html.erb` — `max-w-2xl mx-auto` 제거
- `app/views/bible_highlights/index.html.erb` — `max-w-2xl mx-auto px-4 py-6` 제거
- `app/views/group_qt_sessions/new.html.erb` — `max-w-2xl mx-auto px-4 py-6` 제거

### 추가: 기존 wide_layout 호환
- `app/views/tongtok/index.html.erb` — `content_for(:wide_layout, true)` → `content_for(:layout_width, 'wide')` 교체

### 미변경
- `app/views/pages/home.html.erb` — `layout "auth"` 사용하여 application 레이아웃과 무관

## 테스트
- 679 runs, 1697 assertions, 0 failures, 0 errors

태스크 #1 완료 확인. narrow 4개 + wide 5개 + 특수 5개 작업 시작.

태스크 #1 (3-tier 레이아웃 시스템 구축) 완료 대기 중. 대상 파일 사전 읽기 진행.

## 작업 계획
- 목표: 모든 페이지에서 일관된 레이아웃 폭, PC에서 적절한 사이즈, 반응형 대응
- 접근 방식: 3-tier 시스템 (narrow/default/wide) 구축 후 20개 뷰 파일 정리

## 팀 구성
- layout-dev: 3-tier 시스템 구축 + 기본 폭 뷰 정리 (12파일)
- width-dev: narrow/wide 선언 + 특수 페이지 점검 (9파일)
- ux-reviewer: 구현 후 디자인 검토
- qa-verifier: 테스트 검증

## 서브 티켓
- 5dd2b4da: 3-tier 시스템 + 기본 폭 정리 (layout-dev)
- 244d8079: narrow/wide 선언 + 특수 점검 (width-dev)

## 완료 내역
- **Phase 1**: application.css @theme - 레거시 토큰 → shadcn 시맨틱 토큰 전환
- **Phase 2**: 공유 파셜 23개 전환 완료
- **Phase 3**: Stimulus 컨트롤러 10개 전환 완료
- **Phase 4**: ERB 일괄 치환 (~80 파일)
- **Phase 5**: 레이아웃 3개 (application, admin, auth) 전환
- **Phase 6**: home.html.erb 전환
- **추가**: admin 사이드바 active 스타일 통일 (border-l → bg-primary 패턴)

## 검증 결과
- 레거시 토큰 잔존: `brand-secondary` 1곳 (사이드바 로고 - 의도적)
- dark: 하드코딩: 0건
- 테스트: 672 runs, 1677 assertions, 0 failures, 0 errors

## 기능 개요
- 통독/QT묵상 양쪽 탭에서 묵상 기록 표시
- 하단 고정 입력 (묵상/적용/기도제목 플래그)
- 성경 읽으면서 중간중간 빠른 기록
- 기분(mood) + 저장 양탭 공통

## 분석 결과
- 영향 범위: today.html.erb, _form.html.erb, tab_controller.js, qt/meditations_controller
- 기존 패턴: tab_controller(세그먼트), autosave, offline_sync, MOOD_EMOJIS peer CSS
- DB 변경 불필요: UserMeditation.qt_content_id는 양탭 공유

## 생성된 티켓
1. 기록 표시 파셜 분리 + 양탭 통합 (high)
2. 하단 고정 입력 UI (high)
3. Stimulus 컨트롤러 quick_input_controller (high)

## 리스크
- 하단 네비(fixed bottom-0) 겹침 → bottom-14 배치
- 모바일 키보드 레이아웃 대응 필요
- 오프라인 동기화 연동 고려

## Phase 1: application.css @theme 재작성
- 기존 brand-primary/surface-*/text-text-* 토큰 → shadcn 시맨틱 토큰 (primary/background/foreground)
- 다크모드 CSS 변수 오버라이드 추가
- 글로벌 타이포: 14px 기본, letter-spacing -0.01em, antialiased
- text-input iOS 줌 방지: max(1rem,...) → max(16px,...)
- 기존 font-scale, safe-area, verse-highlight, animation 유틸리티 모두 유지

## Phase 4: ERB 일괄 치환 (~80파일)
- shared/, layouts/, home.html.erb 제외 전체 ERB sed 치환 완료
- 기존 토큰 잔여 0건, dark: 하드코딩 잔여 0건 확인

## 진행 중
- Agent A: Phase 2 (공유 파셜 23개)
- Agent B: Phase 3 (Stimulus 9개) + Phase 5 (레이아웃 3개) + Phase 6 (home.html.erb)

## 변경 사항

### `app/javascript/controllers/qr_controller.js`
- `filename` value 추가 (기본값: "qrcode")
- `download()` 액션 추가 — canvas를 PNG로 다운로드

### `app/views/groups/show.html.erb`
- 초대 QR: "QR 저장" 다운로드 버튼 추가 + filename value 설정
- 출석 QR: 텍스트 URL → 실제 QR canvas 이미지로 교체 + 링크 복사/QR 저장 버튼
- 출석 현황 섹션에서 중복 URL 텍스트 제거

## 테스트
- groups_controller_test.rb: 14 runs, 41 assertions, 0 failures

## 구현 내용

### 1. QtSession에 group_id 추가
- 마이그레이션: `add_column :qt_sessions, :group_id, :string` + 인덱스
- `QtSession belongs_to :group, optional: true`
- `Group has_many :qt_sessions, dependent: :nullify`

### 2. Group 모델 확장
- `meeting_today?` 메서드: daily/weekly/monthly 반복 주기별 오늘 모임 여부 판정
- `qt_enabled?` 메서드 추가
- `has_many :qt_sessions` 연관 관계

### 3. GroupQtSessionsController (new, create)
- 관리자만 QT 플랜 생성 가능
- 생성 시 모임 active 멤버 전원 자동 `QtParticipant` 생성
- 라우팅: `resources :groups do resources :qt_sessions end`

### 4. AttendancesController#check
- `GET /attend/:token` 출석 체크 엔드포인트
- 멤버 확인, 모임일 확인, 중복 방지
- 지각 자동 판정 (`meeting_time + late_minutes`)

### 5. 뷰 업데이트 (groups/show)
- QT 플랜 목록 표시 (empty_state → 실제 데이터)
- "QT 플랜 생성" 버튼 (관리자만)
- 오늘 출석 현황 표시 (멤버 이름, 체크 시각, 상태 배지)
- 출석 QR URL 표시 (관리자만)

### 6. 테스트
- `test/models/group_test.rb`: meeting_today? 5개 + qt_sessions 연관 1개 (총 27 runs)
- `test/controllers/group_qt_sessions_controller_test.rb`: 7 tests (인증, 권한, CRUD)
- `test/controllers/attendances_controller_test.rb`: 8 tests (인증, 토큰, 멤버, 중복, 지각)

### 수정 파일
- `db/migrate/20260303080000_add_group_id_to_qt_sessions.rb` (신규)
- `app/models/qt_session.rb` (group 연관 추가)
- `app/models/group.rb` (qt_sessions, meeting_today?, qt_enabled?)
- `app/controllers/group_qt_sessions_controller.rb` (신규)
- `app/controllers/attendances_controller.rb` (신규)
- `app/views/group_qt_sessions/new.html.erb` (신규)
- `app/views/groups/show.html.erb` (QT플랜/출석 영역 업데이트)
- `config/routes.rb` (nested qt_sessions route 추가)

### 테스트 결과
657 runs, 1640 assertions, 0 failures, 0 errors

## 변경 사항

### 새 파일
- `app/controllers/attendance_stats_controller.rb` - 출석 통계 컨트롤러
- `app/views/attendance_stats/show.html.erb` - 통계 뷰 (Chart.js 3종 차트)
- `test/controllers/attendance_stats_controller_test.rb` - 컨트롤러 테스트 (10건)

### 수정 파일
- `config/routes.rb` - `resource :attendance_stats, only: [:show]` nested route 추가
- `app/views/groups/show.html.erb` - 관리자용 "통계" 버튼 추가
- `test/fixtures/attendance_records.yml` - 통계 테스트용 fixture 7건 추가

## 구현 내용

### AttendanceStatsController
- `show` 액션: 기간별(week/month/all) 출석 통계 조회
- 권한: 관리자/모임장만 접근 가능
- N+1 방지: SQL GROUP BY로 상태별/일자별/멤버별 집계
- `calculate_member_stats`: 멤버별 출석률, 개근 여부 계산
- `count_meetings_in_range`: recurrence_type별 기간 내 모임일 수 계산

### 뷰 (Chart.js)
- 기간 선택 탭 (이번 주/이번 달/전체)
- 상태별 요약 카드 (출석/지각/결석 수)
- 도넛 차트: 출석/지각/결석 비율
- 라인 차트: 일별 출석 추이
- 바 차트: 멤버별 출석률
- 멤버별 상세 테이블 (개근자 하이라이트)
- 기존 chart_controller.js Stimulus 재사용 (다크모드 자동 대응)
- 데이터 없음 시 empty_state 표시

### 테스트 (10건 전체 통과)
- 비로그인 접근 불가
- 관리자/모임장 접근 가능
- 일반 멤버 접근 불가
- 기간 필터 (week/month/all)
- 상태별 집계 정확성
- 멤버별 통계 테이블 렌더링
- Chart.js 컴포넌트 렌더링

## 전체 테스트 결과
657 runs, 1640 assertions, 0 failures, 0 errors, 0 skips

## 구현 내용

### 1. GroupJoinsController (모임 참여)
- `GET /join/:token` - 모임 소개 페이지 (비멤버만, 이미 멤버면 redirect)
- `POST /join/:token` - 실제 참여 처리 (archived 체크)
- `POST /groups/join_by_code` - 초대코드로 참여

### 2. GroupMembersController (관리자 설정)
- `PATCH /groups/:group_id/members/:id/promote` - 관리자 승격 (creator만)
- `PATCH /groups/:group_id/members/:id/demote` - 일반 멤버 강등 (creator만)
- `DELETE /groups/:group_id/members/:id` - 멤버 내보내기 (creator만, 자신 제외)

### 3. QR 코드
- `config/importmap.rb` - qrcode CDN 추가
- `app/javascript/controllers/qr_controller.js` - Stimulus QR 렌더링 + 링크 복사
- groups/show에 QR 코드 표시 (관리자만)

### 4. 뷰
- `app/views/group_joins/show.html.erb` - 모임 소개 + 참여 버튼
- groups/show.html.erb - QR 코드, 멤버 관리 버튼 (승격/강등/내보내기) 추가
- groups/index.html.erb - 초대코드 입력 폼 추가

### 5. 테스트 (21개 전체 통과)
- `test/controllers/group_joins_controller_test.rb` - 11개 테스트
- `test/controllers/group_members_controller_test.rb` - 10개 테스트

### 파일 목록
- 신규: `app/controllers/group_joins_controller.rb`
- 신규: `app/controllers/group_members_controller.rb`
- 신규: `app/views/group_joins/show.html.erb`
- 신규: `app/javascript/controllers/qr_controller.js`
- 수정: `config/routes.rb` (참여/멤버 관리 라우트 추가)
- 수정: `config/importmap.rb` (qrcode CDN)
- 수정: `app/views/groups/show.html.erb` (QR + 멤버 관리 UI)
- 수정: `app/views/groups/index.html.erb` (초대코드 폼)

## 완료 내용

### 마이그레이션 3개
- `create_groups` (id: :uuid, user_id: uuid FK)
- `create_group_members` (id: :uuid, group_id/user_id: uuid FK)
- `create_attendance_records` (id: :uuid, group_id/group_member_id: uuid FK)

### 모델 3개
- `Group`: belongs_to :creator, has_many :group_members/:attendance_records, token/invite_code 자동 생성, admin?/creator?/member? 메서드
- `GroupMember`: belongs_to :group/:user, ROLES 상수, active scope
- `AttendanceRecord`: belongs_to :group/:group_member, STATUSES 상수

### User 모델 확장
- `has_many :created_groups`, `has_many :group_members`, `has_many :joined_groups`

### GroupsController CRUD
- index/show/new/create/edit/update/destroy
- authorize_member!/authorize_admin!/authorize_creator! 권한 검증
- destroy는 soft delete (status: "archived")

### 뷰 6개
- index (내 모임 + 참여 모임), show (상세 + 멤버 + placeholder), new/edit, _form, _group_card
- 디자인 시스템 파셜 활용 (_button, _card, _empty_state, _badge, _input, _select, _switch, _avatar)

### 사이드바 네비게이션
- "모임" 메뉴 추가 (그룹 아이콘 + /groups 경로)

### 라우팅
- `resources :groups`
- `get "/join/:token"` (group_joins#show)
- `get "/attend/:token"` (attendances#check)

### Fixture + 테스트
- groups.yml (3개), group_members.yml (5개), attendance_records.yml (2개)
- 모델 테스트 38개, 컨트롤러 테스트 14개 = 총 52개 신규 테스트
- **전체: 605 runs, 1460 assertions, 0 failures, 0 errors**

## 확인 결과 (전부 이미 구현됨)

### M7: 기분 이모지 통일 ✅
- `ApplicationHelper`: MOOD_EMOJIS, MOOD_LABELS 상수 정의
- `mood_emoji()`, `mood_emoji_for_average()` 헬퍼 메서드
- 모든 뷰(records, shared_meditations, stats, sermon_card, sermon show)에서 헬퍼 사용 확인
- 하드코딩된 이모지 없음

### H3: 묵상 폼 3섹션 Card 분리 ✅
- `_form.html.erb`: 3개 `shared/_card(outlined)` 분리 완료
- 💡묵상 & 깨달음, 🎯실천 계획, ❤️기도제목
- 각 Card에 개별 공유 Switch 포함

### H7: 콘텐츠 max-w-2xl ✅
- `application.html.erb`: `max-w-2xl mx-auto` 기본 적용
- `content_for?(:wide_layout)` → `max-w-4xl` 예외 처리
- 통독(`tongtok/index.html.erb`)에서 `content_for(:wide_layout, true)` 사용

### M6: 묵상 자동 저장 ✅
- `autosave_controller.js`: localStorage 기반 구현
- key: `autosave_{key_value}`, debounce 500ms
- 페이지 로드 시 restore, 서버 저장 성공 시 clear

### H4: 통계 그래프 확장 ✅
- `stats/index.html.erb`: 6개 지표 카드(총묵상/총통독/완료율/현재스트릭/최대스트릭/평균기분)
- 3개 Chart.js 그래프(월별묵상 Line, 기분추이 Bar, 통독추이 Bar)
- 일별 체크 그리드: 7열 요일, 색상 코딩, 월 선택기

## 테스트 결과
553 runs, 1343 assertions, 0 failures, 0 errors, 0 skips

## 확인 결과 (4항목 모두 이미 구현 완료)

### H1: 기도 페이지 4탭 통합 ✅
- `prayers/index.html.erb`: 4탭 구조 (Today/기도 제목/동역자/통계)
- `prayers_controller.rb`: `partners_tab`, `stats_tab` 액션 구현
- `config/routes.rb`: `partners_tab`, `stats_tab` 라우트 등록
- `tab_controller.js` 활용, Turbo Frame lazy loading 적용

### H2: Today 기도 진행률 ✅
- Today 탭에 "오늘의 기도 X/Y" 진행률 바 (`shared/_progress`)
- 매일 기도 / 요일 기도 섹션 분리
- Controller에 `@daily_prayers`, `@weekly_today_prayers`, `@today_progress` 로직

### H5: CSS 애니메이션 유틸리티 ✅
- `application.css`에 `fade-in`, `slide-up` keyframes
- `.animate-fade-in`, `.animate-slide-up` 유틸리티 클래스

### H6: 하단 네비 스크롤 숨김 ✅
- `scroll_nav_controller.js`: 스크롤 다운→숨김, 스크롤 업→표시
- `_bottom_nav.html.erb`에 `data-controller="scroll-nav"` 연결
- `transition-transform duration-300 ease-in-out` 적용

## 테스트 결과
- prayers_controller_test.rb: 29 runs, 82 assertions, 0 failures
- 전체 테스트: **553 runs, 1343 assertions, 0 failures, 0 errors**

## 확인 결과

이전 에이전트가 작업한 코드가 working directory에 이미 존재하며, 모든 기능이 정상 구현되어 있습니다.

### M5: 네비 블러 강화 ✅
- `_header.html.erb`: `backdrop-blur-md` + `bg-surface-default/95` 적용
- `_bottom_nav.html.erb`: 동일 적용

### M1: 사이드바 접기/펼치기 ✅
- `sidebar_controller.js`: `toggleCollapse()`, localStorage, w-16↔w-60, label/logo/userInfo targets
- `_sidebar.html.erb`: data-action, targets, transition-all duration-300
- `application.html.erb`: md:ml-60 + transition-all duration-300

### M4: 동역자 기도 Dialog ✅
- `prayer_modal_controller.js`: fetch + Turbo Frame 파싱 + 로딩/에러 처리
- `_partner_card.html.erb`: 모달 트리거 버튼 (data-action="click->prayer-modal#open")
- `index.html.erb`: Dialog UI (backdrop + 로딩 스피너 + 콘텐츠)
- `prayer_partners_controller.rb`: `render layout: false if turbo_frame_request?`

### 테스트 결과
553 runs, 1343 assertions, 0 failures, 0 errors

## 완료 항목

### M7: 기분 이모지 통일
- `ApplicationHelper::MOOD_EMOJIS` 상수 정의: {1=>"😢", 2=>"😕", 3=>"😐", 4=>"😊", 5=>"😄"}
- `mood_emoji()`, `mood_emoji_for_average()` 헬퍼 메서드 추가
- 6개 뷰 파일 통일: meditations/_form, sermons/_form, sermons/show, _sermon_card, records/index, shared_meditations

### H3: 묵상 폼 3섹션 Card 분리
- `shared/_card` (outlined) 3개로 분리: 💡묵상&깨달음, 🎯실천계획, ❤️기도제목
- 각 Card에 개별 공유 Switch 추가 (is_personal_meditation_shared 등)
- AI 정리 버튼, 기도 목록 추가 버튼 유지

### H7: 콘텐츠 max-w-2xl 적용
- `application.html.erb`: max-w-5xl → max-w-2xl (기본)
- `content_for(:wide_layout)` 사용 시 max-w-4xl
- 통독 현황에 wide_layout 적용
- sessions/index, themes/index 자체 max-w 중복 제거

### M6: 묵상 자동 저장
- `autosave_controller.js` Stimulus 생성
- localStorage 기반, debounce 500ms
- turbo:submit-end 성공 시 자동 클리어
- 묵상 폼에 연결: key=meditation_{qt_content_id}_{date}

### H4: 통계 그래프 확장
- 5 지표 카드: 총 묵상, 총 통독, 완료율, 현재 스트릭, 최대 스트릭
- 평균 기분 카드 (이모지 통일 적용)
- 3 그래프: 월별 묵상 (Line), 기분 추이 (Bar), 통독 추이 (Bar)
- 일별 체크 그리드: 월 선택, 7열 요일 구조, 색상 코딩

## 테스트 결과
- 모델 224 runs, 452 assertions, 0 failures
- 컨트롤러 282 runs, 774 assertions, 0 failures
- 신규 테스트 4개 추가 (mood-chart, reading-chart, daily-grid, grid_month param)

## 완료된 작업

### H1: 기도 페이지 4탭 통합
- `prayers/index.html.erb` 완전 재작성 → 4탭 구조 (Today/기도 제목/동역자/통계)
- `tab_controller.js` 활용 (hash 기반 URL 탭 전환)
- Today 탭: 매일 기도 + 오늘 요일 기도 분리 표시
- 기도 제목 탭: 기존 전체/매일/주간 필터 유지 (pill 버튼)
- 동역자 탭: Turbo Frame lazy load (`partners_tab` 액션)
- 통계 탭: Turbo Frame lazy load (`stats_tab` 액션)

### H2: Today 기도 진행률
- 진행률 카드 (오늘의 기도 X/Y) + `shared/_progress` 파셜 활용
- PrayersController#index에 today 데이터 로직 추가
- `@daily_prayers`, `@weekly_today_prayers`, `@today_progress` 등

### H5: CSS 애니메이션 유틸리티
- `application.css`에 `@keyframes fade-in`, `slide-up` 추가
- `.animate-fade-in`, `.animate-slide-up` 유틸리티 클래스
- 동역자/통계 탭 콘텐츠에 적용

### H6: 하단 네비 스크롤 숨김
- `scroll_nav_controller.js` 생성 (Stimulus)
- 스크롤 다운 → `translate-y-full` (숨김)
- 스크롤 업 → `translate-y-0` (표시)
- 300ms ease-in-out 트랜지션
- `_bottom_nav.html.erb`에 컨트롤러 연결

## 수정된 파일
- `app/controllers/prayers_controller.rb` - index 확장, partners_tab/stats_tab 액션 추가
- `app/views/prayers/index.html.erb` - 4탭 구조 재작성
- `app/views/prayers/partners_tab.html.erb` - 신규 (Turbo Frame)
- `app/views/prayers/stats_tab.html.erb` - 신규 (Turbo Frame)
- `app/assets/tailwind/application.css` - 애니메이션 추가
- `app/javascript/controllers/scroll_nav_controller.js` - 신규
- `app/views/shared/_bottom_nav.html.erb` - scroll-nav 컨트롤러 연결
- `config/routes.rb` - partners_tab, stats_tab 라우트 추가
- `test/controllers/prayers_controller_test.rb` - 8개 테스트 추가
- `test/fixtures/prayer_requests.yml` - today_weekly_prayer 추가

## 테스트 결과
- 기도 컨트롤러: 29 runs, 82 assertions, 0 failures
- 전체: 549 runs, 1334 assertions, 0 failures, 0 errors

## M5: 네비 블러 강화
- `_header.html.erb`: `backdrop-blur-sm` → `backdrop-blur-md`
- `_bottom_nav.html.erb`: `backdrop-blur-sm` → `backdrop-blur-md`

## M1: 사이드바 접기/펼치기
- `sidebar_controller.js`: 데스크탑 `toggleCollapse()` 추가, localStorage 저장
- `_sidebar.html.erb`: data targets (label, logo, userInfo) 추가, 로고 클릭으로 접기/펼치기, `transition-all duration-300`
- `application.html.erb`: main에 `transition-all duration-300` 추가
- 접힌 상태: `w-16` (아이콘만), 펼친 상태: `w-60` (기존)

## M4: 동역자 기도 Dialog
- `prayer_modal_controller.js`: 새 Stimulus 컨트롤러 (fetch로 Turbo Frame 로딩)
- `prayers.html.erb`: `turbo_frame_tag "partner_prayers_modal"`로 래핑
- `_partner_card.html.erb`: 기도제목 링크 → 모달 버튼으로 변경
- `index.html.erb`: 모달 Dialog UI 추가 (backdrop + 로딩 + 콘텐츠)
- `prayer_partners_controller.rb`: `render layout: false if turbo_frame_request?`

## 추가 수정
- `application.css`: `@keyframes slide-up` 닫는 `}` 누락 수정

## 테스트
- 549 runs, 1334 assertions, 0 failures, 0 errors

## 분석 완료
- sidebar: w-60, sidebar_controller.js (toggle/close만 있음)
- header: backdrop-blur-sm, bg-surface-default/95
- bottom_nav: backdrop-blur-sm, bg-surface-default/95
- modal: shared/_modal (modal_controller.js)
- prayer_partners: prayers 라우트 존재, 별도 페이지

## 구현 순서
1. M5: 네비 블러 강화 (간단)
2. M1: 사이드바 접기/펼치기 (중간)
3. M4: 동역자 기도 Dialog (복잡)

## 분석 완료
- PrayersController: index/new/create/edit/update/destroy/stats/check/import_from_qt
- 기존 테스트 21개 모두 통과
- tab_controller.js: hash 기반 탭 전환 지원 (이것을 활용)
- tabs_controller.js: data-id 기반 탭 전환

## 구현 계획
1. H5: CSS 애니메이션 유틸리티
2. H6: 하단 네비 스크롤 숨김
3. H1+H2: 기도 4탭 통합 + Today 진행률

## 생성된 파일
- `db/migrate/20260303060000_create_active_storage_tables.active_storage.rb` - Active Storage 테이블 (UUID PK)
- `config/initializers/active_storage.rb` - Active Storage UUID 생성 훅
- `app/javascript/controllers/image_preview_controller.js` - Stimulus 이미지 미리보기
- `test/fixtures/files/test.jpg`, `test/txt` - 테스트 파일

## 수정된 파일
- `app/models/user.rb` - has_one_attached :avatar + avatar_url 메서드 + 유효성 검사 (5MB, 이미지 타입)
- `app/controllers/profiles_controller.rb` - :avatar permit + remove_avatar 처리
- `app/views/profiles/show.html.erb` - URL 입력 → 파일 업로드 UI + Stimulus 미리보기
- `app/views/shared/_header.html.erb` - avatar_url 적용
- `app/views/shared/_sidebar.html.erb` - avatar_url 적용
- `app/views/prayer_partners/` (4파일) - avatar_url 적용
- `app/views/qt/sessions/` (4파일: show, members, rankings, shared_meditations) - avatar_url 적용
- `db/structure.sql` - Active Storage 테이블 추가
- `test/models/user_test.rb` - 아바타 테스트 7개 추가
- `test/controllers/profiles_controller_test.rb` - 업로드/삭제/거부 테스트 3개 추가

## 테스트 결과
- 541 runs, 1302 assertions, 0 failures, 0 errors

## 수정된 기능
- **KakaoAlimtalkSender**: Net::HTTP 기반 카카오 알림톡 API 클라이언트 (QT/기도 템플릿, 타임아웃/에러 graceful 처리)
- **NotificationService 통합**: send_all에 kakao 채널 추가 (send_kakao private 메서드)
- **설정 UI 활성화**: 카카오 체크박스 disabled/준비 중 제거, 전화번호 입력 필드 추가
- **Stimulus 토글**: kakao 체크 시 전화번호 필드 표시/숨김
- **SettingsController**: phone 파라미터 처리 (User.phone 컬럼 활용)

## 해결된 문제
- **에이전트 무단 변경 (3회째)**: Active Storage/avatar 관련 변경이 또 추가됨 → 전부 revert
- **user.rb 반복 수정**: 에이전트가 checkout 후에도 다시 수정 → shutdown 요청 후 재 checkout

## 테스트 결과
- 531 runs, 1279 assertions, 0 failures, 0 errors (kakao 테스트 16개 추가)

## 파일 변경 (8개)
- 수정: settings_controller.rb, notification_methods_controller.js, notification_service.rb, settings/show.html.erb, 테스트 2개
- 신규: kakao_alimtalk_sender.rb, kakao_alimtalk_sender_test.rb

## 배포 시 필요
- ENV: KAKAO_ALIMTALK_API_KEY, KAKAO_SENDER_KEY

## 수정된 기능

### 1. CSRF 보호 강화 (CRITICAL)
- `app/controllers/api/bible/highlights_controller.rb`: `skip_before_action :verify_authenticity_token` 제거
- `test/controllers/api/bible/highlights_controller_test.rb`: CSRF 토큰 없는 POST/DELETE 요청 거부 테스트 2개 추가
- 결과: API 엔드포인트가 CSRF 보호를 올바르게 적용

### 2. N+1 쿼리 최적화 (HIGH)
- `app/controllers/qt/sessions_controller.rb`:
- **index**: `includes(:qt_participants)` 추가 → session_card에서 N+1 제거
- **members**: 유저별 개별 쿼리 → SQL 집계 쿼리 1개 (GROUP BY + CASE WHEN)
- **rankings**: 유저별 4개 쿼리 → SQL 집계 쿼리 1개 (4개 통계 한번에)
- 결과: 참여자 수에 관계없이 고정 쿼리 횟수로 실행

### 3. IDOR 접근 제어 (MEDIUM)
- `app/controllers/qt/sessions_controller.rb`:
- `before_action :verify_participant` 추가 (show, shared_meditations, members, rankings)
- `verify_participant` 메서드: 공개 세션은 허용, 비공개 세션은 참여자만 접근
- `select` 액션: 비참여자 접근 차단
- `test/controllers/qt/sessions_controller_test.rb`: IDOR 테스트 10개 추가
- 결과: 비참여자의 비공개 세션 접근 완전 차단

## 테스트 결과
- 관련 테스트: 54 runs, 0 failures, 0 errors (sessions 41 + highlights 13)
- 전체 테스트: 551 runs, 2 failures (PrayerPartners - 별도 작업 관련), 0 errors

## 남은 이슈
- PrayerPartners 테스트 2건 실패: 이전 세션의 프로필 이미지 작업에서 발생, 현재 작업과 무관
- structure.sql: Active Storage 마이그레이션 반영 완료, uuid 타입 수정

## 변경 사항

### 신규 파일
- `app/services/kakao_alimtalk_sender.rb` - 카카오 알림톡 API 클라이언트
- TEMPLATES 상수 (qt_reminder, prayer_reminder)
- Net::HTTP 기반 API 호출
- 타임아웃/에러 graceful 처리
- API 키 미설정 시 안전하게 skip

- `test/services/kakao_alimtalk_sender_test.rb` - 10개 테스트
- API 키 미설정 시 graceful skip
- phone 없을 때 실패 처리
- 성공/실패 응답 mock (FakeResponse 클래스)
- 타임아웃 처리 (OpenTimeout, ReadTimeout)
- request body 구조 검증 (하이픈 제거)

### 수정 파일
- `app/services/notification_service.rb` - send_all에 kakao 채널 추가
- send_kakao private 메서드 추가
- @user.respond_to?(:phone) 안전 체크 (phone 컬럼 미존재 대응)
- KakaoAlimtalkSender 호출 + 결과 변환

- `test/services/notification_service_test.rb` - 3개 테스트 추가
- kakao 활성화 시 결과 포함 확인
- no_phone 반환 확인
- push+email+kakao 전체 채널 동시 동작

## 테스트 결과
- 내 테스트: 19 runs, 46 assertions, 0 failures, 0 errors
- 전체: 551 runs, 1323 assertions, 2 failures (기존 PrayerPartners 이슈)

## 참고
- User 모델에 phone 컬럼 없음 → respond_to? 안전 처리
- ENV[KAKAO_ALIMTALK_API_KEY], ENV[KAKAO_SENDER_KEY] 필요
- UserSetting에 kakao_enabled? 메서드 이미 존재

## 분석 결과\n- ApplicationController: `ActionController::Base` 상속으로 `protect_from_forgery with: :exception` 기본 적용\n- HighlightsController: `skip_before_action :verify_authenticity_token` 없음 (양호)\n- JS (bible_passage_controller.js): `X-CSRF-Token` 헤더 정상 전송 (L405, L411, L436)\n\n## 변경 사항\n- `test/controllers/api/bible/highlights_controller_test.rb`에 CSRF 테스트 2개 추가:\n 1. POST without CSRF token → 422 거부 확인\n 2. DELETE without CSRF token → 422 거부 확인\n- `ActionController::Base.allow_forgery_protection = true`로 forgery protection 활성화하여 검증\n\n## 테스트 결과\n- highlights_controller_test: 13 runs, 25 assertions, 0 failures\n- 전체 테스트: 548 runs, 2 failures (PrayerPartnersControllerTest 기존 실패, 본 변경과 무관)

## 수정 파일
- `app/controllers/qt/sessions_controller.rb`

## 변경 사항 (N+1 제거 3건)

### 1. index 액션 (L7)
- **before**: `includes(:qt_theme, :creator)` - qt_participants 미포함
- **after**: `includes(:qt_theme, :creator, :qt_participants)` - qt_participants 추가
- **효과**: `_session_card.html.erb`의 `session.qt_participants.size`에서 N+1 제거

### 2. members 액션 (L90-99)
- **before**: `@participants.map`에서 각 user별 `user.user_meditations.joins(:qt_content).where(...)` = N+1
- **after**: SQL 집계 1개 쿼리 (`group(:user_id).select("user_id, COUNT(*), COUNT(CASE WHEN ...)")`) + `index_by(&:user_id)`
- **효과**: 참여자 N명 → N+1개 쿼리 → 1개 쿼리로 축소

### 3. rankings 액션 (L140-146)
- **before**: `users.map`에서 각 유저별 meditations/completed/shared/tongtok = N*4+1
- **after**: SQL 집계 1개 쿼리로 4개 통계 한번에 조회 (CASE WHEN 사용)
- **효과**: N*4+1개 쿼리 → 1개 쿼리로 축소

## 테스트 결과
- `bin/rails test test/controllers/qt/sessions_controller_test.rb`
- 41 runs, 125 assertions, **0 failures, 0 errors**

## 변경 파일
- `app/views/settings/show.html.erb` - 카카오 체크박스 활성화, 전화번호 입력 필드 추가
- `app/controllers/settings_controller.rb` - phone 파라미터 처리 (빈 문자열→nil)
- `app/javascript/controllers/notification_methods_controller.js` - kakaoPhone target 추가, 토글 로직
- `test/controllers/settings_controller_test.rb` - 테스트 3개 추가 (kakao 저장, phone 업데이트, phone 비우기)

## 변경 사항
1. 카카오톡 체크박스: `disabled` 제거, `opacity-50` 제거, "준비 중" 배지 제거
2. 전화번호 필드: 카카오 체크 시 표시, `010-0000-0000` placeholder, tel 패턴 검증
3. Stimulus: kakaoPhone target으로 체크박스 연동 토글
4. 컨트롤러: `params[:phone].presence`로 빈 문자열→nil 처리

## 테스트 결과
- 9 runs, 35 assertions, 0 failures, 0 errors

## 수정된 기능

### 1. CSRF 보호 (CRITICAL → 해결)
- `highlights_controller.rb`에서 `skip_before_action :verify_authenticity_token` 제거
- JS(bible_passage_controller.js)는 이미 X-CSRF-Token 헤더 포함 → 추가 수정 불필요

### 2. N+1 쿼리 최적화 (HIGH → 해결)
- index: `.includes(:qt_participants)` 추가
- members: SQL GROUP BY + CASE WHEN 집계 (N+1 → 1 쿼리)
- rankings: SQL GROUP BY + CASE WHEN 집계 (N*4+1 → 1 쿼리)

### 3. IDOR 접근 제어 (MEDIUM → 해결)
- `verify_participant` before_action 추가 (show, shared_meditations, members, rankings)
- select 액션 참여자 검증 추가
- 테스트 8개 추가

## 테스트 결과
- 전체: 533 runs, 1279 assertions, 0 failures
- 기존 2 errors: ProfilesControllerTest fixture 누락 (기존 이슈, 본 작업과 무관)

## 남은 이슈
- ProfilesControllerTest fixture 파일 누락 에러 (별도 처리 필요)

## 현황 확인
- working tree에 N+1 최적화 코드가 이미 적용되어 있음
- git diff 확인 완료: index, members, rankings 3건 모두 SQL 집계 쿼리로 전환됨

## 변경 내용 확인
1. **index**: `includes(:qt_participants)` 추가
2. **members**: `user.user_meditations` N+1 → `group(:user_id).select(...)` SQL 집계
3. **rankings**: 유저별 4개 쿼리 → SQL 집계 1개 쿼리 (CASE WHEN)

## 다음 단계
- 테스트 실행하여 기존 테스트 통과 확인

## A. N+1 쿼리 최적화
- `app/controllers/qt/sessions_controller.rb`
- index: `.includes(:qt_participants)` 추가 → _session_card COUNT 쿼리 제거
- members: 참가자별 N+1 → SQL GROUP BY + CASE WHEN 집계 1쿼리 (N+1 → 1)
- rankings: 유저별 N*4+1 → SQL GROUP BY + CASE WHEN 집계 1쿼리 (N*4+1 → 1)

## B. IDOR 접근 제어
- `verify_participant` before_action 추가 (show, shared_meditations, members, rankings)
- 공개 세션: 누구나 접근 허용
- 비공개 세션: 참여자만 접근, 비참여자 리다이렉트
- select 액션: 비참여자 세션 전환 차단

## 테스트
- 8개 테스트 추가 (IDOR 접근 제어 검증)
- 전체: 533 runs, 1279 assertions, 0 failures

ApplicationController, highlights_controller, 기존 테스트 분석 후 CSRF 거부 테스트 추가 예정

## 작업 계획
- `app/services/kakao_alimtalk_sender.rb` 생성
- `app/services/notification_service.rb`에 kakao 채널 통합
- 테스트 작성 (kakao_alimtalk_sender_test.rb + notification_service_test.rb 수정)
- TDD 기반 구현

## 작업 계획
- 목표: CSRF 보호 강화 + N+1 쿼리 제거 + IDOR 접근 제어
- 접근 방식: 3개 서브 티켓으로 분해, 에이전트 팀 병렬 처리

## 코드 분석 결과
### CSRF (api/bible/highlights_controller.rb)
- skip_before_action 없음, 하지만 명시적 CSRF 검증도 없음
- JS(bible_passage_controller.js)에서 이미 X-CSRF-Token 전송 중
- 테스트에서 CSRF 검증 추가 필요

### N+1 (qt/sessions_controller.rb)
- members 액션 (L89-100): participants.map → user.user_meditations 쿼리 = N+1
- rankings 액션 (L111-139): users.map → 각 유저별 4개 쿼리 = N*4+1
- _session_card.html.erb:5: session.qt_participants.size = N+1 (index에서)

### IDOR (qt/sessions_controller.rb)
- set_session (L201-203): QtSession.find(params[:id]) → 무조건 조회
- select (L194-197): 참여자 확인 없이 current_session_id 설정

## 현재 상태
- 보드 현황: todo 5 / in_progress 1 / review 2 / done 121

## 변경 사항
- `app/controllers/api/bible/highlights_controller.rb` - `skip_before_action :verify_authenticity_token` 제거

## JS 확인
- `app/javascript/controllers/bible_passage_controller.js`에서 이미 모든 POST/DELETE에 X-CSRF-Token 헤더 포함
- selectColor() (L405), removeHighlight() (L436)
- JS 수정 불필요

## 테스트
- highlights 테스트: 11 runs, 23 assertions, 0 failures
- 전체: 515 runs, 1235 assertions, 0 failures, 0 errors

## 작업 계획
- 목표: NotificationService에 카카오 알림톡 채널 추가, CRON은 이미 구현됨
- 접근 방식: 2명 에이전트 (백엔드 + 프론트엔드) 분담

## 현재 알림 시스템 구조
- NotificationService: push/email 2채널 → kakao 추가 예정
- NotificationCronJob: 매시간 실행, 시간 일치 사용자에게 알림
- UserSetting: notification_methods "push,email,kakao" 콤마 구분, kakao_enabled? 메서드 존재
- Settings UI: 카카오 체크박스 비활성 ("준비 중") → 활성화 필요

## 구현 전략
1. KakaoAlimtalkSender 서비스 (Net::HTTP 기반 API 클라이언트)
2. NotificationService.send_kakao 메서드 추가
3. 환경변수: KAKAO_ALIMTALK_API_KEY, KAKAO_SENDER_KEY
4. Settings UI 카카오 체크박스 활성화
5. 테스트 (API mock 기반)

## 현재 상태
- 보드 현황: backlog 0 / todo 4 / in_progress 1 / review 2 / done 121

## 작업 계획
- 목표: 리뷰에서 발견된 CRITICAL CSRF, HIGH N+1, MEDIUM IDOR 3건 일괄 수정
- 접근 방식: 파일별 분리하여 2명 에이전트 병렬 처리

## 팀 구성
- csrf-fixer: highlights_controller.rb + JS CSRF 토큰 (파일 충돌 없음)
- sessions-fixer: sessions_controller.rb N+1 + IDOR (동일 파일이므로 1명이 통합 처리)

## 현재 상태
- 보드 현황: backlog 0 / todo 3 / in_progress 3 / review 0 / done 96

## 수정된 기능
- **IndexedDB 오프라인 저장**: `offline_store.js` - logbible-offline DB, pending_meditations store
- **Stimulus 오프라인 동기화**: `offline_sync_controller.js` - 온/오프라인 감지, 폼 가로채기, 자동 동기화
- **Service Worker 캐시**: QT 페이지 Network First 캐시 (qt-pages-v1)
- **Sync API**: `POST /qt/meditations/sync` - 배치 처리, 충돌 해결(서버 우선), 접근 권한 검증
- **오프라인 UI**: 오프라인 배너, 동기화 대기 상태 표시

## 해결된 문제
- **에이전트 무단 변경**: 프로필 이미지 업로드(Active Storage) 기능이 무단 추가됨 → 전부 revert
- **API 포맷 불일치**: 프론트엔드 singular → 백엔드 plural array → 배치 요청으로 통일
- **structure.sql 손상**: 빈 파일로 변경됨 → git checkout HEAD 복구
- **테스트 DB 재생성**: UUID 타입 유지를 위한 2-pass 방식 적용

## 테스트 결과
- 515 runs, 1235 assertions, 0 failures, 0 errors (sync 테스트 7개 추가)

## 파일 변경 (9개)
- 수정: meditations_controller.rb, service-worker.js, _form.html.erb, today.html.erb, importmap.rb, routes.rb, meditations_controller_test.rb
- 신규: offline_sync_controller.js, offline_store.js

## 변경 사항

### 1. 라우트 추가 (`config/routes.rb`)
- `POST /qt/meditations/sync` collection 라우트 추가

### 2. Sync 액션 (`app/controllers/qt/meditations_controller.rb`)
- `sync` 액션 추가 (기존 create/update/organize 미수정)
- `skip_before_action :verify_authenticity_token, only: :sync` (JSON API용)
- 접근 권한 검증: `accessible_content_ids` - User의 활성 참여 세션의 qt_content만 허용
- 충돌 해결: server updated_at > client created_at이면 conflict 반환 (서버 우선)
- JSON 응답: `{ results: [{ qt_content_id, status: "synced"|"conflict"|"error", ... }] }`

### 3. 테스트 (7개 추가)
- 인증 필수 확인
- 새 묵상 생성 (synced)
- 기존 묵상 업데이트 (no conflict → synced)
- 충돌 처리 (server wins → conflict + server_data)
- 접근 불가 qt_content → error
- 빈 배열 → empty results
- 배치 처리 (2개 동시)

### 4. 테스트 결과
- 525 runs, 1258 assertions, 0 failures, 0 errors (기존 1 error는 ProfilesController Active Storage 관련 기존 이슈)

## 변경 사항

### 새 파일
- `app/javascript/lib/offline_store.js` - IndexedDB 래퍼 모듈 (logbible-offline DB, pending_meditations store)
- `app/javascript/controllers/offline_sync_controller.js` - 오프라인 동기화 Stimulus 컨트롤러

### 수정 파일
- `app/views/pwa/service-worker.js` - QT 페이지 Network First 캐시 전략 추가 (qt-pages-v1 캐시)
- `app/views/qt/meditations/_form.html.erb` - offline-sync 컨트롤러 연동, 오프라인 폼 제출 가로채기
- `app/views/qt/today.html.erb` - 오프라인 배너 UI 추가 (amber 색상, 동기화 대기 건수 표시)
- `config/importmap.rb` - lib/ 디렉토리 pin 추가

### 기능
- IndexedDB에 오프라인 묵상 자동 저장
- 온라인 복귀 시 POST /qt/meditations/sync로 자동 동기화
- QT today/day 페이지 Network First 캐시 (오프라인에서도 캐시된 페이지 열람)
- 오프라인 상태 배너 + 동기화 대기 건수 표시

### 테스트
- QT 관련 테스트 62개 전체 통과 (sync 테스트 5개는 백엔드 구현 대기)

## 작업 계획
- 목표: 오프라인에서 묵상 기록 작성/저장, 온라인 복귀 시 자동 동기화
- 접근 방식: 2명 에이전트 (프론트엔드 + 백엔드) 분담

## 구현 전략
1. IndexedDB 래퍼 + offline_sync Stimulus 컨트롤러
2. Service Worker 캐시 확장 (QT 콘텐츠 페이지)
3. 백엔드 sync API 엔드포인트 + 충돌 해결
4. 오프라인 상태 표시 UI

## 현재 상태
- 보드 현황: backlog 0 / todo 5 / in_progress 2 / review 2 / done 118
- 관련 기존 작업: PWA 기반 완료 (Service Worker, 푸시 알림, PWA Install Prompt)

## 작업 계획
- 목표: Active Storage 기반 프로필 이미지 업로드 + 미리보기 UI
- 접근 방식: Active Storage 설치 → User avatar 연결 → UI/Stimulus → 테스트

## 현재 상태 분석
- Active Storage: 미설치 (blobs/attachments 테이블 없음)
- image_processing gem: Gemfile에 이미 존재
- User.profile_image: OAuth URL 저장 (text 컬럼)
- Avatar 파셜: src URL 또는 이니셜 fallback
- 프로필 편집: URL 텍스트 입력 방식

## 서브 티켓 계획
1. Active Storage 설치 + User avatar + avatar_url 헬퍼 + 컨트롤러/뷰 + Stimulus 미리보기 + 테스트

## 리뷰 결과
- 상태: **전체 승인** (7개 서브 티켓 done)
- 리뷰어: code-reviewer (코드 품질), security-reviewer (보안)

## 코드 품질 요약
- Critical: 0건
- High: 3건 (N+1 쿼리 - members/rankings/session_card)
- Medium: 8건 (중복 로직, SRP, 디자인 토큰 불일치 등)
- Low: 5건

## 보안 요약
- CRITICAL: 1건 (API CSRF 비활성화 - highlights_controller, 별도 티켓)
- MEDIUM: 2건 (세션 IDOR, select 참여자 미확인)
- LOW: 1건 (초대코드 노출)
- 안전: XSS, SQL Injection, Mass Assignment, 인증, CSRF(일반)

## 후속 티켓 생성
1. `5cb8bfeb` API CSRF 보호 수정 (critical)
2. `62b323d8` QT 세션 N+1 쿼리 최적화 (high)
3. `134e7895` QT 세션 IDOR 접근 제어 (medium)

## 완료된 부모 티켓
- Phase 0+1 (a9055c68) → done
- QT 테마 브라우즈+구독 (ca4ecb1e) → done
- QT today 탭 분리 (a73d80d0) → done

## 변경 사항
- `app/controllers/bible_highlights_controller.rb` 생성 - index/edit/update/destroy CRUD
- `app/views/bible_highlights/index.html.erb` 생성 - 성경별 그룹핑 + 필터(성경/색상)
- `app/views/bible_highlights/_highlight_item.html.erb` 생성 - Turbo Frame 아이템 (색상 배경, 노트, 편집/삭제)
- `app/views/bible_highlights/edit.html.erb` 생성 - Turbo Frame 노트 편집 폼
- `app/models/bible_highlight.rb` - ABBREV_TO_NAME 매핑 + COLOR_STYLES 상수 추가
- `config/routes.rb` - `/bible/highlights` 라우트 추가

## 테스트
- 11개 테스트 추가: index, 필터, update, destroy, 인증
- 전체 508 runs, 0 failures, 0 errors

## 변경 사항
- `app/controllers/qt/sessions_controller.rb` - 공개 세션 목록 쿼리 + max_participants 제한 로직
- `app/views/qt/sessions/index.html.erb` - "공개 플랜" 3번째 탭 추가
- `app/views/qt/sessions/_session_card.html.erb` - 참여 버튼 + 참여자 수 표시 + 마감 배지

## 테스트
- 3개 테스트 추가: 공개 탭 표시, max_participants 거부, 정상 참여
- 전체 508 runs, 0 failures, 0 errors

## 생성된 파일
- `app/services/ai_prayer_analyzer.rb` - AI 기도 분석 서비스 (AiSermonInterpreter 패턴)
- `db/migrate/20260303043923_add_ai_analysis_to_prayer_requests.rb` - ai_analysis 컬럼 추가
- `test/services/ai_prayer_analyzer_test.rb` - 서비스 테스트 6개
- `app/views/prayers/analyze.turbo_stream.erb` - Turbo Stream 응답
- `app/views/prayers/_ai_analysis.html.erb` - AI 분석 결과 파셜
- `app/views/prayers/_ai_error.html.erb` - 에러 표시 파셜

## 수정된 파일
- `app/controllers/prayers_controller.rb` - analyze 액션 추가
- `config/routes.rb` - post :analyze 라우트 추가
- `app/views/prayers/_prayer_card.html.erb` - AI 분석 영역 통합
- `test/controllers/prayers_controller_test.rb` - analyze 테스트 4개 추가
- `db/structure.sql` - 마이그레이션 반영

## 접근 방식
- SermonsController#interpret + AiSermonInterpreter 패턴 동일 적용
- Turbo Stream으로 비동기 AI 분석 결과 표시
- prayer_card에 인라인 AI 분석 영역 통합
- mock client injection 패턴으로 테스트

## 테스트 결과
- 31 runs, 70 assertions, 0 failures, 0 errors

## 변경 사항

### 1. app/controllers/qt/sessions_controller.rb
- `index` 액션에 `@public_sessions` 추가: 내가 참여하지 않은 공개 활성 세션 조회
- `join` 액션에 `max_participants` 체크 추가: 인원 초과 시 거부 메시지

### 2. app/views/qt/sessions/index.html.erb
- 탭 구조 수정: `shared/_tabs` 파셜 대신 인라인 탭 (콘텐츠 패널이 컨트롤러 내부에 위치하도록 수정 → 탭 전환 정상 동작)
- "공개 플랜" 탭 추가 (3번째 탭)
- 공개 플랜 empty state UI 추가

### 3. app/views/qt/sessions/_session_card.html.erb
- `show_join: false` 로컬 변수 추가
- 공개 세션 카드: "참여하기" 링크 (invite 페이지로 이동)
- max_participants 표시: "N/M명 참여" 형식
- 인원 마감 시 "마감" 뱃지 + 참여 버튼 숨김
- 공개 세션 카드에 description 표시

### 4. test/fixtures/qt_sessions.yml
- `public_other_session`: 공개 활성 세션 (max_participants: 5)
- `full_session`: 인원 마감 세션 (max_participants: 1)

### 5. test/fixtures/qt_participants.yml
- `google_public_other`: google_user가 public_other_session 참여자
- `google_full`: google_user가 full_session 참여자

### 6. test/controllers/qt/sessions_controller_test.rb
- `test "index shows public sessions tab"`: 공개 플랜 탭 렌더링 확인
- `test "index excludes own sessions from public tab"`: 내 세션 제외 확인
- `test "join rejects when max_participants reached"`: 인원 초과 거부 확인

## 테스트 결과
- 세션 컨트롤러 테스트: 33 runs, 98 assertions, **0 failures, 0 errors**
- 전체 테스트: 기존 실패 (PrayerPartners FK, QtController, SQLite FK) 외 신규 실패 없음

## 변경 사항

### 수정 파일
- `app/models/bible_highlight.rb` — ABBREV_TO_NAME(66권 영문약어→한글), COLOR_STYLES, COLORS 상수 + `book_name`, `color_style` 인스턴스 메서드 추가
- `config/routes.rb` — `resources :bible_highlights, only: [:index, :edit, :update, :destroy], path: "bible/highlights"` 추가

### 생성 파일
- `app/controllers/bible_highlights_controller.rb` — index(필터+그룹핑), edit(Turbo Frame), update(Turbo Stream+HTML), destroy(Turbo Stream+HTML)
- `app/views/bible_highlights/index.html.erb` — 성경/색상 필터, 성경별 그룹핑 목록, 빈 상태
- `app/views/bible_highlights/_highlight_item.html.erb` — turbo_frame_tag, 색상 배경, 노트 미리보기, 편집/삭제 버튼
- `app/views/bible_highlights/edit.html.erb` — turbo_frame_tag 안 노트 편집 폼
- `test/controllers/bible_highlights_controller_test.rb` — 11 tests, 23 assertions (모두 통과)

### 테스트 결과
- 내 테스트: 11 runs, 23 assertions, 0 failures, 0 errors
- 전체 테스트: 기존 4 failures, 3 errors 유지 (내 변경과 무관)

### 기능
- `/bible/highlights` — 내 하이라이트 전체 목록
- 성경별/색상별 필터 (GET params)
- 노트 인라인 편집 (Turbo Frame)
- 삭제 확인 + Turbo Stream 제거
- 다크모드 대응, 디자인 시스템 파셜 사용 (shared/button, shared/empty_state)
- 인증 필수 + 타인 하이라이트 접근 차단 (404)

## 작업 시작
- 태스크 claim 완료
- 기존 코드 분석 시작 (모델, API 컨트롤러, 라우트, 디자인 시스템 파셜)

## 작업 시작
- 기존 파일 분석 완료: controller, view, test, fixtures
- 구현 계획: index에 @public_sessions 추가, 탭 추가, join에 max_participants 체크

## 작업 계획
- 목표: AiPrayerAnalyzer 서비스 구현 + Turbo Stream UI로 기도제목 AI 분석 기능 추가
- 접근 방식: 기존 AI 서비스 패턴(AiMeditationAnalyzer, AiSermonInterpreter) 참고하여 2개 서브 티켓으로 분해

## 분석 결과
- 기존 AI 서비스 3개 패턴 분석 완료 (initialize+call, mock client injection)
- PrayersController 구조 파악 (index, new, create, edit, update, destroy, stats, import_from_qt, check)
- PrayerRequest 모델 스키마 확인 (category, response_type, visibility 등)
- Turbo Stream 패턴 확인 (SermonNote 해석 참고)

## 서브 티켓 계획
1. AiPrayerAnalyzer 서비스 + 마이그레이션 + 테스트
2. 기도 AI 분석 UI (컨트롤러 액션 + Turbo Stream + 뷰)

## 작업 계획
- 목표: 공개 세션 탐색/참여 기능 완성 + 하이라이트 관리 페이지 신규 구현
- 접근 방식: 2명의 에이전트가 병렬로 작업 (파일 충돌 없음)

## 현재 상태
- 보드 현황: backlog 0 / todo 6 / in_progress 7 / review 7 / done 96
- 공개 세션: invite/join 액션 존재, is_public/max_participants 컬럼 존재, 공개 탐색 탭 미구현
- 하이라이트: 모델 + API + Stimulus 완료, 관리 페이지 미구현

## 수정된 기능
- **월 선택 드롭다운**: 세션 시작월~현재까지 월 목록 (최신순), select로 특정 월 랭킹 조회
- **본인 순위 하이라이트**: brand-primary/10 배경 + ring + "나" 뱃지 (shared/badge :info)
- **다크모드 대응**: top-3 amber 배경 dark:bg-amber-900/20, 본인 배경 dark:bg-brand-primary/20
- **빈 상태 개선**: shared/empty_state 파셜 사용 (score 0도 빈 상태 처리)
- **테스트 추가**: 특정 월 조회 + 잘못된 월 fallback 테스트 (2건)

## 수정 파일 (3개)
- `app/controllers/qt/sessions_controller.rb` - rankings 액션에 @selected_month, @available_months 추가
- `app/views/qt/sessions/rankings.html.erb` - 전체 교체 (월 선택, 본인 하이라이트, 다크모드, empty_state)
- `test/controllers/qt/sessions_controller_test.rb` - 테스트 2건 추가

## 테스트 결과
- 494 runs, 1177 assertions, 0 failures, 0 errors (492→494, +2)

## 남은 이슈
- 없음

## 작업 계획
- 목표: 랭킹 UI 미세 조정 (월 선택, 뱃지, 본인 하이라이트, 빈 상태)
- 접근 방식: 단일 에이전트로 컨트롤러+뷰+테스트 한꺼번에 처리

## 현재 상태 분석
- 컨트롤러: period="all"/"month" 필터 존재, 특정 월 선택 미지원
- 뷰: 🥇🥈🥉 메달 있으나 다크모드 미대응, 본인 하이라이트 없음, empty_state 미사용
- 테스트: 기본 3개 (get/month/redirect)

## 변경 필요사항
1. 컨트롤러: month 파라미터로 특정 월 조회 (예: ?month=2026-02)
2. 뷰: 월 선택 드롭다운, 다크모드 뱃지, 본인 하이라이트, empty_state 파셜
3. 테스트: 특정 월 조회, 본인 하이라이트 검증

## 수정된 기능
- **Chart.js 기반 설정**: importmap.rb에 Chart.js 4.4.7 CDN pin + chart_controller.js Stimulus 컨트롤러 (line/bar/pie/doughnut 지원, 다크모드, 반응형)
- **묵상 통계 라인 차트**: stats/index.html.erb - HTML 막대 그래프 → Chart.js 라인 차트 교체 (월별 묵상 추이)
- **기도 통계 도넛 차트**: prayers/stats.html.erb - 응답 현황 도넛 차트 추가 (계속 기도/대기/응답yes/응답no)
- **통독 월별 트렌드**: tongtok_controller.rb에 @monthly_reading 추가 + tongtok/index.html.erb에 바 차트 추가

## 수정/생성 파일 (5개)
- `config/importmap.rb` - Chart.js CDN pin 추가
- `app/javascript/controllers/chart_controller.js` - 신규 생성
- `app/views/stats/index.html.erb` - 라인 차트 교체
- `app/views/prayers/stats.html.erb` - 도넛 차트 추가
- `app/controllers/tongtok_controller.rb` - @monthly_reading 추가
- `app/views/tongtok/index.html.erb` - 바 차트 추가

## 테스트 결과
- 492 runs, 1175 assertions, 0 failures, 0 errors

## 팀 구성
- chart-foundation: 기반 설정 (importmap + Stimulus)
- chart-meditation: 묵상 라인 차트
- chart-prayer-tongtok: 기도 도넛 + 통독 바 차트

## 남은 이슈
- 없음

## 변경 사항

### 1. app/views/prayers/stats.html.erb
- 응답 현황 카드에 도넛(doughnut) 차트 추가
- 데이터: keep_praying, waiting, yes, no 4개 카테고리
- 색상: indigo, amber, emerald, red
- cutout 60%로 도넛 스타일
- 데이터가 0인 경우 차트 미표시
- 기존 텍스트 통계 카드 유지

### 2. app/controllers/tongtok_controller.rb
- index 액션에 `@monthly_reading` 변수 추가
- 최근 6개월간 월별 읽은 장 수 집계
- SQLite strftime 함수 사용

### 3. app/views/tongtok/index.html.erb
- 전체 진행률 카드 아래에 "월별 읽기 추이" 바 차트 추가
- borderRadius: 6으로 둥근 모서리
- 데이터 없을 때 빈 상태 메시지 표시

## 테스트 결과
- `bin/rails test` 전체: 492 runs, 0 failures (SQLite lock 에러 11개는 기존 이슈)
- 관련 컨트롤러 테스트: 31 runs, 82 assertions, 0 failures, 0 errors

## 변경 사항\n- `app/views/stats/index.html.erb` 수정\n - 기존 HTML 막대 그래프 (lines 58-74) → Chart.js 라인 차트로 교체\n - `data-controller="chart"`, `data-chart-type-value="line"` 사용\n - 라인 차트 스타일: indigo (#4f46e5), fill area, tension 0.4, point radius 4\n - 데이터 없을 때 빈 상태 메시지 표시\n - `data-testid="monthly-chart"` 유지 (기존 테스트 호환)\n\n## 유지한 항목\n- 핵심 지표 카드 4개 (총 묵상, 완료율, 현재 스트릭, 최대 스트릭)\n- 평균 기분 카드\n- "묵상 기록 보기" 버튼\n\n## 차트 데이터 구조\n- labels: @monthly_data의 label 키 (03월 형식)\n- datasets: 묵상 횟수 데이터 (count 키)\n\n## 테스트 결과\n- `bin/rails test test/controllers/stats_controller_test.rb`: 8 runs, 17 assertions, 0 failures, 0 errors

## 구현 계획
- `app/views/prayers/stats.html.erb`: 응답 현황 카드에 도넛 차트 추가
- `app/controllers/tongtok_controller.rb`: @monthly_reading 데이터 추가
- `app/views/tongtok/index.html.erb`: 월별 트렌드 바 차트 추가

## chart_controller.js 확인 완료
- type/data/options values 지원
- canvas target 사용
- 다크모드 자동 대응

## 작업 시작\n- 티켓 claim 완료\n- stats/index.html.erb 분석 후 월별 묵상 추이 섹션을 Chart.js 라인 차트로 교체 예정

## 변경 사항

### 수정 파일: config/importmap.rb
- Chart.js 4.4.7 CDN pin 추가 (jsdelivr)

### 신규 파일: app/javascript/controllers/chart_controller.js
- Stimulus 컨트롤러로 범용 차트 렌더링
- static values: type(line/bar/pie/doughnut), data(Object), options(Object)
- static targets: canvas
- 다크모드 자동 감지 (prefers-color-scheme) + 실시간 전환
- 모바일 반응형 (aspectRatio: 640px 미만 1.5, 이상 2)
- Cartesian(line/bar) 차트에 scales 자동 설정
- deepMerge로 사용자 옵션 오버라이드 지원
- disconnect() 시 Chart 인스턴스 + observer 정리

## 테스트 결과
- 492 runs, 1175 assertions, 0 failures, 0 errors

## 작업 시작
- config/importmap.rb 읽기 완료
- 기존 Stimulus 컨트롤러 19개 확인
- chart_controller.js 신규 생성 예정

## 작업 계획
- 목표: 묵상/기도/통독 통계를 Chart.js 차트로 시각화
- 접근 방식: 3단계 분해 (기반 설정 → 묵상 차트 + 기도/통독 차트 병렬)

## 분석 결과
- 현재 통계 3개 페이지: stats/index (묵상), prayers/stats (기도), tongtok/index (통독)
- 컨트롤러에서 이미 통계 데이터 준비 중 (monthly_data, prayer_stats, books_data)
- 묵상 통계에 순수 HTML 막대 그래프 존재 → Chart.js 라인 차트로 교체
- 기도/통독은 텍스트 기반 → 차트 추가

## 서브 티켓 계획
1. Chart.js 설정 + chart_controller Stimulus (기반)
2. 묵상 통계 라인 차트 (기반 의존)
3. 기도 파이/바 차트 + 통독 트렌드 차트 (기반 의존)

## 현재 상태
- 보드 현황: backlog 0 / todo 18 / in_progress 4 / review 7 / done 86

## 수정된 기능
- **탭 UI**: today 페이지에 [통독] / [QT] 탭 추가 (tab_controller.js Stimulus)
- **통독 탭**: bible_passage 제목 + YouTube 오디오 + 성경 본문 + 통독 완료 체크
- **QT 탭**: reading_passage(또는 bible_passage 대체) + YouTube 오디오 + 성경 본문 + 묵상 + 질문 + 폼
- **통독 체크**: 장별 토글 버튼으로 BibleReadingLog 저장/삭제 (Turbo Stream)
- **세션 스위처**: 다중 세션 참여 시 드롭다운으로 세션 전환

## 생성/수정 파일 (6개)
- `app/javascript/controllers/tab_controller.js` (신규) - URL hash 기반 탭 전환
- `app/views/qt/today.html.erb` (재구성) - 탭 구조 + 세션 스위처
- `app/controllers/qt_controller.rb` (수정) - load_reading_data, parse_bible_passage, toggle_reading
- `app/views/qt/_reading_check.html.erb` (신규) - 통독 체크 파셜
- `config/routes.rb` (수정) - toggle_reading 라우트
- `test/controllers/qt_controller_test.rb` (수정) - 6개 테스트 추가

## 테스트 결과
- 468 runs, 1125 assertions, 0 failures, 0 errors (QT 관련)
- 기존 PrayerPartners 실패 2개는 무관

## 에이전트 배정
- tab-dev: 탭 UI + today.html.erb 재구성
- reading-dev: 통독 체크 백엔드 + 파셜

## 생성/수정 파일
- `config/routes.rb` - qt 네임스페이스에 themes 리소스 추가 (index, show, subscribe)
- `app/controllers/qt/themes_controller.rb` - 신규 생성 (index: 추천/일반 분류, show: 상세+미리보기, subscribe: 세션 생성)
- `app/views/qt/themes/index.html.erb` - 테마 목록 (추천/일반 섹션, 카드 그리드)
- `app/views/qt/themes/show.html.erb` - 테마 상세 (정보, 콘텐츠 미리보기, CTA)
- `app/views/qt/themes/_theme_card.html.erb` - 테마 카드 파셜
- `test/controllers/qt/themes_controller_test.rb` - 8개 테스트 케이스

## 테스트 결과
- DB 락 없을 때 7/8 통과 확인 (1개는 동시 접근 이슈)
- users 테이블 id 타입 문제로 fixture 로딩 실패 → schema-dev 해결 필요

## 기능
1. **index**: active 테마를 추천(is_default)/일반으로 분류, 카드 그리드
2. **show**: 테마 정보 + 콘텐츠 미리보기(3개) + 구독 CTA (중복 방지)
3. **subscribe**: QtSession + QtParticipant 생성, 중복 구독 방지

## 변경 사항

### 수정된 파일
- `app/controllers/qt_controller.rb` - `load_reading_data`, `parse_bible_passage`, `toggle_reading` 액션 추가
- `config/routes.rb` - `post "qt/toggle_reading"` 라우트 추가
- `test/controllers/qt_controller_test.rb` - toggle_reading 및 reading data 테스트 6개 추가

### 생성된 파일
- `app/views/qt/_reading_check.html.erb` - 통독 체크 파셜 (turbo-frame 기반)

## 주요 기능

### parse_bible_passage 지원 형식
- `"창세기 1장"` → 단일 장
- `"에베소서 1-2장"` → 장 범위
- `"창세기 1:1-31"` → 절 참조에서 장 추출
- `"누가복음 19장, 마태복음 21장, 마가복음 11장"` → 멀티 도서
- `"사도행전 2:1-4, 37-41"` → 절 범위 내 쉼표 처리
- `"다니엘 1-3장"` → 장 범위
- `"시편 23편"` → 편 단위

### toggle_reading 액션
- POST `/qt/toggle_reading` - 통독 완료/취소 토글
- turbo_stream 응답으로 reading_check 프레임만 업데이트
- html fallback으로 redirect_back 지원

### _reading_check 파셜
- `reading_passage` 우선 사용, 없으면 `bible_passage` fallback
- BibleReadingLog 기반 읽은 장 체크 표시
- 완료/미완료 badge + 체크 아이콘
- 디자인 시스템 공유 파셜 활용 (shared/card, shared/badge)

## 테스트
- 14 runs, 32 assertions, 0 failures, 0 errors

## 완료 사항

### 마이그레이션
- `db/migrate/20260302150005_remove_duplicate_columns_from_users.rb` 생성
- users 테이블에서 3개 중복 컬럼 제거:
- `notification_enabled` (boolean) - user_settings에 존재
- `notification_time` (integer) - user_settings에 존재
- `current_session_id` (string) - user_settings에 존재

### 수정 파일
- `test/fixtures/users.yml` - users fixture에서 `notification_enabled`, `notification_time` 제거
- `db/structure.sql` - Ruby로 수동 덤프 (sqlite3 CLI 미설치로 자동 덤프 실패)

### 테스트 결과
- 관련 테스트 39건 전체 통과 (0 failures, 0 errors)
- UserTest: 11 tests
- UserSettingTest: 8 tests
- SettingsControllerTest: 6 tests
- NotificationCronJobTest: 3 tests
- QtSessionsControllerTest 등

### 참고
- UUID PK 소실 없이 정상 마이그레이션 완료
- sqlite3 CLI가 PATH에 없어 db:schema:dump 실패 → Ruby로 structure.sql 수동 덤프
- 전체 테스트 시 다른 에이전트 동시 실행으로 SQLite BusyException 발생하지만, 단독 실행 시 0 failures

## 구현 완료 사항

### 1. QT 세션 edit/update
- `config/routes.rb`: sessions에 `:edit, :update` 추가
- `app/controllers/qt/sessions_controller.rb`:
- `before_action :set_session`에 `:edit, :update` 추가
- `edit` 액션: creator 권한 체크, @themes 로드
- `update` 액션: creator 권한 체크, 성공 시 redirect, 실패 시 422
- `app/views/qt/sessions/_form.html.erb`: new.html.erb에서 폼 파셜 추출 (재사용 가능)
- `app/views/qt/sessions/new.html.erb`: _form 파셜 렌더링으로 교체
- `app/views/qt/sessions/edit.html.erb`: 신규 생성, "플랜 수정" 제목
- `app/views/qt/sessions/show.html.erb`: creator일 때 "수정" 버튼 추가

### 2. QT 세션 스위처 UI
- `app/controllers/qt_controller.rb`: today/day 액션에 `@user_sessions` 추가
- `app/views/qt/today.html.erb`: 상단에 dropdown_controller 활용한 세션 스위처
- 현재 세션 하이라이트 (체크 아이콘)
- 다른 세션 클릭 시 POST /qt/sessions/:id/select로 전환
- 1개만 있을 때는 스위처 숨김

### 3. QT 빈 상태 안내
- `app/views/qt/no_session.html.erb`: 메시지 업데이트
- title: "참여 중인 플랜이 없습니다"
- description: 테마 둘러보기 + 초대코드 안내
- action: "플랜 둘러보기" → qt_sessions_path

### 테스트 (5개 추가)
- `test_edit_renders_form_for_creator` ✅
- `test_edit_redirects_non-creator` ✅
- `test_update_session_with_valid_params` ✅
- `test_update_non-creator_redirects` ✅
- `test_update_with_invalid_params_renders_edit` ✅

> ⚠️ SQLite DB 잠금 이슈: 다른 에이전트와 동시 테스트 실행 시 BusyException 발생. 단독 실행 시 모든 테스트 통과.

## 변경 사항

### 1. 라우트 (config/routes.rb)
- `namespace :qt` 안에 `resources :themes, only: [:index, :show]` 추가
- `member { post :subscribe }` 추가

### 2. 컨트롤러 (app/controllers/qt/themes_controller.rb)
- `index`: `@default_themes` (is_default: true) + `@themes` (is_default: false) 분리
- `show`: active 테마만 find, contents 미리보기 3개, 기존 세션 중복 체크
- `subscribe`: 중복 방지, QtSession + QtParticipant 생성
- `set_theme` private 메서드로 active scope 적용 (inactive → 404)

### 3. 테스트 (test/controllers/qt/themes_controller_test.rb)
- 8개 테스트, 29개 assertions, 0 failures
- 인증 (비로그인 → redirect) 3개
- index (active 테마만 표시) 1개
- show (active 표시 + inactive 404) 2개
- subscribe (생성 + 중복 방지) 2개

### 참고
- 기존 뷰 파일 (index.html.erb, show.html.erb, _theme_card.html.erb) 활용
- 기존 컨트롤러를 팀리드 스펙에 맞게 업데이트
- SQLite BusyException은 다른 에이전트 동시 실행으로 인한 일시적 문제

## 변경 사항

### 신규 파일
- `app/javascript/controllers/tab_controller.js` - 통독/QT 탭 전환 Stimulus 컨트롤러 (URL hash 지원, defaultTab value)

### 수정 파일
- `app/views/qt/today.html.erb` - 통독/QT 탭 구조로 재구성

## 주요 변경 내용

### tab_controller.js
- `tab`, `panel` targets 사용
- `defaultTab` value (기본: "tongtok")
- URL hash로 탭 상태 유지 (#tongtok, #qt)
- 활성 탭: `text-brand-primary`, `border-brand-primary`, `border-b-2`, `font-semibold`
- 비활성 탭: `text-text-muted`

### today.html.erb 재구성
- **통독 탭**: bible_passage 제목 카드, YouTube 플레이어, 성경 본문 (bible-passage controller), 통독 완료 체크 turbo-frame (reading_check)
- **QT 탭**: reading_passage (없으면 bible_passage 대체) 제목 카드, YouTube 플레이어, 성경 본문, 묵상 내용, 묵상 질문, 묵상 기록 폼 (turbo-frame)
- 세션 스위처, 상단 테마 카드, 일차 네비게이션은 탭 외부에 유지
- `turbo-frame id="reading_check"` 빈 프레임으로 두되 `@reading_chapters` 있을 때만 _reading_check 렌더링

## 테스트
- QT 컨트롤러 테스트: 8 runs, 13 assertions, 0 failures

## 작업 계획
- 목표: 성경 하이라이트 기능 (모델 + API + Stimulus UI) 구현
- 접근 방식: 백엔드(모델+API) → 프론트엔드(Stimulus) 순서로 2명 에이전트 팀 구성

## 분석 결과
- bible_passage_controller.js (303줄) - 이미 10가지 구절 포맷 파싱 + 절 렌더링 구현됨
- /public/data/bible/books/{abbrev}.json - 66권 성경 JSON 데이터
- API namespace 미존재 → 새로 생성 필요
- UUID PK 패턴: ApplicationRecord.set_uuid

## 현재 상태
- 보드 현황: backlog 0 / todo 19 / in_progress 3 / review 0 / done 84

## 생성된 파일

- `app/views/qt/themes/_theme_card.html.erb` - 테마 카드 파셜
- `app/views/qt/themes/index.html.erb` - 테마 목록 (추천/전체 섹션)
- `app/views/qt/themes/show.html.erb` - 테마 상세 (정보, 콘텐츠 미리보기, 구독 버튼)

## 사용된 디자인 시스템

- `shared/card` (padding: :md)
- `shared/badge` (variant: :info, AI 뱃지)
- `shared/button` (variant: :primary, tag: :a)
- `shared/empty_state`
- `shared/separator`
- `button_to` (구독 액션)

## 디자인 토큰

- text-text-primary/secondary/muted, text-brand-primary
- text-heading/subheading/body/small/caption
- bg-surface-default, text-status-warning
- grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3
- line-clamp-2, hover:shadow-md transition-shadow

## 작업 범위
- 라우트 추가 (qt 네임스페이스에 themes)
- Qt::ThemesController 생성 (index/show/subscribe)
- 뷰 생성 (index.html.erb, show.html.erb)
- 테스트 생성 (themes_controller_test.rb)

## 작업 범위
1. QT 세션 edit/update 액션 구현
2. QT 세션 스위처 UI
3. QT 빈 상태 안내

## 시작 단계
- 기존 코드 구조 파악
- routes.rb, sessions_controller, views 확인

## 작업 계획
- 목표: today 페이지를 통독 탭 / QT 탭으로 분리
- 접근 방식: 2명 에이전트 병렬 작업
- tab-dev: tab_controller.js 생성 + today.html.erb 탭 구조 재편
- reading-dev: QtController에 BibleReadingLog 데이터 로드 + 통독 체크 파셜 + Turbo Frame

## 현재 상태
- 보드 현황: backlog 0 / todo 19 / in_progress 1 / review 0 / done 84
- 관련 기존 작업: bible_passage_controller.js (성경 본문 렌더링), BibleReadingsController (통독 체크)

## 작업 대상
- users 테이블에서 user_settings와 중복되는 3개 컬럼 제거:
- `notification_enabled` (boolean)
- `notification_time` (integer)
- `current_session_id` (string)

## 진행 순서
1. 코드에서 직접 참조 확인 (Grep)
2. 마이그레이션 생성 및 실행
3. 전체 테스트 통과 확인

## 작업 계획
- 목표: /qt/themes (테마 카드 목록) + /qt/themes/:id (상세+구독) 구현
- 접근 방식: 2명 팀원으로 분할 (백엔드/프론트엔드)

## 코드베이스 분석
- Qt::ThemesController 미존재 → 신규 생성 필요
- routes: qt namespace에 themes 미등록
- QtTheme.active 스코프 존재, QtSession에 invite_code 자동생성 로직 존재
- Subscribe = QtSession 생성 + QtParticipant 등록 (creator role)
- 기존 패턴: Qt::SessionsController 참고

## 서브 태스크
1. theme-backend: routes + controller(index/show/subscribe) + tests
2. theme-views: index/show 뷰 + _theme_card 파셜

## 작업 계획
- 목표: 스키마 중복 정리(Phase 0) + QT 기능 5개(Phase 1) 동시 진행
- 접근 방식: 3명 에이전트 팀 (schema-dev, session-dev, theme-dev)
- 스키마 정리와 QT 기능은 영향 범위가 겹치지 않아 병렬 진행 가능

## 에이전트 배정
- **schema-dev**: 스키마 중복 정리 (users 테이블 3개 컬럼 제거)
- **session-dev**: QT 세션 수정/편집 + 세션 스위처 UI + 빈 상태 안내
- **theme-dev**: QT 테마 브라우즈 + 테마 상세/구독

## 현재 상태
- 보드 현황: backlog 0 / todo 12 / in_progress 1 / review 0 / done 84

## 배포 정보
- 배포 시각: 2026-03-02 19:35
- 배포 환경: production (167.172.82.126)
- 소요 시간: 87.8초

## 포함된 커밋
- `5cf8816` feat: Design system redesign, media player, Bible passage viewer, and auth improvements
- `1a51321` fix: Update Docker image path with GitHub username for ghcr.io

## 변경된 기능
- YouTube 오디오 플레이어 (QT 본문 + 통독하기)
- 디자인 시스템 재설계 (22 파셜, Tailwind CSS v4)
- 성경 본문 뷰어 (66권 JSON 데이터)
- 인증 레이아웃 개선 (Devise → 자체 auth)

## 배포 이슈 해결
- Docker credsStore 제거 (desktop.exe → WSL2 비호환)
- ghcr.io 이미지 경로 수정 (logbible → daniel-kim-9way/logbible)

## 기능 개요
- Service Worker + IndexedDB 기반 오프라인 묵상 저장/동기화

## 분석 결과
- 영향 범위: public/service-worker.js, app/javascript/, views/qt/meditations/
- 기존 패턴: PWA Service Worker(Cache First + Network First) 이미 구현됨
- Background Sync API 활용 가능

## Phase 정보
- **Phase 3** - 가장 후순위
- 복잡도: complex (~4 파일)

## 리스크
- Background Sync API 브라우저 지원 제한적
- 오프라인 ↔ 온라인 충돌 해결 로직 복잡

## 기능 개요
- Active Storage 기반 사용자 프로필 이미지 업로드

## 분석 결과
- 영향 범위: models/user.rb, controllers/profiles_controller.rb, views/profiles/, helpers/
- 기존 패턴: profile_image 컬럼(OAuth URL) 존재 → avatar 우선순위 처리 필요

## Phase 정보
- **Phase 3** - 후순위
- 복잡도: moderate (~6 파일)

## 기능 개요
- 이미 구현된 월별 랭킹 UI 완성

## 분석 결과
- 영향 범위: qt/sessions_controller.rb (rankings), views/qt/sessions/rankings.html.erb
- 기존 패턴: 전체/이번달 period 필터 이미 존재 → 미세 조정만 필요
- **발견**: 기능이 이미 거의 완성되어 있음

## Phase 정보
- **Phase 2** - 가장 작은 작업량
- 복잡도: simple (~2 파일)

## 기능 개요
- 묵상/기도/통독 통계 Chart.js 시각화

## 분석 결과
- 영향 범위: views/qt/stats/, views/prayers/, views/tongtok/, config/importmap.rb
- 기존 패턴: Importmap 기반 JS 의존성, Stimulus 컨트롤러

## Phase 정보
- **Phase 2** - 기도 AI와 병렬 가능
- 복잡도: moderate (~5 파일)

## 기능 개요
- AiPrayerAnalyzer 서비스로 기도 패턴/감정 분석

## 분석 결과
- 영향 범위: services/, controllers/prayers_controller.rb, views/prayers/
- 기존 패턴: AiMeditationAnalyzer, AiSermonInterpreter 동일 패턴 재사용
- ruby-openai gem + Turbo Stream 비동기 UI 패턴 확립됨

## Phase 정보
- **Phase 2** - Phase 1 완료 후
- 복잡도: moderate (~7 파일)

## 기능 개요
- NotificationService에 카카오 알림톡 채널 추가, CRON 스케줄링

## 분석 결과
- 영향 범위: services/, jobs/, models/user_setting.rb, config/recurring.yml
- 기존 패턴: NotificationService.send_all 디스패치, kakao_enabled? 이미 존재
- config/recurring.yml에 hourly job 설정 완료

## Phase 정보
- **Phase 1** - QT 세션 수정과 병렬 진행 가능
- 복잡도: complex (~8 파일)

## 리스크
- 카카오 비즈니스 API 계정/템플릿 사전 준비 필요
- 알림톡 발송 비용 발생

## 기능 개요
- QT 세션 edit/update 액션 추가 (현재 생성만 가능)

## 분석 결과
- 영향 범위: qt/sessions_controller.rb, qt/sessions/ views, routes.rb
- 기존 패턴: resources :sessions 이미 존재 → edit/update 라우트 자동 포함
- new.html.erb 폼을 _form 파셜로 분리하면 재활용 가능

## Phase 정보
- **Phase 1** - 스키마 정리 후 병렬 진행 가능
- 복잡도: simple (~5 파일)

## 기능 개요
- users 테이블의 user_settings와 중복되는 3개 컬럼 제거

## 분석 결과
- 영향 범위: db/migrate/, app/models/user.rb, db/structure.sql
- 기존 패턴: 모든 코드가 user_settings 테이블 사용 확인
- users.notification_enabled, users.notification_time, users.current_session_id → 미사용

## Phase 정보
- **Phase 0 (선행 필수)** - 다른 기능 구현 전 스키마 정리 선행
- 복잡도: moderate (~6 파일)

## 리스크
- SQLite remove_column 시 테이블 재생성 → uuid 타입 소실 주의
- 프로덕션 배포 시 마이그레이션 순서 확인 필요

## 수정된 기능

### MP-1: YouTube Audio Player + QT 통합
- `app/javascript/controllers/youtube_player_controller.js` 생성 - YouTube Iframe API Stimulus 컨트롤러
- 66권 한글 약어/전체 이름 매핑, 10가지 구절 형식 파싱
- 재생/일시정지, 프로그레스 바, 재생속도(0.5x~2.0x), 음소거
- `bible-youtube-urls.json` fetch + 캐싱
- `app/views/shared/_youtube_player.html.erb` 생성 - 재사용 가능한 파셜 (locals: passage, title)
- `app/views/qt/today.html.erb` 수정 - 성경 구절 아래에 오디오 플레이어 삽입

### MP-2: 통독하기 미디어 플레이 통합
- `app/javascript/controllers/tongtok_player_controller.js` 생성 - 통독 전용 플레이어
- 듣기 토글, 장 선택 재생, 연속 재생 (다음 장 자동)
- 동적 innerHTML 플레이어 UI 렌더링
- `app/views/tongtok/_book_card.html.erb` 수정 - 듣기 버튼 + 플레이어 영역 추가

## 테스트 결과
- 446 runs, 1062 assertions, 0 errors
- 기존 실패 2건 (PrayerPartnersControllerTest) - 본 변경과 무관

## 발견된 패턴
- YouTube Iframe API 글로벌 로딩은 Promise 캐싱으로 중복 방지
- Stimulus에서 동적 innerHTML UI + data-action 바인딩 패턴 활용

## 남은 이슈
- 없음

## 상태 확인
- `tongtok_player_controller.js` 존재 확인 (14868 bytes)
- `_book_card.html.erb` 수정 완료 확인
- 테스트: 0 failures (DB lock errors는 병렬 실행으로 인한 SQLite 잠금 - 코드 문제 아님)
- 이전 독립 실행 시 24 runs, 72 assertions, 0 failures, 0 errors

## 변경 사항

### 1. 신규 생성
- `app/javascript/controllers/tongtok_player_controller.js` - 통독 페이지 전용 YouTube 오디오 플레이어 Stimulus 컨트롤러
- YouTube API 직접 제어 (youtube_player_controller.js 패턴 재사용)
- values: `bookName` (String), `totalChapters` (Number)
- targets: `playerArea`, `chapterList`, `playerContainer`, `autoPlayToggle`, `toggleBtn`
- 기능: 듣기 토글, 장 선택 재생, 연속 재생 (autoplay next chapter), 재생/일시정지/탐색/배속/음소거
- innerHTML로 플레이어 UI 동적 렌더링

### 2. 수정
- `app/views/tongtok/_book_card.html.erb`
- 카드를 `data-controller="tongtok-player"`로 감쌈
- 헤더에 듣기 토글 버튼 추가 (헤드폰 SVG 아이콘)
- 장 그리드 아래 플레이어 영역 추가 (기본 hidden)
- 가로 스크롤 장 선택 버튼
- 플레이어 컨테이너 (동적 렌더링)
- 연속 재생 체크박스 토글
- **기존 읽음/안읽음 button_to 토글 완전 보존**

### 3. 디자인
- 듣기 토글: `text-text-secondary hover:text-brand-primary` 활성 시 `text-brand-primary`
- 선택된 장: `bg-brand-primary text-white`
- 플레이어: `bg-surface-subtle rounded-xl p-3` (youtube_player 파셜과 동일)
- 모바일 우선 (가로 스크롤 장 선택)

### 4. 테스트 결과
- 446 runs, 1062 assertions, 0 errors
- 기존 실패 2건 (`PrayerPartnersControllerTest`) - 본 변경과 무관

## 작업 계획
- `tongtok_player_controller.js` Stimulus 컨트롤러 생성
- `_book_card.html.erb` 수정 (듣기 토글 + 플레이어 영역 추가)
- YouTube API 직접 제어 방식 사용 (youtube_player_controller 패턴 복사)
- 연속 재생 기능 포함

## 수정된 기능

### DATE-1: 한국 시간대 설정 (timezone-dev)
- `config/application.rb`: `config.time_zone = "Asia/Seoul"` 설정
- `session_form_controller.js`: `new Date()` UTC 파싱 → 직접 파싱으로 수정
- `test/configuration/timezone_test.rb` (신규): 시간대 테스트 4개

### DATE-2: 달력 날짜 선택 컴포넌트 (팀리드)
- `app/javascript/controllers/datepicker_controller.js` (신규): Stimulus 달력 컨트롤러
- 한국어 요일/월 표시
- 달력 팝오버 토글, 월 이동
- 오늘/선택된 날짜 하이라이트
- 외부 클릭 닫기, min/max 제한
- custom event dispatch (datepicker:change)
- `app/views/shared/_datepicker.html.erb` (신규): 달력 파셜

### DATE-3: 기존 폼 적용 + QT 세션 UX 개선 (팀리드)
- `app/views/qt/sessions/new.html.erb`: 시작일/종료일 → datepicker 교체
- `app/views/sermons/_form.html.erb`: 설교 날짜 → datepicker 교체
- `session_form_controller.js`: 시작일 변경 시 테마 total_days 기반 종료일 자동 계산

## 해결된 문제
- **CRITICAL**: config.time_zone 미설정 → KST 00:00~08:59에 날짜가 하루 밀리는 버그 수정
- **HIGH**: 브라우저 네이티브 date input → 커스텀 한국어 달력 팝오버로 교체

## 발견된 패턴/주의사항
- sqlite3 CLI 미설치 → schema_format = :sql 환경에서 db:migrate 시 에러. 임시로 :ruby로 변경하여 해결
- prayer_partners_controller_test 2개 기존 실패 존재

## 테스트 결과
- 446 runs, 1060 assertions, 2 failures (기존), 0 errors

## 수정된 기능

### [통독-1] 다중 선택 UI + 통독하기 버튼
- `app/javascript/controllers/tongtok_select_controller.js` 생성 - Stimulus 다중 선택 컨트롤러
- `app/views/tongtok/index.html.erb` 수정 - 기록/통독 모드 전환 + 플로팅 액션 바
- `app/views/tongtok/_book_card.html.erb` 수정 - 모드별 장 버튼 (기록: button_to, 통독: JS 선택)

### [통독-2] 성경 읽기 페이지 + 일괄 완료 처리
- `config/routes.rb` 수정 - GET /tongtok/read, POST /bible_readings/batch_create
- `app/controllers/tongtok_controller.rb` 수정 - read 액션 + parse_selections
- `app/controllers/bible_readings_controller.rb` 수정 - batch_create 액션
- `app/views/tongtok/read.html.erb` 생성 - 성경 본문 읽기 페이지 (bible_passage_controller.js 활용)
- `test/controllers/tongtok_controller_test.rb` 수정 - read 테스트 6개 추가
- `test/controllers/bible_readings_controller_test.rb` 수정 - batch_create 테스트 6개 추가

## 테스트 결과
- 통독 관련 테스트: 24 runs, 72 assertions, 0 failures, 0 errors

## UX 흐름
1. 통독 현황 페이지에서 "통독 모드" 버튼 클릭
2. 원하는 장들을 다중 선택 (파란 테두리 표시)
3. 하단 플로팅 바에서 "통독하기" 클릭
4. 읽기 페이지에서 성경 본문 확인 (JSON 데이터 + bible_passage_controller.js)
5. "통독 완료" 클릭 → BibleReadingLog에 일괄 저장 → 현황 페이지 복귀

## 남은 이슈
- PrayerPartnersControllerTest 2개 실패 (기존 이슈, 본 작업과 무관)

## 분석 완료된 파일
- `youtube_player_controller.js` - YouTube API 로딩, 재생 컨트롤 로직 확인
- `_youtube_player.html.erb` - 오디오 플레이어 UI 파셜 확인
- `_book_card.html.erb` - 기존 책 카드 구조 확인
- `tongtok_select_controller.js` - 기존 통독 모드/기록 모드 토글 확인
- `bible-youtube-urls.json` - 한글 책이름 → 장번호 → YouTube URL 구조 확인

## 구현 계획
1. `tongtok_player_controller.js` Stimulus 컨트롤러 생성
2. `_book_card.html.erb`에 듣기 토글 + 플레이어 영역 추가

## 수정/생성 파일

### 수정
- `config/routes.rb` - `tongtok/read` GET, `bible_readings/batch_create` POST 라우트 추가
- `app/controllers/tongtok_controller.rb` - `read` 액션 + `parse_selections` private 메서드 추가
- `app/controllers/bible_readings_controller.rb` - `batch_create` 액션 추가 (일괄 저장)
- `test/controllers/tongtok_controller_test.rb` - read 관련 테스트 6개 추가
- `test/controllers/bible_readings_controller_test.rb` - batch_create 관련 테스트 6개 추가

### 생성
- `app/views/tongtok/read.html.erb` - 성경 읽기 뷰 (bible_passage_controller.js 활용)

## 주요 기능
- `GET /tongtok/read?selections=창세기:1,2,3;마태복음:1` → 성경 본문 렌더링
- 선택 없이 접근 → 통독 현황으로 리다이렉트
- `POST /bible_readings/batch_create` → BibleReadingLog 일괄 저장 (find_or_initialize_by로 중복 방지)
- 저장 후 통독 현황 페이지로 리다이렉트 + 성공 메시지
- 플로팅 "통독 완료" 버튼 (선택된 장 수 표시)

## 테스트 결과
- 446 runs, 1069 assertions, 0 failures, 0 errors
- 신규 테스트 12개 모두 통과

## 변경 사항

### 생성된 파일
- `app/javascript/controllers/tongtok_select_controller.js` - Stimulus 컨트롤러
- toggle(): 기록 모드 ↔ 통독 모드 전환
- selectChapter(): 장 선택/해제 (Map + Set으로 관리)
- startReading(): /tongtok/read?selections=창세기:1,2,3;출애굽기:1,2 형식으로 이동
- clearSelection(): 선택 초기화
- updateSelectionBar(): 선택 수 표시 업데이트

### 수정된 파일
- `app/views/tongtok/index.html.erb`
- data-controller="tongtok-select" 래핑
- 헤더에 모드 전환 토글 버튼 추가
- 하단 플로팅 액션 바 (선택 수 + 초기화 + 통독하기 버튼)
- bottom-20으로 하단 네비와 겹침 방지

- `app/views/tongtok/_book_card.html.erb`
- 기록 모드: 기존 button_to 유지 (recordMode 타겟, 기본 표시)
- 통독 모드: JS 버튼 추가 (selectMode 타겟, 기본 숨김)
- 선택 시 ring-2 ring-brand-primary bg-brand-primary/10 스타일

## 테스트 결과
- 기존 테스트 4개 전부 통과 (0 failures, 0 errors)
- 기록 모드가 기본이므로 기존 동작 영향 없음

## 생성/수정된 파일

### 새로 생성
- `app/javascript/controllers/youtube_player_controller.js` - Stimulus 컨트롤러 (270줄)
- YouTube Iframe API 글로벌 1회 로드 (중복 방지, Promise 캐싱)
- 한글 약어/전체이름 → 전체이름 매핑 (66권 전부)
- bible-youtube-urls.json 조회 + 캐싱
- 다양한 구절 형식 파싱 (시편 23편, 창세기 1:1-5, 창1:1-5 등 10가지 패턴)
- 재생/일시정지, 프로그레스 바 (클릭 seek), 재생속도(0.5x~2.0x), 음소거 기능
- 에러 처리 (YouTube 로드 실패, URL 없음 등)
- disconnect 시 cleanup (interval 정리, player destroy)

- `app/views/shared/_youtube_player.html.erb` - 파셜 (locals: passage, title)
- 컴팩트 카드 스타일 (bg-surface-subtle rounded-xl p-3)
- 디자인 시스템 토큰 사용
- 로딩 → 에러/플레이어 상태 전환
- 모바일 우선 반응형 (flex, shrink-0, truncate)
- 접근성 (aria-label)

### 수정
- `app/views/qt/today.html.erb` - 성경 구절 카드 아래에 오디오 플레이어 추가
- 묵상 구절 플레이어 (항상 표시)
- 통독 구절 플레이어 (reading_passage 있을 때만)

## 테스트 결과
- 434 runs, 1017 assertions, 0 failures, 0 errors

## 작업 계획
- 목표: 성경 장을 선택하고 본문을 읽는 "통독하기" 기능 구현
- 접근 방식: 다중 선택 UI + 읽기 페이지 + 일괄 완료 처리

## 현재 상태
- 보드 현황: backlog 2 / todo 0 / in_progress 1 / review 0 / done 74
- 기존 자산: bible_passage_controller.js, 66권 JSON 데이터, BibleReadingLog 모델

## 서브 태스크 분해
1. **tongtok-select**: 다중 선택 Stimulus 컨트롤러 + 통독하기 버튼 UI
2. **tongtok-reader**: 읽기 페이지 (라우트 + 컨트롤러 + 뷰) + 일괄 완료 처리 + 테스트

## 변경 사항\n\n### 1. config/application.rb\n- `config.time_zone = "Asia/Seoul"` 설정 (주석 해제/변경)\n- 이것으로 Date.current, Time.current 등 모든 Rails 날짜/시간 메서드가 KST 기준으로 동작\n\n### 2. app/javascript/controllers/session_form_controller.js\n- `new Date(start)` → `new Date(sy, sm - 1, sd)` 방식으로 변경\n- UTC 파싱 이슈 방지 (YYYY-MM-DD 문자열을 직접 파싱)\n\n### 3. test/configuration/timezone_test.rb (신규)\n- `config.time_zone == "Asia/Seoul"` 확인\n- `Time.zone.name == "Asia/Seoul"` 확인\n- UTC 23:30일 때 Date.current가 KST 다음 날인지 확인\n- UTC 15:00일 때 Time.current.hour가 KST 0시인지 확인\n\n### 4. Date.current 사용처 검증 (12곳)\n- 모두 config.time_zone 설정으로 자동 KST 적용됨\n- notification_cron_job.rb의 in_time_zone("Asia/Seoul")은 중복이지만 명시적이므로 유지\n\n## 테스트 결과\n- 434 tests, 1017 assertions, 0 failures, 0 errors

## 작업 계획
- 목표: 통독하기와 QT 본문 읽기에서 YouTube 오디오 플레이어 구현
- 접근 방식: 레거시 Next.js 코드를 Stimulus 컨트롤러로 포팅

## 분석 결과
- `public/bible-youtube-urls.json` 이미 존재 (66권 1,189장 YouTube URL)
- `bible_passage_controller.js` 성경 본문 로드 구현됨
- YouTube 오디오 플레이어만 미구현 상태

## 서브 티켓 계획
1. [MP-1] YouTube Audio Player Stimulus 컨트롤러 + 파셜 구현
2. [MP-2] QT 본문 읽기 미디어 플레이 통합
3. [MP-3] 통독하기 미디어 플레이 통합

## 현재 상태
- 보드 현황: backlog 0 / todo 0 / in_progress 3 / review 0 / done 74

## 계획
1. 기존 코드 확인 (_input 스타일, 색상 토큰, importmap 패턴)
2. 레거시 calendar.tsx 참고
3. datepicker_controller.js 생성
4. shared/_datepicker.html.erb 파셜 생성

## 작업 계획\n1. config/application.rb 시간대 설정\n2. session_form_controller.js UTC 파싱 이슈 수정\n3. Date.current 사용처 검증\n4. 테스트 작성 및 전체 테스트 실행

## 작업 계획
- 목표: 날짜 입력 UX 개선 + 한국 시간대(KST) 계산 정확성 확보
- 접근 방식: 3개 서브 티켓으로 분해하여 병렬 처리

## 분석 결과
1. **CRITICAL**: `config.time_zone` 주석 처리 → UTC 기본값. Date.current 12곳이 모두 UTC 기준
2. **HIGH**: 브라우저 네이티브 date input 사용 → 레거시의 달력 팝오버 대비 불편
3. **MEDIUM**: session_form_controller.js의 new Date() UTC 파싱 이슈

## 현재 상태
- 보드 현황: backlog 2 / todo 0 / in_progress 1 / review 0 / done 74
- 관련 기존 작업: 디자인 시스템 재설계 완료 (shared/_input 파셜 존재)