Skip to content

♻️ [Refactor] 지표 메타데이터 Registry 중앙화 #239

@Seojegyeong

Description

@Seojegyeong

🛠️ Issue Description

현재 동일한 지표(clicks, impressions, ROAS 등)의 표시 이름·포맷 함수·단위가 useOverviewMetrics.ts, SinglePlatformView.tsx, AI 리포트 레이블 등 여러 파일에 각각 흩어져 정의되어 있습니다.
공통 파일을 생성하여 API 필드명 → 화면 레이블 → 포맷 함수를 한 곳에서 관리합니다.

💭 Cause and effect

원인

  • "클릭수", toLocaleString() 등 동일한 표현 규칙이 화면 컴포넌트와 훅에 중복 작성되어 있음
  • 지표 이름 변경 시 연관된 모든 파일을 직접 찾아 수정해야 하며 누락 위험 존재
  • AI 리포트 레이블과 화면 표시 텍스트가 별도로 관리되어 불일치 가능성이 있음

예상 결과

  • 지표 이름·포맷·단위 변경 시 metricRegistry.ts 한 곳만 수정하면 전파됨
  • API 필드명, 화면 레이블, AI 리포트 레이블의 연결 고리가 코드에서 명확하게 드러남
  • 새 지표 추가 시 Registry에 항목 하나만 추가하면 전체 화면에 일관되게 반영 가능

📝 check-lists

  • src/constants/metricRegistry.ts 생성 - label, format, unit 필드 포함한 타입 정의
  • 현재 사용 중인 지표 목록 파악 및 Registry에 등록
  • useOverviewMetrics.ts - 인라인 title / value 포맷 → Registry 참조로 교체
  • SinglePlatformView.tsx - 동일 지표 중복 정의 → Registry 참조로 교체
  • AI 리포트 레이블 - Registry의 label 필드 재사용으로 통일

Metadata

Metadata

Assignees

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions