skillhub-034-live-dashboard
wehub-skill-sync
49 行
4.2 KiB
Markdown
49 行
4.2 KiB
Markdown
---
|
||
|
||
# 发布前检查清单（P0 必须通过；在全部绿灯前不得生成 index.html）
|
||
|
||
请在回复中逐条引用每个 P0 项，并在前方标注 `[x]` 或 `[ ]`。有任何 P0 项未勾选时，不得发布。
|
||
|
||
## 视觉完整性
|
||
|
||
- [ ] **P0 — 显示字体**。页面标题使用系统 / 偏 Notion 风格的无衬线字体（SF Pro / system-ui），或来自当前 DESIGN.md 中的编辑型衬线字体。**禁止使用 Inter Display，禁止在正文尺寸使用 SF Pro Display，禁止使用 Helvetica condensed。**
|
||
- [ ] **P0 — 强调色克制**。`--accent` 令牌在正文标记中最多出现两次（典型用法为一个刷新按钮 + 一条迷你趋势线）。KPI 数字上不得使用强调色。
|
||
- [ ] **P0 — 无紫/粉渐变页头**。Notion 的惯用风格为纯色。背景使用 `#fff` 或 `var(--bg-soft)`。
|
||
- [ ] **P0 — 正文对比度**。正文文本与背景的对比度 ≥ 4.5:1。次要文本 ≥ 4.0:1。
|
||
- [ ] **P0 — 顶部无 emoji 图标条**。页面 emoji 只有一个，且语义明确（运营用 `📊`，文档用 `📓`，上线用 `🚀`——禁止出现 emoji 装饰行）。
|
||
|
||
## 数据真实性（最常违反的规则）
|
||
|
||
- [ ] **P0 — 无虚构指标**。每个数字要么由用户提供，要么由数据连接器提供，要么标注为 `—` / `Sample`。禁止出现以下内容："10× faster"、"join 50,000 founders"、"99.99% uptime"，除非用户提供了确切的数字。
|
||
- [ ] **P0 — 示例数据标识**。当 `inputs.connector === mock` 时，页面必须在实时指示器或提示框中显示"Sample data"，以确保该产物的截图永远不会被误认为真实运营数据。
|
||
- [ ] **P0 — 合理的 KPI 范围**。小型团队的 `Total tasks` < 500。`Active members` ≤ 团队人数。`Done this week` ≤ Total。
|
||
|
||
## 连接器接线（仅当 connector !== mock 时适用）
|
||
|
||
- [ ] **P0 — `connectors.json` 存在**于项目根目录。详见 `connectors.md` 中的 schema 说明。
|
||
- [ ] **P0 — 端点已文档化**。`index.html` 中的每个 `fetch()` 调用均对应 `connectors.json` 中的一条记录。
|
||
- [ ] **P0 — 无硬编码密钥**。标记中不得包含 API 令牌、集成密钥、OAuth 客户端 ID 或工作区 ID。OD 守护进程通过 `media-config.json` 解析这些信息。
|
||
- [ ] **P0 — 过期降级**。当 `fetch` 出错或超过 90 秒无成功轮询时，指示器切换为琥珀色，页面上保留上一次的值。产物不得显示空白。
|
||
|
||
## 结构
|
||
|
||
- [ ] **P0 — 单文件**。`index.html` 自包含。除系统字体栈和一个 OD 自定义元素外，不得引入外部 CSS/JS。无 CDN 链接。
|
||
- [ ] **P0 — 侧边栏在 `< 980px` 时折叠**。仪表板可在移动端阅读；侧边栏隐藏，KPI 网格两列堆叠，表格隐藏 `due` 和 `priority` 列。
|
||
- [ ] **P0 — `prefers-reduced-motion`**。当 `(prefers-reduced-motion: reduce)` 生效时，所有动画和脉冲效果均被禁用。
|
||
- [ ] **P0 — KPI 数值使用 `tabular-nums`**。数值在动画或自动刷新过程中不应水平抖动。
|
||
|
||
## 精细打磨（P1）
|
||
|
||
- [ ] P1 — 刷新按钮在轮询期间显示旋转的 ↻ 图标，轮询结束后恢复静止。不得产生布局偏移。
|
||
- [ ] P1 — 活动动态：新插入的行在左侧显示强调色圆点（•），并带有柔和的强调色背景，持续 2 秒后淡出。
|
||
- [ ] P1 — 数据库中被修改的行，其背景以 1.4 秒的 ease-out 渐变闪烁。
|
||
- [ ] P1 — 实时指示器状态：绿色脉冲（空闲）、蓝色实心（同步中）、琥珀色实心（过期）。
|
||
- [ ] P1 — 迷你趋势图的网格线为虚线，线条颜色来自 `--line`，`stroke-dasharray` 为 `2 3`。数据点为填充色 `--accent`，半径 r=3。
|
||
- [ ] P1 — 提示消息位于底部居中，深色 `#1f1f1f`，1800 毫秒自动消失。
|
||
|
||
## 内容
|
||
|
||
- [ ] P1 — 人员头像：18px 圆形头像，两字母首字母缩写，每人有固定的颜色。首字母不超过 2 个字符。
|
||
- [ ] P1 — 状态标签文字使用 Notion 标准标签："Done"、"In progress"、"Blocked"、"In review"、"To do"。大小写需注意："In progress" 而非 "In-Progress"。
|
||
- [ ] P1 — 页脚署名需精确标明来源平台及连接器 slug：`composio.notion`、`composio.linear` 等。
|