alt/agent-roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md

Milestone: Persistence and Worker Backbone

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/foundation-alignment/PHASE.md

목표

PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가 import, normalization, backtest 같은 비동기 작업을 다룰 수 있는 durable backbone을 만든다.

상태

[계획]

구현 잠금

• 상태: 해제
• 결정 필요: 없음

범위

• PostgreSQL migration과 query generation 기준
• Redis 사용 위치와 key prefix 기준
• worker job 실행 모델
• local infrastructure와 worker configuration 정합성
• storage boundary와 domain mapping

필수 기능

Epic: [worker-backbone] Persistence and worker backbone

PostgreSQL, Redis, worker job model, storage boundary 기준을 묶는다.

• [db-migrations] PostgreSQL migration entrypoint가 있다.
• [typed-queries] DB query를 type-safe하게 다루는 생성/검증 흐름이 있다.
• [redis-boundary] Redis 사용 목적과 key prefix 기준이 worker 문서나 config에 정리되어 있다.
• [job-model] worker가 비동기 작업을 표현하고 실행할 기본 job model을 갖는다.
• [storage-ports] domain과 persistence 사이의 adapter/port 경계가 정해져 있다.
• [infra-check] local PostgreSQL/Redis health를 확인하는 반복 가능한 절차가 있다.

완료 기준

• local PostgreSQL/Redis를 실행한 뒤 worker가 필요한 설정을 읽을 수 있다.
• migration/query generation 흐름이 문서화되어 있다.
• worker job이 API 내부 구현에 의존하지 않는다.
• bin/test, bin/lint, bin/build가 통과한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• 실제 KIS API 호출
• backtest engine 전체 구현
• production 배포 구성
• broker/order/risk persistence

작업 컨텍스트

• 관련 경로: services/worker/, deployments/local/, packages/domain/, bin/
• 표준선(선택): PostgreSQL은 durable store, Redis는 보조 cache/queue/pubsub surface로 둔다.
• 선행 작업: Workspace Baseline
• 후속 작업: Korea Daily Data Foundation
• 확인 필요: 없음