# 02. KPI <-> Dataset 연동

## 목표

- KpiMetric과 Dataset의 필드 매핑 구조 확정, KPI 산식(formula) 자동 계산 로직 구현 (Metric 코드 → Dataset 필드 매핑)

## 세부 작업

1. **KpiMetric-DataSet 매핑 구조 설계**
   - [x] KpiMetric이 참조할 Dataset, 필드, 단위 등 매핑 구조 설계
   - [x] Metric 코드와 Dataset 필드의 1:1/1:N 매핑 지원
2. **매핑 UI/UX 및 API 구현**
   - [x] KPI/Metric 관리 화면에서 Dataset 필드 매핑 UI 구현
   - [x] 매핑 저장/수정/검증 API 구현
3. **산식(formula) 파서/검증기 구현**
   - [x] formula 문자열에서 Metric 코드 추출, 구문/유효성 검사
   - [x] 잘못된 formula/매핑에 대한 에러 처리
4. **집계 쿼리/로직 설계 및 구현**
   - [x] Dataset에서 Metric별 RAW 데이터 집계 쿼리/로직 구현
   - [x] 다양한 집계 방식(합계, 평균, 조건부 등) 지원
5. **테스트/문서화**
   - [ ] 매핑/산식/집계 단위/통합 테스트, 예시, 문서화 보완 필요

## 체크리스트

- [x] KpiMetric-DataSet 매핑 구조 설계/구현
- [x] 매핑 UI/저장/검증 API 구현
- [x] formula 파서/검증기 구현 및 테스트
- [x] 집계 쿼리/로직 구현 및 테스트
- [ ] 문서화/예시/테스트 추가 필요

## 완료 기준

- [x] KPI와 Dataset의 매핑/산식/집계가 UI/API/로직/테스트/문서화까지 일관성 있게 구현됨
- [ ] 예시/문서화/테스트가 완전히 보강되어야 함 # 추가 보완 필요