2.9 KiB
2.9 KiB
Milestone: 플랫폼 스캐폴드 기준선
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
현재 생성된 Go·Python·PostgreSQL 스캐폴드가 RARA의 책임 경계와 재현 가능한 개발 흐름을 충족하는지 검토하고 첫 구현 기준선으로 닫는다.
상태
[검토중]
구현 잠금
- 상태: 해제
- SDD: 불필요
- SDD 문서: 없음
- SDD 사유: 이미 구현·검증된 단일 저장소 스캐폴드의 완료 근거를 정리하는 작업이며 새 API나 상태 머신을 설계하지 않는다.
- 잠금 해제 조건: 없음
- 결정 필요: 없음
범위
- Go control-plane, rag-api, worker 실행 진입점
- PostgreSQL 18 제어 상태 스키마와 sqlc 생성 흐름
- Go/Python Protobuf executor 계약과 Python worker
- product-neutral integration port, artifact adapter, 공통 설정과 관측성
- Make, CI, Docker 개발 자산과 로컬 검증 기준
기능
Epic: [baseline] 실행 가능한 플랫폼 기준선
RARA가 후속 Milestone을 수용할 수 있는 저장소 구조와 빌드 계약을 기준선으로 고정한다.
- [service-layout] control-plane, rag-api, Go worker와 Python executor의 실행 구조를 구성했다.
- [state-schema] project, knowledge, workflow, evaluation, release, trace 제어 상태와 sqlc 쿼리 원본을 구성했다.
- [public-contracts] HTTP/JSON·SSE OpenAPI와 Go/Python executor Protobuf 계약을 구성했다.
- [adapter-boundary] source, retrieval, embedding, rerank, generation, secret, artifact의 제품 중립 경계를 구성했다.
- [developer-loop]
make setup,make test,make build,sqlc diff가 재현 가능하게 동작한다. 검증: 로컬 명령이 모두 성공하고 세 Go 바이너리가 생성된다.
완료 리뷰
- 상태: 검토중
- 요청일: 2026-07-18
- 완료 근거: Go 전체 테스트와 Python 테스트 3개가 통과했고, sqlc compile/diff와 세 서비스 빌드 및 control-plane HTTP smoke를 확인했다.
- 검토 항목: 실제 PostgreSQL 인스턴스에 초기 migration을 적용하는 통합 evidence와 저장소 첫 기준선 반영 여부
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: PostgreSQL 실행 환경이 준비되면 migration up/down smoke를 추가 확인한 뒤 완료 archive 후보로 전환한다.
범위 제외
- 실제 retrieval backend, model provider와 source connector 구현
- production 인증, 권한과 운영 UI
- LoRA/QLoRA 학습 실행
작업 컨텍스트
- 관련 경로:
apps/,packages/,api/,db/,configs/,deploy/ - 표준선(선택): 프로젝트 규칙과 각 domain rule의 책임 경계
- 선행 작업: 없음
- 후속 작업: Integration 카탈로그와 Secret 경계
- 확인 필요: 실제 PostgreSQL migration smoke 환경