2 KiB
2 KiB
Server Skeleton
목표
core 서비스의 서버 실행 골격을 구성하고, task 저장 구조와 비동기 job 실행 흐름을 마련한다. 외부 통합은 실제 호출 전 단계의 Adapter stub까지 둔다.
단계
Server Skeleton
상태
완료
구현 잠금
- 상태: 해제
- 이유: 완료된 Milestone의 기록 보정이며, 새 구현 작업을 시작하는 문서가 아니다.
- 해제 조건:
- 완료된 서버 골격과 task 실행 경계가 로드맵에 기록되어 있다.
- 후속 IOP 통합 방향은 External Integration Milestone에서 다룬다.
- 잠금 중 금지:
- 해당 없음
범위
- 서버 실행 골격 구성
- task 저장 구조 구성
- 비동기 job 실행
- Adapter stub 생성
필수 기능
- [server-run] Go HTTP server 실행 골격
- [health-ready] health / readiness endpoint
- [task-api] task 생성, 조회, 목록, enqueue API
- [task-storage] PostgreSQL 기반 task 저장
- [db-codegen] goose migration과 sqlc 기반 DB query 생성 구조
- [river-job] River 기반 task job
- [external-boundary] 초기 외부 실행 호출 경계
- [plane-stub] Plane Adapter stub
- [mattermost-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/ - 후속 작업: Plane Communication Foundation
- 검증 기준: core 변경은
go test ./...또는bin/test를 우선 사용한다.