9WAY 2.0.0 - 프로젝트 타임라인

## 변경 사항
- resend gem 1.3.0 + config/initializers/resend.rb (마케팅 전용, delivery_method 전역 변경 X).
- email_campaigns 테이블 + EmailCampaign 모델(enum status, deliveries 연관, sendable?). email_deliveries.campaign_id FK 연결(on_delete nullify) + EmailDelivery belongs_to :campaign.
- app/services/marketing/campaign_sender.rb: eligible_recipients(segment.members → marketing_subscribed & not_suppressed & email 존재) → 100명 배치 → build_email(토큰 렌더 + 레이아웃 + List-Unsubscribe 헤더 + unsubscribe URL) → ResendClient.send_batch → EmailDelivery 생성. 배치 예외 시 해당 수신자 failed(부분 성공). send_test(본인, 로그 미기록).
- app/services/marketing/resend_client.rb: Resend::Batch.send 래퍼(주입형).
- app/jobs/marketing/send_campaign_job.rb (Solid Queue): deliver/test 분기.
- Admin::Marketing::CampaignsController: CRUD + send_test/deliver(Job enqueue, 동기 발송 X), sendable? 가드.
- ⚠️ 네임스페이스 충돌 해결: Admin::Marketing 내부에서 ::Marketing::SendCampaignJob 으로 최상위 명시.
- Webhooks::ResendController: 캠페인 카운터(delivered/opened/clicked/bounced/unsubscribed) 최초 전이 시에만 증가.
- 뷰: campaigns index/_form/new/edit/show(성과 6지표 + 발송 로그). 사이드바 "캠페인". 세그먼트 show "캠페인 만들기" 버튼(PR2 보류분). ko.yml i18n.

## 테스트
- 신규: email_campaign(5), campaign_sender(6: 게이트/배치분할/토큰/부분실패/send_test), campaigns_controller(10: CRUD/enqueue 검증/sent 차단), 웹훅 카운터(1).
- 전체 스위트 2793 runs, 0 errors. 실패 5건은 전부 기존 vuild 랜딩(본 작업 무관, 커밋 fd65e8b 이후 미갱신).
- 실제 Resend 호출은 FakeClient 주입 / Job enqueue 단언으로 회피(테스트에서 발송 없음).

## 운영 TODO (발송 활성화 전)
- MARKETING_FROM_EMAIL=marketing@9way.co.kr, RESEND_WEBHOOK_SECRET 를 .env / .kamal/secrets / .env.deploy 에 추가.
- Resend 대시보드에서 https://9way.co.kr/webhooks/resend 웹훅 등록.

## Fast-follow (범위 외)
- 진단 결과 유형(WAY/DOMAIN) 세그먼트 조건 — 결과 점수 저장 위치 스파이크 후 SegmentQuery + TokenRenderer({{primary_way}}) 추가.

## 변경 사항
- 마이그레이션 3종: email_deliveries(campaign_id[FK는 PR4], user, resend_email_id[uniq], status, *_at, open/click_count, error_message), email_suppressions(email_address[uniq], reason, suppressed_at), email_webhook_events(event_id[uniq] 멱등키).
- 모델: EmailDelivery(mark_delivered!/record_open!/record_click!/mark_bounced!/mark_complained!, PROGRESS 단계 역행 방지), EmailSuppression(normalizes + 멱등 suppress!), EmailWebhookEvent(already_processed?/record!).
- User: not_suppressed 스코프, unsubscribe_token/find_by_unsubscribe_token(message_verifier).
- app/services/webhooks/svix_verifier.rb: Svix HMAC-SHA256 직접 검증(svix gem 불필요).
- app/services/marketing/token_renderer.rb: {{name}}/{{funnel_stage}} 치환 + HTML 이스케이프, 미지원 토큰 원형 유지.
- Webhooks::ResendController(ActionController::Base 상속 → allow_browser/CSRF/locale 우회, skip_forgery_protection): 서명검증 → 멱등 → 이벤트 처리. bounced→hard_bounce suppression, complained→complaint suppression + email_subscription=false.
- EmailSubscriptionsController#unsubscribe(allow_unauthenticated_access) + 확인 뷰.
- 공개 라우트: POST /webhooks/resend, GET /email/unsubscribe.

## 설계 결정
- resend gem + 실제 발송은 PR4로 격리(외부 의존성 최소화). 웹훅 검증은 수동 HMAC.
- 캠페인 카운터 갱신(delivered_count 등)은 EmailCampaign 생성(PR4) 후 연결.

## 테스트
- 신규 67개: email_delivery(6)/email_suppression(5)/user_funnel 추가(3)/token_renderer(7)/svix_verifier(6, 공식 벡터)/resend_controller(6)/email_subscriptions(2) 등.
- 웹훅 멱등(같은 svix-id 재전송), 서명 실패 401, complained→unsubscribe 검증.

## 운영 TODO (배포 전)
- RESEND_WEBHOOK_SECRET 를 .env / .kamal/secrets / .env.deploy 에 추가.
- Resend 대시보드에서 https://9way.co.kr/webhooks/resend 웹훅 등록(이벤트: delivered/opened/clicked/bounced/complained).

## 참고
- 전체 스위트의 vuild 랜딩 테스트 5건 실패는 본 작업과 무관(커밋 fd65e8b가 _timeline/_claude_pro/_faq partial 삭제 후 테스트 미갱신, 증거 확인).

## 변경 사항
- `app/services/marketing/segment_query.rb`: conditions(jsonb)→User 관계. 화이트리스트(알려진 키만 처리, 나머지 무시) + 전 바인드 파라미터 → SQL 인젝션 차단. 지원: funnel_stages(OR), facts(AND: has_completed/paid_diagnosis, is_applicant/graduate), diagnosis_target, locale, email_subscription, created_after, first_diagnosis_after, days_since_diagnosis_gte, utm_source.
- `db/migrate/20260610071005_*` + `app/models/marketing_segment.rb`: name(unique), description, conditions(jsonb), cached_count, count_refreshed_at, created_by. `members`(실시간), `refresh_count!`.
- `app/controllers/admin/marketing/segments_controller.rb`: CRUD + `refresh_count`. strong params로 conditions 구조 허용 + 빈 값 정리(cleaned_conditions).
- 뷰: index/new/edit/_form(조건 빌더: 퍼널 단계·언어·진단대상 체크박스 + 수신동의/경과일/가입일) / show(실시간 대상 수 + 샘플 20명).
- `app/helpers/admin/marketing/segments_helper.rb`: 조건 요약 칩 라벨.
- 사이드바 "세그먼트" + ko.yml i18n.

## 테스트
- 신규: segment_query(11, 인젝션/OR/AND/경계값 포함), marketing_segment(5), segments_controller(8)
- 회귀: admin+models+services **1530 runs, 0 failures**

## 참고
- "이 세그먼트로 캠페인 만들기" 버튼은 campaigns 라우트(PR4) 생성 후 show에 추가 예정.
- 결과유형(WAY/DOMAIN) 조건은 스파이크 후 fast-follow(범위 외).

## 변경 사항
- `app/models/user.rb`: 퍼널 스코프/메서드 추가
- `FUNNEL_STAGES = %i[subscriber free paid applicant graduate]`
- fact 스코프: `marketing_subscribed`, `with_completed_diagnosis`, `with_paid_diagnosis`, `free_diagnosis_only`, `course_applicants`, `course_graduates`
- `at_funnel_stage(stage)`: 배지와 동일한 **상호배타 현재 단계** 필터
- `funnel_stage`(단건) / `self.funnel_stage_map(ids)`(배치, 목록 N+1 방지)
- `db/migrate/20260610065545_*`: `diagnosis_sessions.is_report_purchased` 부분 인덱스(`where is_report_purchased=true`, `algorithm: :concurrently`). migrate→rollback→migrate 3단계 검증 완료.
- `config/routes.rb`: `namespace :marketing { resources :leads, only: [:index] }`
- `app/controllers/admin/marketing/leads_controller.rb`: 검색(이름/이메일/전화)+퍼널 단계 필터+수신동의 필터+수동 페이지네이션. 페이지 단위 `funnel_stage_map`/진단수/last_active 일괄 조회.
- `app/views/admin/marketing/leads/index.html.erb`: 단계 칩 + 필터바 + 테이블(퍼널 배지/진단수/수신동의)
- `app/views/admin/shared/_sidebar.html.erb` + `_nav_item.html.erb`(funnel 아이콘) + `config/locales/ko.yml`(admin.nav.leads, admin.marketing.* — ko 전용)
- `docs/features/admin_lead_management.md`: 전체 기능 계획서

## 설계 결정
- 스코프를 denorm(`first_diagnosis_completed_at`)이 아닌 **실제 세션 기준**으로 산출 → 마케팅 오분류(잘못된 발송) 방지. 픽스처가 콜백을 안 거치는 점도 고려.
- `NOT IN (subquery)` NULL 함정을 `where.not(user_id: nil)`로 차단.
- PR1에서는 사이드바에 leads 메뉴만 추가(segments/campaigns 경로는 PR2/PR4에서 생성, 미존재 경로 참조 방지).

## 테스트
- 신규: `test/models/user_funnel_test.rb`(14), `test/controllers/admin/marketing/leads_controller_test.rb`(7)
- 회귀: `test/controllers/admin` + `test/models` 전체 **902 runs, 0 failures**
- Tailwind dev 빌드 재실행(새 배지 클래스 반영)

## 완료 기준 충족
어드민 사이드바 "리드 관리"에서 퍼널 단계별 필터·검색·페이지네이션 동작.

## 배포 정보
- 배포 시각: 2026-04-15
- 배포 환경: production (9way.org)
- 배포 시간: 141.3초
- 커밋: 635aafe

## 포함된 주요 커밋 (이번 배포)
- `635aafe` feat: implement inline editing for blog post category and status
- `851b26d` refactor: modernize discount code service, improve UI accessibility
- `0d9bf3e` refactor: replace applies_to_all with polymorphic apply_scope
- `612cb57` fix(growth-mindset): remove all hardcoded Korean default fallbacks
- `d4e82eb` i18n: replace hardcoded Korean in summary card with t() keys
- `e0d9d53` i18n(growth-mindset): add renewal keys for zh, en, vi locales
- `2f860a2` i18n: add Big5 report renewal keys for en, zh, vi
- 외 30+ 커밋 (Big5/Growth Mindset 리포트 리뉴얼, 할인코드 확장, 블로그 인라인 편집)

## 변경된 기능
- **블로그 관리**: 상태/카테고리 인라인 편집 (클릭하여 바로 변경)
- **할인코드 확장**: apply_scope enum + discount_code_items polymorphic
- **Big5 리포트**: 전면 리뉴얼 (아코디언, 레이더 차트, 요약 카드)
- **Growth Mindset 리포트**: 전면 리뉴얼 (디자인 시스템 통일)
- **i18n**: Big5/Growth Mindset 리포트 다국어 키 추가 (ko, en, zh, vi)

## 확인 사항
- 컨테이너 healthy 확인
- 96 파일 변경, +6198 / -1113 lines

## 기능 개요
- 할인코드 적용 범위를 Product(report/credit_pack)에서 Expert::Course(교육프로그램) + Study::Course(온라인강좌)까지 확장
- apply_scope enum (all/report/education/specific) + polymorphic discount_code_items 조인테이블

## 분석 결과
- 영향 범위: 모델 3개, 서비스 4개, 컨트롤러 3개, 뷰 2개, 마이그레이션 2개
- 기존 패턴: string enum, Result 패턴 (Data.define), Payments::CheckoutService 재사용
- 핵심: CheckoutService가 이미 discount_amount/discount_code_id 지원 → Expert 연동 간단

## 생성된 티켓 (5개)
1. [할인코드확장 PR1] DB + 모델 (priority: high)
2. [할인코드확장 PR2] ValidationService (priority: high)
3. [할인코드확장 PR3] Expert/Study 서비스 (priority: high)
4. [할인코드확장 PR4] Admin UI (priority: medium)
5. [할인코드확장 PR5] 결제 UI + 정리 (priority: medium)

## 리스크
- 기존 할인코드 깨짐 → ignored_columns + 기존 테스트 전수 통과로 방어
- 데이터 이관 → 마이그레이션 트랜잭션 + 롤백 검증

## 기술적 결정
- applies_to_all → apply_scope string enum (프로젝트 컨벤션 일관성)
- 2단계 제거 패턴 (ignored_columns → 컬럼 삭제)
- polymorphic 조인테이블로 Product/Expert::Course/Study::Course 통합

## 수정된 기능
- 2가지 개인 크레딧(리포트/진단) → 단일 크레딧으로 통합
- 1크레딧 = 19,800원, 리포트=1.0, 심화진단=0.2, 추천보상=0.2
- 워크스페이스 선물: 1크레딧 단위, 자기 선물 가능
- diagnosis_balance 컬럼 DB에서 완전 제거

## 변경 규모
- 39 파일, +187 / -1,030 lines
- 삭제: DiagnosisCreditPurchaseService, DiagnosisCreditsController, 진단 크레딧 구매 뷰/JS

## UX/UI 검토 결과
- 전체 평가: 기능적 통과, P2/P3 개선사항은 후속 작업
- 선물 모달 2종 통합, 사이드바 단일 뱃지, 크레딧 대시보드 단일 잔액

## 테스트/보안 검증
- 1635 runs, 13 failures, 8 errors (모두 크레딧 무관 기존 이슈)
- 크레딧 관련 실패: 0건
- add!에 lock! 추가 (race condition 방지)
- BigDecimal 사용으로 부동소수점 오류 방지

## 해결된 문제
- ConfirmationService 테스트가 workspace_id 분기 미반영 → 수정 완료
- admin 뷰 하드코딩 한국어 → i18n 처리

## 남은 이슈
- blog/posts Dangerous Send (크레딧 무관, 별도 티켓 필요)
- Payment.diagnosis_credit enum 유지 (기존 레코드 3건 존재)

## 작업 계획
- 목표: 2가지 개인 크레딧(리포트/진단)을 단일 크레딧으로 통합
- 접근 방식: PR1→PR2→PR3→PR4→PR5 순차 진행 (의존성 체인)

## 현재 상태
- 보드 현황: backlog 9 / todo 11 / in_progress 1 / review 9 / done 158
- PR1: DB 마이그레이션 (balance decimal 변환)
- PR2: 모델 통합
- PR3: 서비스 통합
- PR4: 컨트롤러/라우트 통합
- PR5: 뷰/UI/i18n 통합

## 기능 개요
- 2가지 개인 크레딧(리포트/진단)을 단일 크레딧으로 통합
- 1크레딧 = 19,800원 (세전 18,000원 + VAT 10%)
- 강점 리포트 = 1.0 크레딧, 심화 진단 = 0.2 크레딧
- 워크스페이스 → 개인 크레딧 선물 (자기 선물 포함)

## 분석 결과
- 영향 범위: 모델 6개, 서비스 7개, 컨트롤러 5개, 뷰 11개, JS 1개, i18n 4언어
- 삭제 대상: DiagnosisCreditPurchaseService, DiagnosisCreditsController, 진단 크레딧 구매 뷰/JS

## 생성된 티켓 (5개)
1. [크레딧통합 PR1] DB 마이그레이션 (priority: high)
2. [크레딧통합 PR2] 모델 통합 (priority: high)
3. [크레딧통합 PR3] 서비스 통합 (priority: high)
4. [크레딧통합 PR4] 컨트롤러/라우트 통합 (priority: high)
5. [크레딧통합 PR5] 뷰/UI/i18n 통합 (priority: medium)

## 기술적 결정
- balance: integer → decimal(10,1) (0.2 단위 차감)
- diagnosis_balance: 2단계 제거 패턴 (ignored_columns → 별도 마이그레이션)
- credit_type: 기존 이력 유지, 신규 "unified"
- DiagnosisType#credit_cost로 진단별 차감량 캡슐화

## 구현 완료된 PR (5개)

### PR1: BulkReportDownload 모델 + 마이그레이션
- `db/migrate/20260330012810_create_bulk_report_downloads.rb`
- `app/models/bulk_report_download.rb` (enum status, scope expired/active, has_one_attached :file)
- `test/models/bulk_report_download_test.rb` (17 tests)
- `test/fixtures/bulk_report_downloads.yml` (5 fixtures)

### PR2: BulkReportGenerateJob + CleanupJob
- `app/jobs/bulk_report_generate_job.rb` (PDF→ZIP→Active Storage, 순차 처리, GC 관리)
- `app/jobs/bulk_report_cleanup_job.rb` (7일 만료 삭제)
- `config/recurring.yml` 에 매일 2am cleanup 등록
- 테스트 9 runs

### PR3: BulkReportMailer
- `app/mailers/bulk_report_mailer.rb` (completed/failed)
- `app/views/bulk_report_mailer/completed.html.erb`, `failed.html.erb`
- i18n 4개 언어 (ko, en, zh, vi)
- 테스트 6 runs

### PR4: Controller + Routes 비동기 전환
- `handle_bulk_download` 동기→비동기 전환 (Job enqueue)
- `bulk_download_status` (JSON 폴링), `bulk_download_file` (파일 다운로드)
- 중복 요청 방지
- 테스트 10 runs

### PR5: View + Stimulus 폴링 배너
- `bulk_download_status_controller.js` (3초 폴링, 상태별 UI)
- `_bulk_download_banner.html.erb` (progress bar, download button)
- i18n 4개 언어

## 전체 테스트
- **42 runs, 90 assertions, 0 failures, 0 errors**

## 작업 계획
- 목표: BulkReportDownload 모델 + 마이그레이션 + 테스트 + fixture
- 접근 방식: TDD (테스트 먼저 → 구현)

## 전체 일괄다운로드 진행 순서
1. **PR1 (현재)**: 모델 + 마이그레이션
2. PR2 + PR3 (PR1 완료 후 병렬): Job + Mailer
3. PR4 (PR2 완료 후): Controller + Routes
4. PR5 (PR4 완료 후): View + Stimulus

## 기능 개요
- 일괄 리포트 ��운로드 시 동기 PDF 생성으로 인한 HTTP 타임아웃 해결
- 백그라운드 Job으로 전환 + 폴링 방식 상태 표시 + 이메일 알림

## 분석 결과
- 영향 범위: members_controller, PdfGenerator, routes, members views, i18n
- 기존 패턴: AiInsightGenerateJob(폴링), GiftMailer(���메일), Active Storage(4개 모델)
- Turbo Stream broadcast 미사용 → 폴링 방식 채택

## 생성된 티켓 (5개)
- [PR1] BulkReportDownload 모델 + 마이그레이��� (high)
- [PR2] BulkReportGenerateJob + CleanupJob (high)
- [PR3] BulkReportMailer (medium)
- [PR4] Controller + Routes 비동기 전환 (high)
- [PR5] View + Stimulus 폴링 배너 UI (high)

## 리스크
- Grover 메모리 → 순차 처리 + 주기적 GC
- 디스크 누적 → 7일 만료 CleanupJob (매일 2am)
- 중복 요청 → pending/processing 존재 시 거부

## 기술적 결정
- ActionCable 인프라 없음 → Turbo Stream broadcast 대신 Stimulus 폴링 (3초)
- Active Storage local disk 사용 (프로덕션 전환 시 S3 검토)

## 수정된 기능
- 크레딧 현황 페이지: 리포트/진단 2종류 분리 표시, 리퍼럴 현황 N/10
- 진단 크레딧 구매 페이지: 디자인 개선, 무료 획득 안내
- 크레딧 부족 안내 partial: 구매/공유 2가지 옵션
- i18n: 4개 언어 완료

## 테스트 결과
- 14 runs 통과 (credits 6 + diagnosis_credits 8)

## 수정 파일
- 컨트롤러 1개, 헬퍼 1개, 뷰 3개, i18n 4개

## 수정된 기능
- DiagnosisCreditPurchaseService: 3,000원/크레딧, Toss Payments 연동
- Payment 모델: diagnosis_credit 타입 추가
- ConfirmationService: 결제 완료 후 자동 크레딧 지급
- DiagnosisCreditsController: 구매 페이지 + checkout 연동
- 라우트 추가

## 테스트 결과
- 18 runs 통과 (서비스 12 + 컨트롤러 6)

## 기술적 결정
- 멱등성: metadata.credits_added 플래그로 중복 방지
- VAT 10% 포함 처리

## 수정된 기능
- ApplicationController: ref 파라미터 → 쿠키 저장 (30일)
- DiagnosesController: Big5/성장/행복도 진단 시작 시 크레딧 차감
- DiagnosisSessionsController: 강점 진단 완료 시 리퍼럴 보상 트리거
- OAuth/매직링크 가입: 리퍼럴 추적 기록 + 쿠키 삭제
- 공유 URL: referral_url 헬퍼로 ?ref= 파라미터 자동 추가
- i18n: 크레딧 부족 메시지 4개 언어

## 테스트 결과
- 22 runs 통과 (신규 10 + 기존 12)

## 수정 파일
- 컨트롤러 5개, 모델 1개, 헬퍼 1개, 뷰 2개, i18n 4개, 테스트 1개

## 변경 사항

### 컨트롤러 (`diagnosis_sessions_controller.rb`)
- `PART2_DOMAIN_PAIRS`, `PART2_QUESTIONS_PER_ROUND` 상수 추가
- `prepare_part2_round_sequence`: 54라운드 사전 생성 (deterministic, session_seed 기반)
- `next_part2_round`: 시퀀스에서 미응답 페어 반환
- `setup_part2_state`: total_rounds = 시퀀스 크기
- `current_round_number`: / 2로 변경

### 뷰
- `_part2_round.html.erb`: 2버튼 + "둘 다 해당 안됨" 버튼
- `_part2_guide.html.erb`: 미리보기 2개 + "해당없음"

### JS (`diagnosis_controller.js`)
- `skipPart2Round` 메서드 추가
- 선택자: `[data-part2-choice]`로 구분
- response_time null 처리 개선

### i18n (ko, en, zh, vi)
- `none_of_above` 키 추가
- instruction/description 텍스트 변경
- preview_3 제거

### 테스트
- 기존 테스트 2개→3개로 수정 (pairwise, skip, constants)
- 진단 관련 54개 테스트 전체 통과

## 수정된 기능
- Referrals::TrackingService: 신규 가입 시 referral_code → Referral(pending) 생성
- Referrals::RewardService: strength 진단 완료 → referrer diagnosis_balance +1, 월 10개 상한

## 테스트 결과
- 12 runs, 24 assertions, 0 failures

## 기술적 결정
- DiagnosisType 연관관계: `category` (not `diagnosis_category`)
- 테스트에서 referral_code는 update_column으로 설정 (fixture에 없으므로)

## 수정된 기능
- UserCredit에 diagnosis_balance 컬럼 추가 (진단 크레딧)
- CreditTransaction에 credit_type 컬럼 추가 (report/diagnosis 구분)
- User에 referral_code 컬럼 추가 (공유 URL용)
- Referral 모델 신규 생성 (리퍼럴 추적)

## 테스트 결과
- 57 runs, 103 assertions, 0 failures (관련 테스트)
- 기존 테스트 영향 없음

## 마이그레이션
- 4개 모두 가역적, rollback 검증 완료

## 남은 이슈
- 기존 유저의 referral_code는 nil (필요 시 별도 마이그레이션으로 채울 수 있음)

## 작업 계획
- 목표: 진단 크레딧 + 리퍼럴 보상 시스템의 DB 기반 구축
- 접근 방식: 마이그레이션 4개 + 모델 변경/생성을 developer-1에게 위임, QA 검증 후 완료

## 현재 상태
- 보드 현황: backlog 8 / todo 11 / in_progress 1 / review 4 / done 147
- 관련 기존 작업: UserCredit, CreditTransaction 모델 기존 존재

## 기능 개요
- 카카오톡/링크 공유로 유입된 신규 회원이 강점 진단 완료 시 공유자에게 진단 크레딧 +1 보상
- 진단 크레딧으로 Big5/성장 마인드셋/행복도 진단 가능 (1크레딧=1검사)
- 진단 크레딧 개인 구매 가능 (3,000원/개)
- 리포트 크레딧(기존 18,000원)과 분리 운영

## 분석 결과
- 영향 범위: UserCredit, CreditTransaction, User, DiagnosisSession, 결제 플로우
- 기존 패턴: ReportPurchaseService, CreditPurchaseService(워크스페이스), share_token 공유

## 생성된 티켓
- [리퍼럴 PR1] DB 레이어 (priority: high)
- [리퍼럴 PR2] 비즈니스 로직 (priority: high)
- [리퍼럴 PR3] 컨트롤러 (priority: high)
- [리퍼럴 PR4] 진단 크레딧 구매 (priority: medium)
- [리퍼럴 PR5] 뷰/UI (priority: medium)

## 핵심 설계 결정
- UserCredit에 diagnosis_balance 컬럼 추가 (별도 모델 X)
- Referral 모델 신규 생성 (referrer/referee 추적)
- 공유 URL에 ?ref=referral_code 파라미터
- 월 10개 보상 상한, 1인 1추천인

## 작업 계획
- PR3: Workspaces::EngagementSurveysController (관리자 CRUD + 결과)
- PR4: EngagementSurveyResponsesController (비인증 공개 응답)
- 접근 방식: developer-1 = PR3, developer-2 = PR4 병렬 진행 (파일 충돌 없음)

## 수정된 기능
- CreateService: 설문 생성 + 중복 방지 + title 자동 생성
- SubmitResponseService: DiagnosisSession 기반 응답 저장 + EngagementCalculator 채점
- ResultAggregator: 전체/그룹별 집계, 3명 이하 필터링, 몰입 유형 비율, 3요인/9요인 분석, 강약점

## 생성 파일
- `app/services/engagement_surveys/create_service.rb`
- `app/services/engagement_surveys/submit_response_service.rb`
- `app/services/engagement_surveys/result_aggregator.rb`
- `test/services/engagement_surveys/create_service_test.rb`
- `test/services/engagement_surveys/submit_response_service_test.rb`
- `test/services/engagement_surveys/result_aggregator_test.rb`

## 기술적 결정
- DiagnosisSession 재사용 (context_type="b2b", scoring_framework="engagement_3factor")
- 기존 EngagementCalculator + ScoreCalculatorFactory 완전 재사용
- Data.define Result 패턴 (기존 서비스 패턴 준수)
- MINIMUM_RESPONSES=3 상수로 3명 이하 필터링

## 테스트: 17 runs, 59 assertions, 0 failures

## 작업 계획
- 목표: 3개 서비스 객체 구현 (CreateService, SubmitResponseService, ResultAggregator)
- 접근 방식: developer-1이 TDD로 구현

## 핵심 로직
- CreateService: 설문 생성 + 중복 방지
- SubmitResponseService: DiagnosisSession으로 응답 저장 + EngagementCalculator 채점
- ResultAggregator: 전체/그룹별 집계, 3명 이하 필터링, 몰입 유형 비율, 3요인/9요인 분석

## 수정된 기능
- WorkspaceEngagementSurvey 모델: 분기별 설문 관리 (draft/active/closed, access_token 자동 생성)
- DiagnosisSession 확장: workspace_engagement_survey_id, workspace_group_id FK 추가

## 생성/수정 파일
- `db/migrate/20260317080753_create_workspace_engagement_surveys.rb`
- `db/migrate/20260317080816_add_engagement_survey_to_diagnosis_sessions.rb`
- `app/models/workspace_engagement_survey.rb`
- `app/models/diagnosis_session.rb` (연관관계 추가)
- `app/models/workspace.rb` (has_many :engagement_surveys)
- `test/fixtures/workspace_engagement_surveys.yml` (3개 fixture)
- `test/models/workspace_engagement_survey_test.rb` (21 tests)

## 테스트 결과
- 모델 테스트: 508 tests, 0 failures, 0 errors
- 신규 테스트: 21 tests (유효성, 연관관계, enum, 스코프, access_token)

## 작업 계획
- 목표: WorkspaceEngagementSurvey 모델 생성 + DiagnosisSession FK 확장
- 접근 방식: developer-1이 마이그레이션+모델+테스트, 완료 후 QA 검증

## 서브 태스크
1. 마이그레이션 2개 생성 (WorkspaceEngagementSurvey + DiagnosisSession 확장)
2. 모델 구현 (유효성, 연관관계, 스코프, enum)
3. fixture + seed 확인
4. 테스트 작성 및 통과

## 기능 개요
워크스페이스 대시보드에 조직문화(Engagement B2B) 진단 기능 추가. 분기별 설문 생성 → QR/링크로 익명 응답 → 결과 대시보드 집계.

## 분석 결과
- 영향 범위: Workspace, DiagnosisSession, EngagementCalculator, admin/survey_questions
- 기존 패턴: engagement B2C 플로우, QrCodeHelper, WorkspaceAuthorization
- 재사용: EngagementCalculator(채점), EngagementResultFormatter(B2B 분기 지원), _engagement_question.html.erb(문항 뷰)

## 생성된 티켓 (7개)
- [PR1] DB: WorkspaceEngagementSurvey + DiagnosisSession 확장 (high)
- [PR2] 서비스: 생성/응답/집계 (high)
- [PR3] 컨트롤러: 설문 관리 CRUD + 결과 (high)
- [PR4] 공개 응답 플로우: 비인증 컨트롤러 (high)
- [PR5] 뷰: 결과 대시보드 UI (medium)
- [PR6] 뷰: 공개 응답 UI (medium)
- [PR7] Admin: B2B 문항 분리 + 네비게이션 (low)

## 핵심 설계 결정
- DiagnosisSession 재사용 (Option A): 기존 EngagementCalculator/ResultFormatter 완전 활용
- 익명성: user_id는 로그인 시 참고용 기록, 결과 집계에서 미사용
- 3명 이하 그룹 결과 비공개

## 리스크
- 익명 응답 중복 방지: localStorage 기반 soft 방지
- 기존 EngagementCalculator는 개인용 → B2B 집계 로직은 ResultAggregator에서 별도 구현

## 수정된 기능
- 사이드바에 "함께 보기" 메뉴 추가 (커리어테크 아래)
- 하단 탭에 "함께 보기" 메뉴 추가
- 4개 locale i18n (ko, en, zh, vi)
- "together" 그룹 아이콘 SVG 추가

## 수정 파일
- `app/views/shared/_sidebar.html.erb`
- `app/views/shared/_bottom_tabs.html.erb`
- `app/views/shared/_sidebar_nav_item.html.erb`
- `app/views/shared/_bottom_tab_item.html.erb`
- `config/locales/{ko,en,zh,vi}.yml`

## QA 검증 결과
- 테스트: 37/37 통과, Critical/Major 이슈 없음
- 전 locale 표시, 비로그인 미표시, active 상태 정상
- 배포 가능 상태

## 작업 계획
- 목표: 사이드바 + 하단탭에 "함께 보기" 메뉴 추가, 4개 locale i18n
- 접근 방식: developer 1명 구현 → QA 검증

## 현재 상태
- PR1~PR4 모두 review 상태
- PR5 네비게이션: in_progress (마지막 PR)

## 수정된 기능
- 5개 뷰 완성: index(그룹 목록), show(QR코드/멤버), new(생성 폼), join(참여 확인), team_strength(팀강점 매트릭스)
- i18n 키 추가 (ko.yml)
- shared/_input.html.erb 버그 수정

## UX/UI 검토 결과
- P0 border 토큰 수정, P1 반응형/빈 상태 수정, 접근성 aria-label 추가
- 잔여 Minor (shared/_button Partial 교체, 빈 상태 CTA 개선) → 별도 티켓으로

## QA 검증 결과
- 테스트: 72/72 통과 (219 assertions, 0 failures)
- 보안: Brakeman 0 warnings, XSS 안전
- N+1 쿼리: index/show eager loading 수정 완료

## QA/UX 피드백 반영
- N+1 쿼리 3곳 수정 (includes 추가)
- border-border-default → border-gray-200 통일
- 시너지 그리드 반응형 처리
- join 빈 세션 상태 처리 + i18n 키 추가
- aria-label 접근성 추가 (복사 버튼, DNA 매트릭스)

## 작업 계획
- 목표: 함께 보기 기능의 전체 뷰 구현 (index, show, new, join, team_strength)
- 접근 방식: developer 1명 구현 → UX 리뷰어 검토 → QA 검증

## 현재 상태
- PR1 DB: review, PR2 서비스: review, PR3 컨트롤러: review
- PR4 뷰: in_progress (현재)

## 수정된 기능
- ViewGroupsController 8개 액션 (index, show, new, create, destroy, join, process_join, leave, team_strength)
- 라우팅: locale scope 내 view_groups 리소스 + join/process_join 커스텀 라우트
- i18n: flash 메시지 17개 키 (ko.yml)

## 생성/수정 파일
- `app/controllers/view_groups_controller.rb` (신규)
- `config/routes.rb` (수정)
- `config/locales/ko.yml` (수정)
- `app/views/view_groups/` — 최소 스텁 뷰 5개 (PR4에서 완성)
- `test/controllers/view_groups_controller_test.rb` (37개 테스트)

## QA 검증 결과
- 테스트: 37/37 통과, 102 assertions, 0 failures
- 보안: Brakeman 0 warnings, IDOR 방지 확인
- Rubocop: 0 offenses (수정 후)
- Major 이슈 1건(set_view_group return 누락) → guard clause로 수정 완료

## QA 피드백 반영
- set_view_group: guard clause 패턴으로 리팩토링 (DoubleRenderError 방지)
- Rubocop offense 2건 수정

## 작업 계획
- 목표: ViewGroupsController CRUD, 참여(join), 나가기(leave), 팀강점(team_strength) + 라우팅
- 접근 방식: developer 1명이 TDD로 컨트롤러 + 라우트 + 테스트 구현, qa-verifier가 검증

## 현재 상태
- PR1 DB 레이어: review
- PR2 서비스: review
- PR3 컨트롤러: in_progress (현재)

## 수정된 기능
- ViewGroups::TeamStrengthAnalyzer 서비스 구현 (Workspace 버전과 동일 출력 구조)

## 생성 파일
- `app/services/view_groups/team_strength_analyzer.rb` (신규)
- `test/services/view_groups/team_strength_analyzer_test.rb` (11개 테스트)

## QA 검증 결과
- 테스트: 11/11 통과, 79 assertions, 0 failures
- N+1: eager loading 올바르게 적용 (includes :user, diagnosis_session: :diagnosis_type)
- 보안: Brakeman 경고 0건, 서비스 레벨 cross-group 접근 불가
- 종합: 리뷰 진행 가능 (Critical/High 이슈 없음)

## Minor 이슈 (선택적 개선)
- `view_group_members.count` 중복 호출 → 캐싱 가능
- way_scores 합계 0 케이스 테스트 없음 (코드는 방어됨)

## 작업 계획
- 목표: 기존 Workspaces::TeamStrengthAnalyzer를 참고하여 ViewGroups 전용 서비스 생성
- 접근 방식: developer 1명이 TDD로 서비스 + 테스트 구현, qa-verifier가 검증

## 현재 상태
- PR1 DB 레이어 완료 (review 상태)
- 이번 PR2는 서비스 레이어 구현

## 수정된 기능
- ViewGroup + ViewGroupMember 모델, 마이그레이션, 테스트, fixtures 구현 완료

## 생성/수정 파일
- `db/migrate/20260317064325_create_view_groups.rb`
- `db/migrate/20260317064334_create_view_group_members.rb`
- `app/models/view_group.rb` (신규)
- `app/models/view_group_member.rb` (신규)
- `app/models/user.rb` (has_many 추가)
- `test/fixtures/view_groups.yml`, `view_group_members.yml` (신규)
- `test/models/view_group_test.rb` (13개 테스트)
- `test/models/view_group_member_test.rb` (11개 테스트)

## QA 검증 결과
- 테스트: 24/24 통과, 38 assertions, 0 failures
- 보안: FK 제약, unique 인덱스, 이중 보호 모두 정상
- 종합: 리뷰 진행 가능 (Critical/High 이슈 없음)

## Minor 이슈 (즉각 수정 불필요)
- `is_report_purchased` → `is_report_purchased?` 권장
- `diagnosis_session_id` 단독 인덱스 미추가 (향후 필요 시 추가)

## 작업 계획
- 목표: ViewGroup + ViewGroupMember 모델, 마이그레이션, 테스트, fixtures 생성
- 접근 방식: developer 1명이 TDD로 전체 구현, qa-verifier가 검증

## 현재 상태
- 보드 현황: backlog 5 / in_progress 1 / done 137
- 관련 기존 작업: 함께보기 기능 계획 (5개 PR 시리즈의 첫 번째)

## 기능 개요
- 커리어테크 아래 "함께 보기" 메뉴 신설
- 개인이 그룹 생성 → QR코드로 초대 → 팀강점 매트릭스 함께 보기
- Workspace와 달리 경량 구조 (승인/크레딧/결제 없음)

## 분석 결과
- 영향 범위: 모델 2개 신규, 컨트롤러 1개 신규, 뷰 5개, 서비스 1개, 사이드바/하단탭 수정
- 기존 패턴: Workspace의 invite_code, QrCodeHelper, TeamStrengthAnalyzer 참고
- 재사용: rqrcode gem, QrCodeHelper#qr_code_svg, 팀강점 차트 데이터 구조

## 생성된 티켓 (5개)
1. [함께보기 PR1] DB 레이어 (priority: high)
2. [함께보기 PR2] TeamStrengthAnalyzer 서비스 (priority: high)
3. [함께보기 PR3] 컨트롤러 + 라우트 (priority: high)
4. [함께보기 PR4] 뷰 (priority: high)
5. [함께보기 PR5] 네비게이션 + i18n (priority: medium)

## 의사결정 사항
- 참여 시 진단 세션 선택 필수 (report_purchased: true만)
- 소유자 나가기 → 그룹 삭제
- 전 locale에서 메뉴 표시
- 무료 검사로는 참여 불가

## 리스크
- TeamStrengthAnalyzer 결합도 → 별도 서비스로 분리하여 기존 코드 영향 없음
- 모바일 비로그인 QR → return_to 리다이렉트 활용

## 리뷰 결과
- bin/ci: 통과 (Rubocop 0 offenses, Brakeman 0 warnings, 테스트 전체 통과)
- 25개 티켓 모두 done 처리

## 보안 수정 (Critical/High)
- `blog/posts/show.html.erb`: `raw` → `sanitize` (XSS 방지)
- `study/enrollments_controller.rb`: 무료 등록 바이패스 차단
- `study/workshop_payments_controller.rb`: IDOR 수정 (`Current.user.payments.find_by!`)
- `study/assignment.rb`: 파일 content_type 검증 추가
- `config/brakeman.ignore`: 기존 admin mass assignment 4건 무시 처리

## 코드 품질 수정
- `blog/posts_controller.rb`, `admin/blog_posts_controller.rb`: LIKE wildcard injection → `sanitize_sql_like`
- `blog/posts_controller.rb`: N+1 → `includes(:author, :category)`
- `study/workshops_controller.rb`: N+1 → `includes(:course_applications)`

## UX/접근성 수정
- `blog/comments/_comment.html.erb`: reply-form Stimulus scope 수정
- `study/lessons/show.html.erb`: iframe title 속성 추가
- `blog/posts/index.html.erb`, `blog/categories/show.html.erb`: 검색 aria-label
- `blog/likes/_button.html.erb`: 좋아요 버튼 aria-label
- `accordion_controller.js`: aria-expanded 토글 추가
- `video_player_controller.js`: YouTube interval cleanup in disconnect()

## 배치 3 완료 요약
- PR 5-3, 7-1, 7-2, 7-3 모두 review 상태 전환
- Fixture FK 수정 (assignments, certificates)
- 병렬 테스트 워커 DB 12개 스키마 동기화
- todo 티켓 0개, 전 배치 review 대기 중

## 작업 배정
- PR 5-3 비디오 진도 추적 → developer-1
- PR 7-1 수강료 결제 → developer-2
- PR 7-2 워크숍 결제 → developer-3
- PR 7-3 과제+인증서 → developer-4

## 충돌 방지
- PR 5-3: study/progresses, video_player Stimulus
- PR 7-1: study/payments (수강료)
- PR 7-2: study/workshop_payments (워크숍)
- PR 7-3: study/assignments + study/certificates + admin
- routes.rb: 각자 담당 영역만 수정

## 작업 배정
- PR 2-3 TipTap 에디터 → developer-1
- PR 5-2 교육 공개 페이지 → developer-2
- PR 6-2 Workshop Admin+공개 → developer-3

## 충돌 방지
- PR 2-3: admin/blog_posts/ 영역만
- PR 5-2: study/ 컨트롤러+뷰, edu subdomain 라우트
- PR 6-2: admin/expert_courses/ + study/workshops/, admin sidebar 수정
- routes.rb: 각자 담당 영역만 수정 (admin namespace / edu subdomain)

## 작업 배정
- PR 3-2 SEO+RSS → developer-1
- PR 3-3 댓글+좋아요 → developer-2
- PR 5-1 Enrollment+Progress → developer-3
- PR 6-1 Workshop 모델 → developer-4

## 충돌 방지
- PR 3-2/3-3: routes.rb blog subdomain 분리 (feed vs comments/likes)
- PR 3-2: show.html.erb 수정 금지
- PR 5-1/6-1: 완전 독립 모듈

## 생성된 파일
### 컨트롤러 (2)
- admin/blog_posts_controller.rb — CRUD + 필터/검색/페이지네이션
- admin/blog_categories_controller.rb — CRUD

### 뷰 (9)
- admin/blog_posts/ — index, show, new, edit, _form
- admin/blog_categories/ — index, new, edit, _form

### 테스트 (2파일, 24 tests)
- admin/blog_posts_controller_test.rb (14)
- admin/blog_categories_controller_test.rb (10)

### 시드
- db/seeds/seed_blog_categories.rb — 12개 기본 카테고리

### 수정
- routes.rb — admin blog_posts, blog_categories 추가
- sidebar — 블로그 메뉴 추가
- ko.yml — admin 번역 추가

## 생성된 파일
- blog/categories_controller.rb — show (slug, 페이지네이션)
- blog/posts/show.html.erb — 상세 (breadcrumbs, 관련글)
- blog/posts/_post_card.html.erb — 카드 partial
- blog/categories/show.html.erb — 카테고리별 목록
- blog/shared/_sidebar.html.erb — 카테고리 + 최근글
- blog/shared/_pagination.html.erb — 수동 페이지네이션

## 수정된 파일
- blog/posts_controller.rb — index(12/page), show(slug, 조회수), search(ILIKE)
- blog/posts/index.html.erb — Coming Soon → 실제 목록
- routes.rb — blog subdomain에 posts, categories, search 추가

## 주요 구현
- 페이지네이션: 수동 offset/limit (12/page)
- 조회수: increment_counter 동시성 안전
- N+1 방지: includes(:author, :category)
- 비로그인 열람 가능

## 생성된 파일
### 컨트롤러 (3)
- admin/study_courses_controller.rb — CRUD + toggle_active
- admin/study_chapters_controller.rb — CRUD (nested under course)
- admin/study_lessons_controller.rb — CRUD (nested under chapter)

### 뷰 (12)
- admin/study_courses/ — index, show (트리 구조), new, edit, _form
- admin/study_chapters/ — new, edit, _form
- admin/study_lessons/ — new, edit, _form

### 테스트 (3파일, 29 tests)
- admin/study_courses_controller_test.rb (13)
- admin/study_chapters_controller_test.rb (8)
- admin/study_lessons_controller_test.rb (8)

### 수정
- config/routes.rb — admin study routes 추가
- admin/shared/_sidebar.html.erb — 교육 메뉴 추가
- admin/shared/_nav_item.html.erb — education 아이콘 추가

## 작업 계획
- developer-1: PR 2-2 Blog Admin CRUD (admin/blog_posts, admin/blog_categories)
- developer-2: PR 3-1 블로그 공개 페이지 (blog/posts, blog/categories)
- developer-3: PR 4-2 Study Admin CRUD (admin/study_courses, chapters, lessons)

## 파일 충돌 방지 전략
- routes.rb: 각 에이전트가 담당 영역만 수정
- admin sidebar: developer-1이 블로그 메뉴, developer-3이 교육 메뉴 담당
- developer-2는 blog subdomain 영역만 수정 (admin 미접촉)

## 리뷰 결과
- 상태: 승인
- 테스트: 98 runs, 147 assertions, 0 failures

## 코드 품질
- 판정: 조건부 승인 (Critical 0, High 4, Medium 6)
- High 이슈는 모두 향후 관련 PR에서 처리:
- Sluggable concern 추출 → PR 2-2/3-1
- slug 중복 suffix → PR 2-2/3-1
- 복합 인덱스 [status, published_at] → PR 3-1
- counter_cache (comments_count, likes_count) → PR 3-3

## 보안
- 판정: PASS (Critical 0, High 0, Medium 2)
- Brakeman: 경고 0건
- 의존성: 취약 Gem 0개
- Medium: comment content 길이 제한, materials_url 형식 검증 권장

## UX/UI
- P0/P1 이슈 5건 수정 완료
- default_scope 제거, 한글 slug fallback, Finish 레슨 추가, visible scope, inverse_of

## 구현 결과
- Blog 모델 4개: Category, Post, Comment, Like (마이그레이션 + 테스트 + fixtures)
- Study 모델 3개: Course, Chapter, Lesson (마이그레이션 + 테스트 + fixtures + 시드)
- 테스트: 98 runs, 147 assertions, 0 failures

## P0/P1 수정 완료
- default_scope 제거 → has_many ordering 람다로 이동
- 한글 slug fallback 추가 (Blog::Post, Category)
- Finish 레슨 시드 추가
- visible scope + published_at 자동설정
- Blog 모델 inverse_of 추가

## UX/UI 검토 결과
- 모델 구조가 향후 UI 구현을 잘 지원
- P2/P3 이슈는 컨트롤러 구현 시 함께 처리 예정

## 테스트/보안 검증 결과
- brakeman: 경고 0건
- FK/인덱스 모두 적절
- bin/ci rubocop 실패는 기존 코드 문제 (새 코드는 OK)

## UX 리뷰 결과
- 평가: 개선 필요 (Minor~Medium)
- P0: default_scope 제거, 한글 slug fallback
- P1: Finish 레슨 누락, visible scope, published_at 자동설정

## QA 검증 결과
- bin/ci: rubocop 실패 (기존 코드 문제, 새 코드는 OK)
- 테스트: 91 runs, 0 failures
- brakeman: 경고 0건
- 종합: 리뷰 진행 가능

## 수정 계획
P0/P1 이슈 5건을 developer로 수정 후 완료 처리

## 생성된 파일

### 마이그레이션 (3)
- `db/migrate/20260311110000_create_study_courses.rb`
- `db/migrate/20260311110001_create_study_chapters.rb`
- `db/migrate/20260311110002_create_study_lessons.rb`

### 모델 (4)
- `app/models/study.rb` — table_name_prefix "study_"
- `app/models/study/course.rb` — recalculate_totals!, slug 자동생성(한글 처리)
- `app/models/study/chapter.rb` — preview/ordered scopes
- `app/models/study/lesson.rb` — video_type enum (vimeo/youtube)

### 테스트 (3파일, 46 tests)
- `test/models/study/course_test.rb` (18)
- `test/models/study/chapter_test.rb` (12)
- `test/models/study/lesson_test.rb` (16)

### 시드
- `db/seeds/seed_study_courses.rb` — 강점코치 입문 과정 (11챕터, 24레슨, 353분)

## 검증
- 46/46 테스트 통과
- 마이그레이션 → 롤백 → 재마이그레이션 성공
- 시드 idempotent 확인
- recalculate_totals! 정상 동작

## 생성된 파일

### 마이그레이션 (4)
- `db/migrate/20260311100000_create_blog_categories.rb`
- `db/migrate/20260311100001_create_blog_posts.rb`
- `db/migrate/20260311100002_create_blog_comments.rb`
- `db/migrate/20260311100003_create_blog_likes.rb`
- `db/migrate/20260311123734_create_active_storage_tables.active_storage.rb`

### 모델 (5)
- `app/models/blog.rb` — table_name_prefix "blog_"
- `app/models/blog/category.rb`
- `app/models/blog/post.rb`
- `app/models/blog/comment.rb`
- `app/models/blog/like.rb`

### 테스트 (4파일, 45 tests)
- `test/models/blog/category_test.rb` (9)
- `test/models/blog/post_test.rb` (21)
- `test/models/blog/comment_test.rb` (9)
- `test/models/blog/like_test.rb` (6)

### Fixtures (4)
- `test/fixtures/blog/categories.yml`
- `test/fixtures/blog/posts.yml`
- `test/fixtures/blog/comments.yml`
- `test/fixtures/blog/likes.yml`

### 수정된 파일
- `app/models/user.rb` — has_many :blog_posts, :blog_comments, :blog_likes 추가

## 검증
- 45/45 테스트 통과
- 마이그레이션 → 롤백 → 재마이그레이션 성공
- Development DB 무사 (users: 9066, sessions: 8509)

## 작업 계획
- PR 2-1 (Blog 모델)과 PR 4-1 (Study 모델) 병렬 구현
- developer-1: Blog::Post, Category, Comment, Like 모델 + 마이그레이션
- developer-2: Study::Course, Chapter, Lesson 모델 + 시드 데이터
- 완료 후 UX/UI 리뷰 + QA 검증

## 접근 방식
- 각 developer가 독립적인 테이블/모델을 담당하여 파일 충돌 없음
- TDD 방식: 테스트 먼저 → 구현

## 리뷰 결과
- 상태: 승인
- 테스트: 6/6 통과, regression 없음

## 코드 품질
- BaseController 상속 구조 적절 (ApplicationController → BaseController → PostsController)
- default_url_options 오버라이드로 locale 파라미터 깔끔하게 제거
- skip_before_action :set_sidebar_workspaces 적절 (비인증 페이지)
- strict locals 사용 (_navbar_subdomain)

## 보안
- csrf_meta_tags, csp_meta_tag 포함
- allow_unauthenticated_access 적절 (공개 페이지)
- html_safe/raw 사용 없음

## UX/UI
- shared/footer 재사용 (법적 정보 포함)
- shared/_navbar_subdomain 추출로 DRY
- yield :head 추가 (SEO 확장성)
- 디자인 토큰 올바르게 사용

## 수정된 기능
- blog./edu. 서브도메인 라우팅 constraints
- Blog::BaseController, Study::BaseController
- blog.html.erb, study.html.erb 레이아웃
- shared/_navbar_subdomain.html.erb (공통 navbar)
- 임시 컨트롤러/뷰 (Coming Soon)

## UX/UI 검토 결과
- P1 수정 완료: footer → shared/footer, yield :head 추가
- P2 수정 완료: navbar partial 추출, skip_before_action 추가
- P3 후속 처리: 배경색 토큰 통일, max-w 통일, 메타태그 보완

## 테스트/보안 검증 결과
- 신규 6개 테스트 통과
- 기존 테스트 regression 없음 (기존 8개 실패는 무관)
- CSRF/CSP/XSS 보안 처리 적절

## 생성/수정 파일
- config/routes.rb (서브도메인 constraints)
- config/environments/development.rb (hosts 추가)
- app/controllers/blog/base_controller.rb
- app/controllers/study/base_controller.rb
- app/controllers/blog/posts_controller.rb
- app/controllers/study/courses_controller.rb
- app/views/layouts/blog.html.erb
- app/views/layouts/study.html.erb
- app/views/shared/_navbar_subdomain.html.erb
- app/views/blog/posts/index.html.erb
- app/views/study/courses/index.html.erb
- test/controllers/blog/posts_controller_test.rb
- test/controllers/study/courses_controller_test.rb

## 작업 계획
- 목표: blog./edu. 서브도메인 라우팅 인프라 구축
- 접근: developer 1명으로 라우팅+컨트롤러+레이아웃+테스트 구현

## 현재 상태
- 보드: todo 17 / in_progress 1 / done 104
- 이 티켓이 모든 후속 Phase의 기반

## 기능 개요
- blog.9way.co.kr: 블로그 (포스트, 카테고리, 댓글, 좋아요, SEO)
- edu.9way.co.kr: 교육 LMS (코스, 레슨, 수강, 진도추적) + 워크숍 (오프라인)

## 분석 결과
- 기존 앱에 Blog/Education 관련 코드 없음 — 완전 신규
- ActiveStorage 설정됨(미사용), Grover(PDF) 사용 가능
- 기존 결제 서비스(Toss Payments) 재사용 가능

## 생성된 티켓 (17개, 7 Phase)
- Phase 1: 서브도메인 라우팅 (1개, HIGH)
- Phase 2: 블로그 코어 (3개, HIGH)
- Phase 3: 블로그 퍼블릭 (3개, HIGH)
- Phase 4: 교육 코스 (2개, MEDIUM)
- Phase 5: 교육 수강 (3개, MEDIUM)
- Phase 6: 워크숍 (2개, MEDIUM)
- Phase 7: 결제+고급 (3개, LOW)

## 기술적 결정
- 리치 텍스트: text 컬럼 + TipTap (ActionText 대신)
- 이미지: ActiveStorage
- PDF: Grover
- 네임스페이스: Blog::, Study::, Expert::

## 계획서
- docs/plans/blog-edu-subdomain.md

## 변경 사항
- `test/load/diagnosis_flow.js` 생성
- slug 수정: `big5-adult` → `big5` (실제 DB slug과 일치)

## 스모크 테스트 결과 (로컬 dev, 2 VU, 30초)
- 진단 시작 p95: 53ms (기준 < 2000ms)
- 문항 로드 p95: 245ms (기준 < 1500ms)
- 응답 제출 p95: 73ms (기준 < 3000ms)
- 결과 로드 p95: 16ms (기준 < 2000ms)
- 플로우 완료: 4건
- 에러: 0건

## 실행 방법
```
docker run --rm --network host \
-v $(pwd)/test/load:/scripts \
grafana/k6:latest run \
--env BASE_URL=https://9way.org \
/scripts/diagnosis_flow.js
```

## 생성 파일
- `test/load/diagnosis_flow.js` (신규)

## 주요 기능
- Big5 진단 전체 플로우 시뮬레이션 (5단계)
- ramp-up: 10 → 50 → 100 → 500 → 0
- 커스텀 메트릭 4개 + 실패율 메트릭
- CSRF 토큰 자동 파싱
- 실제 question ID 기반 응답 생성
- 5% 확률 "해당 사항 없음" 시뮬레이션
- thresholds: p95 < 1s, 에러율 < 1%

## 작업 계획
- 목표: Big5 진단 전체 플로우의 부하 테스트 스크립트 작성
- 접근 방식: 에이전트가 기존 라우트와 API를 분석하여 k6 스크립트 생성

## 현재 상태
- 단일 티켓으로 서브 티켓 불필요
- 코드 변경 없이 신규 파일 1개 생성

## 리뷰 결과
- 상태: 승인 (서브 티켓 2건 모두 완료)

## 서브 티켓 결과
1. Server API: 승인 — upsert_all 벌크 저장, 타입 안전성 수정 완료, 테스트 12건 통과
2. Client Stimulus: 승인 — ARIA 접근성, i18n 4개 언어, 타임아웃 토스트 추가 완료

## 보안
- Brakeman 0건, bundler-audit 0건
- CWE 스캔 Critical 0건
- XSS 방어 적절 (_escapeHTML, textContent, ERB 자동 이스케이프)

## 성과
- HTTP 요청 30배 감소 (30라운드 × AJAX → 최종 1회 제출)
- sessionStorage crash recovery 구현
- 4개 언어 i18n 완전 지원

## 리뷰 결과
- 상태: 승인
- 코드 품질: 반려사유 3건 모두 수정 확인 (ARIA 접근성, i18n 7개 value, 타임아웃 토스트)
- 보안: PASS — innerHTML은 _escapeHTML()로 보호, 토스트는 textContent 사용, ERB 자동 이스케이프 적용
- i18n: 4개 언어(ko, en, zh, vi) 모두 7개 키 존재 확인

## 리뷰 결과
- 상태: 승인
- 코드 품질: 반려사유 3건 모두 수정 확인 (Boolean cast, question_id 타입 통일, index 키 타입 통일)
- 보안: PASS — ActiveModel::Type::Boolean.new.cast() 안전, .to_s 변환 SQL injection 무관
- 테스트: 타입 안전성 테스트 2건 추가, 전체 12 runs 0 failures

## 변경 사항
### big5_batch_controller.js
- ARIA: role="radiogroup", role="radio", aria-checked 추가
- ARIA: neither 버튼에 aria-label 추가
- ARIA: selectCard()/selectNeither()에서 aria-checked 토글
- i18n: 7개 Stimulus value 추가 (submittingText, completeTitle 등)
- i18n: _showSubmitting/_showComplete/_showError의 하드코딩 텍스트를 value로 교체
- 타임아웃: _showTimeoutToast() 메서드 추가, 1.5초 토스트 표시 후 다음 라운드 전환

### big5_show.html.erb
- 카운트다운에 role="timer" aria-live="polite" 추가
- 7개 data-big5-batch-*-value 속성 추가 (t() 헬퍼로 번역 전달)

### i18n 파일 (4개 언어)
- diagnosis.big5.batch.* 키 추가 (ko, en, zh, vi)

## 변경 사항
### diagnosis_sessions_controller.rb
- `ActiveModel::Type::Boolean.new.cast(r[:selected])` 적용 — 문자열 "false" 안전 처리
- `submitted_ids`를 `.to_s` 변환하여 타입 통일
- `valid_question_id_strings` Set 생성으로 검증 로직 타입 일치
- `string_keyed_index` 변환으로 dna_type nil 방지

### diagnosis_sessions_controller_test.rb
- 문자열 "true"/"false" selected 필드 테스트 추가
- 문자열 question_id 검증 및 dna_type 조회 테스트 추가

## 테스트 결과
- 12 runs, 63 assertions, 0 failures, 0 errors

## 리뷰 결과
- 상태: 승인
- 코드 품질: 2×7=14 슬롯, 메모리 영향 미미(~14MB). DB pool 자동 연동 확인
- 보안: 이슈 없음
- UX/UI: 해당 없음
- 참고: 배포 후 메모리 사용량 모니터링 권장

## 리뷰 결과
- 상태: 승인
- 코드 품질: 이슈 없음. PDF 생성(10-30초) 고려한 60초 설정 합리적
- 보안: 이슈 없음
- UX/UI: 해당 없음

## 리뷰 결과
- 상태: 승인
- 코드 품질: locale별 캐싱 적절. 이중 캐싱(Rails.cache + 메모이제이션) 효율적
- 보안: 이슈 없음
- UX/UI: 해당 없음

## 리뷰 결과
- 상태: 승인
- 코드 품질: upsert_all 벌크 저장 적절. where(id:).index_by 패턴으로 N+1 제거 확인
- 보안: SQL Injection 위험 없음
- UX/UI: 해당 없음

## 리뷰 결과
- 상태: 승인
- 코드 품질: 캐시 키 설계(session.id + locale) 적절. includes(:translations)로 N+1 방지
- 보안: 캐시 오염 불가 확인
- UX/UI: 해당 없음

## 리뷰 결과
- 상태: 승인
- 코드 품질: 이슈 없음. test 환경 url 고정으로 DATABASE_URL 침투 방지 확인
- 보안: DB 설정 적절
- UX/UI: 해당 없음

## 리뷰 결과
- 상태: 반려
- bin/ci: 통과

## 코드 품질
- sessionStorage crash recovery 잘 구현됨
- XSS 방어 (_escapeHTML) 적절
- catch 블록 에러 무시 (medium) — console.warn 추가 권장

## 보안
- CSRF 토큰 헤더 전송 OK
- sessionStorage 동일 탭 한정 OK

## UX/UI
- [MUST-FIX] 진단 카드 ARIA 속성 누락 (role="radio", aria-checked, role="radiogroup")
- [MUST-FIX] locale_dropdown ARIA 누락 (aria-expanded, role="menu")
- [MUST-FIX] JS 내 한국어 텍스트 하드코딩 — 4개 언어 지원인데 i18n 미적용
- [MUST-FIX] 타임아웃 자동 스킵 시 사용자 피드백 없음

## 수정 필요 사항
- ARIA 접근성 속성 추가
- Stimulus value로 번역 텍스트 전달 또는 서버 렌더링 template 사용
- 타임아웃 스킵 토스트 메시지 추가

## 리뷰 결과
- 상태: 반려
- bin/ci: 통과 (payments 관련 기존 실패 제외)

## 코드 품질
- [CRITICAL] r[:selected] 타입 안전성 — 문자열 "false"가 truthy로 처리되어 모든 응답이 1로 저장될 위험
- [HIGH] question_id 타입 불일치 — String vs UUID Set 비교로 검증 무력화 가능
- [HIGH] valid_questions_index 키 타입 불일치 — dna_type이 nil로 저장될 위험

## 보안
- Brakeman/bundler-audit 통과
- upsert_all SQL Injection 위험 없음
- value 필드 Boolean→0/1 변환으로 임의값 주입 불가

## UX/UI
- 해당 없음 (서버 API)

## 수정 필요 사항
- ActiveModel::Type::Boolean.new.cast() 사용
- r[:question_id].to_s로 타입 통일
- 타입 안전성 테스트 추가

## 수정된 기능
- database.yml: `max_connections` → `pool` 키 수정 (AR 표준 키)
- deploy.yml: response_timeout 120→60초, RAILS_MAX_THREADS 5→7
- prepare_all_big5_rounds: Rails.cache.fetch 캐싱 (세션별, 1일 TTL)
- build_description_cache: Rails.cache.fetch 캐싱 (locale별, 1일 TTL)

## 테스트/보안 검증 결과
- bin/ci: 855 runs, 3 failures/7 errors (모두 pre-existing)
- Brakeman: 신규 이슈 없음
- N+1 쿼리: 없음
- 캐시 키 안전성: 확인 (사용자 입력 미포함)

## 변경 파일
- config/database.yml
- config/deploy.yml
- app/controllers/diagnosis_sessions_controller.rb
- app/services/diagnosis/big5_result_formatter.rb
- test/controllers/diagnosis_sessions_controller_test.rb
- test/services/diagnosis/big5_result_formatter_test.rb

## 재검증 결과

### ✅ 캐싱 구현 확인

**prepare_all_big5_rounds (diagnosis_sessions_controller.rb:364)**
```ruby
Rails.cache.fetch(["big5_rounds", @session.id, I18n.locale], expires_in: 1.day)
```
- 캐시 키: 세션 ID + 로케일 조합 ✅
- 만료: 1일 TTL ✅
- 사용자 입력 미포함: session.id(UUID), I18n.locale(시스템값) ✅
- RNG 시드도 `Digest::MD5.hexdigest(@session.id.to_s)` 방식으로 개선 (process 재시작에도 동일 시드 보장) ✅

**build_description_cache (big5_result_formatter.rb:36)**
```ruby
Rails.cache.fetch("big5:descriptions:#{locale}", expires_in: 1.day)
```
- 캐시 키: 로케일 기반 ✅
- 만료: 1일 TTL ✅
- 사용자 입력 미포함 ✅

### ✅ 테스트 결과
- 컨트롤러: 10 runs, 23 assertions, 0 failures, 0 errors ✅
- Formatter: 4 runs, 6 assertions, 0 failures, 0 errors ✅
- 전체: 855 runs, 2135 assertions, 3 failures, 7 errors (모두 pre-existing)
- CustomPayments 라우팅 7건 (pre-existing)
- Admin::Payments 3건 (pre-existing)

### ✅ 보안 (Brakeman)
- 신규 이슈 없음 (기존 4건 동일)

### ✅ N+1 쿼리 없음
- `includes(:translations)` 적용
- `find_quality_code`는 `Rails.cache.fetch("big5:quality_code_map")` 유지

### 종합 판정
**검증 통과** — 모든 캐싱 구현이 올바르게 완료됨