# Milestone: 플랫폼 스캐폴드 기준선

## 위치

- Roadmap: [ROADMAP.md](../../../ROADMAP.md)
- Phase: [PHASE.md](../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을 수용할 수 있는 저장소 구조와 빌드 계약을 기준선으로 고정한다.

- [x] [service-layout] control-plane, rag-api, Go worker와 Python executor의 실행 구조를 구성했다.
- [x] [state-schema] project, knowledge, workflow, evaluation, release, trace 제어 상태와 sqlc 쿼리 원본을 구성했다.
- [x] [public-contracts] HTTP/JSON·SSE OpenAPI와 Go/Python executor Protobuf 계약을 구성했다.
- [x] [adapter-boundary] source, retrieval, embedding, rerank, generation, secret, artifact의 제품 중립 경계를 구성했다.
- [x] [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/`
- 표준선(선택): [프로젝트 규칙](../../../../agent-ops/rules/project/rules.md)과 각 domain rule의 책임 경계
- 선행 작업: 없음
- 후속 작업: [Integration 카탈로그와 Secret 경계](integration-catalog-and-secrets.md)
- 확인 필요: 실제 PostgreSQL migration smoke 환경