leiyun
/
ute2e
1
0
Fork 0
Koodi Ongelmat 0 Pull-pyynnöt 0 Julkaisut 0 Wiki Toiminta
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
22 Commitit
1 Haara
543 MiB
 
 
 
 
Puu: 8d421bd7b4
Branchit Tagit
${ item.name }
Create branch ${ searchTerm }
from '8d421bd7b4'
${ noResults }
ute2e/reports/open-platform-style-20260909/index.html

29 rivejä
7.1 KiB
Raaka Blame Historia 

  1. <!doctype html>

  2. <html lang="zh-CN">

  3. <head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>开放应用与 API 文档调整验收 · 2026-09-09</title>

  4. <style>

  5. *{box-sizing:border-box}body{margin:0;background:#f3f6f5;color:#172b26;font:15px/1.75 system-ui,"Microsoft YaHei",sans-serif}main{max-width:1250px;margin:auto;padding:32px 24px}header,section{background:#fff;border:1px solid #dce5e0;border-radius:10px;padding:26px;margin-bottom:22px}h1{font-size:26px;margin:0 0 8px}h2{font-size:20px;margin:0 0 16px}h3{font-size:16px}p{margin:10px 0}.muted{color:#586d66}.status{display:inline-block;border-radius:20px;background:#e0f4e9;color:#08744d;padding:3px 13px;font-weight:600}.metrics{display:flex;flex-wrap:wrap;gap:20px;margin-top:20px}.metrics div{padding:12px 20px;background:#f5f9f7;border-radius:6px}.metrics b{display:block;color:#087b54;font-size:25px}.grid{display:grid;grid-template-columns:1fr 1fr;gap:20px}.shot{min-width:0;margin:0;border:1px solid #dce5e0;border-radius:6px;overflow:hidden}.shot img{width:100%;display:block}.shot figcaption{padding:10px 14px;color:#586d66;font-size:13px}.mobile img{max-width:390px;margin:auto}.wide{grid-column:1/-1}.full-doc{max-width:820px;margin:auto}.full-doc img{width:100%}a{color:#087b54}table{width:100%;border-collapse:collapse}th,td{text-align:left;border:1px solid #dce5e0;padding:10px 12px}th{background:#f4f8f6}code{overflow-wrap:anywhere;background:#f4f6f5;padding:2px 4px}li+li{margin-top:5px}@media(max-width:760px){main{padding:12px}header,section{padding:17px}.grid{grid-template-columns:1fr}h1{font-size:22px}.metrics{gap:8px}.metrics div{padding:10px}}

  6. </style></head>

  7. <body><main>

  8. <header><span class="status">验收通过</span><h1>开放应用与 API 文档调整</h1><p class="muted">数字人服务系统 · 2026-09-09 · 开发环境真实页面验证</p><p>开放应用统一使用现有系统的标题、搜索工具栏、列表和底部分页。API 文档从开放应用页内进入，采用目录导航与完整正文，每个接口直接展示描述、输入参数、输出参数、返回示例和错误码。</p><div class="metrics"><div><b>13 / 13</b>业务接口完整展示</div><div><b>8</b>浏览器检查组通过</div><div><b>33</b>相关后端测试通过</div><div><b>6</b>真实数据库搜索检查通过</div></div></header>

  9. <section><h2>本次变更与验证</h2><table><thead><tr><th>项目</th><th>结果</th></tr></thead><tbody>

  10. <tr><td>页面风格</td><td>使用统一语义色、系统页面容器、Element Plus 表格、工具按钮和分页；浅色、深色均截图检查。</td></tr>

  11. <tr><td>文档入口</td><td>菜单仅保留开放应用，右上角按钮进入文档二级页；当前菜单继续高亮开放应用，返回按钮可正常回到列表。</td></tr>

  12. <tr><td>文档内容</td><td>13 个接口与运行中的 OpenAPI 契约逐项比对；无折叠组件，每个接口均包含四个章节和返回示例。参数类型、默认值与范围取自服务端契约。</td></tr>

  13. <tr><td>参数与错误码</td><td>明确请求头、路径、查询和 JSON 参数；注明幂等键必填、视频尺寸范围、授权要求；区分 HTTP 业务码、任务失败码和二进制响应。</td></tr>

  14. <tr><td>移动端与外部访问</td><td>公共文档 /developer 无需登录；390px 窄屏无页面横向溢出，宽参数表在表格内滚动。</td></tr>

  15. <tr><td>附带修复</td><td>KingBase MySQL 兼容模式下，原 contains 查询中的 || 被解释为逻辑运算，造成搜索返回全部数据。改为绑定完整 LIKE 参数，并转义通配符；应用名称、APPID 和授权资源搜索验证通过。</td></tr>

  16. </tbody></table><p>前端 <code>pnpm exec vue-tsc --noEmit</code> 通过。后端菜单测试 5 项、迁移测试 23 项、开放平台测试 5 项通过；后者包含新增关键词和字面通配符回归用例。真实 KingBase 对应用及五类资源的不匹配关键词均返回 0 条。浏览器无未捕获脚本错误。</p><p>数据库迁移 <code>20260909_034_open_api_docs_secondary.sql</code> 已在开发库执行并复核：软删除文档菜单及其权限关联，保留访问权限本身；恢复默认菜单不会重新出现文档。全量 DDL 和接口说明已同步。</p><p class="muted">环境说明：测试期间发现开发配置使用 2 个数据库连接且无溢出连接，后台任务和页面并发曾触发连接池等待。本次运行进程按代码默认值使用 pool_size=10、max_overflow=20，未修改持久化连接配置。本轮未重复视频生成业务测试，也未更改应用密钥、授权数据或成片协议。</p><p><a href="results.json">浏览器检查结果 JSON</a> · <a href="../../tools/open-platform-style.mjs">可复跑的 E2E 脚本</a></p></section>

  17. <section><h2>页面截图</h2><p class="muted">点击截图可查看原图。</p><div class="grid">

  18. <figure class="shot wide"><a href="01-applications-light.png"><img src="01-applications-light.png" alt="浅色开放应用列表，统一工具栏和分页"></a><figcaption>开放应用：标题、搜索、重置、新建、列表和底部分页统一。</figcaption></figure>

  19. <figure class="shot wide"><a href="02-docs-overview-light.png"><img src="02-docs-overview-light.png" alt="文档二级页面，系统菜单仅显示开放应用"></a><figcaption>文档二级页：左侧系统菜单不展示文档，页内目录提供接口定位。</figcaption></figure>

  20. <figure class="shot wide"><a href="09-generation-input.png"><img src="09-generation-input.png" alt="成片生成接口描述和输入参数"></a><figcaption>接口正文：请求方式、路径、权限和输入参数表直接呈现。</figcaption></figure>

  21. <figure class="shot"><a href="04-docs-dark.png"><img src="04-docs-dark.png" alt="深色文档页"></a><figcaption>文档深色主题。</figcaption></figure>

  22. <figure class="shot"><a href="05-applications-dark.png"><img src="05-applications-dark.png" alt="深色开放应用列表"></a><figcaption>开放应用深色主题。</figcaption></figure>

  23. <figure class="shot wide"><a href="06-application-dialog-dark.png"><img src="06-application-dialog-dark.png" alt="深色应用配置弹窗"></a><figcaption>配置弹窗沿用系统主题，授权资源区域正常显示；测试未保存修改。</figcaption></figure>

  24. <figure class="shot mobile"><a href="07-docs-mobile.png"><img src="07-docs-mobile.png" alt="390像素移动端公共文档入口"></a><figcaption>移动端：公共文档与目录。</figcaption></figure>

  25. <figure class="shot mobile"><a href="08-docs-mobile-parameters.png"><img src="08-docs-mobile-parameters.png" alt="移动端参数表，表格内部横向滚动"></a><figcaption>移动端：宽参数表内部滚动，页面本身不溢出。</figcaption></figure>

  26. </div></section>

  27. <section><h2>单个接口完整展示</h2><p>以“提交成片生成任务”为例，以下完整截图覆盖描述、输入参数、输出参数、返回示例和错误码。</p><figure class="shot full-doc"><a href="03-generation-document.png"><img src="03-generation-document.png" alt="成片生成接口四个章节完整截图"></a></figure></section>

  28. </main></body></html>