CON-P01 范围、导航与同源工程

范围与代码边界

在 products/oceanway-console 建立前端工程。页面、路由、业务适配由本仓负责，Core 管身份和资金；Developer 保持公开独立门户。以下 src/app、src/features、src/lib 等为建议目录，尚未创建。

需求与接口输入

产品行为引用Console 操作范围；精确字段与差异见两端 API 映射。以下接口按所关联 CA 操作列出本任务核对范围，不表示每个接口都已挂载或必须同时启用。

设计采用OceanWay 与 shadcn 规范，场景沿用原型任务书。建议目录和交付物是实施要求，实际工程状态见开工基线。

任务与交付

CON-P01.01 · 锁定页面图与功能开关

范围级别：必需。

产品操作：CA-C01、CA-C03、CA-C14、CA-C19

前置：现行产品范围、固定 new-api 源码及两端开工基线。

实施范围：划分公开登录/恢复、私有总览、Keys、模型价格、用量、钱包订单、任务、账户安全、产品入口；给每条路由登记访问条件和返回位置。注册、增强认证、兑换、订阅、Playground 逐项标记启用条件。

接口依据：CORE-ADMIN-027；CORE-AUTH-041；CORE-AUTH-025；CORE-AUTH-027；CORE-AUTH-030；CORE-AUTH-046；CORE-AUTH-011；CORE-AUTH-042；CORE-USER-013；CORE-USAGE-004；CORE-USAGE-003；CORE-USAGE-010；CORE-USAGE-008；CORE-BILL-038；CORE-BILL-039；CORE-BILL-040；CORE-BILL-031；CORE-MODEL-017；EDGE-COMPAT-035

交付物：路由—页面—CA-C 操作表、导航草图、能力开关清单；页面路径是待实现路由，不冒充已运行地址。

验收场景：关闭订阅和 Playground 后没有可购买或可提交的入口；未登录直达私有页保留受控返回位置；普通客户不出现运营菜单。

CON-P01.02 · 建立对齐固定上游的前端工程

范围级别：必需。

产品操作：支撑本产品全部已启用操作；不另增产品需求。

前置：CON-P01.01

实施范围：检查 references/new-api/web 的 package、锁文件、构建和组件配置，按职责迁入 React/TypeScript/Rsbuild/TanStack/Tailwind 4/shadcn/Base UI；固定版本与来源记录，建立开发、类型检查和生产构建命令。

接口依据：工程/验收任务不新增业务接口；使用依赖任务已冻结的协议。

交付物：可启动的最小应用、依赖锁文件、环境变量样例、来源与差异说明；接口地址使用环境配置。

验收场景：干净安装后可启动和构建，嵌套路由直接刷新可访问；产物无服务凭据；不复制网关后台或引入跨仓源码 import。

CON-P01.03 · 实现请求适配与身份隔离缓存

范围级别：必需。

产品操作：CA-C02、CA-C04

前置：CON-P01.02、CORE-01.03

实施范围：在请求适配层分别处理 HTTP、success/message/data 与会话错误；保留端点斜杠、分页和错误语义。查询键绑定当前主体和筛选；身份切换取消旧请求并清理私有缓存，普通网络故障不直接注销。

接口依据：CORE-USER-013；CORE-AUTH-024；CORE-AUTH-023；CORE-KEY-002；CORE-KEY-011；CORE-KEY-003；CORE-KEY-004；CORE-KEY-006；CORE-KEY-008

交付物：接口适配规范、只读查询与写操作错误样例、401/403/429/超时处理、敏感字段禁日志清单。

验收场景：HTTP 200 业务失败不能显示保存成功；A 账户慢请求晚于 B 登录返回也不覆盖 B 页面；403 展示无权限而非无限登录循环。

CON-P01.04 · 定义字段、状态和样例交付规范

范围级别：必需。

产品操作：CA-C03、CA-C07、CA-C09

前置：CON-P01.01、CON-P01.03

实施范围：每页记录真实 API 字段、显示单位、时间与空值、筛选支持范围；按账户、Key、operation、order、task ID 串联样例。原型数据单独启用并显式标示。

接口依据：CORE-USER-013；CORE-USAGE-004；CORE-USAGE-003；CORE-USAGE-010；CORE-USAGE-008；CORE-MODEL-017；CORE-MODEL-018；CORE-MODEL-014；OW-01；OW-04；OW-05

交付物：页面字段字典、状态样例索引、接口缺口清单；沿用 CA/GAP 与 Contracts，不建立第二套权威 DTO。

验收场景：加载、空集合、读取失败、无权限、未配置和零值可区分；示例人民币/积分标非真实报价；正式构建不自动回退到模拟成功。

阶段退出与记录

本阶段必需任务的交付物和验收记录齐全，条件项明确是否启用及原因；接口缺口有对应 Core/Contracts 任务。原型走查、真实接口接入和业务联调分开记录。前置任务是本任务真实完成的依赖，设计和明确标识的模拟页面可先行，不据此宣称后端完成。

遇到方法、字段、权限或恢复语义缺口，更新原 CA/GAP 和 Contracts 草案并关联本任务，不在前端猜测补出权威价格、余额或命令结果。

返回 Console 主计划 · 操作覆盖 · 联合验收。