# 03. KPI 실적값(KpiValue) 자동 집계/생성

## 목표

- Dataset에서 Metric별 집계 → formula 계산 → KPI Value 자동 생성/저장 로직 구현

## 세부 작업

1. **자동 집계 트리거/스케줄 설계**
   - [x] KPI Value 자동 집계 주기(스케줄러, 수동 트리거 등) 설계
   - [x] 집계 대상 KPI/기간/조직 등 파라미터 정의
2. **집계/계산/저장 로직 구현**
   - [x] Dataset에서 Metric별 RAW 데이터 집계
   - [x] KPI formula에 따라 계산, KPI Value 엔티티로 저장
   - [x] 집계/계산 오류 및 로그 기록
3. **수동 입력/수정 지원**
   - [ ] 자동 집계 외 수동 입력/수정 API/화면 구현 필요
   - [ ] 수동 입력 시 이력/상태 관리 보완 필요
4. **이중 집계/중복 방지**
   - [x] 동일 KPI/기간/조직에 대해 중복 집계 방지 로직 구현
   - [x] 기존 값 존재 시 덮어쓰기/누적/무시 등 정책 정의
5. **테스트/문서화**
   - [ ] 자동/수동 집계 시나리오별 테스트, 예시, 문서화 보완 필요

## 체크리스트

- [x] 자동 집계 트리거/스케줄 설계/구현
- [x] 집계/계산/저장/업서트/에러처리 구현
- [ ] 수동 입력/수정, 테스트/문서화 보완 필요

## 완료 기준

- [x] KPI Value 자동 집계/생성 로직이 완전히 동작함
- [ ] 수동 입력/테스트/문서화가 완전히 보강되어야 함 # 추가 보완 필요