本地工作区
本机 OceanWay 目录的结构与使用约定
本机工作区位于 ~/Projects/OceanWay。工作区根目录本身不是 Git 仓库，各项目独立管理。platform/oceanway-platform 已在 2026-10-02 按 T-01 导入官方 rc.41，建立本地验证分支和隔离环境；尚无 OceanWay 远端。
目录结构
OceanWay/
├─ README.md 工作区入口
├─ platform/
│ └─ oceanway-platform 官方 rc.41 基线与隔离环境；t01-baseline-environment
├─ products/
│ ├─ oceanway-studio 产品工程
│ ├─ oceanway-site 品牌官网
│ ├─ oceanway-drama 迁入产品工程后归档
│ ├─ oceanway-commerce 迁入产品工程后归档
│ ├─ oceanway-console 前端迁入平台后归档
│ └─ oceanway-admin 前端迁入平台后归档
├─ gateways/
│ ├─ oceanway-text-gateway uumi
│ └─ oceanway-media-gateway 媒体网关
├─ operations/
│ ├─ oceanway-docs 文档站（唯一的需求、架构与进度来源）
│ ├─ oceanway-design 设计规范
│ └─ oceanway-infrastructure 部署编排
├─ references/new-api new-api 阅读参考
├─ .worktrees/ 媒体网关的任务工作树
└─ archive/ 只读归档
├─ repos/ oceanway-core、oceanway-api-edge、oceanway-contracts
├─ coordination-2026-09/ 原协调目录的完整副本
└─ artifacts/ 原 Playwright 截图与会话产物约定
- 文档只有一个来源。 需求、架构、决策和进度都写在文档站，不在工作区根目录另建协调文件。仓库内只保留开发说明（怎么运行、代码结构）。
archive/只读。 不在归档目录里开发；需要参考旧代码时直接阅读。archive/coordination-2026-09/含密钥文件，绝不能提交到任何 Git 仓库。 其中的文本记录已另存于文档仓库的archive/coordination-2026-09/。- 不长期保留未提交的改动。 每天结束前提交并推送。
本地端口
| 服务 | 地址 |
|---|---|
| 文档站（开发） | http://localhost:3001 |
| Drama 交互原型工作台 | http://127.0.0.1:5210，后端 5211 |
新增常用服务时补充到此表，避免端口冲突。