3.6 KiB
3.6 KiB
Milestone: Control Plane Resource API
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
project를 격리 root로 두고 knowledge base, source, dataset, workflow, evaluation과 release를 동일한 관리 계약으로 생성·조회·변경할 수 있게 한다. 모든 project-owned 요청은 project scope를 강제하고 장시간 실행·온라인 RAG·운영 UI가 재사용할 안정적인 Control Plane 경계를 제공한다.
상태
[계획]
구현 잠금
- 상태: 해제
- SDD: 필요
- SDD 문서: SDD.md
- SDD 사유: resource API, project isolation, idempotency, optimistic concurrency와 오류 schema를 정의한다.
- 잠금 해제 조건:
- SDD 잠금이 해제되어 있다.
- SDD 사용자 리뷰가 없거나 승인/해결되었다.
- Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
- Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
- 결정 필요: 없음
범위
- project root identity와 project-owned resource identity
- knowledge base, source, dataset, workflow, evaluation과 release 관리 API
- cursor pagination, filter, stable error와 revision 기반 optimistic concurrency
- mutation idempotency와 conflict 의미
- OpenAPI·내부 계약 포인터와 lifecycle contract test
기능
Epic: [resources] 공통 Resource 수명주기
각 도메인이 서로 다른 관리 API 의미를 재정의하지 않게 공통 경계를 만든다.
- [project-boundary] project를 격리 root로 정의하고 모든 project-owned resource identity와 query에 project scope를 강제하며 교차 프로젝트 접근을 기본 거부한다.
- [resource-lifecycle] project, knowledge base, source, dataset, workflow, evaluation과 release의 생성·조회·목록·변경·비활성화 계약을 제공한다.
- [api-consistency] cursor pagination, filter, stable error envelope과 revision 기반 optimistic concurrency를 일관되게 적용한다.
- [mutation-idempotency] 생성과 명령형 변경에 idempotency key, replay와 conflict 의미를 적용한다.
Epic: [contracts] 소비자 계약
CLI, UI, worker와 외부 자동화가 같은 계약을 검증할 수 있게 한다.
- [management-contract] 관리 API를 versioned OpenAPI로 게시하고
agent-contract가 도입되면 원문 포인터를 연결한다. - [lifecycle-tests] resource별 상태 전이, idempotency, stale revision과 cross-project read·write negative contract test를 제공한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 모든 기능 Task와 검증 충족 및 구현 잠금 해제 여부를 완료 시 기록한다.
- 검토 항목: project scope 강제, replay·conflict 의미, resource lifecycle과 계약 호환성
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트: 없음
범위 제외
- 외부 identity provider 연동과 세분화된 RBAC
- online retrieve·answer data plane
- 운영 UI 구현
작업 컨텍스트
- 관련 경로:
apps/control-plane/,api/openapi/,packages/go/controlplane/,db/ - 표준선(선택): project-scoped identity, stable error, cursor pagination, optimistic concurrency, idempotent mutation
- 선행 작업: Integration 카탈로그와 Secret 경계
- 후속 작업: 내구성 있는 Workflow Runtime, 수집과 Dataset 수명주기
- 확인 필요: 없음