Draft+approve REQ-005~009 from dcy-002 (slot-core daemon + API)

Decompose dcy-002 FR-1~FR-6 into five requirements and promote them to Approved (gate passed; source dcy-002 confirmed): - REQ-005 (Installation): slot-core daemon runtime + lifecycle/healthz - REQ-006 (Data): PostgreSQL SlotRepository + schema + drift test - REQ-007 (Interface): intent submission API + idempotency - REQ-008 (Interface): read-only slot/capacity query API - REQ-009 (Documentation): daemon/API/persistence baseline alignment NFR-1/2/3 absorbed into REQ-006/007 acceptance. Update SRS index (Next ID -> REQ-010, register, change log) and dcy-002 created-REQ refs. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-04 11:12:34 +09:00
parent 346a580856
commit a44f9fddb7
7 changed files with 570 additions and 3 deletions
@@ -0,0 +1,112 @@
+# req-005: 슬롯 코어 데몬 런타임 부트스트랩
+
+- Status: Approved
+- Type: Installation
+- Priority: High
+- Owner: project maintainers
+
+## Intent
+- trex-core 를 장기 실행 데몬으로 기동하는 런타임 기반(엔트리포인트 + lifecycle)을 만들어, 이후 HTTP API·영속화 레이어가 그 위에서 동작하도록 한다.
+
+## Requirement
+- `pyproject.toml` 에 FastAPI·uvicorn·psycopg 의존성과 console_scripts 엔트리포인트를 추가하고, 데몬을 기동/정상종료하는 lifecycle 과 `GET /v1/healthz` 를 제공한다. 거래일 슬롯 사전할당(preallocate)은 공개 엔드포인트가 아니라 데몬 lifecycle(기동/스케줄) 내부에서 수행한다.
+
+## Acceptance Criteria
+1. Given 설치된 trex-core, When 콘솔 스크립트로 데몬을 기동, Then 프로세스가 떠서 `GET /v1/healthz` 가 200 을 반환한다.
+2. Given 기동된 데몬, When 종료 시그널, Then 진행 중 요청을 정리하고 graceful shutdown 한다.
+3. Given 데몬 lifecycle, When 거래일 시작(기동/스케줄), Then 슬롯 preallocate 가 멱등하게 1회 수행된다(공개 엔드포인트 없이).
+4. Given `pyproject.toml`, When 확인, Then FastAPI·uvicorn·psycopg 의존성과 데몬 console_scripts 가 존재한다.
+
+## Impacted Area
+- Docs: docs/runtime-flows.md(데몬 흐름), docs/project-structure.md(런타임 레이어) — REQ-009 에서 정합
+- Modules: pyproject.toml, trex_core/ 하위 데몬 런타임/엔트리포인트(애플리케이션 레이어)
+- Tests: 데몬 기동/healthz/shutdown 통합테스트
+
+## Notes
+- 프레임워크 FastAPI+uvicorn(dcy-002 OQ-2). API 엔드포인트 자체는 REQ-007/008, 영속화는 REQ-006.
+- REQ-006(영속화)·REQ-007/008(API)의 선행 런타임 기반이다.
+- 출처: dcy-002 FR-1.
+
+## Change Log
+
+### CHG-20260603-01
+- Date: 2026-06-03
+- Author: Justin Ko
+
+#### Change Summary
+- dcy-002 FR-1 로부터 최초 생성(Proposed).
+
+#### Intent
+- 슬롯 코어 데몬 런타임 부트스트랩 요구사항을 backlog 로 정규화.
+
+#### Acceptance Criteria Delta
+- Added:
+  - 기동/healthz, graceful shutdown, lifecycle preallocate, deps/entrypoint 4개 기준
+- Updated:
+  - 없음
+- Removed:
+  - 없음
+
+#### Impacted Area Delta
+- Docs:
+  - docs/runtime-flows.md, docs/project-structure.md
+- Modules:
+  - pyproject.toml, 데몬 런타임/엔트리포인트
+- Tests:
+  - 데몬 lifecycle 통합테스트
+
+#### Delivery Trace Delta
+- Batches:
+  - none
+- Releases:
+  - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: confirm-req 후 batch 편성
+
+#### Validation Plan
+- 데몬 기동 + healthz + shutdown 통합테스트로 검증.
+
+### CHG-20260603-02
+- Date: 2026-06-03
+- Author: Justin Ko
+
+#### Change Summary
+- Status Proposed → Approved (confirm-req).
+
+#### Intent
+- 승인 게이트(필수 필드·구체 AC·blocker 없음) 충족, source dcy-002(confirmed, handoff 승인)와 모순 없음 확인.
+
+#### Acceptance Criteria Delta
+- Added:
+  - 없음
+- Updated:
+  - 없음
+- Removed:
+  - 없음
+
+#### Impacted Area Delta
+- Docs:
+  - docs/srs/index.md (Register 상태 Approved)
+- Modules:
+  - 없음
+- Tests:
+  - 없음
+
+#### Delivery Trace Delta
+- Batches:
+  - none (batch 편성 전)
+- Releases:
+  - none
+
+#### Revalidation Impact
+- Reverification Needed: no
+- Existing Implementation Invalidated: no
+- Status Recommendation: keep-current
+- Follow-up Action: suggest-batch-reqs / draft-batch 로 delivery batch 편성
+
+#### Validation Plan
+- 승인 후 batch planning 에서 본 REQ 의 Acceptance Criteria 를 검증 기준으로 사용.