# 数字大师墙 · 高端文旅方案 (Master Wall)

> 状态：**方案已定稿，待编码**
> 决策：**第一期全链路一次到位** · **文旅成交先纯留资、不接支付**
> 归属：数字我 / Digital Me — 广场(Plaza)的高端子区

---

## 1. 定位与闭环

**数字大师墙 = 永续种草入口；线下文旅 = 稀缺高价转化。**

```
游客 → 和大师数字分身随时聊(免费/低价·种草)
     → 报名平台围绕大师定制的人文旅游路线(转化·第一期为留资)
     → 旅途中与大师本人 喝咖啡/宴请/接待(稀缺高潮)
     → 大师拿旅游分成；数字分身继续做 行前讲解 + 行后答疑(把"在场"延展成永久)
```

数字人补的是大师最稀缺的资源——**时间**。这是模式成立的核心。

平台承诺：大师的**形象/声音/知识库由平台线下免费建立**（含整理、录入资料）；大师签署**授权协议 + 配合协议**，按约定配合文旅接待，享**旅游收益分成**。

---

## 2. 决策记录 (locked)

| 决策点 | 结论 |
|---|---|
| 第一期范围 | **全链路**：大师墙展示 + 数字大师聊天 + 文旅路线浏览 + 预约(留资) + 分成台账 + 后台建档/排团/结算 |
| 文旅成交/收钱 | **第一期纯留资**：预约只收意向线索(姓名/联系方式/意向路线)，不接支付；线下人工跟进 |
| 分成台账 | 照记**预估分成额**，状态 `pending`；实际成交由后台**人工确认**后转 `confirmed` 计入 |
| 支付集成 | 第一期**不做**（wallet/WXPAY 留到第二期，数据模型预留字段） |

---

## 3. 数据模型（落进现有 MongoDB）

### 3.1 `twins`（扩展现有集合）
大师本质是一类被平台线下精修过的 twin，复用现有 `avatarUrl / voiceId / 知识库 / profession / verified / inPlaza`：

```js
// 新增字段
isMaster:    Boolean,   // 是否大师（大师墙筛选主键）
masterTier:  String,    // 'flagship'镇馆 | 'resident'常驻 | 'guest'客座
domain:      String,    // 领域：guoxue国学 | shuhua书画 | zhongyi中医 | chadao茶道 | feiyi非遗 | gujian古建 | meishi美食 …
region:      String,    // 地域：huizhou徽州 | suzhou苏州 | dali大理 …
honorific:   String,    // 尊称，如「南山先生」
masterworks: [String],  // 代表作/成就
masterId:    ObjectId,   // → masters 业务档案
```

### 3.2 `masters`（新）— 业务档案
```js
{
  _id, twinId,
  status: 'invited'|'signed'|'building'|'live'|'paused', // 生命周期
  buildProgress: { photo:Bool, voice:Bool, knowledge:Bool, review:Bool }, // 线下建档进度
  poolWeight: Number,         // 默认在"大师池(30%)"中的拆分权重(具体成团时以 tour.masterShares 为准)
  offlineCommit: String,      // 配合承诺摘要(SLA 详见 agreement)
  contact: { name, phone, note },
  createdAt, updatedAt
}
```

### 3.3 `agreements`（新）— 授权 + 配合协议（命门）
```js
{
  _id, masterId,
  kind: 'authorization'|'cooperation',
  scope: {                    // 授权范围
    useImage:Bool, useVoice:Bool, useKnowledge:Bool,
    canSay:[String],          // 数字人可涉及话题
    cannotSay:[String],       // 禁区
  },
  cooperationSLA: {           // 配合承诺量化(cooperation 协议)
    teaPerTour:Number,        // 每团茶叙次数
    banquetPerYear:Number,    // 每年私宴上限
    receptionNote:String,
  },
  revocable:Bool, term:{from,to},
  inheritance:String,         // 离世/继承条款
  aiDisclosure:String,        // AI 披露话术("数字分身·非本人实时,以线下为准")
  signedAt, snapshot          // 签署快照(留痕)
}
```

### 3.4 `tours`（新）— 文旅产品
```js
{
  _id, title, cover, region,
  masterIds:[ObjectId],       // 关联大师(可多位)
  tier: 'digital'数字陪游 | 'study'研学团 | 'private'私宴接待,
  itinerary:[{day,title,desc}],
  masterMoments:[String],     // 大师线下互动内容(茶叙/宴请/接待)
  priceHint:Number,           // 价格区间提示(第一期不收款,仅展示)
  // 三方固定分成(sum=100)：平台 / 大师池 / 旅游组织者(地接)
  revShare: { platform:20, masters:30, organizer:50 },
  // 大师池(30%)在多位大师间的拆分权重(按参与度/天数)
  masterShares: [{ masterId, weight }],
  seats:Number, seatsLeft:Number,
  status:'draft'|'open'|'closed',
  createdAt, updatedAt
}
```

### 3.5 `bookings`（新）— 预约线索（第一期=留资，不收钱）
```js
{
  _id, tourId, masterIds:[],
  visitor: { name, phone, wechat, note, intent }, // 留资
  userId: ObjectId|null,      // 登录用户则关联
  status: 'lead'|'contacted'|'won'|'lost', // 人工跟进流转
  estAmount: Number,          // 预估成交额(人工填/路线价)
  createdAt, updatedAt
}
```

### 3.6 `payouts`（新）— 大师分成台账
```js
{
  _id, masterId, bookingId, tourId,
  baseAmount:Number,          // 成交额基数
  pct:Number,                 // 分成比例(取自 masters.revSharePct)
  amount:Number,              // 预估分成 = base*pct
  status:'pending'|'confirmed'|'paid', // 留资=pending；后台确认成交→confirmed
  createdAt, updatedAt
}
```

---

## 4. API 端点

### 公开（no-auth，复用 plaza 风格）
```
GET  /api/plaza?isMaster=1&domain=&region=   大师墙列表(复用 listPlaza + isMaster 筛选)
GET  /api/masters/:slug                        大师详情(档案+代表作+可预约路线)
GET  /api/tours?master=&region=&tier=          文旅路线列表
GET  /api/tours/:id                            路线详情
POST /api/bookings                             提交预约留资 {tourId, name, phone, ...}
```

### 后台（admin，复用现有 SUPER_ADMIN_EMAILS 鉴权）
```
POST /api/admin/masters                     建档：twin 标记为大师 + 创建 masters
PATCH/api/admin/masters/:id                 更新档案/建档进度/分成比例
POST /api/admin/masters/:id/agreements      录入授权/配合协议
POST /api/admin/tours   PATCH /:id          排团/编辑路线/开关席位
GET  /api/admin/bookings                     线索看板 + 流转状态
PATCH/api/admin/bookings/:id                 跟进(contacted/won/lost)+填成交额 → 生成/确认 payout
GET  /api/admin/payouts                      分成台账
```

---

## 5. 前端页面（Vue3 + 复用现有组件）

**C 端**
- `广场(Plaza.vue)` 顶部新增 **「大师墙」** 区块：大卡片(尊称/流派/地域/代表作/可预约标) + 领域·地域筛选。
- `大师详情(MasterProfile.vue·新)`：档案 + `和TA聊`(→现有 /me/:slug) + `深度咨询`(→现有 consult) + `跟TA去旅行`(该大师的 tours)。
- `文旅路线(Tours.vue / TourDetail.vue·新)`：路线列表/详情、行程、大师时刻、`预约`按钮。
- `预约留资(BookingForm)`：姓名/联系方式/意向 → POST /api/bookings。
- `我的预约(可选)`：登录用户看自己的留资状态。

**后台（Admin.vue 扩展 tab）**
- 大师建档看板(进度 photo/voice/knowledge/review) · 协议录入 · 分成比例
- 排团(tours) · 线索看板(bookings 流转) · 分成台账(payouts)

---

## 6. 授权与合规（不可省）

1. 真人肖像+声音：授权范围明确、**可撤销**、有期限、**离世/继承条款**。
2. **AI 披露**：大师数字人页面固定标注"数字分身·非本人实时，以线下为准"。
3. **话题围栏**：大师数字人按 `domain` + `agreement.scope.cannotSay` 设禁区，复用现有 `moderation`。
4. 协议**签署快照留痕**(`agreements.snapshot`)。

---

## 7. 分成台账口径（留资阶段）

**固定三方分成**：`平台 20% · 大师池 30% · 旅游组织者(地接) 50%`（`tour.revShare`，可后台改）。

- 提交预约(booking=lead) → 用 `tour.priceHint` 为基数，先算三方金额：
  - 平台 = base × 20%，组织者 = base × 50%，大师池 = base × 30%。
  - 大师池再按 `tour.masterShares[].weight` 拆给每位大师，各生成一条 `payout(status:pending)`。
- 后台把 booking 标 `won` 并填**实际成交额** → 相关 `payout` 转 `confirmed`、按实额重算。
- 大师端仪表盘(第二期)读 `payouts` 展示：带来多少线索/成交/预估分成。

---

## 8. 建议施工顺序

1. **后端模型+公开读**：twins 扩展字段 → masters/tours/bookings/payouts 集合 → listPlaza 加 isMaster → GET masters/tours + POST bookings。
2. **大师墙 + 详情 + 文旅 + 预约**（C 端可跑通种草→留资）。
3. **后台**：建档/协议/排团/线索/台账。
4. **合规围栏**：AI 披露 + domain 禁区注入 persona。
5. 造 2–3 位样板大师 + 1 条样板路线(建议冷启动垂类：非遗匠人「跟 X 大师游徽州」)，端到端演示。

---

## 9. 第二期（预留，不在本期）

支付成交(wallet/WXPAY 意向金/全款) · 大师收益仪表盘 · 配合 SLA 排期提醒 · 多垂类复制。

---

# 附一 · 成都首发案例（细化落地样板）

首发城市 **成都**，垂类 = 艺术 + 民间收藏 + 古建。三位大师上墙 + 一条 5 天精品路线，作为样板数据端到端跑通，再向全国复制。

## A. 三位首发大师（seed → twins + masters）

| 大师 | 尊称/身份 | domain | masterTier | 代表性 | 数字分身人设要点 |
|---|---|---|---|---|---|
| **朱成** | 艺术大师 · 民间博物馆馆长 | `diaosu` 雕塑石刻 | flagship 镇馆 | 朱成石刻艺术博物馆馆长；雕塑家；抢救性民间石刻收藏（万佛墙/民间造像） | 以"用石头留住一座城的记忆"为魂，讲民间美学、收藏故事、造像背后的信仰与匠心 |
| **李江** | 美术家 · 美术学院系主任 | `meishu` 美术 | resident 常驻 | 美术学院系主任；画家 | 笔墨见性，讲绘画语言、创作观、看画之道，能对团友作品现场点评 |
| **唐杰** | 中国古建泰斗 | `gujian` 古建 | flagship 镇馆 | 中国古建筑权威 | 营造之道，解构斗拱/营造法式/会馆形制，讲古建的当代传承与"论道" |

> 每位大师：平台线下免费建档（拍形象 / 录声音 / 整理并录入作品集与谈艺资料入知识库）→ 签授权+配合协议 → 上墙。作品集 = 现有 `gallery`（worksFromContext）承载，数字分身聊天时可引用。

## B. 样板路线「成都 · 大师人文之旅」5 天（seed → tours）

- **档位** `private` 私宴接待级 · **8 人精品团** · **¥50,000 / 人**（40 万/团）
- **定位**：人文朝圣 · 三位泰斗亲自同行、私宴、论道，市面买不到的稀缺接待
- **配套**：顶奢文化酒店（大慈寺旁 · 博舍级）、专属管家、名家私宴、数字分身行前讲解 + 行后问道

| Day | 主题 | 行程 | 大师时刻(masterMoments) |
|---|---|---|---|
| **D1** | 入蓉·序章：大慈千年 | 专属管家接机 → 入住文化酒店 → 大慈寺·太古里人文漫步 → 欢迎晚宴 | **朱成**出席茶叙破冰《我为什么收藏这座城的记忆》 |
| **D2** | 朱成·石头里的众生 | 朱成石刻艺术博物馆深度导览（万佛墙/民间造像）→ 拓片/雕塑手作体验 → 私宴 | **朱成馆长亲自导览 + 点评手作 + 论"民间博物馆如何留住城市的魂"** |
| **D3** | 李江·笔墨见性 | 蓝顶艺术区·李江画室 → 看画论画/大师示范 → 命题写生一对一指点 → 当代艺术下午茶雅集 | **与李江面对面**：现场示范、点评团友习作、咖啡对谈 |
| **D4** | 唐杰·营造之道 | 洛带古镇客家会馆群（清代古建）→ 唐杰现场解构斗拱/营造法式 → "论道"沙龙 → 宽窄巷子夜话·私宴 | **与唐杰论道**：古建当代传承沙龙 |
| **D5** | 历史建筑·故事收官 | 安仁公馆群 / 都江堰-青城山古建 → 专家讲建筑背后的家族与时代故事 → 结业茶会 → 送机 | 赠"数字传承卡"，行后可继续向三位大师数字分身问道 |

**价值锚点（为何值 5 万）**：三位泰斗亲自陪同+私宴（不可复制）· 顶奢文化住宿 · 8 人极致小团 · 数字分身永续问道。

**分成（固定 平台20 / 大师30 / 组织者50，后台可改）**：成交 40 万/团 →
- 平台 **8 万**（20%）· 旅游组织者(地接) **20 万**（50%）· 大师池 **12 万**（30%）
- 大师池 12 万按参与度拆：朱成(D1茶叙+D2整天，权重2) **6 万** · 李江(D3，权重1) **3 万** · 唐杰(D4，权重1) **3 万**
- 各生成一条 `payout(pending)`，成交确认后转 `confirmed`。

## C. 大师申请上墙入口（新增能力）

大师本人或机构可自助申请上墙 → 平台审核 → 通过后进入线下免费建档流程。

**数据模型 `master_applications`（新）**
```js
{
  _id, name, honorific, domain, region,
  achievements:[String], works:[{title,image}], // 成就/代表作
  contact:{ name, phone, wechat },
  intro:String, wishNote:String,               // 自述 / 合作意向
  status:'pending'|'reviewing'|'approved'|'rejected',
  reviewNote:String, createdAt, updatedAt
}
```
**API**
```
POST /api/masters/apply                 公开：提交申请
GET  /api/admin/master-applications      后台：申请列表
PATCH/api/admin/master-applications/:id  后台：审核(approved→一键转入建档、创建 masters+twin 草稿)
```
**页面**：大师墙 + 大师详情页放 **「申请成为大师 / 推荐大师」** 入口 → `MasterApply.vue` 表单。

## D. 全国运营蓝图（成都跑通后复制）

```
线上种草(全国大师数字分身矩阵，永续免费聊)
   → 定团(按大师/主题/区域成团，够人开团)
   → 定线路(路线设计，复用 tours 模型)
   → 定内容(逐日行程 + 大师时刻 + 专家讲解)
   → 线下落地(地接 + 接待 + 大师按 SLA 配合)
```
成都 = 首发样板；跑通后复制到 苏州 / 徽州 / 西安 / 大理 …（换 region + 换大师 + 换路线，系统结构不变）。

## E. 样板数据落库（施工第 5 步据此造）

- 3 个 twin（朱成/李江/唐杰）标 `isMaster` + 各自 domain/tier/honorific/代表作，配头像占位。
- 3 条 `masters` 档案（含 revSharePct 示例）+ 各一份授权/配合协议样例。
- 1 条 `tours`：上面 5 天路线，`tier:'private'`，`priceHint:50000`，`seats:8`。
- 端到端演示：大师墙 → 大师详情 → 路线详情 → 预约留资 → 后台看到线索 + 生成 pending 分成。

---

# 附二 · 报名支付 · 分成口径 · 合规（已上线定稿，2026-07-10）

> 本节记录实际落地版本，口径以此为准（覆盖前文早期的 20% 定金/在线全款等描述）。

## A. 报名与支付流程（游客侧）

1. 游客在广场/大师详情看到大师能力 → 顶部「大师文旅」板块看到路线与参团邀请。
2. **报名两种方式**：`仅留资`（顾问跟进，不付款）｜`报名·交预定金锁位`。
3. **平台只收预定金 = 总额的 50%**（如 5万/人 → 定金 2.5万/人，按出行人数计），支付即 `reserved` 锁席。
4. **尾款（另 50%）出行前直接交给旅游团（线下），不经平台**。故**取消在线全款**选项。
5. 支付通道：`stub` 即时到账（演示）；生产接 `TOUR_PAY_PROVIDER`（微信/Stripe/分账）。

## B. 三方分成口径（固定 平台20 / 大师30 / 组织者50）

- **预定金（总额 50%）= 平台 20% + 大师 30%**：定金一到账即**覆盖大师全部 30%**，故大师分成 `reserved/won → confirmed`（`payoutStatusFor`）；仅留资未付 → `pending`。
- **组织者 50% = 线下尾款**，由旅游团（持牌旅行社）出行前直收，台账记「线下应收」，不经平台。
- `listPayouts.summary` 三方汇总：`totalDeal / platform(20%) / masterConfirmed(30%) / masterPending / organizerOffline(50%) / depositInHand(=平台+大师)`。
- 成都样例（1 人）：总 5万 → 平台 1万 + 大师 1.5万（confirmed，=定金 2.5万）+ 组织者 2.5万（线下）。
- 大师池 30% 按 `tour.masterShares` 权重最大余数法精确拆分（朱成2/李江1/唐杰1 → 7500/3750/3750）。

## C. 合规要点（**上线前必须落实**；非法律意见，以监管/专业法务为准）

- **支付牌照 / 防二清**：平台**不得**把游客的钱收进自有账户再分给大师/组织者（= 二清，无牌照违法）。
  合规做法：① 用**持牌支付机构的分账**（微信支付/支付宝/银联商务/连连/合利宝等），支付时直接拆账到各方账户；或 ② 定金**直入「旅游组织者（持牌旅行社）」商户号**，平台仅按技术/服务费另行结算。**平台不碰资金池。**
- **旅游资质**：组团/带团需**《旅行社业务经营许可证》**。由**持牌旅行社当「旅游组织者/地接」**与游客签旅游合同、收尾款、担责、买旅意险；平台仅做信息撮合/种草/技术层，并遵守**《在线旅游经营服务管理暂行规定》**（审核合作旅行社资质、留存合同、处理投诉）。
- **模式天然适配**：平台=撮合/种草层，组织者=持牌旅行社（其 50% 尾款线下自收）。落地只需：①支付换成持牌分账/钱直入旅行社商户号；②文旅由持牌旅行社运营并签合同。

## D. 其它已上线增量

- **大师短片**：`twin.videoUrl`，详情页 16:9 播放器 + 墙卡 ▶ 标；后台可上传/贴链。
- **资料录入台**（后台每位大师）：形象/声音/短片/知识库上传，复用 `media.js`/`storage.js`/`knowledge.js`（无 key 时知识库降级存原文）。
- **访客默认落广场**（未登录 `/`→`/plaza`，登录→`/dashboard`）；**大师墙纯展示大师能力**，文旅只在「大师文旅」板块与一行轻引导。
- **三城样板**：成都/苏州/徽州（7 大师 + 3 路线），`gh workflow run seed-masters.yml` 灌生产。