alt/agent-roadmap/phase/trading-expansion/milestones/workspace-port-env-standardization.md

Milestone: 워크스페이스 포트/환경 표준화

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/trading-expansion/PHASE.md

목표

ALT의 테스트/원격 환경과 로컬 개발 포트를 workspace 공통 대역으로 정렬한다. Flutter dev preview, services/api, services/worker, PostgreSQL, Redis, 원격 runner 문서가 같은 포트 정책을 말하게 만들고, 기존 field/remote 포트는 호환성 확인 뒤 단계적으로 조정한다.

상태

[진행중]

구현 잠금

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

범위

• Flutter/web preview host publish를 workspace frontend 대역 후보로 정리
• services/api와 services/worker host publish 포트를 backend 대역 후보로 정리
• PostgreSQL/Redis host publish는 필요할 때만 DB/cache offset 대역으로 노출하고, compose 내부 통신은 service DNS를 우선한다는 기준 정리
• agent-test/local의 원격 runner, artifact/bootstrap, OpenAI-compatible, wire/metrics 포트 설명을 workspace 공통 대역과 맞춘다
• KIS live smoke, token, account, private host 값은 tracked 문서에 쓰지 않고 책임 경계와 evidence 위치만 남긴다

기능

Epic: [inventory] ALT environment inventory

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을 한 번에 갱신할 수 있는 체크리스트를 작성한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 없음
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• 원격 서버에 배포된 포트 즉시 변경
• KIS credential, account id, token, private host 값 기록
• 실거래 order/risk/portfolio 구현
• Flutter 운영 화면 구현

작업 컨텍스트

• 관련 경로: 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 방지
• 확인 필요: 없음