Sprint 133: 이월 항목 처리

Decisions

Context: Sprint 129에서 LanguageSwitcher 4곳 마운트(AppLayout L384/L464, AuthShell L43, LandingContent L80). Sprint 132에서 LegalLayout 5번째 마운트. GuestNav(/guest, /guest/preview/[slug])는 자체 nav(Logo + ThemeToggle + signup CTA)가 있으나 LanguageSwitcher 미마운트 — 게스트 페이지 한/영 전환 불가
Choice: GuestNav 우측 actions div에 <Suspense fallback={null}><LanguageSwitcher /></Suspense> 추가 (ThemeToggle 앞 배치). 6번째 마운트 지점 일관화. GuestNav.test.tsx 신규 생성(4 cases)
Alternatives: ThemeToggle 뒤 배치 → 다른 마운트 지점과 시각적 위치 불일치
Code Paths: frontend/src/components/guest/GuestNav.tsx:73-75, frontend/src/components/guest/__tests__/GuestNav.test.tsx
PR: #163 (ea9ac28, Squash merge)

Context: SharedLayout(/shared/[token])은 <>{children}</> 빈 fragment — nav 자체 부재. LanguageSwitcher 마운트 시 nav 컨테이너 신규 디자인 필요
Choice: 정책 제외 유지. 공유 링크는 토큰 발급자 locale 고정이 UX 상 적절. Sprint 132 D2 정책 결정과 일관
Alternatives: ① 미니 nav 추가 (디자인 결정 필요, scope 초과) / ② page.tsx 상단에 위임 (UX 어색)
Rationale: 비인증 공유 링크에서 언어 전환은 발급자 의도 이탈. nav 없는 레이아웃에 강제 마운트는 과잉

Context: Sprint 130 ADR-026 이월 항목. Scout 정찰 결과 DLQ(submission.events.dlx) + NACK(channel.nack(msg, false, false)) + Redis 멱등성 + Saga 타임아웃(5/15/30분) + 최대 3회 재시도가 완전 구현됨
Choice: D-2 이월 해소. Circuit Breaker 패턴 부재는 별건으로 Sprint 134+ 시드
Code Paths: services/github-worker/src/worker.ts:132,224,350-402, services/submission/src/saga/mq-publisher.service.ts:88-105,149-207, services/submission/src/saga/saga-orchestrator.service.ts:34-42,455

Context: Scout 정찰 중 infra/ 디렉토리가 이 AlgoSu 레포에 존재하지 않음 확인. k8s 매니페스트는 aether-gitops 외부 레포에만 존재
Choice: C-1(revisionHistoryLimit 추가) 포함 모든 매니페스트 변경은 aether-gitops 레포에서 별도 작업 필요. Sprint 134+ 이월

사실 관계 정정: infra/ 디렉토리는 본 레포에 실제로 존재한다. Sprint 133 Wave B 정찰의 find infra/ ... 명령이 셸 글로빙 / 인자 형태 문제로 빈 결과를 반환하여 "부재"로 오판한 것
실제 구조:
- infra/k3s/ — base Kustomize 매니페스트 (gateway/frontend/postgres/redis/rabbitmq/minio/identity/problem/submission/github-worker/ai-analysis 등 전체 서비스)
- infra/overlays/{dev,staging,prod}/ — 환경별 Kustomize overlay (이미 분리 완료, ADR-028 옵션 A 적용 근거)
- infra/sealed-secrets/ — SealedSecret 템플릿
- infra/DEPLOYMENT.md — 배포 가이드 (L115에 revisionHistoryLimit: 3 정책 명시)
C-1 재분류: revisionHistoryLimit 적용은 본 레포 infra/k3s/*.yaml 직접 수정 가능. aether-gitops 외부 작업 아님. Sprint 134 작업 후보로 정정
검증 패턴 교훈: Scout 정찰 시 find <dir> 빈 결과는 디렉토리 부재가 아니라 명령 인자 / 글로빙 문제일 수 있음 — ls -la <dir> + test -d <dir> + find <dir> -type f | head 3중 확인 필수
연관 ADR: ADR-028(부분 적용됨 확정), 사용자 발언 2026-04-27 "개발서버는 이미 분리되어있습니다"

Where: GuestNav.tsx (Client Component)
Pattern: <Suspense fallback={null}><LanguageSwitcher /></Suspense> — 우측 actions 영역, ThemeToggle 또는 nav 우측 첫 번째 위치
Precedent: AppLayout(L384/L464), AuthShell(L43), LandingContent(L80), LegalLayout(L36-38), GuestNav(L73-75)
When to Reuse: 신규 layout에 언어 전환 필요 시. nav 컨테이너가 이미 존재하는 경우에만 적용. nav 부재 시 정책 제외 판단 선행

Sprint 130 운영 부채 미소화분 (aether-gitops 외부 레포 또는 인프라 의존):

ADR-027 구현 — aether-gitops 브랜치 규율
ADR-028 구현 — 개발 서버 분리 (인프라 비용 결정 선행)
C-1: revisionHistoryLimit: 3 적용 완료 — 본 레포 infra/k3s/*.yaml 8개 Deployment (Sprint 134 PR로 적용)
D-1: 사후 정정 — e2e-full.sh 657줄 실재, .github/workflows/ci.yml workflow_dispatch 수동 전용. 자동 PR CI 통합은 Sprint 135 신규 시드로 재분류 (Sprint 134 정정)
SealedSecret 컨트롤러 키 rotation 자동 재봉인 CI
AlertManager receiver self-test 룰

신규 시드:

Circuit Breaker 패턴 도입 (GitHub API, Problem Service, AI Analysis Service HTTP 호출)