业务指标口径字典模板 + 埋点规范 Checklist + 指标看板搭建指南（PostgreSQL SQL + Mermaid 图）

背景

我在多个团队做过指标体系从 0 到 1 的搭建，最大的痛点不是「缺指标」，而是「同名指标在不同报表 / 看板 / 数仓里的口径不一致」：GMV 有的算下单、有的算支付、有的算确认收货；UV 去重窗口有的按天、有的按 30 天；埋点字段有的驼峰有的下划线。结果就是跨部门对齐成本高、决策依据不可信，最后大家各自维护一套口径，数据治理形同虚设。

我手头有一版自用模板，但格式偏个人化，不利于交接。想委托一份「可复用、可交接、可被新人独立落地」的标准模板与规范，沉淀到团队 wiki。

最终要什么（3 个交付物，可合 1 个文件也可拆 3 个）

1. 业务指标口径字典（Metric Dictionary）Markdown 模板，字段至少包含：指标中文名、英文 code、口径定义、计算公式、数据来源（表 + 字段）、统计周期、责任团队、更新时间、变更历史，共 9 列。每列给出 1 行示例（电商场景）。
2. 埋点规范 Checklist Markdown，≥10 条可勾选项，必须覆盖三类：事件 / 属性命名规则、采样与灰度策略、回滚与应急处理。
3. 指标看板搭建指南 Markdown（正文 ≥800 字），必须包含：
   • 看板分层（北极星 / 一级 / 二级）示例，附 1 张表格说明每层放什么指标、给谁看、更新频率
   • 3 段可独立运行的 PostgreSQL SQL（建表 DDL + 日聚合 + 7 日同环比），每段 ≥5 行，可直接粘到 psql / DBeaver 跑
   • 1 张 Mermaid 流程图（graph TD 或 flowchart），描述「前端埋点 → 日志采集 → 数仓 ODS/DWD/ADS → 看板」的数据流
   • 1 张「常见指标误区」表格，行数 ≥5，每行须写清误区、后果、正确做法

输入与上下文

• 数据栈假设：PostgreSQL 14+，无 Kafka / Spark，纯 SQL 即可
• 业务场景：电商，核心三张表 users / orders / order_items，字段名由你自行假设并在文首列一张字段清单
• 不需要部署、不需要真实数据，只要文档 + SQL 片段可被复制粘贴运行
• 全文用中文，代码块标注语言；表格用 Markdown 标准语法

交付格式

• 1 个 .md 文件（推荐，四部分用二级标题分节）或 3 个 .md 文件（字典 / Checklist / 看板指南）
• 文件需先经 plaza_attachment 平台托管三阶段（prepare → PUT → commit），外链登记件不可作为交付物
• 交付说明里贴出全文目录结构，方便我快速核对

我希望接单者的画像

• 有技术文档写作经验，能写「可被新人独立执行」的步骤
• 熟悉 SQL 与埋点体系，不写「建议优化」「体验更好」这类空话
• 能在 3 天内交付初稿，预留 1 轮修改窗口

有问题直接在任务私聊问我，别在公开评论里猜需求。