refactor: 프론트엔드 미사용 코드 정리 (869줄) + knip 게이트 승격

[k002bill2]

요약

대시보드의 미사용 코드를 5배치로 정리하고, 재발을 막도록 CI knip 게이트를 승격했습니다.
51파일 869줄 삭제, 기능 변경 없음.

knip Unused exports 88 → 8, Unused files 8 → 0, Duplicate exports 19 → 0.

배치 구성

커밋	내용	지표
93469f3	미사용 파일 8건 삭제	files 8 → 0
f64d3bc	knip 게이트 승격 + 중복 default export 19건	duplicate 19 → 0
abb35a1	스켈레톤 7종 (barrel 줄 + 파일 동시)	exports 69 → 55
b45ffb8	barrel 7종 미사용 재노출 29줄	exports 55 → 27
95cbbe5	dead code 함수·컴포넌트 12건 + export 축소 4건	exports 27 → 8

게이트 승격 (재발 방지)

- "knip": "knip --dependencies"
+ "knip": "knip --dependencies --include files"
+ "knip:all": "knip"

CI frontend-knip(required)이 이제 미사용 파일도 차단합니다.
exports/types까지 켜지 않은 이유는 잔여 86건이 즉시 CI를 빨간불로 만들기 때문이며,
백엔드 mypy의 래칫 전략(pyproject.toml disable_error_code)과 같은 방식으로
현재 수준에서 고정하고 악화만 막습니다. 조사는 게이트 밖 knip:all로 합니다.

검증

배치마다 아래 5종을 전부 통과(exit 0)했고, 각 배치에 Codex 외부 리뷰를 돌려 지적 0건입니다.

게이트	최종 결과
tsc --noEmit	exit 0
eslint	에러 0
knip (CI 게이트)	exit 0
vitest run	205 파일 / 4365 테스트 통과 (5배치 내내 불변)
vite build	성공
test:coverage	threshold 에러 없음 — Statements 71.67% → 71.96%, Lines 72.86% → 73.13%

판정 근거에 대한 메모

정적 "unused" 판정을 그대로 신뢰하지 않고 모듈 그래프로 확인했습니다. 실제로 세 번 갈렸습니다.

1. 상대경로 grep은 판정 불가 — '../audit'이 출발 디렉토리에 따라 stores/audit과
   components/audit 중 무엇을 가리키는지 달라집니다
2. 형제 파일 참조 — barrel 29줄 제거 시 고아 파일이 0건이었습니다. 소비자가 같은
   디렉토리의 형제 파일이라 경로 기반 grep에는 보이지 않습니다
3. unused export ≠ 미사용 — knip의 unused export는 "외부에서 안 쓰인다"입니다.
   같은 파일 안에서 쓰이는 것은 본체를 두고 export만 제거했습니다
   (splitArgs/applySandboxPreset, formatTrendLabel/normalizeProvider)

남긴 것

• unused exports 8건 — 테스트 동반 삭제 필요(feedback 셀렉터 3종),
  이름 단위 편집(MergeRequestCard), 스토어 구현체 멀티라인 블록(orchestration 4종).
  각각 별도 판단이 필요해 이번 범위에서 제외했습니다
• exported types 78건 — 정리 권고하지 않습니다. TS 타입은 컴파일 시 소거되어 출력
  변화가 0이고 게이트 대상도 아닌 반면, FastAPI↔React 계약 타입이라 integration-qa의
  대조 근거로 쓰입니다
• AuditLogFilter 중복 정의 (stores/audit.ts:31, components/audit/AuditLogTable.tsx:45)
  — 삭제가 아니라 통합 리팩터 후보라 손대지 않았습니다
• 백엔드 ERA001 21건 / ARG 81건 — 별건. 크로스모듈 dead code는 vulture 설치 선행 필요

테스트 계획

• npm run type-check / npm run lint / npm run knip
• npm run test:coverage (4365건 통과, 임계치 충족)
• npm run build
• Codex 외부 리뷰 5회 (배치별) — 지적 0건
• CI 7개 job 통과 확인

🤖 Generated with Claude Code

https://claude.ai/code/session_017UEJENahpFQRnU6aYKkH7V