02_表间关系说明.txt 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. 智慧运营看板 — 表间逻辑关系(数据流)
  2. 一、主键对齐键(全链路)
  3. · tenant_id + factory_id:多租户/多工厂隔离。
  4. · module_code:S1~S7(九宫格与详情模块);S8/S9 若单独展示仍可用同维度。
  5. · metric_code:指标技术主键;建模、中间结果、接口合并均依赖此键一致。
  6. · biz_date(及未来的 biz_month):统计粒度;长周期可读月汇总表。
  7. 二、配置层(目标)
  8. ado_smart_ops_metric_catalog
  9. → 定义「系统里有哪些指标」:编码、默认名、层级、单位、是否可上首页。
  10. ado_smart_ops_layout_item
  11. → 定义「某租户某工厂首页/详情要展示哪些行、顺序、展示名覆盖、L2 父级、公式说明文案」。
  12. → 每行必须引用 catalog 中已存在的 metric_code(或先登记再引用)。
  13. ado_smart_ops_home_module(建议新增)
  14. → 九宫格内「单个模块区域」用卡片式还是列表式:layout_pattern = card_grid | table_list。
  15. → 与 layout_item 中同 module_code 的 L1 行配套:数据行一致,仅前端模板不同;呈现字段(当前值/目标/期量差/绿黄红)见 03_指标呈现与期量差约定.txt 第五节。
  16. 三、计算层(定时任务)
  17. ado_smart_ops_metric_rule(可选进阶)
  18. → 描述如何从更底层汇总表计算并写入 L1/L2 日表。
  19. ado_s9_calc_task / ado_s9_calc_log
  20. → 任务注册与执行日志(可与现有壳表演进)。
  21. ado_s9_kpi_formula(可与 metric_rule 合并演进)
  22. → 公式版本与规则载体。
  23. 四、中间结果层(现状 + 可选扩展)
  24. ado_s9_kpi_value_l1_day
  25. → 供九宫格 / home-l1:按 module_code + metric_code + biz_date 取数。
  26. ado_s9_kpi_value_l2_day / ado_s9_kpi_value_l3_day
  27. → 供 module-detail 等:按 module_code + metric_code + biz_date。
  28. ado_s9_kpi_value_l1_month / ado_s9_kpi_value_l2_month(目标可选)
  29. → 月粒度 rollup,减轻长区间扫描日表压力。
  30. 五、接口合并逻辑(逻辑非表)
  31. 1)读 layout_item 得当前应展示的 metric_code 列表与顺序、展示名。
  32. 2)读 home_module(或等价配置)得各 module_code 的 layout_pattern,供九宫格选卡片模板或列表模板。
  33. 3)批量读 L1 或 L2 日表(及可选月表)取 metric_value、target_value,并按 03 文档计算期量差与 achievementLevel。
  34. 4)左连接合并:无数据行仍输出,数值为空,供前端占位。
  35. 六、与现有 ado_s9_kpi_def / relation / page_binding
  36. · 若继续沿用:可将 kpi_def 强化为与 catalog 等价,避免重复表。
  37. · relation:可用于指标树;与 layout_item.parent_row_id 二选一或并存迁移。
  38. · page_binding:可选,将 metric 绑定到 page_code(九宫格 cell 等)。
  39. 七、S8 告警
  40. ado_s8_alert_record 独立链路;可通过 metric_code/module_code 与 KPI 体系弱关联。