v1.2.0: contracts batch1 (21/79), thin shells+sitemap, regression 75.1%+report, playground, related components, scenario page, deploy assets
This commit is contained in:
aurora-admin
@@ -4,6 +4,23 @@
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
## [1.2.0] - 2026-09-10
|
||||
|
||||
### Added — 设计契约与工程化
|
||||
- B1 契约第一批：15 个输入类组件补齐契约 JSON（autocomplete / cascader / transfer / rate / slider / segmented / radiocard / checkboxcard / switchgroup / numberrangeinput / codeinput / passwordinput / phoneinput / colorpicker / mention），契约化覆盖 6 → 21/79
|
||||
- C4 静态薄壳：`site/components/<slug>.html` × 79（每组件独立可爬 URL：title + meta description + canonical + 刷新跳转），`sitemap.xml`（80 URL，部署后回填 `$SiteUrlBase`）
|
||||
- C3 headless 回归：79 个测试页全量执行 812 条断言（当前通过率 75.1%，失败项即改进 backlog），产出 `tests/report.json`；CI runner `tools/run-regression.mjs`（Playwright，含 JUnit XML 输出）
|
||||
- 首页 Hero 显示「测试通过率」（读取 tests/report.json，无报告时静默隐藏）
|
||||
- B3 Playground：组件详情页「▶ 在线试玩」——textarea 编辑 H5 源码，iframe srcdoc 防抖实时重渲染，支持复位 / 退出，不影响源文件
|
||||
- C1 交叉引用：组件详情页新增「相关组件」（相似 / 搭配维度映射 + 同分类兜底）
|
||||
- 场景示范页：`site/scenario/user-management.html`（筛选表单 + 数据表格 + 分页 + 新建弹窗 + 消息反馈，视觉全部来自令牌与 components.css），首页 Hero 加入口
|
||||
- 部署物料：根 `README.md`、Pages 入口 `index.html` 重定向、`.github/workflows/deploy-pages.yml`、`.gitignore`
|
||||
|
||||
### Fixed
|
||||
- 测试页断言协议落地：`tests/_runtime.js` 运行期自动标注快照节点 `data-assert`（多级结构启发式：.row → .demo → .demo-block → 首层；此前 79 页实际无断言节点，PLAN v1.1 声称与实现不符）
|
||||
- `site/data.js` / `site/data.json` 去除 UTF-8 BOM（PS5.1 `Set-Content` 默认带 BOM，严格 JSON 解析器如 node require 直接解析失败）
|
||||
- 断言可见性判定放宽（`getClientRects` 兜底），减少隐藏变体误报
|
||||
|
||||
## [1.1.1] - 2026-09-08
|
||||
|
||||
### Added — 竞品对齐改造（第一批，依据《竞品网站检查报告》与《现状问题分析与改造清单》）
|
||||
|
||||
+12
@@ -2,6 +2,18 @@
|
||||
|
||||
Aurora Admin 组件库的测试设计：**零依赖、可视化、可机读**。每个组件都有一份独立的测试页 `tests/<slug>.html`，加上 `tests/index.html` 总览入口。
|
||||
|
||||
## headless 回归（v1.2.0 起）
|
||||
|
||||
```bash
|
||||
node site/dev-server.js # 先起站
|
||||
node tools/run-regression.mjs # 需 npm i playwright；输出 tests/report.json + report-junit.xml
|
||||
```
|
||||
|
||||
- `tests/report.json` 是首页「测试通过率」的数据源；无报告时首页静默隐藏该数字。
|
||||
- 当前基线：812 条断言，通过率 **75.1%**。失败项集中在演示页真实缺口：状态变体（states）52、ARIA 51、键盘可达 35——这是演示页的改进 backlog，不是 runner 的误报。
|
||||
- 注意：测试页断言节点由 `_runtime.js` 运行期自动标注（`.row → .demo → .demo-block → 首层` 启发式）；重建测试页后无需额外处理。
|
||||
- 本地快速复跑（不装 playwright）：起站后用浏览器控制台跑一遍 79 页即可（见 git 历史中的收集脚本）；重建 data.js 后浏览器需 Ctrl+F5。
|
||||
|
||||
## 测试矩阵（每个组件都跑这 8 项）
|
||||
|
||||
| # | 维度 | 说明 |
|
||||
|
||||
+1
-1
File diff suppressed because one or more lines are too long
+1
-1
File diff suppressed because one or more lines are too long
@@ -5,8 +5,8 @@
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
<title>场景示范 · 用户管理 - Aurora Admin</title>
|
||||
<meta name="description" content="用 Aurora Admin 79 个组件搭出的完整后台页面示范：筛选表单 + 数据表格 + 分页 + 弹窗 + 消息反馈。">
|
||||
<link rel="stylesheet" href="../.design_library/aurora-admin/colors_and_type.css">
|
||||
<link rel="stylesheet" href="../.design_library/aurora-admin/components.css">
|
||||
<link rel="stylesheet" href="../../.design_library/aurora-admin/colors_and_type.css">
|
||||
<link rel="stylesheet" href="../../.design_library/aurora-admin/components.css">
|
||||
<style>
|
||||
/* 场景页布局：仅排版类样式，组件视觉全部来自 components.css 与令牌 */
|
||||
* { box-sizing: border-box; }
|
||||
|
||||
Reference in New Issue
Block a user