SuperPortia Project Landscape — 29 Projects, 3 Dimensions
SuperPortia 已成長到 29 個專案。沒有地圖，連建造者自己都會迷路。這篇文章就是那張地圖——一個完整的登記冊，三個分類維度讓整體面貌一目了然。
三個維度
每個專案沿三個軸向分類：
1. Port（在哪裡找到它）
本地 port 號碼是專案在 SS1 上的地址。Command Center 透過這些 port 監控健康狀態。沒有 port = 純雲端服務，或沒有運行中的程序。
Port 範圍遵循以下慣例：
| 範圍 | 用途 |
|---|---|
| 3000–3999 | Frontend dev servers |
| 4000–4999 | Backend services + APIs |
| 6000–6999 | Databases + Docker 基礎設施 |
| 8000–8999 | API servers + MCP |
2. Deploy Type（如何更新）
這是最容易混淆的維度，因為共有九種截然不同的模式。了解一個專案使用哪種模式，決定了當代碼變更時你需要做什麼。
cloud-serverless — 推送代碼，執行 wrangler deploy，完成。沒有本地 build 步驟。代碼直接在 Cloudflare Workers 上運行。Serverless = 不需要管理伺服器。
- 範例：Cloud UB Worker、Email Intake、Scout Worker
local-build-cloud — 必須先在本地 build（例如 npm run deploy，會執行 opennext/astro build），再將 build 產物 deploy 到 Cloudflare Workers。跳過本地 build = 部署的是舊代碼。
- 範例：Bridge（OpenNext → CF Workers）、Reading（Astro → CF Workers）
cloud-static — 推送到 GitHub，Cloudflare Pages 自動 build 並部署。git push 之後零手動步驟。
- 範例：Docs Site、Catmints Cafe、Blog
factory-storefront — 最複雜的模式。本地 pipeline（Python/LangGraph）每天運行以生成內容（JSON、MDX）。然後 Astro 從這些內容 build 出站點並 deploy 到 Cloudflare Pages。代碼很少變動；內容每天都在變。
- 範例：NQIO（KOL pipeline → 週報 → Astro → CF Pages）
local-only — 透過 launchd 在 SS1 上運行。無雲端部署。只能透過 localhost 訪問（或透過 Cloudflare Access 遠端訪問）。
- 範例：Command Center、SPM、Agentic
local-tunnel — 在本地透過 Docker 或 launchd 運行，透過 Cloudflare Tunnel（cloudflared）對外暴露。服務本身保持在 SS1 上。
- 範例：SiYuan Notes（Docker + tunnel → note.superportia.dev）
local-daemon — 在 SS1 上作為背景程序運行（launchd 或 cron）。無 web UI。靜默工作——監控、輪詢、分類。
- 範例：SRE、KOL Narratives、MCP Server、MTAAA Pipeline
docker — 在 SS1 的 Docker 容器中運行。可能有也可能沒有 web UI。用 docker start 或 Docker Compose 啟動。
- 範例：Open WebUI、LiteLLM、Qdrant
config-only — 不是運行中的服務。包含其他專案使用的設定檔、規則、腳本或文件。
- 範例：Ops（.claude/ config）、Vault（Obsidian 知識庫）、SuperPortia Monorepo
3. Role（在生態系中做什麼）
platform-hub — 本身是一個應用程式，同時管理子專案或模組。有自己的 registry/index 頁面。
- Command Center → 在
/projects管理全部 29 個專案 - SPM → 在
/modules管理 62 個模組 - NQIO → 管理 KOL 頻道 + pipeline 執行
- Agentic → 管理學習看板 + 閱讀來源
standalone — 單一用途的應用程式，專注做好一件事。
- Bridge → 夏哥每日儀表板 + agent 對話
- Reading → RSS 閱讀 + AI Q&A
- SiYuan → 筆記
infrastructure — 其他專案依賴它。它若停了，多個系統會出問題。
- Cloud UB Worker → 大腦，所有人都在查詢它
- MCP Server → Claude Code 連接 UB 的橋梁
- Qdrant → 本地 embedding 的向量搜尋
- SRE → 監控 + 告警
pipeline — 按排程處理資料。沒有互動式 UI。輸入 → 轉換 → 輸出。
- Email Intake → Gmail → 分類 → email_intel 表
- Scout Worker → RSS → 解析 → UB entries
- KOL Narratives → YouTube → NotebookLM → 交易情報
static-site — 純 HTML/CSS/JS，無伺服器端邏輯。內容透過 git push 變更。
- Docs Site、Catmints Cafe、Blog
config-ops — 不是服務。提供其他系統使用的規則、腳本和設定。
- Ops、Vault、SuperPortia Monorepo
完整登記冊
| # | Port | 專案 | URL | Deploy | Role | Status |
|---|---|---|---|---|---|---|
| 1 | 3000 | NQ 2026 Alpha | — | local-only | standalone | dev |
| 2 | 3000 | Weekly Ops | week.nqio.dev | local-only | standalone | dev |
| 3 | 3001 | Open WebUI | — | docker | standalone | standby |
| 4 | 3002 | Bridge | bridge.superportia.dev | local-build-cloud | standalone | active |
| 5 | 3333 | Docs Site | docs.superportia.dev | cloud-static | static-site | active |
| 6 | 3900 | Command Center | — | local-only | platform-hub | active |
| 7 | 3991 | SPM | spm.superportia.dev | local-only | platform-hub | dev |
| 8 | 3994 | NQIO | nqio.dev | factory-storefront | platform-hub | dev |
| 9 | 4000 | LiteLLM | — | docker | infrastructure | standby |
| 10 | 4010 | Agentic | agentic.superportia.dev | local-only | platform-hub | dev |
| 11 | 4321 | Reading | read.superportia.dev | local-build-cloud | standalone | active |
| 12 | 6333 | Qdrant | — | docker | infrastructure | active |
| 13 | 6806 | SiYuan | note.superportia.dev | local-tunnel | standalone | active |
| 14 | 8787 | MCP Server | — | local-daemon | infrastructure | active |
| 15 | — | Cloud UB | ub.superportia.dev | cloud-serverless | infrastructure | active |
| 16 | — | Email Intake | — | cloud-serverless | pipeline | active |
| 17 | — | Scout Worker | scout.superportia.dev | cloud-serverless | pipeline | active |
| 18 | — | KOL Narratives | — | local-daemon | pipeline | active |
| 19 | — | MTAAA Pipeline | — | local-daemon | pipeline | dev |
| 20 | — | NQ ICT Scout | — | local-daemon | pipeline | dev |
| 21 | — | Ops | — | config-only | config-ops | active |
| 22 | — | SRE | — | local-daemon | infrastructure | active |
| 23 | — | Vault | — | config-only | config-ops | active |
| 24 | — | Catmints Cafe | cafe.superportia.dev | cloud-static | static-site | active |
| 25 | — | Blog | blog.superportia.dev | cloud-static | static-site | dev |
| 26 | — | SuperPortia | — | config-only | config-ops | active |
| 27 | — | UB Dashboard | ub.superportia.dev | cloud-serverless | standalone | planned |
| 28 | — | Nyam | nyam.superportia.dev | planned | standalone | planned |
| 29 | — | Prop Firms | propfirms.superportia.dev | planned | standalone | planned |
如何閱讀這張表
依 deploy type — 當你需要更新某個東西時：
- cloud-serverless / cloud-static →
git push或wrangler deploy - local-build-cloud → 先在本地 build，再 deploy
- factory-storefront → 先跑 pipeline，再 build + deploy
- local-only / local-daemon →
launchctl kickstart - docker →
docker restart
依 role — 當某個東西壞掉時：
- infrastructure 停了 → 多個專案受影響，優先修復
- platform-hub 停了 → 管理可視性喪失，但 app 仍可運作
- pipeline 停了 → 資料停止流入，但現有資料仍可提供
- standalone 停了 → 只有那個 app 受影響
依 status — 什麼需要關注：
- active（17 個）→ 在 production 運行
- development（7 個）→ 建設中，可能不穩定
- standby（2 個）→ 已安裝但未運行
- planned（3 個）→ 僅登記冊佔位符
Port 衝突
截至 2026-03-15 存在兩個衝突：
- 3000：NQ 2026 Alpha + Weekly Ops（Weekly Ops 是子專案，將合併至 NQIO）
- 3001：Open WebUI（standby）— Bridge 已移至 3002 以解決衝突
這張地圖能帶來什麼
有了三個維度的登記冊，Command Center 可以：
- 依 role 篩選 — 只顯示 infrastructure、只顯示 pipeline
- 依 deploy type 分組 — 「需要手動部署」vs「push 後自動部署」
- 依 port 監控 — 對每個有 port 的專案做健康檢查
- 審計合規 — 哪些專案通過
/createscaffold 驗證
登記冊存放於 command-center/src/data/registry.json，是所有專案 metadata 的唯一真實來源（SSoT）。