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

1.5 KiB

M01 Server Skeleton

목표

core 서비스의 서버 실행 골격을 구성하고, task 저장 구조와 로컬 모델 호출 기반 비동기 job 실행 흐름을 마련한다. 외부 통합은 실제 호출 전 단계의 Adapter stub까지 둔다.

단계

  • Phase: Phase 1. Server Skeleton

상태

  • 진행 중

범위

  • 서버 실행 골격 구성
  • task 저장 구조 구성
  • 로컬 모델 호출 기반 비동기 job 실행
  • Adapter stub 생성

필수 기능

  • Go HTTP server 실행 골격
  • health / readiness endpoint
  • task 생성, 조회, 목록, enqueue API
  • PostgreSQL 기반 task 저장
  • goose migration과 sqlc 기반 DB query 생성 구조
  • River 기반 task job
  • 모델 호출 경로
  • Plane Adapter stub
  • Mattermost Adapter stub

완료 기준

  • core 서버를 로컬에서 실행할 수 있다.
  • task 생성부터 조회, enqueue까지 기본 API 흐름이 동작한다.
  • DB migration과 sqlc query 생성 흐름이 정리되어 있다.
  • River job이 task를 처리하는 기본 경로를 가진다.
  • Plane과 Mattermost는 실제 API 호출 전 stub 경계로 분리되어 있다.

범위 제외

  • 실제 Plane API 호출
  • 실제 Mattermost 메시지 발송
  • IOP native protocol 연동
  • Agent Integrator 연동
  • 복잡한 권한 정책
  • 복잡한 workflow DSL

작업 컨텍스트

  • 이전 출처: services/core/README.md## 단계별 다음 작업
  • 주요 작업 영역: services/core/
  • 검증 기준: core 변경은 go test ./... 또는 bin/test를 우선 사용한다.