docs(roadmap): 포트 환경 마일스톤을 동기화한다

현재 repo의 core, client preview, proto-socket, provider env baseline을 마일스톤 작업 항목과 컨텍스트에 반영한다.
This commit is contained in:
toki 2026-06-07 19:58:00 +09:00
parent a42403d8bc
commit 1b9858dbe8

View file

@ -30,12 +30,12 @@ NomadCode의 Flutter client, core service, compose/local run, code-server previe
### Epic: [inventory] NomadCode environment inventory
NomadCode가 직접 소유한 client/core 포트와 외부 IOP/Nexo/Plane 연동 endpoint를 분리해 정리한다.
NomadCode가 직접 소유한 client/core 포트와 외부 IOP/Nexo/Plane 연동 endpoint를 현재 repo baseline 기준으로 분리해 정리한다.
- [ ] [client-preview] Flutter web/code-server preview 포트를 frontend 대역 `13010` 후보로 정리하고 기존 local preview 포트와의 호환성을 기록한다.
- [ ] [core-port] Core HTTP/API host publish 후보를 backend `18010`으로 문서화하되, 기존 `8080` local default와 migration note를 남긴다.
- [ ] [infra-ports] PostgreSQL/Redis host publish 후보를 `15410/16310`으로 정리하고, compose 내부 통신은 service DNS 우선으로 문서화한다.
- [ ] [external-endpoints] IOP Edge OpenAI-compatible endpoint, Nexo messaging package, Plane/Mattermost/Jira integration은 raw secret 없이 source of truth와 책임 경계만 남긴다.
- [ ] [client-preview] Flutter web/code-server preview는 현재 local smoke 기준 `8081` 계열 임시 포트와 `/proxy/<port>/` base href를 사용한다. frontend 대역 후보 `13010`으로 정리할 때 기존 preview 흐름과 workspace mock URL의 `localhost:8080` code-server entry 호환성을 기록한다.
- [ ] [core-port] Core HTTP/API는 현재 `HTTP_ADDR=:8080`, Docker `EXPOSE 8080`, compose `8080:8080` host publish를 사용한다. backend host publish 후보 `18010`으로 문서화하되, 기존 `8080` local default와 migration note를 남긴다.
- [ ] [infra-ports] PostgreSQL/Redis는 현재 compose 내부에서 `code-server-postgres:5432`, `code-server-redis:6379` service DNS를 사용하고 별도 host publish를 갖지 않는다. 필요한 경우만 DB/cache offset 대역 `15410/16310` 노출 후보를 문서화한다.
- [ ] [external-endpoints] IOP Edge OpenAI-compatible endpoint는 현재 `MODEL_BASE_URL`, `MODEL_API_KEY`, `MODEL_NAME`, `MODEL_CONTEXT_SIZE`, `MODEL_TIMEOUT_SEC`로 설정하고, A2A/proto-socket/provider 연동은 `A2A_*`, `PROTO_SOCKET_*`, `PLANE_*`, `JIRA_*`, `MATTERMOST_*` env로 분리한다. raw secret 없이 source of truth와 책임 경계만 남긴다.
## 완료 리뷰
@ -60,6 +60,13 @@ NomadCode가 직접 소유한 client/core 포트와 외부 IOP/Nexo/Plane 연동
- 관련 경로: `apps/client/`, `services/core/`, `docker-compose.yml`, `.env.example`, `agent-test/local/`, `packages/contracts/`
- 외부 관련 경로: `../iop/`, `../nexo/packages/messaging_flutter/`, `../proto-socket/dart/`
- 표준선(선택): container 내부 포트와 기존 local default는 compatibility baseline으로 유지하고, host publish, preview, remote runner 문서부터 workspace 대역으로 정렬한다.
- 현재 작업 동기화:
- 활성 로드맵 포인터는 `Agent-Ops MCP Control Plane` Phase와 이 Milestone을 가리키며, active `agent-task/` 작업 파일은 없다.
- Core baseline source는 `services/core/internal/config/config.go`, `services/core/Makefile`, `services/core/docker-compose.yml`, `services/core/Dockerfile`, `services/core/README.md`에 흩어져 있고, 현재 외부 host publish 기준은 `8080`이다.
- Client preview baseline source는 `agent-test/local/mobile-smoke.md`이며, 현재 human web preview는 code-server `/proxy/<port>/`와 예시 `8081`을 사용한다.
- Workspace mock entry는 `apps/client/lib/src/features/workspaces/domain/project_workspace.dart`에서 code-server `localhost:8080` URL을 사용한다.
- Proto-socket client endpoint는 `apps/client/lib/src/integrations/proto_socket/proto_socket_endpoint_config.dart``PROTO_SOCKET_*` env에서 오며, host가 없으면 비활성화된다.
- external provider/model endpoint 값은 tracked roadmap에 실제 token/password를 기록하지 않고 env 이름과 책임 경계만 동기화한다.
- 선행 작업: workspace 공통 포트 inventory 정리
- 후속 작업: compose/env/test smoke 갱신과 drift 방지
- 확인 필요: 없음