# EvalVault 상태 요약 (Status)

> Audience: 개발자 · 운영자 · 리뷰어
> Purpose: "지금 EvalVault가 어디까지 왔고, 무엇을 하고 있는지"를 1페이지로 공유
> Last Updated: 2026-01-09

---

## 현재 상태 (요약)

- **Current Version**: 릴리스는 git tag 기준 (pyproject 버전은 릴리스 워크플로에서 동기화)
- **Core Focus**: 병렬 리팩토링 단계 (R1~R4, D1 샘플/리포트 확보)
- **Tests**: 약 1.3k+ (unit 1,261 + integration 91 기준)

테스트 수 확인(재현 가능):

```bash
uv run pytest tests --collect-only -q
```

---

## 지금 “활발히 쓰는” 핵심 기능

- **평가 실행/저장/비교**: Typer CLI + SQLite/PostgreSQL 저장소
- **Web UI**: FastAPI + React 기반 Evaluation/History/Reports
- **관측성(Observability)**: Phoenix(OpenTelemetry/OpenInference) 중심, 필요 시 Langfuse/MLflow 병행
- **Domain Memory**: 평가 결과 학습 → threshold 보정/컨텍스트 보강/트렌드 분석
- **분석 파이프라인**: Query → Intent 분류 → DAG 모듈 실행(요약/검증/비교/분석)

---

## 현재 제한 사항 (투명 공개)

- **Web UI 리포트**: 기본/상세 템플릿 + LLM 보고서만 제공, 비교 템플릿은 준비 중
- **Domain Memory 인사이트**: CLI(`evalvault analyze`, `domain memory`) 중심으로 노출, Web UI 패널은 미제공
- **MemoryBasedAnalysis**: CLI 분석 경로에서 제공, Web UI 보고서에는 아직 미연동

---

## 현재 작업의 성격 (시점/우선순위)

병렬 에이전트가 작업한 결과를 리팩토링/통합하는 단계입니다.

- **병렬 리팩토링**: R1~R4 산출물 정합성/경로 최신화
  - 기준 문서: [internal/plans/PARALLEL_WORK_PLAN.md](../internal/plans/PARALLEL_WORK_PLAN.md)
- **문서 통합/최신화**: ✅ 완료 (2026-01-09)
  - 통합 문서: `guides/USER_GUIDE.md`, `architecture/ARCHITECTURE.md`
  - README 언어 변경: `README.md` (한국어), `README.en.md` (영어)
- **CLI/Web/성능 리팩토링**: P2.2, P4.1 진행 중, P3 완료
  - 로드맵: [ROADMAP.md](ROADMAP.md)

---

## P2 완료 현황 (R1~R4, D1)

병렬 리팩토링 트랙(R1~R4, D1) 산출물 확보 기준으로 **완료 상태**로 정리했습니다.

| ID | 상태 | 비고 |
|----|------|------|
| R1 | 완료 | 하이브리드 서치 평가 파이프라인 통합 |
| R2 | 완료 | GraphRAG 검색 최적화 + 샘플 확보 |
| R3 | 완료 | 대용량 처리 최적화 샘플/리포트 확보 |
| R4 | 완료 | 하이브리드 서치 벤치마크 스모크 완료 |
| D1 | 완료 | DebugReportService 샘플 3종 검증 |

> 상세 산출물은 내부 상태 보드(`docs/internal/status/STATUS.md`)에 집계합니다.

---

## ROADMAP 기준 다음 작업 (병렬 진행 가능)

1. P2.2 Web UI 재구조화
2. P3 성능 최적화
3. P4.1 CLI UX 개선
4. P5 테스트 개선
5. P6 문서화 개선 (완료)
6. P8.5 Domain Memory 확장 과제

상세 범위/일정: [internal/plans/PARALLEL_WORK_PLAN.md](../internal/plans/PARALLEL_WORK_PLAN.md)

### 지금 착수해야 할 작업

- P2.2 Web UI 재구조화
- P3 성능 최적화
- P6 문서화 개선 ✅ (2026-01-09 완료)
- P8.5 Domain Memory 확장 과제
- 상세 범위/일정: [internal/plans/PARALLEL_WORK_PLAN.md](../internal/plans/PARALLEL_WORK_PLAN.md)

---

## 문서/작업 추적에서의 "정답" 위치

- **내부 상태 SSoT**: [internal/status/STATUS.md](../internal/status/STATUS.md)
- **병렬 작업 기준**: [internal/plans/PARALLEL_WORK_PLAN.md](../internal/plans/PARALLEL_WORK_PLAN.md)
- **문서 허브**: [INDEX.md](../INDEX.md)
- **계획/백로그**: [ROADMAP.md](ROADMAP.md)
- **개발 가이드**: [internal/reference/DEVELOPMENT_GUIDE.md](../internal/reference/DEVELOPMENT_GUIDE.md)
- **배포/사용자 문서**: [README.md](../../README.md) (한국어), [README.en.md](../../README.en.md) (영어), [USER_GUIDE.md](../guides/USER_GUIDE.md), `tutorials/`
- **아카이브 (완료 기록)**: `../internal/archive/`
