77 lines
3.7 KiB
Markdown
77 lines
3.7 KiB
Markdown
# Milestone: Index 게시와 Release 수명주기
|
|
|
|
## 위치
|
|
|
|
- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
|
|
- Phase: [PHASE.md](../PHASE.md)
|
|
|
|
## 목표
|
|
|
|
retrieval dataset version을 backend별 후보 index로 게시하고, 평가 가능한 불변 release로 묶는다. production alias 전환과 rollback은 원자적·명시적으로 수행하며 온라인 요청이 부분 게시 상태를 보지 않게 한다.
|
|
|
|
## 상태
|
|
|
|
[계획]
|
|
|
|
## 구현 잠금
|
|
|
|
- 상태: 해제
|
|
- SDD: 필요
|
|
- SDD 문서: [SDD.md](../../../sdd/rag-serving/index-publication-and-release/SDD.md)
|
|
- SDD 사유: index publish, release 상태 머신, alias promotion·rollback과 backend identity 계약을 정의한다.
|
|
- 잠금 해제 조건:
|
|
- [x] SDD 잠금이 해제되어 있다.
|
|
- [x] SDD 사용자 리뷰가 없거나 승인/해결되었다.
|
|
- [x] Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
|
|
- [x] Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
|
|
- 결정 필요: 없음
|
|
|
|
## 범위
|
|
|
|
- retrieval policy와 embedding·backend capability 사전 검증
|
|
- candidate index build·publish와 external backend identity
|
|
- dataset, index artifact, policy snapshot을 묶는 immutable release
|
|
- candidate, active, retired, failed 상태와 alias version
|
|
- transaction 기반 explicit promotion과 rollback
|
|
- orphan index 정리와 backend reconciliation
|
|
|
|
## 기능
|
|
|
|
### Epic: [index] Candidate Index 게시
|
|
|
|
완료되지 않은 index가 온라인 alias에 노출되지 않게 게시 단계를 분리한다.
|
|
|
|
- [ ] [preflight] dataset schema, embedding dimension, backend capability와 retrieval policy 호환성을 build 전에 검증한다.
|
|
- [ ] [candidate-build] content-addressed dataset과 policy로 candidate index를 만들고 external identity와 manifest를 기록한다.
|
|
- [ ] [publish-reconcile] backend publish 결과를 멱등하게 반영하고 timeout·부분 실패 뒤 상태를 reconciliation한다.
|
|
|
|
### Epic: [release] 명시적 Release 전환
|
|
|
|
온라인 소비자가 항상 하나의 완전한 release identity를 보게 한다.
|
|
|
|
- [ ] [release-snapshot] dataset version, index identity와 retrieval·generation policy를 immutable release content로 묶는다.
|
|
- [ ] [alias-promotion] release와 evaluation evidence를 연결한 명시적 promotion decision을 받아 candidate를 active alias로 원자적으로 승격한다.
|
|
- [ ] [rollback-retire] 이전 release로 alias를 롤백하고 더 이상 참조되지 않는 index를 안전하게 retire한다. 검증: promotion 경쟁, rollback과 backend failure 통합 테스트가 통과한다.
|
|
|
|
## 완료 리뷰
|
|
|
|
- 상태: 없음
|
|
- 요청일: 없음
|
|
- 완료 근거: 모든 기능 Task와 검증 충족 및 구현 잠금 해제 여부를 완료 시 기록한다.
|
|
- 검토 항목: partial publish, concurrent promotion, rollback과 backend reconciliation
|
|
- agent-ui 상태 반영: 해당 없음
|
|
- 리뷰 코멘트: 없음
|
|
|
|
## 범위 제외
|
|
|
|
- 평가 결과만으로 production 자동 승격
|
|
- retrieval backend 내부 index 포맷 통일
|
|
- mutable production index의 in-place update
|
|
|
|
## 작업 컨텍스트
|
|
|
|
- 관련 경로: `packages/go/controlplane/`, `packages/go/integration/`, `db/`
|
|
- 표준선(선택): candidate-before-active, immutable release, explicit alias transaction
|
|
- 선행 작업: [수집과 Dataset 수명주기](../../knowledge-lifecycle/milestones/ingestion-and-dataset-lifecycle.md), [내구성 있는 Workflow Runtime](../../workflow-automation/milestones/durable-workflow-runtime.md)
|
|
- 후속 작업: [Retrieve와 Answer Pipeline](retrieval-and-answer-pipeline.md), [평가와 승격 Gate](../../quality-governance/milestones/evaluation-and-promotion-gates.md)
|
|
- 확인 필요: 없음
|