06 开发（跨仓）01_技术总览
DEV-X-01-003 本地工作区
本机 OceanWay 目录的结构与使用约定
本机工作区位于 ~/Projects/OceanWay。工作区根目录本身不是 Git 仓库，各项目独立管理。platform/oceanway-platform 在 2026-10-02 导入官方 rc.41；2026-10-11 已建立私有远端 userWZ/oceanway-platform 并上传首快照。2026-10-13 本机工作分支为 t04-platform-authority，HEAD 为 6fefab7，后续源码和证据仍有未提交内容；远端 main 首快照为 1dc6fa1。运行制品另按冻结源码指纹和镜像 ID 核对，不能据本机 HEAD 宣称这些后续内容已经提交或发布。
目录结构
OceanWay/
├─ README.md 工作区入口
├─ platform/
│ └─ oceanway-platform 平台开发；t04-platform-authority；已有私有远端
├─ products/
│ ├─ oceanway-studio 产品工程
│ ├─ oceanway-site 品牌官网
│ ├─ oceanway-drama 已归档（Drama 冻结，ADR-0004）
│ ├─ oceanway-commerce 迁入产品工程后归档
│ ├─ oceanway-console 已归档（ADR-0002）
│ └─ oceanway-admin 已归档（ADR-0002）
├─ gateways/
│ ├─ oceanway-text-gateway uumi（GitHub 仓库已归档）
│ └─ oceanway-media-gateway 媒体网关
├─ operations/
│ ├─ oceanway-docs 文档站（唯一的需求、架构与进度来源）
│ ├─ oceanway-design 设计规范
│ ├─ oceanway-infrastructure 部署编排主工作区；历史快照分支
│ └─ oceanway-infrastructure-platform-staging
│ Infrastructure 独立工作树；平台隔离部署编排
├─ references/new-api 官方源码阅读参考；固定385d2dfd1
├─ .worktrees/ 媒体网关的任务工作树
└─ archive/ 只读归档
├─ repos/ oceanway-core、oceanway-api-edge、oceanway-contracts
├─ coordination-2026-09/ 原协调目录的完整副本
└─ artifacts/ 原 Playwright 截图与会话产物Infrastructure 的 staging 工作树使用 codex/platform-staging-deployment，与主工作区共享同一 Git 仓库，不是新增仓库。2026-10-13 核对 deploy/platform-staging/ 仍为未跟踪文件；部署运行证据、待提交编排和仓库主线状态应分别记录。Studio 的近期产品接入代码已提交到其快照分支，具体版本与未完成联调见仓库与文档对照表及Studio 对接。
约定
- 文档只有一个来源。 需求、架构、决策和进度都写在文档站，不在工作区根目录另建协调文件。仓库内只保留开发说明（怎么运行、代码结构）。
archive/只读。 不在归档目录里开发；需要参考旧代码时直接阅读。archive/coordination-2026-09/含密钥文件，绝不能提交到任何 Git 仓库。 其中的文本记录（已做密钥清理）已另存于文档仓库的content/docs/08_归档/05_重构前过程记录/03_协调记录2026-09/（不在站点渲染；历史参考，不构成依据）。- 不长期保留未提交的改动。 每天结束前提交并推送。
本地端口
| 服务 | 地址 |
|---|---|
| 文档站（开发） | http://localhost:3001 |
| Drama V3 工作台（开发中） | 独立 Next.js，http://127.0.0.1:3200（V3 无后端/Worker） |
新增常用服务时补充到此表，避免端口冲突。