MVP-WX 实施方案（微信小程序版 MVP - MVP-WX）¶

文档编号：DOC-D00-M2 / MVP-WX 版本：V1.0 创建日期：2026-08-07 维护人：TL / PO / DT 关联文档：TND-P、MVP-FS、方案对比、CPT-D、QSV-D、QMD、MDS-D、RQD-O

一、方案总述¶

1.1 背景与定位¶

MVP-FS 飞书版 V1.1 解决了"业务已启动、系统未就绪"的极速可上手问题（0 开发、1 天配置），但其核心瓶颈在于：数据依赖手工录入，客户需加微信/飞书才能沟通，师傅需在飞书填表，数据采集质量受人为因素影响大。

MVP-WX 是 MVP-FS 的姊妹方案：以微信小程序为载体，客户扫码即用、师傅打卡拍照、数据自动入库，将"手工录入"升级为"自动采集"。两种方案数据模型完全一致（CPT-Lite 40 字段 / QSV-Lite 15 字段 / MDS-Lite 四库），可并行或分阶段实施。

1.2 设计目标¶

目标	含义	验证标准
客户零门槛	扫码/搜索即用，无需加好友、无需装新 App	客户下单 ≤3min，培训 0min
数据自动采集	师傅打卡拍照，系统自动结构化入库	L6 数据完整率 ≥95%（FS 约 60-70%）
支付闭环	微信支付内嵌，签约到收款一体化	支付转化率 ≥80%
AI 内嵌	AI 通过云函数参与报价/派单/质检	AI 自动填写 50%+ 字段
可演进	云数据库 schema 兼容未来自建系统	迁移到 FastAPI+PostgreSQL 零成本
4 周上线	TL 1 人 4 周完成开发+审核+上线	Week 4 末首单跑通

1.3 核心策略¶

一句话：微信小程序（客户端+师傅端）+ 云开发（零运维）+ AI 云函数，客户扫码下单、师傅打卡拍照、数据自动入库，4 周上线。

┌─────────────────────────────────────────────────────────────────┐
│                    MVP-WX 核心策略："三端自动"                    │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  Layer 4: AI 协同层    云函数调用大模型（报价/派单/质检/周报）    │
│          ▲                                                      │
│  Layer 3: 流程层       CPT 8 阶段小程序化（L1→L8）              │
│          ▲                                                      │
│  Layer 2: 数据层       云数据库（与 FS 同 schema）+ 云存储       │
│          ▲                                                      │
│  Layer 1: 工具层       微信小程序×3端 + 微信云开发 + 微信支付    │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

1.4 设计原则¶

数据模型与 FS 完全一致：字段名、枚举值、snake_case 命名完全相同，确保 FS↔WX 可互导、未来迁移到自建系统零成本
自动采集优先：能用 GPS/拍照/支付自动获取的，绝不手工录入
三端分离：客户端重体验、师傅端重效率、管理端重管控
云开发零运维：不建服务器、不配域名、不装数据库，TL 一人可维护
渐进增强：先跑通 8 阶段核心流程，AI 能力按周迭代加入

1.5 文档定位¶

维度	说明
前置依赖	RQD-O 业务需求、CPT-D 8 阶段设计、QMD 报价模型
同级文档	MVP-FS（飞书版）、方案对比
下游文档	TND-E 技术平台演进方案（MVP-WX 作为 Phase 1 候选实现）
适用阶段	日均 5-30 单阶段（FS 适合 0-10 单验证，WX 适合 10+ 单规模化）

二、技术选型与架构¶

2.1 技术栈总览¶

层	选型	理由
客户端	微信小程序原生（WXML+WXSS+JS）	无需下载、扫码即用、微信生态内闭环
后端	微信云开发 CloudBase	零运维、免域名、免 SSL、TL 一人可维护
数据库	云数据库 CloudDB（NoSQL/MongoDB 语法）	schema 灵活、与未来 PostgreSQL 字段名直接映射
存储	云存储 CloudStorage	照片/签字/附件直传，CDN 加速
AI	云函数调用大模型 API	报价建议/需求提炼/师傅推荐/周报生成
支付	微信支付（小程序支付）	签约到收款一体化，无需跳转
消息	订阅消息 + 模板消息	阶段变更通知、超时预警、NPS 推送

2.2 系统架构¶

graph TB
    subgraph "微信生态"
        CUST["📱 客户端小程序<br/>weavely-customer"]
        WORK["📱 师傅端小程序<br/>weavely-worker"]
        ADMIN["📱 管理端小程序<br/>weavely-admin"]
    end

    subgraph "微信云开发 CloudBase"
        CF["⚡ 云函数<br/>业务逻辑+AI调用"]
        DB[("🗄️ 云数据库<br/>orders/quotes/<br/>workers/customers/<br/>services/buildings")]
        CS["📁 云存储<br/>照片/签字/附件"]
    end

    subgraph "外部服务"
        AI["🤖 大模型 API<br/>GLM/GPT"]
        PAY["💳 微信支付"]
    end

    subgraph "飞书同步（可选）"
        FS["📊 飞书多维表<br/>WEAVELY-MVP"]
    end

    CUST --> CF
    WORK --> CF
    ADMIN --> CF
    CF --> DB
    CF --> CS
    CF --> AI
    CF --> PAY
    CF -.->|"定时同步<br/>CSV导入"| FS

    style CUST fill:#2a9d8f,stroke:#004046,color:#fff
    style WORK fill:#457b9d,stroke:#004046,color:#fff
    style ADMIN fill:#D4AF78,stroke:#004046,color:#004046
    style CF fill:#004046,stroke:#004046,color:#fff
    style DB fill:#007a85,stroke:#004046,color:#fff
    style CS fill:#007a85,stroke:#004046,color:#fff
    style AI fill:#e76f51,stroke:#004046,color:#fff
    style PAY fill:#e76f51,stroke:#004046,color:#fff
    style FS fill:#F2F0EB,stroke:#D4AF78,stroke-dasharray:5 5,color:#004046

2.3 三端职责划分¶

端	用户	核心功能	页面数
客户端	客户（C端用户）	下单/查报价/支付/查进度/验收签字/NPS	~8 页
师傅端	安装师傅	接单/打卡/拍照/工时/增项报告	~6 页
管理端	OL/BO/SPO	需求确认/报价审核/派单/数据看板/回访	~10 页

三端共用一个小程序（通过角色切换），还是三个独立小程序？ - MVP 阶段推荐三端合一（一个小程序 + 角色切换页），减少审核成本和开发量 - 日均 30+ 单后可拆分为独立小程序，提升各自体验

2.4 云开发环境配置¶

配置项	值	说明
云环境 ID	`weavely-mvp`	一个环境即可
数据库集合	6 个	orders / quotes / workers / customers / services / buildings
云函数	~8 个	见 §2.5
云存储	1 个 bucket	/photos /signs /attachments
套餐	基础版（免费额度）或专业版	日均 <30 单免费额度够用

2.5 云函数清单¶

云函数	触发方式	功能
`createOrder`	客户端调用	L1 创建订单 + AI 提炼需求
`generateQuote`	管理端调用	L3 自动算价 + AI 报价建议
`assignWorker`	管理端调用	L4 派单 + AI 师傅推荐
`workerCheckin`	师傅端调用	L6 打卡（出发/到达/完工）+ GPS
`uploadPhotos`	师傅端调用	L6 照片上传云存储 + 关联订单
`acceptOrder`	客户端调用	L7 验收确认 + 电子签字
`npsSurvey`	定时触发	L8 自动推送 NPS + 回访触发
`weeklyReport`	定时触发（每周五 18:00）	AI 生成周报 + 同步飞书

三、极简数据模型¶

3.1 与 MVP-FS 完全一致¶

核心原则：MVP-WX 的云数据库集合字段与 MVP-FS §3 的飞书多维表字段完全一致（字段名、类型、枚举值），确保： - FS↔WX 可互导（CSV 导入导出） - 未来迁移到自建系统（FastAPI+PostgreSQL）零成本 - 两种方案可并行运行，数据可合并

3.2 云数据库集合设计¶

集合名	对应 FS 表	字段数	主键	说明
`orders`	CPT-Lite	40	`order_id`	订单跟踪（8 阶段状态机）
`quotes`	QSV-Lite	15	`quote_id`	报价记录
`workers`	WPL-Lite	8	`worker_id`	师傅台账
`customers`	CPL-Lite	10	`customer_id`	客户台账
`services`	SCL-Lite	7	`category_id`	品类费率
`buildings`	BPL-Lite	8	`building_id`	楼宇系数

3.3 自动采集增强字段（FS 无）¶

以下字段在 MVP-WX 中由系统自动采集，FS 版需手工录入：

字段	FS 版	WX 版	采集方式
`created_at`	手工填	✅ 自动	云函数 `Date.now()`
`updated_at`	手工填	✅ 自动	云函数每次更新触发
`worker_depart_time`	手工填	✅ 自动	师傅点击"出发"按钮
`worker_arrive_time`	手工填	✅ 自动	师傅点击"到达"+GPS 验证
`work_complete_time`	手工填	✅ 自动	师傅点击"完工"
`actual_work_hours`	手工算	✅ 自动	到达→完工时间差
`site_photos_url`	手工传链接	✅ 自动	拍照直传云存储
`acceptance_sign_url`	手工传链接	✅ 自动	客户手写签字 canvas
`gps_location`	❌ 无	✅ 新增	师傅打卡 GPS 坐标
`payment_transaction_id`	❌ 无	✅ 新增	微信支付订单号

数据完整率预期：FS 版 L6 数据完整率约 60-70%（依赖手工），WX 版 ≥95%（自动采集）。

3.4 数据库 Schema 示例（orders 集合）¶

{
  "_id": "auto_generated",
  "order_id": "ORD-20260807-001",
  "current_stage": "L6",
  "order_status": "进行中",
  "created_at": "2026-08-07T10:30:00+08:00",
  "updated_at": "2026-08-07T14:20:00+08:00",
  "lead_source": "SCENE01线上",
  "customer_id": "CUST-0001",
  "customer_name": "陈先生",
  "customer_contact": "+852-91234567",
  "lead_demand": "宜家PAX衣柜安装，6柜连体",
  "category": "衣柜",
  "product_model": "PAX-100x58x236",
  "install_address": "沙田第一城第3座15楼",
  "preferred_time": "2026-08-09T14:00:00+08:00",
  "building_id": "BLD-0001",
  "quote_id": "QTE-20260807-001",
  "quote_amount": 1800,
  "quote_status": "已确认",
  "assigned_worker_id": "WK-001",
  "worker_depart_time": "2026-08-09T13:15:00+08:00",
  "worker_arrive_time": "2026-08-09T13:45:00+08:00",
  "work_complete_time": "2026-08-09T16:30:00+08:00",
  "actual_work_hours": 2.8,
  "gps_location": { "lat": 22.3833, "lng": 114.1833 },
  "site_photos_url": ["cloud://weavely-mvp/photos/ORD-001-1.jpg", "..."],
  "acceptance_result": "通过",
  "nps_score": null,
  "_openid": "customer_wechat_openid"
}

四、三端功能设计¶

4.1 客户端小程序¶

页面	功能	对应阶段
首页/扫码入口	服务介绍 + 立即下单按钮	L1
下单表单	品类选择/型号/地址/时段/现场照片上传	L1→L2
报价查看	报价明细展示 + 确认/拒绝按钮	L3→L4
支付页	微信支付调起 + 支付结果	L4
订单进度	8 阶段实时进度条 + 师傅信息	L4→L7
验收页	逐项确认 + 手写签字 canvas	L7
评价页	NPS 0-10 评分 + 文字反馈	L8
历史订单	已完成订单列表 + 复购入口	—

4.2 师傅端小程序¶

页面	功能	对应阶段
接单列表	待接单/进行中/已完成 Tab	L4
订单详情	客户信息/地址导航/产品信息	L4→L6
打卡页	出发/到达/完工三按钮 + GPS	L6
拍照页	入户前/安装中/完工照多拍上传	L6
工时记录	自动计算 + 增项备注	L6
异常上报	异常类型选择 + 照片 + 描述	L6

4.3 管理端小程序¶

页面	功能	对应阶段
工作台	今日订单概览 + 待办提醒	全局
需求确认	新订单列表 + 需求补充	L2
报价审核	AI 报价建议 + 人工确认/调整	L3
派单管理	AI 师傅推荐 + 人工指派	L4
配送协调	配送安排 + 状态更新	L5
异常监控	超时/客诉/异常单列表	全局
回访管理	NPS 列表 + 低分跟进	L8
数据看板	日/周/月统计图表	全局

五、8 阶段操作手册（小程序版）¶

5.1 L1 线索获取¶

维度	说明
触发	客户扫码（随箱卡/线下物料）或搜索小程序
核心动作	客户填写下单表单 → 系统自动创建 order 记录
自动采集	`lead_source`（扫码参数）/ `created_at` / `customer_contact`（微信授权）
AI 辅助	`lead_demand` 自由文本 → AI 云函数提炼结构化需求
通知	OL 管理端收到订阅消息通知
SLA	OL 2h 内响应（同 FS）

5.2 L2 需求确认¶

维度	说明
触发	OL 管理端点击"确认需求"
核心动作	OL 核实品类/型号/地址，匹配 BPL 楼宇库，补充现场条件
自动采集	客户上传的现场照片已关联订单
异常	需求超能力 → 转介合作方（同 FS）

5.3 L3 报价生成¶

维度	说明
触发	OL 管理端点击"生成报价"
核心动作	云函数 `generateQuote` 自动算价 + AI 报价建议
公式	`subtotal = base × complexity × building × worker_level + extra` → `final = MIN(subtotal - discount, cap)`
AI 辅助	基于历史订单分析偏差，建议折扣/附加费
输出	报价单推送到客户小程序 → 客户查看明细

5.4 L4 签约下单¶

维度	说明
触发	客户小程序内点击"确认报价并支付"
核心动作	微信支付 → 支付成功自动更新 `payment_status`
派单	云函数 `assignWorker` + AI 师傅推荐 → OL 确认 → 推送师傅端
通知	师傅端收到接单通知（订阅消息）
自动采集	`payment_transaction_id` / `signed_at`

5.5 L5 配送安排¶

维度	说明
触发	OL 管理端安排配送
核心动作	选择配送方式/时间 → 推送客户+师傅
签收	客户小程序内确认签收或师傅端代签
异常	延误≥2h / 损坏 → PAUSE（同 FS）

5.6 L6 上门安装（核心环节）¶

维度	说明
触发	师傅端打卡"出发"
核心动作	三次打卡（出发/到达/完工）+ 三组拍照（入户前/安装中/完工照）
自动采集	`worker_depart_time` / `worker_arrive_time` / `work_complete_time` / `actual_work_hours`（自动算时间差）/ `gps_location` / `site_photos_url`
L6 作业规范	穿鞋套 / 地面保护 / 垃圾带走（同 CPT-D §2.1）
增项/异常	师傅端即时上报 → OL 管理端收到通知
AI 辅助	照片上传后 AI 识别安装质量（预埋，Phase 1 启用）

5.7 L7 验收交付¶

维度	说明
触发	师傅点击"完工" → 客户小程序收到验收通知
核心动作	客户逐项确认 → 手写签字 canvas → 自动生成签字图
自动采集	`acceptance_sign_url` / `acceptance_time` / `acceptance_result`
异常	整改 → 回退 L6（同 FS）

5.8 L8 售后回访¶

维度	说明
触发	验收后 1-3 天，云函数 `npsSurvey` 定时推送
核心动作	客户小程序内 NPS 评分 0-10 + 文字反馈
自动采集	`nps_score` / `followup_note`
口碑营销	NPS 9-10 → 自动推送推荐邀请文案 + 分享小程序卡片
低分跟进	NPS ≤6 → 入问题客户池 → OL 24h 内跟进（同 FS）

5.9 异常处理¶

与 MVP-FS §4.9 一致，差异在于： - 异常上报通过小程序即时推送（FS 通过 WhatsApp + 飞书回填） - PAUSE/ESCAPE 状态在云数据库中自动流转（FS 手工改阶段）

六、AI 协同设计¶

6.1 AI 参与方式（云函数调用大模型）¶

阶段	AI 能力	实现方式
L1	需求提炼	客户自由文本 → `createOrder` 云函数调用 AI → 结构化 `lead_demand`
L3	报价建议	`generateQuote` 云函数调用 AI → 基于历史偏差建议折扣/附加费
L4	师傅推荐	`assignWorker` 云函数调用 AI → 技能/位置/评分/负载综合排序
L6	照片质检（预埋）	照片上传后 AI 识别安装质量（Phase 1 启用）
L8	口碑触发	NPS 9-10 → AI 生成个性化推荐文案
周报	数据分析	`weeklyReport` 云函数调用 AI → 生成 Markdown 周报

6.2 AI 调用架构¶

flowchart LR
    A["小程序前端"] --> B["云函数"]
    B --> C{"需要 AI?"}
    C -->|是| D["调用大模型 API"]
    D --> E["AI 返回结果"]
    E --> F["云函数处理"]
    C -->|否| F
    F --> G["写入云数据库"]
    G --> H["返回前端"]

    style B fill:#004046,stroke:#004046,color:#fff
    style D fill:#e76f51,stroke:#004046,color:#fff
    style G fill:#007a85,stroke:#004046,color:#fff

6.3 AI 规范（与 FS 一致）¶

AI 辅助不替代，关键决策人把关
AI 产出须 OL/BO 审查后入库
AI 参与的记录标注 _ai_generated: true
大模型 API Key 存云函数环境变量，不暴露前端

七、开发实施计划（4 周冲刺）¶

7.1 Week 1：需求确认 + 环境搭建¶

天	任务	产出
D1-2	需求确认 + UI 原型设计（Axure/Figma）	原型图 24 页
D3	微信小程序注册 + 云开发环境创建	AppID + 云环境 `weavely-mvp`
D4	数据库集合初始化 + 种子数据导入	6 集合 + WPL≥3/CPL≥5/SCL≥5/BPL≥5
D5	基础框架搭建（三端角色切换 + 登录）	可运行的空框架

7.2 Week 2：客户端核心功能¶

天	任务	产出
D6-7	下单表单 + 照片上传	L1→L2 流程跑通
D8	报价查看页 + 微信支付对接	L3→L4 流程跑通
D9	订单进度页 + 验收签字	L5→L7 流程跑通
D10	NPS 评价页 + 历史订单	L8 流程跑通

7.3 Week 3：师傅端 + 管理端¶

天	任务	产出
D11-12	师傅端：接单/打卡/拍照/工时	L6 全流程跑通
D13-14	管理端：需求确认/报价审核/派单	L2→L4 管理流程跑通
D15	管理端：异常监控/数据看板/回访	全管理功能跑通

7.4 Week 4：AI + 联调 + 上线¶

天	任务	产出
D16-17	AI 云函数开发（报价建议/师傅推荐/周报）	AI 能力上线
D18	全流程联调测试（模拟 3 单走通 L1→L8）	测试报告
D19	提交微信审核 + 修复审核问题	审核通过
D20	上线 + 首单跑通 + 复盘	MVP-WX V1.0 上线

7.5 人力配置¶

角色	投入	职责
TL 司徒	100% × 4 周	架构+开发+联调+上线
PO 郭	20% × 4 周	需求确认+原型评审+验收
OL 成文	10% × 4 周	业务流程确认+测试+培训
DT 听写	辅助	文档+AI 提示词+周报模板

八、成本估算¶

项目	费用	说明
微信小程序认证	¥300/年	企业主体认证
云开发套餐	¥0-40/月	基础版免费额度（日均<30单够用）；专业版 ¥40/月
大模型 API	¥0-200/月	按调用量计费，MVP 阶段量小
域名+SSL	¥0	云开发自带，无需额外购买
开发人力	TL 1人×4周	内部成本，无外包
合计（首年）	¥500-3000	不含人力

对比 MVP-FS：FS 工具成本 ¥0（飞书免费版够用），但 WX 的 ¥500-3000 换来的是客户体验提升 + 数据自动采集 + 支付闭环。

九、与 MVP-FS 的关系¶

9.1 数据模型完全一致¶

两种方案的 CPT-Lite / QSV-Lite / MDS-Lite 字段定义、枚举值、snake_case 命名完全相同，可互导互迁。

9.2 演进路径¶

flowchart LR
    P0["Phase 0<br/>MVP-FS 飞书版<br/>0开发 1天配置<br/>日均0-10单"]
    -->|"Week 1-4<br/>TL开发"| P0X["Phase 0X<br/>MVP-WX 小程序版<br/>4周开发<br/>日均5-30单"]
    --> P1["Phase 1<br/>FS+WX 并行<br/>飞书管理+小程序采集<br/>日均10-50单"]
    --> P2["Phase 2<br/>自建系统<br/>FastAPI+PostgreSQL<br/>日均30+单"]

    P0 -.->|"CSV 导出<br/>字段直接映射"| P0X
    P0X -.->|"云数据库导出<br/>字段直接映射"| P2

    style P0 fill:#D4AF78,stroke:#004046,color:#004046
    style P0X fill:#2a9d8f,stroke:#004046,color:#fff
    style P1 fill:#457b9d,stroke:#004046,color:#fff
    style P2 fill:#004046,stroke:#004046,color:#fff

9.3 并行运行策略¶

场景	FS 角色	WX 角色
FS 已上线、WX 开发中	主力运行	开发中
WX 上线初期	主力运行 + 数据备份	试运行（部分单走 WX）
WX 稳定后	管理后台（OL 用飞书看板）	主力运行
自建系统上线后	退役	退役或保留为客户端

9.4 飞书同步机制¶

MVP-WX 支持将云数据库数据定时同步到飞书多维表（weeklyReport 云函数 + 飞书 API），实现： - OL 仍可在飞书看数据看板（习惯过渡） - 数据双备份（云数据库 + 飞书） - FS 的 mvp-data-checker.py / mvp-weekly-report.py 脚本仍可复用

十、风险与应对¶

风险	概率	影响	应对措施
小程序审核被拒	中	上线延迟	提前研究审核规则；服务类小程序需企业认证+类目匹配
开发周期延期	中	上线推迟	4 周计划留缓冲；Week 4 D18-19 专设修复时间
云开发免费额度不足	低	服务中断	监控用量；超量自动降级或升级专业版（¥40/月）
香港用户微信习惯	中	客户不愿用小程序	调研确认；保留 FS 作为备选方案
师傅不愿装小程序	中	L6 数据缺失	师傅端极简化（3 按钮打卡）；培训+激励
大模型 API 不稳	低	AI 功能降级	云函数降级策略：AI 不可用时回退规则引擎

修订记录¶

版本	日期	修订人	修订内容
V1.0	2026-08-07	DT	首版创建：微信小程序+云开发方案；三端设计（客户端/师傅端/管理端）；8 阶段小程序化操作手册；AI 云函数架构；4 周开发冲刺计划；与 MVP-FS 数据模型完全一致、可互导互迁、并行运行策略

本方案为 MVP 微信小程序版实施文档，飞书版见 MVP-FS，方案对比见对比文档，技术规划见 TND-P，技术平台演进见 TND-E。