PLAT-04-004 本地开发环境
工具链审计、隔离数据库、共享登录验证与配置清单
当前可做与后续启动
2026-10-10本机实例收敛：当前平台唯一浏览器入口是 http://127.0.0.1:18089，登录、Console和Admin由同一个Go程序内嵌前端提供。内部API为18088，保留的Platform PostgreSQL为30444；无需单独启动Vite或18443 TLS桥。启动、状态、重建和停止统一使用平台仓库 scripts/platform-local.py，具体命令与私有配置路径以该仓README为准。启动器先构建前端再编译Go，进程锁防止重复启动，数据库探测核对原库名和原角色，保留账号、密钥与原业务数据。该loopback HTTP入口不作为生产TLS/跨域SSO证据。
2026-10-02 T-01的官方rc.41基线环境及18080/18081、15432、16379端口仅为历史验证记录，不是当前启动入口；基线工具链与证据仍见平台仓库 docs/baseline.md、docs/verification/T-01/environment.md。文档站检查仍在 operations/oceanway-docs 执行：pnpm dev（3001）、pnpm docs:redirects、pnpm docs:check、pnpm types:check、pnpm build。
源码导入后，平台 README 已补齐本机已验证命令；后续继续维护从干净检出完成安装、数据库准备、启动、夹具、检查和构建的实际命令。Go 版本从所选 go.mod/toolchain 读取，Node/包管理器从前端包清单和锁文件读取，不能照搬文档站的版本。PostgreSQL/Redis 版本按基线支持与生产环境统一确认。
启动顺序
- 固定源码 SHA 和依赖，记录工具链；确认本机服务端口，避开文档站 3001 与 Drama 5210/5211。
- 建立独立平台测试 PostgreSQL 数据库及受限数据库用户，设置独立 Redis 命名空间/实例；禁止使用现有 uumi 或产品生产库。
- 导入迁移并创建固定的测试用户、价格、角色与服务凭据；测试积分比例显式标注，不代表正式商业规则。
- 启动本地 TCP 上游与支付夹具，配置平台渠道和只包含已验证模型的销售目录。
- 启动平台、Console/Admin，再启动专用测试产品入口；检查会话、资金和后台恢复。
- 保存环境清单和脱敏证据；清理夹具数据采用可重建的测试库，不删现有业务数据。
配置分类
以下列的是配置要求，具体环境变量名以基线审计和最终实现为准。
| 分类 | 必须明确 |
|---|---|
| 数据存储 | PostgreSQL 连接、池上限、迁移策略；Redis 地址/隔离/失效策略 |
| 身份 | 会话签名或存储配置、Cookie 域/路径、安全属性、允许 Origin、返回白名单 |
| 产品 | 三产品作用域服务凭据、允许动作、轮换撤销与后台授权方式 |
| 供应 | uumi/媒体网关地址和专属上游 Key；本地默认夹具，真实地址按授权切换 |
| 价格与订单 | 精度、舍入、测试兑换比例、启用模型/价格、支付商户及通知校验 |
| 恢复 | 扫描频率、租约、重试退避、待核对阈值与告警 |
| 网络 | 服务监听、两前端路由、外部 URL、可信代理、限流 |
新增 .env.example 只写占位值和说明，启动时校验必需字段。错误不能输出完整凭据。生产密钥不复用到夹具，默认不开真实收费调用。
模型发现与本机代理 DNS
T-06/T-08、PL-011.R08～10：模型接入地址填写 HTTPS 站点根地址，例如 https://api.example.com，不附 /v1；不同类型专用服务 Key 在后台接入配置中加密持久化，不逐 Key 写环境变量。模型发现为服务端受保护的只读请求，不生成模型结果。
本机代理可能把真实域名解析到 198.18.0.0/15 Fake-IP。该保留地址仍由 SSRF 防护拒绝；不能放开私网或关闭 HTTPS 验证。平台可显式设置 OCEANWAY_PLATFORM_RELAY_DNS_OVER_HTTPS_URL，为托管上游使用独立 HTTPS DNS 查询。当前实现要求公开 IP 字面量、443、/dns-query（示例 https://1.1.1.1/dns-query），禁止重定向；解析所得全部地址继续校验并固定连接，原始上游域名用于证书校验。DNS 请求只含域名与记录类型，不含服务 Key；显式 DNS 故障不回退系统解析。未配置该项时仍使用系统 DNS。
当前保留实例的工作目录为 .local/platform-browser-fixture，私有 runtime.json 承载运行配置；使用 python3 scripts/platform-local.py --rebuild 顺序构建前端与Go，保留现有数据库、接入配置与用户会话。一次性浏览器夹具仅用于独立隔离验收，不通过重新初始化夹具清除已保存的配置。脱敏DNS验证证据在平台 docs/verification/T-08/model-discovery-dns-20261005/；该本机设置不等同于生产网络验收。
共享 Cookie 的本地验证
首个正式主域已确定为 oceanway.tech，入口/白名单需配置化；具体子域和后续独立主域SSO待T-04设计验收。建议使用受控本地 .test 子域名和本地 HTTPS 反向代理，模拟平台/Console/产品入口；具体名称与端口在 T-01 确认。域名解析与证书的实际配置由开发环境说明提供，不在文档任务中修改系统 hosts 或证书信任。
单个 localhost 页面不证明跨子域共享、Secure、Origin/CSRF 和白名单有效。夹具同时包含允许入口与拒绝入口，记录 Cookie 的实际 Domain/Path 属性及退出后的行为。