aurora-admin
eb25feedaf
【本次核心 · S6-P21】 - 族层数据：families.json + 44 份契约注入 family/familyRole/familyParams； data.json / data.js / site/details 同步。13 族 / 44 成员 / 35 独立 → 概念组件 79→48。 - 79 个 slug 全保留、集合逐一不变（铁律 5 对外承诺未破）；frameworks 仍 395 文件、薄壳仍 79。 - 归族判据为契约中可核对字段（semanticTypeCandidates 重叠 / anatomy 为同一骨架子集 / 变体维度同构 / doNotInvent 显式从属声明），每族 mergeBasis 写明依据，不按名字猜。 - 实现层合并（导航族端到端切片）：tools/gen-family-impl.mjs 从 5 端模板生成 TopMenu / SideMenu / MixedNavigation 共 15 文件，参数 direction=top|side|mixed； 三份 CSS md5 完全相同 = 一份样式表服务三个组件。 - 新增 tools/gen-families.mjs、tools/gen-family-impl.mjs、tools/verify-families.mjs、 tools/lib/family-model.mjs、tools/lib/family-impl/nav-menu/*.tpl。 【同时清掉此前已完成但未提交的批次】 生成物（data.json / data.js / site/sources / site/components 薄壳 / sitemap.xml / tests 报告） 跨阶段交织，无法拆成互相自洽的多个提交，故按既有批量风格合并提交： - Package：三端可 import（S5-P18）+ 发布到私有 npm 源 - Docs site：导航语言改下拉（S5-P19）、详情页代码块默认展开、中英切换完整性 - Security：生产部署链审计修复（2026-09-19）+ 线上部署 - Theme modes 日间/夜间/自动；S1-P4 data.js 瘦身；S2-P5 暗色；S2-P6 跨端一致性； S2-P7 行为断言；S2-P9 FAQ；S3-P8 RTL；S3-P9 契约缺口解释层；S4-P12 发布流程 - 补入 tools/pack-deploy.mjs、run-site-smoke.mjs、verify-*.mjs，.dockerignore、 安全审计修复与待决策项.md 【验收】 - node tools/verify-families.mjs → OK: 族层端到端一致（13 族 / 44 成员 / 79 组件不变 / 395 文件不变） - node tools/verify-cross-platform.mjs → 79/79 identical（HEAD 基线 high 44） - node tools/run-regression.mjs → 100%（79/79 页，1017/1017 断言，N/A 34），连跑 8 次一致，0 超时 - 逐页实测：topmenu / sidemenu / mixednavigation 各 13/13，帧内 direction 参数正确，0 JS 错误 - 零运行时依赖 OK；build-site.ps1 ASCII-only OK 【未纳入】site/components/<slug>/ 平台薄壳 316 个 —— 历史从未跟踪且属构建产物，保持现状。
49 lines
3.9 KiB
Plaintext
49 lines
3.9 KiB
Plaintext
# Aurora Admin Design System
|
||
|
||
> Aurora Admin 是一套 B 端后台管理设计系统：**79 个全量组件契约 × 4 个运行端 + CSS 资产**（H5 / React / Vue 2 / Vue 3 / CSS），品牌主色 #2F54EB，桌面端优先（最小宽度 1280px），所有色值取自 au-* CSS 变量令牌，零运行时依赖。当前版本读取 `site/data.json.meta.version`（v1.4.1）。
|
||
|
||
## 机器可读数据（Agent 优先消费这些，无需解析 HTML）
|
||
|
||
- [site/data.json](data.json)：全量数据单文件——meta（版本/品牌/计数）+ 六大分类 + 全部设计令牌 + 79 个组件（规格摘要、4 个运行端文件路径、CSS 资产、API 提炼、核心契约）。
|
||
- [site/details/<slug>.json](details/)：组件完整契约与规格详情，文档站按需加载。
|
||
- [site/sources/<slug>/*](sources/)：文档站代码查看与 H5 在线试玩所需源码。
|
||
- [.design_library/aurora-admin/components/index.json](../.design_library/aurora-admin/components/index.json)：79 个组件契约的权威映射（schemaVersion 3）。
|
||
- [.design_library/aurora-admin/css.json](../.design_library/aurora-admin/css.json)：设计令牌结构化 JSON（颜色/字体/间距/圆角/阴影/控件高度）。
|
||
- [.design_library/aurora-admin/components.css](../.design_library/aurora-admin/components.css)：全部组件样式单文件聚合。
|
||
- [.design_library/aurora-admin/colors_and_type.css](../.design_library/aurora-admin/colors_and_type.css)：CSS 变量令牌源文件。
|
||
|
||
## 核心组件契约
|
||
|
||
契约覆盖全部 79 个组件；核心入口示例：
|
||
|
||
- [button](../.design_library/aurora-admin/components/button.json)
|
||
- [input](../.design_library/aurora-admin/components/input.json)
|
||
- [select](../.design_library/aurora-admin/components/select.json)
|
||
- [table](../.design_library/aurora-admin/components/table.json)
|
||
- [card](../.design_library/aurora-admin/components/card.json)
|
||
- [modal](../.design_library/aurora-admin/components/modal.json)
|
||
|
||
## 文档站页面
|
||
|
||
- [首页](./#/): 产品概览、核心能力、快速入口
|
||
- [组件总览](./#/overview): 79 个组件的分类总览与实时 H5 预览
|
||
- [快速开始](./#/guide): 令牌引入、按端取用组件、目录与命名约定
|
||
- [设计规范](./#/design): 色彩 / 字体 / 间距 / 圆角 / 阴影 / 控件高度
|
||
- [For Agents](./#/agents): Agent 消费资源清单、data.json 数据形状、使用规则
|
||
- [更新日志](./#/changelog): SemVer 版本记录
|
||
|
||
## 运行端、A11y 与 RTL
|
||
|
||
- 运行端为 H5、React、Vue 2、Vue 3 四端；CSS 是配套样式资产，不另计为运行端。
|
||
- A11y 已纳入自动化结构断言基线（键盘可达、焦点环、ARIA、对比度、token 使用等），但当前结果不等同于完整 WCAG 2.1 AA 合规声明；屏幕阅读器、焦点顺序、动态播报和 200% 缩放仍需人工或辅助技术验收。
|
||
- RTL 已纳入样式迁移与验证范围，部分组件使用 CSS 逻辑属性。可在宿主页面设置 `dir="rtl"` 做定向验证；当前不宣称 79 个组件已完成全量 RTL 视觉验收，图标方向、复杂布局、溢出与交互顺序仍需逐组件复核。
|
||
|
||
## Agent 使用规则（生成 UI 前必读）
|
||
|
||
1. 不发明：组件变体不得超出契约 dims 声明的维度与取值；扩展组件以 specLines 规格原文为准。
|
||
2. 不硬编码颜色：所有色值取自 tokens 中的 au-* 变量；语义色（成功/警告/错误/信息）独立于品牌蓝。
|
||
3. 尊重未明示：契约 unknowns 列出的项规格未定义，生成前向用户澄清而非假设。
|
||
4. 理解字段语义：doNotInvent 是设计边界，不是待实现功能；unknowns 是开放设计问题，不是错误。实现中已有的值只有在规格明确后才能当作契约值。
|
||
5. 文案规范：按钮用动词短语（新建/编辑/删除/提交），错误反馈给出具体字段与修正方向，不使用 emoji。
|
||
6. 测试基准：`tests/<slug>.html` 的断言结果标注 `data-assert` / `data-status`，可机读回归。
|