MVP-FS 启动辅助工具（飞书版）· WEAVELY

🧭 快速导航（启动 5 步走）

按以下顺序完成配置，即可跑通 MVP Phase 0（4-8 周）

配置飞书多维表格 WEAVELY-MVP

按下方 §1 字段清单创建 6 张表，字段名使用 snake_case，与未来数据库列名保持一致
录入基础台账数据（WPL / CPL / SCL / BPL）

师傅名册、核心客户清单、品类费率、典型楼宇信息，见 §2 台账导入模板
设置飞书自动化规则与视图

阶段提醒、超时预警、看板视图，按 §3 一键配
团队培训 2 小时

§4 8 阶段操作手册 + §5 协作规范，全员过一遍 + 模拟一单走完全流程
上线首单

跑通一单，复盘字段缺口，然后进入"每周迭代"节奏（§6 周报生成 + 表单迭代）

📋 §1 飞书多维表格字段清单（复制即可建表）

多维表名称：WEAVELY-MVP；所有字段名使用英文 snake_case，字段中文名用于显示

CPT-Lite · 订单跟踪表（40 字段）

#	字段名（英文）	字段中文名	阶段	类型	必填	枚举 / 格式
通用信息 GN（5）
1	order_id	订单编号	GN	文本	✅	ORD-YYYYMMDD-NNN
2	current_stage	当前阶段	GN	单选	✅	L1/L2/L3/L4/L5/L6/L7/L8/异常/完成
3	order_status	订单状态	GN	单选	✅	进行中/已完成/已取消/异常暂停
4	created_at	创建时间	GN	日期	✅	自动
5	updated_at	更新时间	GN	日期	✅	自动
L1 线索获取（5）
6	lead_source	线索来源	L1	单选	✅	SCENE01线上/SCENE02随箱卡/SCENE03电商/SCENE04物流/SCENE05品牌/SCENE06菜鸟/推荐/其他
7	customer_name	客户姓名	L1	文本	✅
8	customer_contact	客户联系方式	L1	文本	✅	WhatsApp / 电话
9	lead_demand	初步需求	L1	文本	✅	AI 辅助提炼
10	lead_time	线索入站时间	L1	日期	✅
L2 需求确认（5）
11	category	服务品类	L2	单选	✅	衣柜/橱柜/床/餐桌/书柜/其他
12	product_model	产品型号	L2	文本	✅
13	install_address	安装地址	L2	文本	✅
14	preferred_time	期望时段	L2	日期	✅
15	site_condition_note	现场条件备注	L2	文本	⬜	电梯/楼层/停车/物业要求
L3 报价生成（5）
16	quote_id	报价编号	L3	文本	✅	QTE-YYYYMMDD-NNN
17	quote_amount	报价金额	L3	数字	✅	HKD
18	quote_detail	报价明细	L3	文本	✅	基础费+附加费+系数
19	quote_time	报价时间	L3	日期	✅
20	quote_status	报价状态	L3	单选	✅	待确认/已确认/已拒绝/已流失
L4 签约下单（4）
21	signed_at	签约时间	L4	日期	✅
22	payment_method	付款方式	L4	单选	✅	FPS/信用卡/现金/月结
23	payment_status	付款状态	L4	单选	✅	未付/已付/部分付/已退款
24	assigned_worker_id	指派师傅	L4	关联	✅	→ WPL-Lite
L5 配送安排（4）
25	delivery_method	配送方式	L5	单选	✅	自送/物流/客户自提/品牌直发
26	delivery_time	配送时间	L5	日期	⬜
27	delivery_status	签收状态	L5	单选	✅	待配送/配送中/已签收/异常
28	delivery_note	配送备注	L5	文本	⬜	损坏/延误记录
L6 上门安装（7）
29	worker_depart_time	师傅出发时间	L6	日期	✅
30	worker_arrive_time	师傅到达时间	L6	日期	✅
31	work_complete_time	完工时间	L6	日期	✅
32	actual_work_hours	实际工时	L6	数字	✅	小时1位小数，反哺 QMD 核心
33	site_photos_url	现场照片链接	L6	附件	✅	飞书云文档链接
34	extra_work_note	增项记录	L6	文本	⬜
35	exception_note	异常记录	L6	文本	⬜
L7 验收交付（3）
36	acceptance_result	验收结果	L7	单选	✅	通过/整改/客诉
37	acceptance_time	验收时间	L7	日期	✅
38	acceptance_sign_url	客户签字照	L7	附件	✅
L8 售后回访（2）
39	nps_score	NPS 评分	L8	数字	✅	0-10，反哺 CPL 画像核心
40	followup_note	回访备注	L8	文本	⬜	复购/推荐/意见

QSV-Lite · 报价表（15 字段）

final_amount = MIN( subtotal - discount , cap_price )
subtotal = base_fee × complexity_factor × building_factor × worker_level_factor + extra_work_fee

① quote_id / ② order_id / ③ category / ④ base_fee / ⑤ complexity_factor
⑥ building_factor / ⑦ worker_level_factor / ⑧ extra_work_fee / ⑨ subtotal / ⑩ discount
⑪ cap_price / ⑫ final_amount / ⑬ quote_detail_json / ⑭ quote_time / ⑮ quote_status

MDS-Lite · 四库台账

WPL 师傅（8）：worker_id / name / contact / level(L1-L3) / skill_categories / total_orders / avg_rating / status
CPL 客户（10）：customer_id / name / contact / address / lead_source / total_orders / last_nps / tags / referrer_id / status
SCL 品类（7）：category_id / name / sub_category / base_fee / base_work_hours / cap_price / skill_required
BPL 楼宇（8）：building_id / estate_name / address / building_type / floor_factor / has_elevator / parking_note / access_note

📥 将飞书 CSV 导出后，可运行 python scripts/mvp-data-checker.py <csv> 一键校验字段覆盖率、必填缺失、枚举异常、NPS/工时等核心指标。

🧮 §2 MVP 报价计算器（QSV-Lite 辅助）

纯前端、无服务端。计算后复制结果粘贴进 QSV-Lite / CPT-Lite 即可

参数输入

基础费率参考 QMD §

品类基础费（HKD）
复杂度系数 1.0-2.0
楼宇系数 0.8-3.0
师傅等级系数 0.8-1.5
附加费（HKD）
折扣（HKD）
封顶价（HKD）

报价结果

请输入参数并点击「计算报价」

✅ §3 8 阶段操作 Checklist（一线随身版）

按阶段打勾，避免遗漏必填字段和必做动作

负责人：ML 洪 / OL 成文

L1 线索获取

录入线索来源 lead_source
记录客户姓名+联系方式
沟通记录截图 → AI 提炼 lead_demand
记录线索入站时间
2h 内响应

负责人：OL

L2 需求确认

确认品类 category + 型号
确认地址，匹配 BPL 楼宇库
确认期望时段 preferred_time
引导客户拍电梯/门框/停车照片
采集现场条件备注

负责人：OL + QSV-Lite

L3 报价生成

查 SCL 品类基础费
查 BPL 楼宇系数
查 WPL 师傅等级系数
QSV-Lite 公式 → QTE 编号
AI 生成报价单文本后发客户

负责人：OL

L4 签约下单

记录签约时间
确认付款方式与状态
AI 推荐匹配师傅，人工确认
WhatsApp 通知师傅订单详情
关联 assigned_worker_id

负责人：OL

L5 配送安排

确认配送方式
协调配送时间
到达前 1h 通知客户+师傅
更新签收状态
延误/损坏 → delivery_note 记录

负责人：师傅 + OL

L6 上门安装（核心）

出发打卡 depart_time
到达打卡 arrive_time
穿鞋套 / 地面保护 / 垃圾带走
拍摄入户前 + 安装中 + 完工照
记录 actual_work_hours（1 位小数）
增项/异常 → 立即文本记录
完工打卡 complete_time

负责人：师傅 + 客户

L7 验收交付

引导客户逐项检查
验收结果通过/整改/客诉
客户签字照上传 → 填链接
售后说明（保修期/联系方式）
若整改 → 回退 L6

负责人：OL

L8 售后回访

验收后 1-3 天回访
NPS 评分 0-10（必填）
记录客户反馈 followup_note
NPS 9-10 → 推荐邀请文案
NPS ≤ 6 → 入问题客户池

🤝 §4 协作规范（MVP 期间严格执行）

工具使用、沟通流程、数据沉淀、AI 协作 —— 4 大类 18 条

📬 工具使用规则

场景	正确工具	❌ 错误做法	责任人
订单录入	飞书多维表格 WEAVELY-MVP	微信/Word/纯文本记业务	OL/ML
报价计算	QSV-Lite 公式字段或本页计算器	Excel 私下表	OL/BO
照片/签字采集	飞书云文档 → 链接回填表	仅发微信群，不入档	师傅/OL
日常沟通	飞书群（重要 @相关人）	私聊决定、不抄送	全员
技术问题	GitHub Issue（飞书 @TL 只是通知）	口头 / 微信临时群	TL/OL
正式文档	docs/ 目录 Git 管理	本地电脑个人文档	TL/DT
P0 故障	电话 + 飞书 @ 所有人	等待、拖延	发现者 / TL

🔁 信息流与闭环（18 条核心）

一线 → 上游

OL → PO：每周一线痛点 / 字段缺口（飞书表单）
OL → TL：Bug / 异常 / 阻塞（GitHub Issue，SLA < 30min）
OL → BO：报价偏差 / 议价情况（月报汇总）
OL → SPO：里程碑异常（立即电话 + 文字）
师傅 → OL：现场增项 / 异常（即时 WhatsApp + 表回填）

上游 → 一线

SPO → 全员：战略调整 / 资源调配（24h 内传达，文字版）
BO → TL：报价参数变更（文档 + 评审，禁止口头）
PO → TL：需求文档 + 验收标准（双周 Sprint）
TL → OL：系统上线 / 故障通知（30min 内，SLA）
TL → PO：技术方案（48h 内出稿）

🧠 AI 协作规范（听写 DT 参与原则）

原则：AI 辅助不替代，关键决策人把关；AI 产出须审查；AI 参与须标注。

AI 提炼的 lead_demand，OL 人工过目后入库
AI 生成报价单文本，OL 确认金额后发送
AI 推荐师傅，OL 结合经验做最终指派
AI 自动计算 actual_work_hours，须人工核对异常值
周报初稿由 scripts/mvp-weekly-report.py 生成，听写润色，OL/BO 事实确认
表单迭代建议：AI 分析字段缺口，TL 确认后才加字段
客户回复话术 AI 生成，发送前 OL 检查语气
故障根因分析 AI 辅助，TL 最终结论签字

📝 数据与版本规则

所有数据 唯一真实源 = 飞书多维表；微信群信息 24h 内回填
每次表单字段变更：版本号 +1（V1.0 → V1.1 → ...），并写入 WLG 对话记录
MVP 阶段单表上限 50 字段；超过即进入 Phase 1 拆分子表
每周五 18:00 前导出 CSV（UTF-8 无 BOM），运行数据检查脚本 + 生成周报
删除字段需 BO 确认（防止数据断裂），新增字段 TL 确认即可

🗺 §5 8 阶段流程图（Mermaid 可复制粘贴）

下方 Mermaid 代码可直接用在文档 / 飞书支持 Mermaid 的场景

flowchart TD L1["L1 线索获取
ML/OL · 2h内响应"] --> L2["L2 需求确认
OL · 品类/地址/时段"] --> L3["L3 报价生成
OL+QSV · 公式"] --> L4["L4 签约下单
OL · 签约+派单"] --> L5["L5 配送安排
OL · 通知+签收"] --> L6["L6 上门安装
师傅 · 7条SOP+工时"] --> L7["L7 验收交付
师傅+客户 · 签字"] --> L8["L8 售后回访
OL · NPS+口碑"] L2 -->|"需求超能力"| ESC1["转介合作方
END"] L3 -->|"流失"| POOL["流失跟踪池
7d/30d 回访"] L5 -->|"延误≥2h / 损坏"| PAUSE1["PAUSE
告知客户"] L6 -->|"增项确认"| L3 L6 -->|"超能力"| PAUSE2["PAUSE换师傅"] L7 -->|"验收不通过"| L6 L8 -->|"NPS≤6"| ESC2["问题客户池
BO 介入"] style L1 fill:#2a9d8f,stroke:#004046,color:#fff style L2 fill:#457b9d,stroke:#004046,color:#fff style L3 fill:#004046,stroke:#004046,color:#fff style L4 fill:#D4AF78,stroke:#004046,color:#004046 style L5 fill:#457b9d,stroke:#004046,color:#fff style L6 fill:#2a9d8f,stroke:#004046,color:#fff style L7 fill:#004046,stroke:#004046,color:#fff style L8 fill:#D4AF78,stroke:#004046,color:#004046

🛠 §6 脚本使用速查

① 数据质量检查（mvp-data-checker.py）

# 安装依赖：无，标准库即可
python scripts/mvp-data-checker.py export/CPT-Lite.csv --table cpt
python scripts/mvp-data-checker.py export/QSV-Lite.csv --table qsv
python scripts/mvp-data-checker.py export/WPL-Lite.csv --table wpl

② 周报生成（mvp-weekly-report.py）

python scripts/mvp-weekly-report.py \
  --cpt export/CPT-Lite-week.csv \
  --qsv export/QSV-Lite-week.csv \
  --out 发布/MVP周报-$(Get-Date -Format yyyyMMdd).md

③ 其他项目脚本（复用）

脚本	用途	MVP 场景
`scripts/sync-docs-repo.ps1`	同步 docs + 发布至 hk2026-docs	周报/迭代记录归档公开
`scripts/deploy-site.ps1`	MkDocs 部署 Cloudflare Pages	对外文档站点发布
`scripts/build-site.py`	构建文档站点	本地预览 docs 变更

📋 所有脚本使用前，先读 scripts/README.md，里面包含环境要求、前置命令、执行示例。

🚀 §7 上线首单 Checklist（启动仪式）

飞书多维表 WEAVELY-MVP 创建完成

6 张表均存在，字段名符合 §1 英文 snake_case 规范，自动化规则配置
基础台账 ≥ 最低种子数

WPL ≥ 3 位师傅 / CPL ≥ 5 位客户 / SCL ≥ 5 个品类 / BPL ≥ 5 个典型楼宇
自动化规则生效

新订单提醒、阶段变更提醒、超时提醒，至少完成 1 次模拟验证
全员培训 2h 完成

§3 8阶段 + §4 协作规范，全员现场提问无遗留，模拟走单一轮
脚本可运行

mvp-data-checker.py 跑通（可空表，至少无运行时错误）
首单进入 L1

OL 录入首单 → 全流程打卡 → 完成 L8 NPS → 运行数据检查脚本 → 生成首周周报 → 迭代 V1.1

✨ 完成以上 6 项 = MVP Phase 0 启动完成！进入"每周复盘 → 表单迭代 → 数据沉淀"节奏，目标 4-8 周累计 50+ 单后进入 Phase 1。

🧭 快速导航（启动 5 步走）

配置飞书多维表格 WEAVELY-MVP

录入基础台账数据（WPL / CPL / SCL / BPL）

设置飞书自动化规则与视图

团队培训 2 小时

上线首单

📋 §1 飞书多维表格字段清单（复制即可建表）

CPT-Lite · 订单跟踪表（40 字段）

QSV-Lite · 报价表（15 字段）

MDS-Lite · 四库台账

🧮 §2 MVP 报价计算器（QSV-Lite 辅助）

参数输入

报价结果

✅ §3 8 阶段操作 Checklist（一线随身版）

L1 线索获取

L2 需求确认

L3 报价生成

L4 签约下单

L5 配送安排

L6 上门安装（核心）

L7 验收交付

L8 售后回访

🤝 §4 协作规范（MVP 期间严格执行）

📬 工具使用规则

🔁 信息流与闭环（18 条核心）

🧠 AI 协作规范（听写 DT 参与原则）

📝 数据与版本规则

🗺 §5 8 阶段流程图（Mermaid 可复制粘贴）

🛠 §6 脚本使用速查

① 数据质量检查（mvp-data-checker.py）

② 周报生成（mvp-weekly-report.py）

③ 其他项目脚本（复用）

🚀 §7 上线首单 Checklist（启动仪式）

飞书多维表 WEAVELY-MVP 创建完成

基础台账 ≥ 最低种子数

自动化规则生效

全员培训 2h 完成

脚本可运行

首单进入 L1