dashboard-specification

仪表板规范

适用场景

• 正在构建新的仪表板，开发人员需要在开始前获得清晰的需求说明
• 现有仪表板令人困惑或使用率偏低，需要进行有章法的重新设计
• 利益相关者与数据团队对仪表板应展示哪些内容有不同看法
• 将仪表板需求作为更广泛的数据产品流程的一部分进行文档记录
• 创建一份可交接的自助式分析规范，无需多轮问答

流程

1. 明确目的 — 用一句话写明：“此仪表板为需要[决策或采取的行动]的[受众]回答[问题]。”如果无法用一句话说明，就需要先缩小范围。请参阅 references/dashboard_design_principles.md。
2. 分析目标用户 — 对每类受众（高管、经理、个人贡献者），记录他们的访问频率、访问时想要回答的首要问题，以及他们对技术的熟悉程度。需求不同的用户通常需要不同的仪表板，而不是在一个仪表板上添加更多筛选器。
3. 定义指标层级 — 列出主要 KPI（顶部的重点数字）、辅助指标以及详细拆分项。包含超过 10–12 个不同指标的仪表板，通常试图涵盖太多内容。
4. 设计信息架构 — 按照“重点数据 → 趋势 → 拆分 → 详情”的模式勾勒布局。将最重要的信息放在左上角。请使用 references/dashboard_requirements_guide.md 了解布局模式。
5. 指定交互方式 — 列出全局筛选器（日期范围、区域、细分群体）、下钻路径、点击操作和悬停提示内容。每个筛选器和下钻操作都会增加复杂度；请说明其必要性。
6. 记录数据需求和成功标准 — 对每项指标，记录来源表、转换逻辑和刷新频率。定义仪表板成功的衡量方式（采用率、临时请求减少情况）。填写 assets/dashboard_spec_template.md。

所需输入

• 仪表板要回答的业务问题
• 候选指标列表（团队可以提供粗略清单；你将负责筛选整理）
• 主要受众（角色、访问频率、需要做出的决策）
• 数据可用性：已确认的来源表和刷新计划
• 任何限制：工具（Tableau、Looker、Metabase 等）、品牌指南

输出

• references/dashboard_design_principles.md — 布局层级、图表选择、信息密度指南
• references/dashboard_requirements_guide.md — 如何收集需求、避免范围蔓延并验证规范
• assets/dashboard_spec_template.md — 完整规范：目的、用户、指标层级、布局线框图、交互方式、数据源、成功标准