nomadcode/agent-ops/roadmap/milestones/server-skeleton.md

56 lines
1.6 KiB
Markdown

# Server Skeleton
## 목표
core 서비스의 서버 실행 골격을 구성하고, task 저장 구조와 로컬 모델 호출 기반 비동기 job 실행 흐름을 마련한다. 외부 통합은 실제 호출 전 단계의 Adapter stub까지 둔다.
## 단계
Server Skeleton
## 상태
완료
## 범위
- 서버 실행 골격 구성
- task 저장 구조 구성
- 로컬 모델 호출 기반 비동기 job 실행
- Adapter stub 생성
## 필수 기능
- [x] Go HTTP server 실행 골격
- [x] health / readiness endpoint
- [x] task 생성, 조회, 목록, enqueue API
- [x] PostgreSQL 기반 task 저장
- [x] goose migration과 sqlc 기반 DB query 생성 구조
- [x] River 기반 task job
- [x] 모델 호출 경로
- [x] Plane Adapter stub
- [x] Mattermost Adapter stub
## 완료 기준
- [x] core 서버를 로컬에서 실행할 수 있다.
- [x] task 생성부터 조회, enqueue까지 기본 API 흐름이 동작한다.
- [x] DB migration과 sqlc query 생성 흐름이 정리되어 있다.
- [x] River job이 task를 처리하는 기본 경로를 가진다.
- [x] Plane과 Mattermost는 실제 API 호출 전 stub 경계로 분리되어 있다.
## 범위 제외
- 실제 Plane API 호출
- 실제 Mattermost 메시지 발송
- IOP native protocol 연동
- Agent Integrator 연동
- 복잡한 권한 정책
- 복잡한 workflow DSL
## 작업 컨텍스트
- 이전 출처: `services/core/README.md``## 단계별 다음 작업`
- 주요 작업 영역: `services/core/`
- 후속 작업: Plane Thin E2E Loop
- 검증 기준: core 변경은 `go test ./...` 또는 `bin/test`를 우선 사용한다.