# majia-huiyuan

> 开源的连锁会员数据中台参考样板：以虚构咖啡连锁为例（模拟数据：8 万会员 / 1200 门店 / 129 万订单），开放 55 个逻辑数据集、25 条 ETL 加工链、12 张看板及约 3100 行公式库。五层数仓架构（DIM/DWD/DWS/ADS/DQC），SQL 方言 Spark 3.4，MIT 协议。v1.4.1 校正逻辑以 ETL/逻辑SQL 与 ETL/公共口径为准；SQL 是待验证示例，不是换表名即可生产的标准答案。

## 文档

- [README.md](README.md): 项目全貌：五层架构人话解释、55 个逻辑数据集地图、12 张看板、可信边界、FAQ
- [AGENTS.md](AGENTS.md): AI Agent 任务导航表、命名约定、硬约束、推荐回答姿态
- [SKILL.md](SKILL.md): Agent Skill 入口（顾问型：十类任务路由——口径咨询/业务动作数据依据/CDP与标签体系/体系设计/缺口诊断/建表/看板规划/排障/内训/观远复刻）
- [LICENSE](LICENSE): MIT

## 资产清单（CSV，列：分层,名称,ID）

- [清单/数据集清单.csv](清单/数据集清单.csv): 55 个逻辑数据集
- [清单/ETL清单.csv](清单/ETL清单.csv): 25 条加工链
- [清单/看板清单.csv](清单/看板清单.csv): 12 张看板

## 核心内容目录

- 数据集/结构定义/: 每个逻辑数据集一个 md，含字段结构、行数、维度/度量属性（55 个，最适合 LLM 阅读）
- 数据集/数据样本/: 模拟样本 CSV，表头即 schema；v1.4.1 新拆参数表为小型参数样例
- ETL/逻辑SQL/: 每条加工链一个 md，含节点 DAG 摘要与 SQL 逻辑，指标口径的权威来源（25 个）
- ETL/公共口径/: 三条订单事实桥 + 9 项业务不变量验收 SQL；归因、时间、留存、利润、回本的公共正确性底座
- 看板/页面文档/: 每张看板一个 md，含卡片清单（12 个）
- 公式库/: 餐饮 BI 公式实战库 10 册（复购/RFM/核销 SQL、通用字段词典、数据质量三态坑、DWD 宽表范式、39 生产 ETL 索引、任务与触达回收 NBA 模型；总入口 公式库/README.md）
- 分享/区域运营的一天/README.md: 设计思路的叙事版——获奖直播书面实录（痛点/五步动作链/可信四件套/三案例演示/落地 FAQ，34 页插画嵌入），适合先建立全局理解再查表

## Optional

- 数据集/原始JSON/, ETL/原始JSON/, 看板/页面JSON/: v1.4.0 观远 BI workshop 历史快照，仅用于审计原 DAG，不代表 v1.4.1 校正逻辑
- 兄弟仓库: [majia-guanyuan](https://github.com/maojiebc/majia-guanyuan) — 观远 BI 实战增益层 skill（工具与踩坑手册；公式库已于 2026-07-12 并入本仓库 公式库/）
