claudeers.
// Data & Analytics

majia-huiyuan

会员运营 · 马甲实战版 — 开源连锁会员数据家底：中台样板间（54 数据集·25 ETL·12 看板·全模拟）+ BI 公式库（9 册 2900 行）+ 获奖直播实录（34 页插画）。装进 Claude Code/OpenClaw/Codex/WorkBuddy 即会员数据顾问 · v1.3.1

// Data & Analytics[ cli ][ api ][ claude ]#claude#bi#chinese#crm#data-warehouse#guandata#llm-friendly#membership#data◷ MIT$open-sourceupdated about 1 month ago
Actively maintained
100/100
last commit 14 days ago
last release 14 days ago
releases 8
open issues 0
// star history
★ 12 github ↗website ↗

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up majia-huiyuan (claude-skill project) into my current project.
Found on https://claudeers.com/majia-huiyuan
Repo: https://github.com/maojiebc/majia-huiyuan
Homepage/docs: https://github.com/maojiebc/majia-guanyuan
Detected install method: claude-skill → # copy this skill into .claude/skills/majia-huiyuan/
Category: data. Platforms: cli, api.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-skill)
# copy the skill dir into your project:
# .claude/skills/majia-huiyuan/   (or ~/.claude/skills/majia-huiyuan/ for all projects)
// or clone
git clone https://github.com/maojiebc/majia-huiyuan

// compatibility

Platformscli, api
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
Language—

majia-huiyuan · 会员运营家底（开源样板间）

skills.sh

会员运营 · 马甲实战版 — 一套完整的、可以照着抄的连锁会员数据体系。以一家虚构的咖啡连锁为例，从会员注册的第一行数据，到老板看的经营驾驶舱：54 个数据集、25 条数据加工链、12 张看板，外加约 2900 行的实战公式库，全部摊开。

数据全部模拟生成，与任何真实企业无关。MIT 协议，个人用、公司用、商用，都随便。

majia-huiyuan v1.3.1 功能架构：三大资产（样板间 54 数据集/25 ETL/12 看板 · 公式库 9 册 2900 行 · 方法论实录 34 页直播）+ 五层数仓 DIM→DWD→DWS→ADS→DQC + 会员数据顾问八类活（口径咨询/体系设计/缺口诊断/建表 DDL/看板规划/质量排障/方法论内训/观远复刻）+ 与兄弟 skill majia-guanyuan 分工

谁适合看：做会员、做私域的业务同学；做数据分析、数据建设的同学；想给自己公司从零搭一套会员数据体系的人。不需要会写代码。

AI 也适合看：如果你是 AI Agent（WorkBuddy / Claude / Codex / Cursor …），你的入口在 llms.txt 和 AGENTS.md；本仓库同时是一个可安装的 Agent Skill（SKILL.md），装法见下方。

这是什么

会员运营这行有块三不管地带：字段怎么定义、口径怎么算、看板怎么搭，做业务的嫌它是技术细节，做数据的嫌它是业务琐事，两边都懂的人当它是吃饭本事。结果就是，想学的人找不到一份能从头看到尾的完整参照。

这个仓库就是那份参照——一个"样板间"。

它是 2026 年 5 月在观远 BI 官方 workshop 实例上独立搭建的一套完整会员数据中台，虚构了一家咖啡连锁：8 万会员、1200 家门店、141 个加盟商、74 个商品、129 万笔订单。麻雀不大，五脏俱全：会员注册、订单、发券、积分、私域触达、投诉评价、加盟分账、门店成本，全链路的数据都有，而且是打通的。

毛坯房教不会人装修，样板间可以。你不一定照单全收，但每面墙长什么样、水电怎么走，这里都看得见。

本仓库会持续迭代，路线图见下方。

三分钟看懂：数据分五层

所有数据集按五层组织（这是数据行业的通用做法，名字唬人，事情简单）：

层行话人话本库数量
DIM维度层档案柜：会员档案、门店档案、商品档案，一行 = 一个人 / 一家店 / 一件商品10
DWD明细层流水账：每笔订单、每次发券、每条评价，一行 = 发生过的一件事16
DWS汇总层台账：把流水按人、按店、按月归拢，复购率、RFM 分层都在这层算出来16
ADS应用层驾驶舱：老板、店长、运营直接看的最终报表8
DQC质检层质检员：两套数对不上时，先来这层查1
param参数表阈值配置（比如"几天没来算流失"，写在表里而不是写死在公式里）3

数据的流向一句话：档案柜 + 流水账 →（25 条加工链）→ 台账 → 驾驶舱。

资产地图（54 个数据集）

每个数据集一句人话。字段级明细看 数据集/结构定义/，长什么样看 数据集/数据样本/。

DIM 档案柜（10）

数据集一句话
dim_会员主档每个会员一行：等级、注册渠道、城市、状态（8 万行）
dim_会员身份桥一个人的多个身份（手机号 / 微信 / 支付宝）怎么认成同一个人
dim_门店主档每家店一行：城市、店型、开业日期（1200 家）
dim_加盟商主档每个加盟商一行（141 个）
dim_商品主档每个商品一行：品类、价格带（74 个）
dim_券模板每种券一行：面额、门槛、有效期
dim_活动主档每场营销活动一行
dim_员工导购每个店员 / 导购一行
dim_成本科目房租、人力、原料……成本怎么分类
dim_日期日期维表：节假日、周末、月份归属

DWD 流水账（16）

数据集一句话
dwd_订单每笔订单一行：金额、渠道、是否会员、是否用券（129 万行）
dwd_订单商品订单里的每件商品一行
dwd_会员注册绑定每次注册 / 绑定一行
dwd_券事件每张券的发放、核销、过期
dwd_积分事件每笔积分的挣与花
dwd_会员触达每次触达一行：短信 / 企微 / Push，发给谁、谁打开（50 万行）
dwd_私域事件进群、退群、加好友、会话
dwd_活动参与谁参加了哪场活动
dwd_评价每条顾客评价
dwd_投诉每条投诉
dwd_会员经营任务总部派给门店的会员任务及完成情况
dwd_加盟合同明细每份加盟合同
dwd_加盟分账明细每笔加盟分账
dwd_门店成本明细每笔门店成本
dwd_门店投资明细每笔开店投资
dwd_门店目标每店每期的目标值

DWS 台账（16）

数据集一句话
dws_会员RFM分层每个会员的 R / F / M 打分和分层标签（做精准营销的底座）
dws_会员生命周期新客 / 活跃 / 沉睡 / 流失，每人当前在哪一段
dws_会员同期群留存按注册月份分组，看每批人第 N 月还剩多少（Cohort 留存）
dws_私域转化漏斗触达 → 查看 → 下单，每场活动的漏斗和转化率
dws_券效益分析每种券花了多少、带回多少
dws_渠道迁移分析顾客在堂食 / 外卖 / 小程序之间怎么流动
dws_商品销售分析每个商品卖得怎么样
dws_门店日报每店每天的核心经营数
dws_目标达成每店目标完成进度
dws_新店爬坡_Comp老店新店爬坡曲线，和可比老店（Comp）对照
dws_单店利润月汇总每店每月的利润账
dws_成本结构汇总成本按科目的构成
dws_加盟商经营汇总每个加盟商名下门店的经营汇总
dws_加盟回本测算每家加盟店投了多少、回了多少、预计几个月回本、风险等级
dws_员工导购效能每个导购拉新、复购带动的效能
dws_体验口碑汇总评价、投诉汇总成门店体验分

ADS 驾驶舱（8）

数据集一句话
ads_高层经营驾驶舱给老板：大盘营收、会员贡献、风险信号
ads_会员私域驾驶舱给会员负责人：活跃、新增、触达、会员销售占比
ads_会员经营任务池给运营：待办的会员经营任务清单
ads_门店每日指挥台给店长：今天该看的数、该做的事
ads_活动权益复盘给营销：每场活动的投入产出复盘
ads_单店利润健康给财务 / 拓展：每店利润健康度
ads_加盟商单店报告给加盟商：他自己店的经营报告
ads_异常归因清单数据异动的归因线索清单

DQC 质检 + param 参数（4）

数据集一句话
dqc_归因清单对账两条链路算同一个数，对不上就报警
param_会员生命周期阈值几天算沉睡、几天算流失，阈值配置
param_利润健康阈值利润健康度的分档线
param_豁免日历大促 / 特殊日期豁免名单（防止误判异常）

12 张看板

从老板到店长到加盟商，每个角色一张自己的报表。清单见 清单/看板清单.csv，每张的卡片明细在 看板/页面文档/。

01 高层经营驾驶舱 · 02 会员私域驾驶舱 · 03 会员经营任务池 · 04 门店每日指挥台 · 05 活动权益复盘 · 06 体验风险专题 · 07 单店利润健康 · 08 加盟商单店报告 · 09 总览（ECharts 重构版）· 10 异常归因作战页 · 外卖业绩近 30 天 GMV · 参赛作品提交页

公式库（60+ 段可直接抄的 SQL）

样板间给你看结构，公式库给你抄算法。公式库/ 蒸馏自两段连锁餐饮 BI 实战履职（已全脱敏，约 2900 行），2026-07-12 从 majia-guanyuan 迁入本仓库统一维护，按主题分 9 册：

分册管什么
01 日期与时间T-1、本月、近 N 天、用餐时段、跨月对齐、观远时间宏
02 顾客与会员新老客、消费频次 3 口径、复购（跨天 vs 非跨天）、RFM 8 类 × 营销策略、留存流失
03 营收 KPI客单价 AC、ADS、ADT、Comp 同店、会员贡献占比
04 渠道与门店堂食外卖分流、门店生命周期、多渠道评价 pipeline
05 券与折扣核销率、折扣率、折扣分桶、注册首张券
06 SQL 工具箱字符串拆解、开窗排名、累计窗口
07 数据质量坑NULL / 空串 / 'null' 三态、口径歧义、通用字段词典
08 ETL 工程范式DWD 宽表底座、财务双源对账、POS 归一化、Cohort 网格
09 生产 ETL 索引39 个生产 ETL 按 11 个业务域的索引与复用决策表

总入口和"5 条最容易踩的坑"见 公式库/README.md。样板间的表结构 + 公式库的算法，两样凑齐，就是能开工的图纸。

一场直播，把这套东西讲了一遍

2026 年 7 月，这套体系的设计思路在观远「对话 AI Hero」直播里完整讲过一次（AI 创新赛一等奖作品《区域运营的一天》）：区域运营一上午的巡店分析，AI 怎么压缩到几分钟，怎么归因到人、怎么学会闭嘴、怎么多看一眼。

📖 分享/区域运营的一天/ —— 34 页插画板全嵌的书面实录，当时演示的数据环境就是本仓库。想先看故事再翻表的，从这里进。

目录结构（怎么翻）

清单/          三张总清单 CSV（数据集 / ETL / 看板，含 ID）——先看这里拿全景
公式库/        餐饮 BI 公式实战库（README + 9 册）★ 算法和口径 SQL 都在这
分享/          直播分享书面实录（34 页插画长文）★ 想先看故事的从这进
数据集/
  结构定义/    每个数据集的字段结构说明 ★ 最值得先看
  数据样本/    每个数据集 200 行模拟样本 CSV，字段长什么样一目了然
  原始JSON/    观远平台原始定义（整套复刻时用）
ETL/
  逻辑SQL/     25 条加工链的节点结构和 SQL 逻辑 ★ 口径都在这
  原始JSON/    平台原始定义（复刻用）
看板/
  页面文档/    每张看板放了哪些卡片、各是什么
  页面JSON/    页面布局原始定义

三种用法

① 业务同学：对照自查。 打开 数据集/数据样本/dws_会员RFM分层.csv，你嘴里的"复购""流失""分层"在数据里就长这样。拿 清单/数据集清单.csv 当清单，对照你公司现在的会员体系，缺哪层、缺哪几张表，一眼看得出来。

② 数据同学：抄字段和口径。 结构定义里有全部字段，逻辑SQL 里有全部加工口径，公式库 里有复购 / RFM / 核销这些通用算法的标准 SQL："顾客识别键怎么建""RFM 怎么打分""回本偏离度怎么算"，直接抄，表名换成你家的就能用。SQL 方言是 Spark 3.4。

③ 整套复刻。 用观远 BI 的话，原始JSON 配合官方 CLI 全家桶（npm i -g @guandata/guanskill）可以半自动重建；不用观远也没关系，五层结构、字段设计、SQL 逻辑都是通用的，任何 BI 或数仓照着搭就行。

让 AI 替你干活（推荐）

这个库特意做成了 AI Agent 友好的。把仓库地址扔给你的 AI 工具（WorkBuddy / Claude Code / Codex / Cursor……），直接说人话：

  • "对照这个库，看看我们公司的会员数据还缺什么"
  • "把 dws_会员RFM分层 的口径翻译成我们数仓的建表语句"
  • "照这套结构，给我出一版我们品牌的会员看板规划"

AI 会自己顺着 llms.txt 和 AGENTS.md 找到路，不用你解释仓库结构。

🎛 当 Agent Skill 用

本仓库同时是一个 Agent Skill（SKILL.md 在仓库根部）——装进任何支持 SKILL.md 的 agent（Claude Code / OpenClaw / Codex / WorkBuddy …），它就变成一个随叫随到的会员数据顾问，能干八类活：口径与公式咨询、从零设计会员数据体系、现有体系缺口诊断、生成建表 DDL、按角色规划看板、数据质量排障、方法论内训、观远整套复刻。

# ClawHub / OpenClaw
clawhub install majia-huiyuan
openclaw skills install majia-huiyuan

# GitHub CLI（gh 2.90+）
gh skill install maojiebc/majia-huiyuan majia-huiyuan --agent claude-code --scope user

# 手动 clone 到对应 agent 的 skills 目录
git clone https://github.com/maojiebc/majia-huiyuan.git ~/.claude/skills/majia-huiyuan   # Claude Code
git clone https://github.com/maojiebc/majia-huiyuan.git ~/.codex/skills/majia-huiyuan    # Codex

装完试一句："帮我看看我们公司的会员数据体系缺什么"，或者"复购率的口径给我几种标准算法"。

数据说明（必读）

  • 全部数据由程序模拟生成，与任何真实企业无关；手机号等个人标识列已打码（形如 156****0925）
  • 仓库内每表附 200 行样本；完整规模（如会员 8 万、订单 129 万）标在各表的结构定义里
  • JSON 里的资源 ID 是 workshop 实例私有的，复刻时会生成你自己的
  • 快照时间 2026-06-24，导出工具为观远官方 guancli

兄弟项目

项目关系
majia-guanyuan观远 BI 实战增益层 skill。工具与踩坑手册在那边，数据与公式在这边；本库的模拟中台和公式库都源自它，现独立迭代

路线图

  • 口径卡片：每张核心表配一页"这张表回答什么业务问题"
  • 通用建表 DDL：不用观远也能一键建表的 SQL 版本
  • 实战问题包：常见会员运营问题 → 用哪几张表、怎么查（脱敏后的真实场景）
  • 行业变体：茶饮 / 正餐 / 零售的差异字段说明
  • 字段词典中英对照

想看哪个先做，提个 issue 投票。

📋 版本记录

最新：V1.3.1 (2026-07-23) — 文档装修：新增功能架构图（docs/architecture.svg + PNG，三大资产 / 五层数仓 / 八类活一图看全）、README.en.md 英文版、品牌后缀「· 马甲实战版」pixel-perfect 落到各展示面。内容零改动。

V1.3.0 (2026-07-12) — Skill 化：新增 SKILL.md + manifest.json，仓库本体即 Agent Skill，可经 ClawHub / gh skill / git clone 安装；顾问型定位（八类活任务路由 + 五条硬约束）。

V1.2.0 (2026-07-12) — 新增《区域运营的一天》获奖直播书面实录（34 页插画长文：五步动作链 / 可信四件套 / 三案例现场实录 / 落地 FAQ）。

完整变更历史见 GitHub Releases。

完整历史见 GitHub Releases。

FAQ

是真实数据吗？ 不是，全部模拟生成，放心引用结构、不要引用数值。 能商用吗？ MIT 协议，能，注明出处就行。 我不用观远 BI，这库对我有用吗？ 有。五层结构、54 张表的字段设计、25 条链的口径 SQL 都是平台无关的，观远只是它出生的地方。 发现错误 / 想要新内容？ 提 issue。你提一条，这套东西就厚一点。

👤 作者 / 联系

马甲（@maojiebc） · 超级马甲 · 14 年用户运营，连锁餐饮"数据与运营之间的翻译官"

渠道链接
📧 Email[email protected]
🐙 GitHubgithub.com/maojiebc
🐦 X@maojiebc
📕 小红书超级马甲
📰 微信公众号超级马甲

踩过的坑、总结的经验，不叫私有，是群策群力。

// faq

What is majia-huiyuan?

会员运营 · 马甲实战版 — 开源连锁会员数据家底：中台样板间（54 数据集·25 ETL·12 看板·全模拟）+ BI 公式库（9 册 2900 行）+ 获奖直播实录（34 页插画）。装进 Claude Code/OpenClaw/Codex/WorkBuddy 即会员数据顾问 · v1.3.1. It is open-source on GitHub.

Is majia-huiyuan free to use?

majia-huiyuan is open-source under the MIT license, so it is free to use.

What category does majia-huiyuan belong to?

majia-huiyuan is listed under data in the Claudeers registry of Claude-compatible tools.

0 views
★ 12 stars
unclaimed
updated about 1 month ago

// embed badge

majia-huiyuan on Claudeers
[![Claudeers](https://claudeers.com/api/badge/majia-huiyuan.svg)](https://claudeers.com/majia-huiyuan)

// retro hit counter

majia-huiyuan hit counter
[![Hits](https://claudeers.com/api/counter/majia-huiyuan.svg)](https://claudeers.com/majia-huiyuan)

// reviews

// guestbook

0/500

// related in Data & Analytics

🔓
CLIProxyAPI

Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini 3.1 P…

// datarouter-for-me/⟨Go⟩★ 48,367◷ MIT[ claude ]
🔓
airflow

Apache Airflow - A platform to programmatically author, schedule, and monitor workflows

// dataapache/⟨Python⟩★ 46,515◷ Apache-2.0[ claude ]
🔓
marketingskills

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

// datacoreyhaines31/⟨JavaScript⟩★ 44,798◷ MIT[ claude ]
🔓
claude-code-templates

CLI tool for configuring and monitoring Claude Code

// datadavila7/⟨Python⟩★ 30,319◷ MIT[ claude ]
→ see how majia-huiyuan connects across the ecosystem