本地开发环境
工具链审计、隔离数据库、共享登录验证与配置清单
当前可做与后续启动
2026-10-02 T-01 已导入官方 new-api rc.41，真实工具链、锁文件、安装/构建/初始化/启动/检查命令见平台仓库 README 与 docs/baseline.md；运行证据见 docs/verification/T-01/environment.md。本机启动 scripts/build-local.sh 后执行 python3 scripts/dev.py up，原版 UI/API 为 127.0.0.1:18080，夹具 18081，独立 PostgreSQL 16.14 为 15432，独立 Redis 8.6.3 为 16379。尚未迁入 Console/Admin，尚未验证共享 Cookie 或资金闭环。文档站检查仍在 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 只写占位值和说明，启动时校验必需字段。错误不能输出完整凭据。生产密钥不复用到夹具，默认不开真实收费调用。
共享 Cookie 的本地验证
首个正式主域已确定为 oceanway.tech，入口/白名单需配置化；具体子域和后续独立主域SSO待T-04设计验收。建议使用受控本地 .test 子域名和本地 HTTPS 反向代理，模拟平台/Console/产品入口；具体名称与端口在 T-01 确认。域名解析与证书的实际配置由开发环境说明提供，不在文档任务中修改系统 hosts 或证书信任。
单个 localhost 页面不证明跨子域共享、Secure、Origin/CSRF 和白名单有效。夹具同时包含允许入口与拒绝入口，记录 Cookie 的实际 Domain/Path 属性及退出后的行为。