From 1b9858dbe8be63cd310803aa24a91737bedcb4c1 Mon Sep 17 00:00:00 2001 From: toki Date: Sun, 7 Jun 2026 19:58:00 +0900 Subject: [PATCH] =?UTF-8?q?docs(roadmap):=20=ED=8F=AC=ED=8A=B8=20=ED=99=98?= =?UTF-8?q?=EA=B2=BD=20=EB=A7=88=EC=9D=BC=EC=8A=A4=ED=86=A4=EC=9D=84=20?= =?UTF-8?q?=EB=8F=99=EA=B8=B0=ED=99=94=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 현재 repo의 core, client preview, proto-socket, provider env baseline을 마일스톤 작업 항목과 컨텍스트에 반영한다. --- .../workspace-port-env-standardization.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md b/agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md index abdc804..c263fa3 100644 --- a/agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md +++ b/agent-roadmap/phase/agent-ops-mcp-control-plane/milestones/workspace-port-env-standardization.md @@ -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//` 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//`와 예시 `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 방지 - 확인 필요: 없음