Skip to content

E8(#5040 执行器):验收 —— showcase 端点回迁 /apps/showcase/… + RED-first e2e + 真实 boot 探针 + 升级文档安全复核 #5112

Description

@os-zhuang

Part of #5040(E 系列第 8 单,收尾件,v17 切版等本单绿)。Blocked-by: E7(翻转单)。

范围

  1. showcase 回迁:恢复被注释的 apis: 声明(声明式 apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint 全仓无实现 #4936 时随硬拒注释),路径迁到命名空间前缀 /api/v1/apps/showcase/…,过 E7 的 publish 门;
  2. RED-first e2e:先写断言「声明的端点在真实 boot 上可达且语义正确」的失败测试,再让链条把它变绿 —— 覆盖:匹配命中执行(每种 target 类型至少一条)、authRequired: false 匿名可达 / 缺省需鉴权、rateLimit 429 + Retry-After、cacheTtl 响应头、未声明路径 404 形状与 声明式 apis:(ApiEndpoint)入站面全链路零执行:元数据装载成功、路由从未挂载、matchEndpoint 全仓无实现 #4936 前逐字节一致;
  3. 真实 boot 探针(参照 GET /openapi.json 有两个属主:rest-server 真serve,http-dispatcher 的 generateOpenApi 分支全仓无实现(ADR-0076 D1 影子重复) #5078 的实测纪律,curl 非 grep):boot showcase → 逐端点 curl 断言 + /api/v1/openapi.json 含端点条目(E6 enrichment 生效证明)+ 阴性对照;
  4. 升级文档安全复核(维护者裁决的落点):确认 upgrade-guide 中「审视历史 apis: 配置、尤其显式 authRequired: false」指引在场、准确、可被 AI 维护者据此执行 —— 按安全件验收,不是文案顺带;
  5. 覆盖真相:执行器代码「结构性不可达」豁免随本单终结,coverage 纳入正常门。

约束

执行器车道程序卡(session_01EYGdmvWP1ieZSLqvAW6uyd 按序派发),其它车道请勿认领;不改 content/docs/releases/。

关联:#5040 设计 §6/§7、E7 翻转单、#5078(boot 实测纪律先例)。

Activity

  1. self-assigned this
    on Aug 4, 2026
  2. os-zhuang commented on Aug 4, 2026

    @os-zhuang
    ContributorAuthor

    认领(E8 收官) —— PM 会话 session_01EYGdmvWP1ieZSLqvAW6uyd(执行器车道),分支 claude/issue-5112-acceptance,与 E7b(#5189)并行派发。前置:E1–E7 全部落 main(翻转在 d21c001)。

    文件面声明(#4604,与 #5189 互斥):examples/app-showcase(apis: 回迁 + manifest.namespace)、e2e 测试面、真实 boot 探针脚本/测试、覆盖豁免终结。不碰 packages/metadata / packages/spec(#5189 的面)。

    验收注记:boot 断言只限端点条目,不因内建 $ref 悬空(存量 #5168)判失败;多租户交错验收点按 E5b 报告;composed-stack(设计 §7-7)如超范围如实报告留档。


    Generated by Claude Code

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions