# majia-huiyuan

> 开源的连锁会员数据中台样板间：以虚构咖啡连锁为例（模拟数据：8 万会员 / 1200 门店 / 129 万订单），完整开放 54 个数据集、25 条 ETL 加工链、12 张看板的结构定义、数据样本与口径 SQL，另含约 2900 行的餐饮 BI 公式实战库（公式库/，蒸馏自真实履职、已脱敏）。五层数仓架构（DIM/DWD/DWS/ADS/DQC），SQL 方言 Spark 3.4，MIT 协议。数据全部模拟生成，仅结构与口径可引用，数值不可当真实经营数据。

## 文档

- [README.md](README.md): 项目全貌：五层架构人话解释、54 个数据集地图（每个一句话）、12 张看板、三种用法、FAQ
- [AGENTS.md](AGENTS.md): AI Agent 任务导航表、命名约定、硬约束、推荐回答姿态
- [SKILL.md](SKILL.md): Agent Skill 入口（顾问型：八类任务路由——口径咨询/体系设计/缺口诊断/建表/看板规划/排障/内训/观远复刻）
- [LICENSE](LICENSE): MIT

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

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

## 核心内容目录

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

## Optional

- 数据集/原始JSON/, ETL/原始JSON/, 看板/页面JSON/: 观远 BI 平台原始定义，仅整套复刻到观远实例时需要（配合官方 CLI 全家桶 @guandata/guanskill）
- 兄弟仓库: [majia-guanyuan](https://github.com/maojiebc/majia-guanyuan) — 观远 BI 实战增益层 skill（工具与踩坑手册；公式库已于 2026-07-12 并入本仓库 公式库/）
