update workspace docs

This commit is contained in:
toki 2026-07-04 10:13:51 +09:00
parent b670592ad4
commit d6d0e65912
2 changed files with 6 additions and 5 deletions

View file

@ -29,12 +29,12 @@
| 프로젝트 | Frontend / Preview | Backend / API | Artifact / Model | Wire / Agent Transport | Metrics | DB / Cache | 메모 |
|---|---:|---:|---:|---:|---:|---:|---|
| `iop` | `13000` (`dev:13001`) | `18000` (`dev:18001`) | `18080`, `18081` (`dev 후보:18082/18083`) | `19080`, `19081`, `19090` (`dev:19001/19002/19003`) | `19092` (`dev 후보:19101`) | `15400`, `16300` (`dev:15401/16301`) | 기존 field 포트 `18080`, `18081`, `19080`, `19090` 유지. dev profile은 `.env.dev.example` 기준 |
| `nomadcode` | `13010` | `18010` | - | IOP 경유 | - | `15410`, `16310` | 기존 local core/default `8080` compatibility note 필요 |
| `nomadcode` | `13010` (`dev:13011`) | `18010` (`dev:18011`) | - | IOP 경유 | - | `15410`, `16310` (`dev:15411/16311`) | Core 내부/default `8080`은 유지하고 host publish만 local/dev로 분리. Gito webhook target은 local `18010`, dev `18011` |
| `oto` | `13020` | `18020` | - | OTO-owned slot 미확정 | - | - | 기본 local 테스트 evidence는 `/Users/toki/agent-work/oto` 원격 runner 기준. 기존 product default `127.0.0.1:8080`은 compatibility fallback |
| `alt` | `13030` | `18030`, `18031` | - | `19030` optional | - | `15430`, `16330` | 기존 API/worker 포트와 migration note 필요 |
| `nexo` | `13040` | `18065`, `18066` 유지 | - | - | - | compose-internal 우선 | 변경 필요 시 `18040` 계열 후보. `18065/18066`은 compatibility baseline |
| `appsok` | `13050` | - | - | - | - | - | remote Mac runner 중심. 일반 Flutter/macOS build는 public port 없음 |
| `gito` | `13060` | `18060` | - | `19060` optional | - | `15460`, `16360` | nomadcode처럼 remote runner 기준. Core 내부/default `8080`은 유지하고 host publish/direct smoke만 gito-owned slot 사용 |
| `gito` | `13060` (`dev:13061`) | `18060` (`dev:18061`) | - | `19060` optional (`dev:19061`) | - | `15460`, `16360` (`dev:15461/16361`) | remote runner 기준. Core 내부/default `8080`은 유지하고 host publish/direct smoke만 gito-owned slot 사용 |
| `proto-socket` | - | - | - | test runner `29090-29899` | - | - | 운영 포트가 아니라 crosstest local fixed port 예외 |
## 제외 또는 host 의존

View file

@ -20,8 +20,8 @@
| `alt` | 필요 시 `ssh toki@toki-labs.com` | `~/agent-work/alt` | Docker-backed PostgreSQL/Redis, platform/device/browser runtime, 외부 provider/live smoke | frontend `13030`, API/worker `18030/18031`, optional wire/evidence relay `19030`, DB/cache `15430/16330` | field reserve `13000-13099`, artifact/model `18080/18081`, wire `19080/19090`, metrics `19092`, specialized `19190`는 shared baseline으로만 취급 | KIS/live provider credential은 private rule 또는 secret-only profile에서만 사용 |
| `iop` | `ssh toki@toki-labs.com`, code-server/remote runner | `/Users/toki/agent-work/iop-dev` | Control Plane, Edge, Node, Client, Docker compose, field/bootstrap 검증 | local/test: frontend `13000`, CP HTTP `18000`, DB/cache `15400/16300`; dev: frontend `13001`, CP HTTP `18001`, DB/cache `15401/16301` | local/test field baseline `18080/18081`, `19080/19081/19090`, metrics `19092`; dev wire/model candidates `19001/19002/19003`, `18082/18083`, metrics `19101` | Edge token 등 secret 원문은 원격 환경에서 주입하고 tracked 문서에 기록하지 않음 |
| `nexo` | `ssh toki@toki-labs.com` | repo `~/agent-work/nexo`, compose `~/docker/agent-service/nexo/compose` | Mattermost core/push-proxy runtime, Flutter/Android, Detox, FCM/device evidence | core `18065`, push-proxy `18066` | Android Detox Metro는 `8081` 점유 시 `8088`; Flutter Web preview는 ignored `web-smoke.env` 값 기준 | Mattermost/FCM/test account 값은 `agent-test/local/secrets.md` 같은 ignored profile에서만 확인 |
| `nomadcode` | `ssh toki@toki-labs.com` standard remote runner | `$HOME/agent-work/nomadcode` | Core, Flutter client, Android SDK runner, Mattermost/FCM 시나리오 | Flutter/code-server preview `13010`, Core compose host publish `18010:8080`, DB/cache 후보 `15410/16310` | sibling `../nexo/packages/messaging_flutter`, `../proto-socket/dart` 경로 전제 | Mattermost/FCM/signature 등 private input은 ignored local profile 기준 |
| `gito` | `ssh toki@toki-labs.com` standard remote runner | `$HOME/agent-work/gito` | Core Go, Flutter client, provider webhook/proto-socket smoke, agent-shell runner baseline | Flutter/code-server preview `13060`, Core host publish/direct HTTP `18060`, optional proto-socket/agent transport `19060`, DB/cache 후보 `15460/16360` | Core internal/default `8080`은 compatibility 경로. IOP field `18080/19080/19090`과 nexo `18065/18066`은 gito-owned slot으로 쓰지 않음 | Provider webhook secret, credential_ref, runner credential은 ignored local profile 기준 |
| `nomadcode` | `ssh toki@toki-labs.com` standard remote runner | local `$HOME/agent-work/nomadcode`; dev `$HOME/agent-work/nomadcode-dev` | Core, Flutter client, Android SDK runner, Mattermost/FCM 시나리오, Gito branch webhook consumer | local preview `13010`, Core host publish `18010:8080`, DB/cache 후보 `15410/16310`; dev preview `13011`, Core host publish `18011:8080`, DB/cache 후보 `15411/16311` | sibling `../nexo/packages/messaging_flutter`, `../proto-socket/dart` 경로 전제. IOP dev model endpoint `http://toki-labs.com:18083/v1`은 dependency baseline이며 nomadcode-owned port가 아님 | Mattermost/FCM/signature/Gito webhook secret 등 private input은 ignored local profile 기준 |
| `gito` | `ssh toki@toki-labs.com` standard remote runner | local `$HOME/docker/services/code-server/data/volume/workspace/gito`; dev `$HOME/agent-work/gito-dev` | Core Go, Flutter client, provider webhook/proto-socket smoke, agent-shell runner baseline, NomadCode delivery smoke | local preview `13060`, Core host publish/direct HTTP `18060`, optional proto-socket/agent transport `19060`, DB/cache 후보 `15460/16360`; dev preview `13061`, Core HTTP `18061`, optional transport `19061`, DB/cache 후보 `15461/16361` | Core internal/default `8080`은 compatibility 경로. NomadCode webhook target은 local `http://127.0.0.1:18010/api/integrations/gito/webhook`, dev `http://127.0.0.1:18011/api/integrations/gito/webhook` | Provider webhook secret, credential_ref, runner credential, Gito delivery signing secret은 ignored local profile 기준 |
| `proto-socket` | 기본은 local matrix; Dart.web Chrome 없을 때 remote fallback | `toki@toki-labs.com`, `~/agent-work/proto-socket-dart-web` | Dart.web/WSS Chrome fallback, SPKI wrapper, cross-language matrix 보조 | crosstest runner fixed range `29090-29899` | runtime service port 없음; 예제 `9090`은 제품/테스트 슬롯 아님 | runner 입력 secret 없음. SSH 인증은 local 계정/agent 환경 책임 |
| `oto` | `ssh toki@toki-labs.com` standard remote runner | `/Users/toki/agent-work/oto` | OTO runner, Core HTTP, Flutter client/web preview, bootstrap/release validation | frontend/web preview `13020`, Core HTTP host publish `18020` | product fallback `127.0.0.1:8080`은 compatibility 경로. OTO-owned wire/agent transport port는 아직 확정하지 않음 | `OTO_RUNNER_RELEASE_BASE_URL`, enrollment token, private release host 원문은 tracked 문서에 기록하지 않음 |
| `agent-shell` | 없음 | 없음 | Dart/Flutter package test | 없음 | package 자체 포트 없음. host 앱이 환경 소유 | 없음 |
@ -38,7 +38,8 @@
| `iop` dev profile | local/test stack이 원격 host에서 이미 `13000`, `18000`, `19080`, `19081`, `15400`, `16300`을 점유할 수 있음 | dev profile은 `.env.dev.example` 기준 `13001`, `18001`, `19001`, `19002`, `19003`, `15401`, `16301`을 사용하고 compose project/network를 분리한다. |
| `oto` remote local profile | 제품 fallback `127.0.0.1:8080`과 workspace backend slot `18020`이 함께 존재함 | 테스트/원격 evidence는 `18020`을 기준으로 하고 `8080`은 product compatibility fallback으로만 문서화한다. |
| `nexo` `18065/18066` | workspace backend 후보 `18040` 계열과 다름 | Mattermost compatibility baseline으로 유지한다. 신규 nexo-owned backend가 필요할 때만 `18040` 계열을 검토한다. |
| `gito` local test slots | 새 remote runner 기반 local 환경이 필요하지만 `nomadcode`, `oto`, `nexo`, `iop` 포트와 겹치면 안 됨 | gito-owned slot을 `13060/18060/19060/15460/16360`으로 둔다. Core 내부/default `8080`은 compatibility-only이며 IOP field baseline이나 nexo compatibility ports를 재사용하지 않는다. |
| `nomadcode` local/dev split | local profile과 dev profile을 같은 원격 host에서 분리해야 함 | local은 `13010/18010/15410/16310`, dev는 `13011/18011/15411/16311`을 사용한다. Gito dev subscription target은 `http://127.0.0.1:18011/api/integrations/gito/webhook`이다. |
| `gito` local/dev split | Gito provider intake와 NomadCode consumer target을 같은 원격 host에서 분리해야 함 | local은 `13060/18060/19060/15460/16360`, dev는 `13061/18061/19061/15461/16361`을 사용한다. dev Gito는 NomadCode dev `18011`로 delivery한다. |
| `proto-socket` `29090-29899` | 일반 runtime port가 아니라 test runner fixed range | workspace 예외 대역으로 유지하고 제품 host publish 표준화 대상에서 제외한다. |
## 변경 전 체크리스트