port 番号戦略
ABBCC ポート戦略
worktree ごとにポートが衝突しないよう、5桁固定のポート番号体系（ABBCC） を採用しています。
ポート番号 = A × 10000 + BB × 100 + CC| 桁 | 意味 | 値の範囲 |
|---|---|---|
| A | モノレポ識別子 | 4（uzuPJ/app 固定） |
| BB | worktree 番号 | 00〜99（自動割り当て） |
| CC | サービス識別子 | 下記テーブル参照 |
例：worktree 番号 01 の WEB サービス（CC=10）→ 4 × 10000 + 1 × 100 + 10 = 40110
サービス識別子（CC）一覧
インフラ（00-09）
| CC | サービス | 環境変数 |
|---|---|---|
| 00 | メイン DB（PostgreSQL） | BACKEND_DB_PORT |
| 01 | メイン Redis | BACKEND_REDIS_PORT |
| 02 | MDMS.jp DB | MDMS_JP_DB_PORT |
| 03 | MDMS.jp Redis | MDMS_JP_REDIS_PORT |
| 06 | Auth Server | AUTH_PORT |
UZU Web フロントエンド（10-19）
| CC | サービス | 環境変数 |
|---|---|---|
| 10 | WEB（LP） | WEB_PORT |
| 11 | Studio Editor | STUDIO_EDITOR_PORT |
| 12 | ADMIN | ADMIN_PORT |
| 13 | Studio | STUDIO_PORT |
UZU バックエンド（20-29）
| CC | サービス | 環境変数 |
|---|---|---|
| 20 | GraphQL サーバー | BACKEND_GRAPH_PORT |
| 21 | gRPC サーバー | BACKEND_GRPC_PORT |
| 22 | mdmsjp-grpc へのポートフォワード | MDMS_JP_GRPC_FORWARD_PORT |
| 23 | analytics-server へのポートフォワード | ANALYTICS_GRPC_FORWARD_PORT |
MDMS.jp（30-39）
| CC | サービス | 環境変数 |
|---|---|---|
| 30 | Frontend | MDMS_JP_FRONTEND_PORT |
| 31 | Backend | MDMS_JP_BACKEND_PORT |
| 32 | Shop | MDMS_JP_SHOP_PORT |
| 33 | Admin | MDMS_JP_ADMIN_PORT |
ツール・ドキュメント（40-49）
| CC | サービス | 環境変数 |
|---|---|---|
| 40 | Docusaurus（開発 Wiki） | DOCS_PORT |
UZU Code（50-59）
| CC | サービス | 環境変数 |
|---|---|---|
| 50 | シナリオ dev サーバー（Vite） | PS3_SCENARIO_PORT |
| 51 | uzu-code play-server（Wrangler） | PS3_PLAY_SERVER_PORT |
| 52 | uzu-code content-server | PS3_CONTENT_SERVER_PORT |
Uzu Tokyo（60-69）
| CC | サービス | 環境変数 |
|---|---|---|
| 60 | DB | UZUTOKYO_DB_PORT |
| 61 | Backend | UZUTOKYO_BACKEND_PORT |
| 62 | Frontend | UZUTOKYO_FRONTEND_PORT |
統合 CMS（70-79）
| CC | サービス | 環境変数 |
|---|---|---|
| 70 | Strapi（Admin UI + API） | CMS_PORT |
| 71 | CMS DB（PostgreSQL） | CMS_DB_PORT |
使い方
bash
# task init 実行時に自動で worktree 番号が割り当てられ、
# .ports.local が生成されます
task init
# 現在のポート割り当てを確認
task dev-info.worktree-number: 自動割り当てされた worktree 番号が保存されるファイル.ports.local: ABBCC 形式で生成されたポート設定ファイル（各 Taskfile から読み込まれる）
新しいサービスを追加する場合
scripts/port-strategy/port_map.sh の PORT_ENTRIES に CC 値を追加してください。CC の空き番号は上記テーブルの各カテゴリの予約範囲内から選びます。
レガシーポート設定（フォールバック）
.ports.local が存在しない場合、.ports.default の固定ポートが使われます。
| サービス | ポート |
|---|---|
| WEB（LP） | 4001 |
| Studio Editor | 4002 |
| ADMIN | 4003 |
| Studio | 4004 |
| GraphQL サーバー | 5001 |
| gRPC サーバー | 8080 |
| メイン DB | 6001 |
| メイン Redis | 6002 |
| MDMS.jp DB | 6003 |
| Auth Server | 40006 |
| MDMS.jp Redis | 6006 |
| Docusaurus（開発 Wiki） | 3000 |
| MDMS.jp Frontend | 7001 |
| MDMS.jp Backend | 7002 |
| MDMS.jp Shop | 7003 |
| MDMS.jp Admin | 7004 |