From 44951bcc27d599e8dc2939a2f0545a4261937559 Mon Sep 17 00:00:00 2001 From: pikastech Date: Tue, 21 Jul 2026 01:39:27 +0200 Subject: [PATCH] feat: define SuperAPI devlevel entrypoints --- config/platform-infra/public-edge.yaml | 4 ++-- .../specs/PJ2026-01050205-superapi.md | 22 ++++++++++++++----- 2 files changed, 19 insertions(+), 7 deletions(-) diff --git a/config/platform-infra/public-edge.yaml b/config/platform-infra/public-edge.yaml index f0f10f3d..880a6e18 100644 --- a/config/platform-infra/public-edge.yaml +++ b/config/platform-infra/public-edge.yaml @@ -147,7 +147,7 @@ targets: - id: findjob configRef: config/platform-infra/findjob.yaml path: publicExposure - - id: superapi + - id: superapi-local configRef: /root/superapi/config/superapi.yaml path: publicExposure - sourceCommit: f9b357b0dd3f312c98803f34bb3521d9f9780bb7 + sourceCommit: 14dfc721f89db976cb1c73c5246d350b79b1a3a3 diff --git a/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md b/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md index ddb7c318..005b009e 100644 --- a/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md +++ b/project-management/PJ2026-01/specs/PJ2026-01050205-superapi.md @@ -263,7 +263,7 @@ SuperAPI 还是 Codex 原生运行面。Company Skills 解析只能移除对应 吞掉其后的 system/developer prompt。L0 应覆盖重复目录和原生技能混合输入， L1 应使用真实 Codex 历史回归，并分别披露解析耗时。 -### 4.13 USER-KEY-SKILL-REQ-013 YAML-first L0/L1 +### 4.13 USER-KEY-SKILL-REQ-013 YAML-first L0-L3 owning YAML 应声明： @@ -271,18 +271,30 @@ owning YAML 应声明： - Temporal serviceRef、namespace、task queue、超时和重试； - gateway、API、worker 与 Web 的 native entrypoint、固定端口、PID、日志、状态目录、停止等待上限和启动就绪等待上限； - 管理 API 的同源路径； -- Web 固定 HTTPS origin； +- L1、L2 和 L3 各自独立的固定 HTTPS origin； +- L2 与 L3 各自独立的 namespace、Service、Deployment、SecretRef、 + PostgreSQL 连接、Temporal task queue 和运行时状态目录； +- L2 master 分支与 L3 release 分支的自动交付关系； - gateway 快照路径与刷新策略； - CLI 默认 local target 和 `--over-api` target。 -交付顺序只覆盖 L0 和 L1： +交付和回归顺序覆盖 L0-L3： 1. L0 直接调用 repository、dispatcher、快照构建和历史导入函数； 2. L0 使用 native PostgreSQL 完成 skill、API Key、绑定和历史查询闭环； 3. L1 通过项目 CLI 独立启动 worker、API、Web 和 gateway； 4. L1 用同一 CLI 的 `--over-api` 重复管理操作； -5. L1 从 `https://superapi.hwpod.com` 验证多页面 Web 和 `/v1/*` gateway； -6. 本阶段不进入 L2，不触发 CI/CD 或 Kubernetes rollout。 +5. L1 从 `https://superapi-local.hwpod.com` 验证多页面 Web 和 `/v1/*` gateway； +6. L2 由 master 分支的正常 push 事件自动构建并收敛到开发 namespace， + 从 `https://superapi-dev.hwpod.com` 验证同一管理与 Gateway 业务路径； +7. L3 只消费已经通过 L2 的同一提交链，由 release 分支的正常 push 事件自动构建 + 并收敛到生产 namespace，从 `https://superapi.hwpod.com` 验证正式业务路径； +8. release 必须保持为 master 的祖先，生产发布只允许把 release 快进到已经通过 + L2 回归的 master 提交，禁止在 release 上直接开发、cherry-pick 或生成独有提交； +9. L2 与 L3 禁止共享进程、临时状态卷或捕获目录；数据库可以使用同一 PostgreSQL + 服务，但必须使用独立数据库或独立 schema，避免开发数据污染生产数据； +10. L1、L2 与 L3 的公开入口、运行对象和发布状态均由 owning YAML 选择，禁止通过 + 命令行 URL、临时端口、裸 Kubernetes apply 或手工 Caddy 配置形成第二真相。 ### 4.14 USER-KEY-SKILL-REQ-014 文档型 Remote Skill 导入