Files
aurora-admin/.design_library/kole-ui/components/card.json
T
aurora-admin f1fbfc2ddb
Regression / regression (push) Canceled after 0s
feat(品牌标识): 几何 K 图标(favicon/顶栏标记/theme-color) + 并行会话成果入库
## 品牌标识(本次会话)

起因:品牌此前没有任何图形标识 —— 唯一 favicon 是内联 data-URI 里的字母「A」,
那是 v2.0.0「Aurora Admin → Kole UI」改名漏掉的一处(PC 顶栏也是「A」,
移动端站已是「K」;移动端文档站则完全没有 favicon)。

- 几何:24 网格三个互不接触的笔画(竖 + 两斜),圆头描边;
  描边 2.25 → 16px 标签页尺寸下正好 1.5px = 规范原文「描边1.5px」
- 取色分两套(刻意):favicon 硬编码品牌蓝/白(渲染在浏览器标签栏,不继承 kole-dark);
  顶栏标记走 currentColor(实测暗色下自动转 rgb(20,22,28))
- 新增 theme-color 双条(light #FFFFFF / dark #1C1F26,取 --kole-color-card-bg)
- 修 site/app.js hero 标语 KOLE ADMIN → KOLE UI(改名变形残留)
- 移动端 7 个模板补 favicon(此前计数 0)

验收:门禁 9 条全 OK(site-routing/site-routes/mobile-docs/mobile-site/isolation/
theme/nav/i18n/icons);PC 回归 1464/1464 · 移动端 807/807,各连跑 8 次一致;
两端 favicon 405 字节逐字节一致;PC 站控制台错误 1→0。

## 并行会话成果(本次一并入库)

- 图标系统:2576 图标(TDesign/Element Plus,MIT)+ 11 端注入 + 5 个构建门禁工具
  + IconPreview 预览页 + ICON-SPEC.md 冻结规格
- 移动端平台:47 组件 × 6 端 + 文档站 53 页 + 隔离门禁
- PC 组件:103 个大后台组件 / 组件11 批次
- uni-app:PC 端试点 + 移动端端实现 + 真实编译验证

## 工程

- .gitignore 补 .scratch/ 与 .zcode-preexisting-*.txt(会话中间产物,实测 9.1MB,不入库)
- CHANGELOG 补品牌标识条目
- ROADMAP 登 S8-P4(品牌标识任务包 + og:image/apple-touch-icon 未做部分)
2026-09-21 10:05:48 +08:00

115 lines
3.6 KiB
JSON

{
"schemaVersion": 2,
"sourceKind": "structured-spec",
"slug": "card",
"family": "card-shell",
"familyRole": "base",
"familyParams": {},
"name": "卡片 Card",
"confidence": "high",
"semanticTypeCandidates": [
"card",
"surface",
"container"
],
"variantDimensions": [
{
"name": "style",
"values": [
"bordered",
"shadowed"
]
},
{
"name": "padding",
"values": [
"16px",
"24px"
]
},
{
"name": "section",
"values": [
"title",
"content",
"actions"
]
}
],
"representativeVariants": [
{
"style": "bordered",
"padding": "16px",
"label": "边框卡片"
},
{
"style": "shadowed",
"padding": "24px",
"label": "阴影卡片"
},
{
"style": "bordered",
"padding": "24px",
"section": "title-content-actions",
"label": "含标题与操作区"
}
],
"anatomy": {
"container": "卡片容器:圆角8px,边框1px var(--color-border) 或低阴影",
"titleArea": "标题区:可含标题与右侧操作",
"contentArea": "内容区",
"actionArea": "操作区"
},
"structurePatterns": {
"radius": "var(--radius-large)",
"border": "1px solid var(--color-border)",
"shadow": "var(--shadow-low)",
"padding": "16px / 24px"
},
"usageHints": [
"圆角8px,边框1px var(--color-border) 或低阴影",
"内边距16px/24px",
"结构:标题区、内容区、操作区"
],
"doNotInvent": [
"整卡可点击",
"整卡 hover 位移/边框变化",
"整卡过渡时长",
"整卡键盘 focus 行为",
"卡片 hover 交互规范"
],
"unknowns": [
"卡片网格间距规范"
],
"clarificationNotes": [
{
"item": "整卡可点击",
"kind": "decision",
"meaning": "整张卡片是否作为一个可点击整体。",
"why": "实现侧 Card.html 整卡无点击处理与 pointer 光标,只有内部链接/按钮可交互。",
"decision": "拍板:整卡不可点击;可交互内容必须用内部链接或按钮承载。"
},
{
"item": "整卡 hover 位移/边框变化",
"kind": "decision",
"meaning": "鼠标悬停整卡时是否产生位移、边框或阴影之外的反馈。",
"why": "实现侧无整卡 hover 规则;规范只定义默认低阴影。",
"decision": "拍板:无整卡 hover 反馈;悬停中阴影仅为容器视觉层级,不代表可点击。"
},
{
"item": "卡片 hover 交互规范",
"kind": "boundary",
"meaning": "指整张卡片在鼠标悬停和键盘聚焦时是否产生反馈,不是卡片内部链接或按钮自己的 hover 状态。",
"why": "现有规范只定义了卡片默认低阴影与悬停中阴影,没有定义整卡是否可点击、边框或位移变化、过渡时长、光标和键盘 focus 的完整状态矩阵。",
"decision": "已拍板:整卡不可点击、无整卡 hover;focus-visible 仅作用于卡片内部可聚焦元素。"
},
{
"item": "卡片网格间距规范",
"kind": "open-question",
"meaning": "指同一栅格中相邻卡片之间的 gap,以及不同容器宽度下 gap 是否保持不变。",
"why": "通用规范只给出组件之间 16px/24px 的间距梯度,CardList 只说明采用栅格,没有给出卡片专用 gap、列数或响应式断点。",
"decision": "保持开放:需要确认 CardList 的默认 gap、列数和响应式断点后,才能把实现值升级为正式契约。"
}
]
}