diff --git a/docs/pool-architecture.md b/docs/pool-architecture.md
new file mode 100644
index 0000000..cb44b4b
--- /dev/null
+++ b/docs/pool-architecture.md
@@ -0,0 +1,35 @@
+# 光湖共享节点池 · 架构文档
+
+> 铸渊 ICE-GL-ZY001 · D112 · 2026-05-25 · TCS-0002∞
+
+## 架构
+
+铸渊主控 → 语言主控层(冰朔侧/6台) + 光湖团队层(团队侧/awen) → 统一规则(目录/端口/PM2/Gatekeeper)
+
+## 节点加入流程
+
+1. 冰朔签发: `bash generate-join-token.sh --team awen`
+2. Awen运行: `bash <(curl -fsSL https://guanghulab.com/pool/join-pool.sh) --token jt_xxx --team awen --operator "Awen"`
+3. 冰朔审批: POST /api/pool/approve
+4. 自动完成: 创建目录→注册→保存配置→验证连接
+
+## CVM分区
+
+/opt/zhuyuan/ice/ (冰朔侧·端口3900-3999) + /opt/zhuyuan/team/awen/ (团队·端口3000-3099)
+PM2: ice:service / team:awen:service
+
+## 端口分配
+
+冰朔侧:3900-3999 | awen:3000-3099 | feimao:3100-3199 | juzi:3200-3299 | yanfan:3300-3399 | yeye:3400-3499 | zhizhi:3500-3599
+
+## API端点
+
+POST /api/pool/join (加入) | GET /api/pool/join-status/:id (状态) | POST /api/pool/approve (审批) | POST /api/pool/report (心跳) | GET /api/pool/status (全局) | DELETE /api/pool/node/:code (移除)
+
+## 安全
+
+join_token预签发制 | 冰朔审批 | pool_token独立令牌 | 回滚支持 | 只注册不部署
+
+## 文件
+
+scripts/pool/join-pool.sh | scripts/pool/generate-join-token.sh | scripts/pool/pool-utils.sh | brain/pool-topology.json | _deploy/console-server/server.js
\ No newline at end of file