50 lines
3.0 KiB
Markdown
50 lines
3.0 KiB
Markdown
---
|
||
title: 万师傅大数据知识库（wiki 索引）
|
||
source_status: 汇编自 sql-agent-demo 项目的 knowledge/、skills/、docs/、data/、queries/
|
||
updated_at: 2026-07-30
|
||
---
|
||
|
||
# 万师傅大数据知识库
|
||
|
||
这是从 [sql-agent-demo](../sql-agent-demo) 项目中提炼出的人类可读知识库。
|
||
`sql-agent-demo/knowledge/*.json` 是给 Agent 运行时读的机器规则（强约束、字段固定），本 wiki 是同一批知识的说明版，
|
||
补充背景和取舍理由，供人阅读、评审和向新成员讲解。两边内容应保持一致；改规则先改 JSON（或先在这里达成一致再回填 JSON），
|
||
不要让两处各说各话。
|
||
|
||
## 文件索引
|
||
|
||
| 文件 | 内容 |
|
||
|---|---|
|
||
| [warehouse.md](warehouse.md) | 数仓分层架构、选表规则、分区语义、层间依赖边界 |
|
||
| [sql-rules.md](sql-rules.md) | SQL 查询安全规范、只读执行边界、分析师取数脚本部署规范 |
|
||
| [business.md](business.md) | 指标口径、业务枚举、已知歧义点、真实业务 SQL 案例 |
|
||
| [decisions.md](decisions.md) | 冲突裁决记录、已确认/待确认问题（只追加，不改历史条目） |
|
||
| [tables/](tables/README.md) | `wanshifu_dw` 表目录：ODS/DWD/DWS/DIM/ADS/MID 约5579张表的表名、字段和中文注释（元数据快照，非 DDL） |
|
||
| [biz/](biz/README.md) | 万师傅平台级通用业务知识（角色定义、跨域事件链路），抽取自 dev-knowledge-base，不含 SQL/表结构 |
|
||
|
||
## 知识优先级（对应 `knowledge/index.json`）
|
||
|
||
当不同来源的说法冲突时，按以下顺序取高优先级来源，并在 [decisions.md](decisions.md) 里保留冲突记录：
|
||
|
||
1. 用户为本 Agent 确认的规则（`user_confirmed_agent_rule`）
|
||
2. 分析师/商业分析师数仓开发规范（`analyst_development_standard`）
|
||
3. 已验证的表级知识（`verified_table_level_knowledge`）
|
||
4. 万师傅数仓开发规范（`warehouse_development_standard`）——仅作设计学习参考
|
||
5. 已验证的加工代码（`verified_job_code`）
|
||
6. DDL 元数据（`ddl_metadata`）
|
||
7. 表名推断（`table_name_inference`）——最低优先级，仅在无其他证据时使用
|
||
|
||
## 原始规范文档指针
|
||
|
||
以下文档目前只在 [decisions.md](decisions.md) 中被引用，本 wiki 未内嵌其原文，需要时向对应负责人获取：
|
||
|
||
- 《数据分析师_商业分析师数仓开发规范.md》v2.0.0（2026-06-02 生效）—— 分析师主规范
|
||
- 《万师傅数仓开发规范.md》v1.5.0（2026-06-01 生效）—— 数仓设计学习参考
|
||
- 《万师傅数仓现状_订单数据架构.md》—— 订单域参考
|
||
|
||
## 维护约定
|
||
|
||
- 新增知识前先判断属于哪个优先级层，写清 `source_status` 和确认日期。
|
||
- 只有 [decisions.md](decisions.md) 允许追加式记录历史；其余文件维护"当前有效状态"，改了直接覆盖旧内容，版本历史交给 git。
|
||
- 中文写解释和背景，表名、字段名、状态码、枚举值等机器接口标识符保留原文（不翻译、不改写大小写）。
|