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