# 新茶饮供应链经营理论 v1：版本历史（CHANGELOG）

> 本文件是 [main.md](main.md) 的版本历史档案，仅记录每次升级的变化，不参与文章正文叙事。
> 最新版本：[main.md](main.md)（v1.0 / 2026-07-28）
> 母理论：[四把尺子理论 v26](../../四把尺子理论/v26/main.html)
> 参照蓝本：[乌龟养鱼基础理论 v1](../../乌龟养鱼基础理论/v1/main.html)（双角色 + 专章结构参照）、[健康理论 v1](../../健康理论/v1/main.html)（9 部分 + 5 配套件参照）、[赚钱理论 v2](../../赚钱理论/v2/main_money.html)（§7 风险章节）

---

## v1.0（2026-07-28）· 初版·B2B 供货 + 自营零售双角色经营理论

> **触发**：用户问"模仿四把尺子，生成一个咖啡奶茶原料和咖啡机设备经营理论"，经用户确认采用 **"B2B 供货 + 自营零售"双角色视角** + **"原料+设备+耗材"全品类一体** 结构。

**核心识别**：

- v1 框架**首次把"B2B 供货"和"自营零售"作为双角色经营理论呈现**——两个角色都基于同一套 4 把尺子，但有各自的公理特化、4 把尺子落地方式、5 条元规则
- v1 框架**首次明确"双角色协同必须满足 5 个条件"**——B2B 和自营有天然冲突，必须有规则才能避免内部打架
- v1 框架**继承 v26 的"自反性"传统**——v1 知道自己是"新手操作手册"，不是"新茶饮经营圣经"

**主要变化**：

1. **新建** `main.md`（约 35KB / 9 大部分 / 含 3 大公理 + 4 把尺子 + B2B 供货框架 + 自营零售框架 + 双角色协同专章 + 实践路径 + 与 v26 关系 + 6 个质疑 + 边界声明）
2. **新建** `build_main_html.py`（基于乌龟养鱼 v1 build_main_html.py 简化版，主题色用 #b45309 琥珀色，象征咖啡豆）
3. **新建** `index.html`（总入口，含 9 卡片快速入口 + 4 把尺子速览 + 元规则清单 + 版本历史）
4. **新建** `README.md`（项目说明，含文件结构 + 4 把尺子 + 5+5 元规则 + 5 个双角色条件 + 6 个质疑）
5. **新建** `CHANGELOG.md`（本文，v1.0 初始化）
6. **编译** `main.html`（由 build_main_html.py 生成）

**9 大部分结构**：

| # | 部分 | 备注 |
|---|------|------|
| 1 | 第一部分：为什么需要一套"新茶饮供应链经营理论" | 3 大常见误区 + 为什么靠个人经验不够 |
| 2 | 第二部分：四把尺子（商业通用版） | 3 大公理 + 4 把尺子 + B2B 和自营双视角参数表 |
| 3 | 第三部分：B2B 供货框架 | B2B 公理 + 4 把尺子特化 + 5 条元规则 |
| 4 | 第四部分：自营零售框架 | 自营公理 + 4 把尺子特化 + 5 条元规则 |
| 5 | 第五部分：双角色协同专章 | 3 大冲突 + 5 个协同条件 + 3 种组织模式 + 3 层增强回路 |
| 6 | 第六部分：从理论到行动 | 个人/团队/公司/行业 4 层 |
| 7 | 第七部分：与四把尺子理论的关系 | 继承 + 适配 + 边界 + 与 v1 健康/养龟养鱼对照 |
| 8 | 第八部分：常见质疑与回应 | 6 个常见质疑 |
| 9 | 第九部分：v1 的边界声明 | 不覆盖 + 假设 + 后续计划 + 自反性声明 |

**4 把尺子的新茶饮版翻译**：

| 尺子 | v26 原文 | v1 新茶饮版 |
|------|----------|------------|
| 兜底 | 生存价值 | 现金流安全（库存周转/账期/坏账/毛利率/现金流储备）|
| 激励 | 创新价值 | 客户复购（品质稳定/配送及时/售后响应/技术支持）|
| 能力 | 识别人才/机会 | 识人识货（7 大红旗客户 + 6 大红旗供应商 + 6 大红旗顾客）|
| 意义 | 守护什么值得活 | 长期主义（生存/关系/品牌/传承 4 层）|

**5+5 条元规则**（v1 框架的核心反直觉保护）：

B2B 供货 5 条：
1. 不可让"先发货后付款"成为默认模式
2. 不可让"价格战"成为主要竞争策略
3. 不可让"一家供应商"成为关键原料的唯一来源
4. 不可让"账期超过 60 天"成为常态
5. 不可让"个人关系"完全替代"流程"

自营零售 5 条：
1. 不可让"位置"成为唯一依赖
2. 不可让"新品"成为唯一竞争力
3. 不可让"员工"成为最不稳定的变量
4. 不可让"营销"替代"产品"
5. 不可让"扩张"成为唯一目标

**5 个双角色协同条件**（v1 框架的原创判断）：

1. 自营店必须避开客户商圈 🔴 必需
2. 自营店必须有差异化定位 🔴 必需
3. 客户分级制度必须明确 🔴 必需
4. 财务/库存必须分账 🔴 必需
5. 团队必须有边界 🟡 推荐

**3 种双角色组织模式**：

| 模式 | 适合 | 优势 | 风险 |
|------|------|------|------|
| 平行模式 | 1-2 家自营店 + 5-10 家客户 | 简单清晰 | 资源争夺 |
| 事业部模式 | 3-5 家自营店 + 20+ 家客户 | 各管各的 | 管理成本高 |
| 孵化模式 | 1 家自营店 + 验证新品 + 卖给客户 | 验证新趋势 | 自营店压力大 |

**配套文件清单**：

```
v1/
├── main.md              # 9 大部分，约 35KB
├── main.html            # 编译后
├── index.html           # 总入口
├── README.md            # 项目说明
├── build_main_html.py   # 编译脚本
└── CHANGELOG.md         # 本文件
```

**v1 与 v26 / v1 健康 / v1 养龟养鱼 的关系**：

- v1 继承 v26 的 3 大公理 + 4 把尺子 + 元规则
- v1 参照 v1 养龟养鱼的"双独立框架 + 协同专章"结构（养龟/养鱼 → B2B/自营）
- v1 参照 v1 健康理论的 9 部分 + 5 配套件结构
- v1 与 v26 §7 赚钱理论 v2 风险章节有交叉（现金流/坏账/扩张风险）

**v1 的自反性声明**（v1 第九部分原文）：

> **v1 知道自己"不是一个完整的经营理论"**——它只是**一个起点**。
> 如果你发现 v1 的哪条原则与你的实际经验冲突，**以你的经验为准**——但请先验证 3-6 个月（商业系统的变化需要时间）。
> 如果你发现 v1 的某条原则有明显错误，欢迎在补充文章中提出——v1.0.x 系列会保留错误并标注，作为"自我审视"的证据。

**v1 的边界**：

- 不覆盖咖啡豆种植/烘焙/萃取工艺
- 不覆盖咖啡机/萃茶机维修/校准
- 不深入品牌营销/小红书运营/抖音引流
- 不覆盖融资/股权/上市
- 不覆盖跨境电商/海外市场
- 不覆盖大型连锁/加盟体系
- 以国内"个人+小团队"为基本场景

---

## v1.0.x 后续计划

- **v1.1**：补充咖啡豆/茶叶选型实战指南
- **v1.2**：补充常见供货合同模板（账期/坏账/退货）
- **v1.3**：补充 3 个真实开店案例
- **v1.4**：v1 AI 讨论专用版（精简 50%）
- **v2.0**：扩展到"连锁加盟""跨境贸易"