diff --git a/README.md b/README.md index 4b5dc35..c46cb9f 100644 --- a/README.md +++ b/README.md @@ -129,6 +129,9 @@ AI agent는 작업 전에 루트 지침과 관련 domain rule을 먼저 확인 | Redis host publish | `16330` | PostgreSQL(`5432`)과 Redis(`6379`)의 container 내부 포트는 service DNS/container internal 통신에만 사용하며, host publish 기본값은 위 슬롯으로 통일한다. +이 표는 로컬 checkout과 원격 테스트 runner에서 외부로 노출하는 ALT 포트의 tracked 기준이다. 원격 runner의 실제 host/user/path, artifact/bootstrap endpoint, OpenAI-compatible endpoint, 개인 wire/metrics endpoint는 tracked 문서에 원문을 남기지 않고 local/private rule 또는 secret-only profile에서만 다룬다. ALT에 직접 할당된 public/dev 슬롯이 없으면 tracked 문서에서는 `미할당`으로 둔다. + +기존 smoke 문서나 field/remote 메모가 다른 포트를 가리키면 먼저 위 슬롯과 `deployments/local/docker-compose.yml`, `bin/dev`, `bin/infra-check`, API/worker config 기본값을 대조한 뒤 같은 변경에서 갱신한다. 호환성 확인 전에는 legacy 포트를 새 기본값으로 다시 확정하지 않는다. ## Secret 관리 diff --git a/agent-roadmap/ROADMAP.md b/agent-roadmap/ROADMAP.md index d222bdf..623e32f 100644 --- a/agent-roadmap/ROADMAP.md +++ b/agent-roadmap/ROADMAP.md @@ -16,15 +16,15 @@ ALT는 개인용 quant system workspace로, 한국장 일봉 MVP에서 시작해 - [완료] 데이터 기반 - 경로: `agent-roadmap/archive/phase/data-foundation/PHASE.md` - 요약: 한국장 일봉을 대상으로 provider-neutral market data import, normalization, persistence를 만든다. -- [검토중] 운영 표면 - - 경로: `agent-roadmap/phase/operator-surface/PHASE.md` +- [완료] 운영 표면 + - 경로: `agent-roadmap/archive/phase/operator-surface/PHASE.md` - 요약: Flutter 실화면 전에 CLI/YAML/log 중심 command-first operator workflow로 KIS data, storage status, backtest 실행/결과 확인을 반복 가능하게 만든다. +- [완료] 거래 확장 + - 경로: `agent-roadmap/archive/phase/trading-expansion/PHASE.md` + - 요약: paper trading, 미국장 확장, 주문/리스크/포트폴리오, 실거래 adapter 경계를 MVP 이후 단계로 연다. - [진행중] 백테스트 루프 - 경로: `agent-roadmap/phase/backtest-loop/PHASE.md` - 요약: 일봉 기반 strategy execution, backtest lifecycle, result persistence, repeatable verification을 만든다. -- [진행중] 거래 확장 - - 경로: `agent-roadmap/phase/trading-expansion/PHASE.md` - - 요약: paper trading, 미국장 확장, 주문/리스크/포트폴리오, 실거래 adapter 경계를 MVP 이후 단계로 연다. - [보류] 운영 UI - 경로: `agent-roadmap/phase/operator-ui/PHASE.md` - 요약: command/headless workflow와 거래 확장 기능이 충분히 표면화된 뒤 Flutter operator console과 push notification UI boundary를 연다. diff --git a/agent-roadmap/phase/operator-surface/PHASE.md b/agent-roadmap/archive/phase/operator-surface/PHASE.md similarity index 99% rename from agent-roadmap/phase/operator-surface/PHASE.md rename to agent-roadmap/archive/phase/operator-surface/PHASE.md index 3898e0b..19a1609 100644 --- a/agent-roadmap/phase/operator-surface/PHASE.md +++ b/agent-roadmap/archive/phase/operator-surface/PHASE.md @@ -2,7 +2,7 @@ ## 상태 -[검토중] +[완료] ## 목표 diff --git a/agent-roadmap/phase/trading-expansion/PHASE.md b/agent-roadmap/archive/phase/trading-expansion/PHASE.md similarity index 87% rename from agent-roadmap/phase/trading-expansion/PHASE.md rename to agent-roadmap/archive/phase/trading-expansion/PHASE.md index 00d75b1..3c52a27 100644 --- a/agent-roadmap/phase/trading-expansion/PHASE.md +++ b/agent-roadmap/archive/phase/trading-expansion/PHASE.md @@ -2,7 +2,7 @@ ## 상태 -[진행중] +[완료] ## 목표 @@ -22,11 +22,11 @@ - [완료] US Market Expansion - 경로: `agent-roadmap/archive/phase/trading-expansion/milestones/us-market-expansion.md` - 요약: 한국장 MVP 구조 위에 미국장 데이터를 추가한다. -- [검토중] Live Trading Boundary - - 경로: `agent-roadmap/phase/trading-expansion/milestones/live-trading-boundary.md` +- [완료] Live Trading Boundary + - 경로: `agent-roadmap/archive/phase/trading-expansion/milestones/live-trading-boundary.md` - 요약: 실거래 adapter, 주문, 리스크, 포트폴리오 경계를 paper trading 안정화 이후에 연다. -- [진행중] 워크스페이스 포트/환경 표준화 - - 경로: `agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md` +- [완료] 워크스페이스 포트/환경 표준화 + - 경로: `agent-roadmap/archive/phase/trading-expansion/milestones/workspace-port-env-standardization.md` - 요약: ALT의 Flutter preview, API/worker, PostgreSQL/Redis host publish, 원격 테스트 환경 포트를 workspace 공통 대역으로 정렬한다. ## Phase 경계 diff --git a/agent-roadmap/phase/trading-expansion/milestones/live-trading-boundary.md b/agent-roadmap/archive/phase/trading-expansion/milestones/live-trading-boundary.md similarity index 90% rename from agent-roadmap/phase/trading-expansion/milestones/live-trading-boundary.md rename to agent-roadmap/archive/phase/trading-expansion/milestones/live-trading-boundary.md index 8fd89fa..c42f49c 100644 --- a/agent-roadmap/phase/trading-expansion/milestones/live-trading-boundary.md +++ b/agent-roadmap/archive/phase/trading-expansion/milestones/live-trading-boundary.md @@ -11,7 +11,7 @@ ## 상태 -[검토중] +[완료] ## 구현 잠금 @@ -45,15 +45,15 @@ ## 완료 리뷰 -- 상태: 요청됨 +- 상태: 승인됨 - 요청일: 2026-06-08 - 완료 근거: `broker-port`, `order-lifecycle`, `risk-limits`, `account-sync`, `audit-trail`이 모두 PASS 완료 로그로 충족됐다. - 완료 근거: `account-sync`는 `agent-task/archive/2026/06/m-live-trading-boundary/04+01_account_sync/complete.log`의 Roadmap Completion으로 확인했다. - 완료 근거: `audit-trail`은 `agent-task/archive/2026/06/m-live-trading-boundary/05+02,03,04_audit_trail/complete.log`의 Roadmap Completion으로 확인했다. - 리뷰 필요: - - [ ] 사용자가 완료 결과를 확인했다 - - [ ] archive 이동을 승인했다 -- 리뷰 코멘트: 모든 기능 Task가 완료되어 Milestone을 `[검토중]`으로 전환했다. 사용자 최종 확인 후 `[완료]` 전환과 archive 이동을 진행한다. + - [x] 사용자가 완료 결과를 확인했다 + - [x] archive 이동을 승인했다 +- 리뷰 코멘트: 사용자 승인에 따라 Milestone을 `[완료]`로 전환하고 archive 이동한다. ## 범위 제외 @@ -69,4 +69,4 @@ - 선행 작업: Paper Trading Readiness, Paper Trading Command Workflow, US Market Expansion - 후속 작업: Flutter Operator Console MVP - 확인 필요: 없음 -- 현재 작업 현황: 모든 기능 Task 완료. Milestone 완료 리뷰 요청됨, 사용자 최종 확인과 archive 승인 대기. +- 현재 작업 현황: 모든 기능 Task 완료. 사용자 확인과 archive 승인 완료. diff --git a/agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md b/agent-roadmap/archive/phase/trading-expansion/milestones/workspace-port-env-standardization.md similarity index 50% rename from agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md rename to agent-roadmap/archive/phase/trading-expansion/milestones/workspace-port-env-standardization.md index 25030ab..02a46b1 100644 --- a/agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md +++ b/agent-roadmap/archive/phase/trading-expansion/milestones/workspace-port-env-standardization.md @@ -11,7 +11,7 @@ ALT의 테스트/원격 환경과 로컬 개발 포트를 workspace 공통 대 ## 상태 -[진행중] +[완료] ## 구현 잠금 @@ -32,20 +32,24 @@ ALT의 테스트/원격 환경과 로컬 개발 포트를 workspace 공통 대 ALT가 실제로 사용하는 테스트/원격 환경과 포트의 source of truth를 정리한다. -- [ ] [test-env-map] `agent-test/local`과 remote runner 문서에서 ALT 테스트/원격 환경, artifact, wire, metrics 포트 목록을 raw secret 없이 정리한다. -- [ ] [compose-map] `deployments/local`, `bin/dev`, `.env.example` 계열의 API/worker/PostgreSQL/Redis host publish 값을 공통 대역 후보와 대조한다. -- [ ] [slot-plan] ALT 기본 후보를 frontend `13030`, backend `18030/18031`, optional wire `19030`, DB/cache `15430/16330`으로 문서화하고 기존 포트와의 migration note를 남긴다. -- [ ] [smoke-update] 포트 변경이 필요한 smoke command, README, local rule을 한 번에 갱신할 수 있는 체크리스트를 작성한다. +- [x] [test-env-map] `agent-test/local`과 remote runner 문서에서 ALT 테스트/원격 환경, artifact, wire, metrics 포트 목록을 raw secret 없이 정리한다. 근거: `agent-test/local/rules.md`, `agent-test/local/*-smoke.md`, `README.md`, `agent-task/archive/2026/06/m-workspace-port-env-standardization/02+01_local_infra/complete.log`. +- [x] [compose-map] `deployments/local`, `bin/dev`, `.env.example` 계열의 API/worker/PostgreSQL/Redis host publish 값을 공통 대역 후보와 대조한다. 근거: `deployments/local/docker-compose.yml`, `bin/dev`, `bin/infra-check`, API/worker config 기본값, `agent-task/archive/2026/06/m-workspace-port-env-standardization/01_service_defaults/complete.log`, `agent-task/archive/2026/06/m-workspace-port-env-standardization/03+01,02_operator_client_refs/complete.log`. +- [x] [slot-plan] ALT 기본 후보를 frontend `13030`, backend `18030/18031`, optional wire `19030`, DB/cache `15430/16330`으로 문서화하고 기존 포트와의 migration note를 남긴다. 근거: `README.md`의 워크스페이스 포트 슬롯, `agent-task/archive/2026/06/m-workspace-port-env-standardization/02+01_local_infra/complete.log`. +- [x] [smoke-update] 포트 변경이 필요한 smoke command, README, local rule을 한 번에 갱신할 수 있는 체크리스트를 작성한다. 기준: 포트 변경 시 `deployments/local/docker-compose.yml`, `bin/dev`, `bin/infra-check`, API/worker config, README, headless smoke 문서, `agent-test/local`을 같은 변경에서 대조한다. 근거: `agent-task/archive/2026/06/m-workspace-port-env-standardization/03+01,02_operator_client_refs/complete.log`. ## 완료 리뷰 -- 상태: 없음 -- 요청일: 없음 -- 완료 근거: 없음 +- 상태: 승인됨 +- 요청일: 2026-06-08 +- 완료 근거: + - README에 workspace 포트 슬롯과 remote/private endpoint 책임 경계, legacy migration note를 정리했다. + - local smoke profile의 API/client/worker 포트 기준을 `13030/18030/18031/15430/16330` 슬롯으로 맞췄다. + - compose, helper script, infra check, API/worker config 기본값이 같은 슬롯을 가리키는지 대조했다. + - `test-env-map`과 `slot-plan`은 `02+01_local_infra/complete.log`의 README/local test rule 검증으로, `compose-map`과 `smoke-update`는 `03+01,02_operator_client_refs/complete.log`의 Roadmap Completion으로 확인했다. - 리뷰 필요: - - [ ] 사용자가 완료 결과를 확인했다 - - [ ] archive 이동을 승인했다 -- 리뷰 코멘트: 없음 + - [x] 사용자가 완료 결과를 확인했다 + - [x] archive 이동을 승인했다 +- 리뷰 코멘트: 사용자 승인에 따라 Milestone을 `[완료]`로 전환하고 archive 이동한다. ## 범위 제외 @@ -59,5 +63,5 @@ ALT가 실제로 사용하는 테스트/원격 환경과 포트의 source of tru - 관련 경로: `agent-test/local/`, `deployments/local/`, `bin/`, `services/api/`, `services/worker/`, `apps/client/` - 표준선(선택): container 내부 포트는 서비스 기본값을 유지하고, workspace 표준화 대상은 host publish와 문서화된 remote/smoke 포트다. - 선행 작업: workspace 공통 포트 inventory 정리 -- 후속 작업: compose/env/test smoke 갱신과 drift 방지 +- 후속 작업: 백테스트 루프의 Finance Agent Research Sidecar Sketch 검토 - 확인 필요: 없음