wendang/04-客户验收订单与分销全链路流程.md

客户验收－订单与分销完整业务流程

用途：供客户按真实业务顺序进行小程序、管理后台及资金结果验收。

本文只使用业务名称和中文状态，不使用研发阶段编号、程序常量或内部任务编号。

当前覆盖：来源进入、预约下单、抢单派单、上门履约、报价增费、费用确认、支付退款、订单结算、分销收益、师傅收益、通知及发票。

一、参与角色

角色	主要操作
用户	进入来源页面、预约下单、确认费用、支付、查看进度、申请发票
师傅	抢单或接受派单、提交到场、报价、施工记录、费用和完工结果
派单员	查看超时工单、接管派单、选择合格师傅、持续跟踪工单
分销参与人	邀请人、业务员、合伙人按订单创建时冻结的关系获得对应收益
管理人员	维护服务与费用配置、查看订单资金、处理发票和异常资金事项
系统	固化订单事实、推进状态、接收支付退款结果、结算分账、生成通知和统计

二、全链路流程图

flowchart TD
    A[用户进入小程序] --> B{是否带有效来源}
    B -->|否| C[记录为平台自然来源]
    B -->|好友或合作方来源| D[校验并保存本次运行来源]
    C --> E[选择服务项目并填写预约资料]
    D --> E
    E --> F[创建订单并冻结来源、服务、地址和分配关系]
    F --> G{是否需要先支付上门费}
    G -->|是| H[待支付上门费]
    H --> I[用户支付]
    I --> J[创建唯一待接工单]
    G -->|否| J
    J --> K[待接单]
    K --> L{接单方式}
    L -->|师傅抢单| M[校验资格与服务项目后接单]
    L -->|工单超时| N[进入派单员可操作范围]
    N --> O[派单员接管或选择师傅]
    O --> P[被派师傅确认接单]
    M --> Q[待上门]
    P --> Q
    Q --> R[师傅提交到场信息]
    R --> S[已到场]
    S --> T[提交首次方案和费用]
    T --> U{施工安排}
    U -->|待用户确认| V[用户确认报价]
    U -->|下次上门| W[挂起履约并释放师傅]
    W --> X[师傅再次到场]
    X --> V
    V --> Y{是否有待支付预付款}
    Y -->|有| Z[等待用户支付后施工]
    Y -->|无| AA[进入施工]
    Z --> AA
    AA --> AB[提交施工记录或新增费用]
    AB --> AC{继续方式}
    AC -->|继续施工| AA
    AC -->|下次上门| W
    AC -->|提交完工| AD[已提交完工]
    AD --> AE{是否仍有待确认或待支付费用}
    AE -->|有| AF[用户确认并支付剩余费用]
    AE -->|无| AG[订单完成]
    AF --> AG
    AG --> AH[生成唯一订单结算]
    AH --> AI[师傅收益进入压款]
    AH --> AJ[分销收益提交微信分账或进入钱包兜底]
    AH --> AK[平台收益和支付手续费入账]
    AI --> AL[压款到期释放为可提现余额]
    AG --> AM[用户按订单申请发票]
    AM --> AN[管理人员开具并交付电子发票]
    K --> AO{用户接单前取消}
    AO -->|无已付金额| AP[直接取消]
    AO -->|存在已付金额| AQ[按原收款原路退款]
    AQ --> AR[退款成功后取消并冲正相关资金]
    AN --> AS{开票后是否发生退款}
    AS -->|是| AT[生成对应红字处理任务]

中文状态速查

业务对象	中文状态	客户验收含义
订单	待支付上门费	尚未满足创建工单条件
订单	待派单	工单已创建，等待抢单或派单
工单	待接单	当前尚无师傅正式承接
工单	待师傅确认	已派给指定师傅，等待接受或拒绝
工单	待上门	师傅已经接单，尚未提交到场
工单	已到场	已记录到场时间、说明和照片
工单	施工中	首次报价门禁已满足，可以继续履约
工单	改天上门	本次履约暂停，师傅已释放，等待再次到场
工单	已提交完工	师傅已完工，但可能仍有费用待确认或待支付
订单	已完成	履约完成且订单全部有效费用已处理完毕
订单	已取消	取消条件及相关退款均已完成
费用	待确认	用户尚未确认师傅提交的费用
费用	已确认	用户已认可费用，可按支付规则处理
费用	待支付	已达到支付条件但尚未支付
费用	已支付	微信支付成功并收到有效结果
退款	处理中	已提交原路退款，等待最终结果
退款	已退款	退款成功，订单和资金已按规则推进
发票	待处理	用户已经提交订单开票申请
发票	处理中	管理人员正在办理
发票	已开票	电子发票已经交付
发票	已驳回／已取消	未开票，本次申请不再占用可开票额度

三、来源与预约下单

1. 用户从普通入口进入时，订单来源记为平台自然来源。

2. 用户从好友分享或合作方二维码进入时，系统先校验来源是否有效；有效来源只保存在当前小程序运行周期内。

3. 同一运行周期再次下单，继续使用最近一次有效来源；扫描新的有效来源时覆盖旧来源；完全退出后重新进入且没有新来源时恢复平台自然来源。

4. 预约页只展示包含有效服务项目的分类。用户选择服务项目、服务地址，填写问题描述，可按页面要求上传图片。

5. 提交订单时，系统一次性冻结以下事实，后续配置变化不得覆盖历史订单：

   • 用户和订单来源；
   • 服务分类、服务项目和服务地址；
   • 上门费及其支付方式；
   • 邀请人、业务员、合伙人等有效分销参与关系；
   • 平台剩余分配关系。

6. 只有平台参与分配时，不额外生成无业务价值的分销关系变更日志，但不影响订单创建和平台收益。

7. 需要先支付上门费时，订单显示“待支付上门费”，支付成功后才创建工单；不需要先付时直接创建唯一待接工单。

8. 客户应核对订单服务、地址、来源、费用和初始进度是否与下单内容一致。

四、抢单、派单与接单

1. 新工单立即进入公共抢单范围，但师傅只能看到与本人已选服务项目匹配、且本人具备接单资格的工单。
2. 未超过后台配置的抢单等待时间前，派单员不可见该工单，避免抢单和人工派单过早混在一起。
3. 超时后，工单同时保留在抢单范围和派单范围；此时师傅仍可抢单。
4. 派单员正式选择“接管派单”后，工单暂时退出公共抢单和公共派单范围，给派单员留出联系师傅的处理时间。
5. 派单员可续期接管、主动放回公共范围，或选择服务项目匹配的合格师傅进行派单；接管超时后系统自动放回，不需要人工命令。
6. 师傅抢单、派单员接管和正式派单采用唯一结果控制，先成功的有效，后到操作不能覆盖已有结果。
7. 被派师傅可确认接单或拒绝；拒绝后按规则重新进入可处理范围。
8. 派单员只能在师傅端小程序操作。小程序业务身份与管理后台账号、角色是两套完全独立的权限体系。
9. 派单员完成派单后仍可持续查看本人经手工单的后续进度。
10. 抢单及派单列表应按业务紧迫程度和时间稳定排序，同一时刻结果保持稳定。

师傅占用与多单规则

• 待确认派单不占用师傅。
• 师傅接单后到提交完工之间，正常履约工单视为有效占用。
• 选择改天上门或进入异常处理后，立即释放占用，师傅可以承接其他工单。
• 默认开启占用限制时，已有有效占用的师傅不再看到其他公共抢单，只保留本人已有工单及待确认派单。
• 关闭占用限制后，师傅可看到所有符合服务项目和接单资格的公共工单。
• 该开关不限制派单员继续向师傅派单，师傅仍需自行确认。

五、到场、报价、施工与改天上门

1. 提交到场

1. 师傅接单后进入“待上门”。
2. 到场时必须上传现场照片，可填写现场说明。
3. 到场时间由系统生成，师傅不可自行修改。
4. 同一师傅有多个已接工单时，系统只拦截真正冲突的同时施工，不应因多个工单都停留在“待上门”而全部无法推进。

2. 首次方案与报价

师傅到场后提交问题说明、现场照片、费用明细和本次施工安排：

• 选择“待用户确认”：用户确认后才能进入施工；存在预付款时，还必须支付成功。
• 选择“改天上门”：订单保持当前报价和确认事实，本次履约暂停，师傅立即释放。

用户未确认报价时师傅再次到场，工单恢复为“已到场”，仍等待用户确认，不能施工；用户已确认且无未付预付款时，再次到场后恢复“施工中”；用户已确认但预付款未付时，继续等待支付。

3. 施工中记录

1. 施工中可多次提交问题说明、现场照片及新增费用。
2. 后付费用需要用户知晓并确认，但不暂停当前施工。
3. 预付费用必须暂停施工，待用户确认并支付成功后继续。
4. 施工中可选择继续施工或改天上门；选择改天上门后沿用前述释放和再次到场规则。
5. 已经形成的用户确认、支付结果和历史记录不得因改天上门而丢失或倒退。

4. 待上门时间展示

选择改天上门后，用户订单列表、师傅接单列表、派单员列表和师傅服务订单列表均应显示红色“上门时间”，其值为师傅设置的下次上门时间；再次到场后不再按待上门提示展示。

六、费用明细、材料和记录修订

费用类型

类型	主要内容	支付方式
服务费	金额、备注	后付
上门费	金额、备注；与下单时初始上门费不是同一收费事实	后付
师傅代购材料费	金额、购买清单图、备注	可选预付或后付
后台材料库费用	选择材料、规格和数量，由系统按权威材料及规格复原	可选预付或后付

后台配置只决定是否显示材料库入口；关闭后仍不影响已有材料费用事实。材料名称、规格、单位和价格由后端根据材料及规格标识复原，不能只信任前端传入的文字和金额。

记录修改规则

1. 用户确认前，师傅可以从该条工单记录重新进入修改。
2. 修改形成新版本，历史事实不被覆盖；记录列表只展示当前有效版本，避免用户看到重复记录。
3. 用户确认后、进入支付后或工单已提交完工后，该条记录只读。
4. 已提交完工时，即使施工中费用尚未确认，也不允许再修改原记录；如确需调整，应通过异常处理或重新履约形成新事实。
5. 用户当前没有“驳回费用”按钮。存在异议时先不确认，与师傅沟通，由师傅在允许修改阶段调整后再确认。

七、完工、费用确认与支付入口

1. 施工完成时，师傅直接提交施工后说明、照片和最终费用，不再选择施工安排；仍需改天上门时应继续走施工中记录。

2. 师傅提交完工后立即释放占用，并停止修改此前履约记录。

3. 尚有待确认或待支付费用时，工单显示“已提交完工”，不能提前显示订单完成。

4. 用户按一条服务记录确认其关联费用；前端可提供明确的一键确认全部待确认项，后端仍逐条校验和记录结果。

5. 用户订单详情的入口固定显示“去支付”，不使用“确认费用”等容易产生歧义的按钮名称：

   • 存在待确认费用时，点击后先进入费用确认页；
   • 没有待确认费用，且存在有效、金额大于零、尚未支付的费用时，点击后进入支付；
   • 不存在可处理费用时不显示按钮。

6. 预付款确认后必须支付才能解除施工门禁；后付费用可在施工结束后统一处理。

7. 全部有效费用处理完毕后，工单和订单进入“已完成”。

八、支付、取消与退款

支付

1. 系统按当前可支付费用创建或复用收款单，并永久冻结本次收款所包含的收费项。
2. 小程序调起微信支付。用户完成支付后正常提示“支付成功”并刷新订单，不显示增加认知负担的“支付结果确认中”。
3. 业务最终结果以微信有效通知和项目收款事实为准，不能只依赖客户端支付成功提示。
4. 上门费支付成功后创建首张工单；施工预付款成功后解除施工门禁；完工尾款结清后推进订单完成。

接单前取消

1. 师傅正式接单前，用户可以取消订单。
2. 没有已支付费用时直接取消。
3. 存在已支付费用时，按原成功收款、原收费项和本次退款金额精确创建退款，可支持多张收款单拆分及部分退款事实。
4. 全部应退退款成功后，统一取消订单和工单；尚有退款处理中时继续冻结，不能提前显示取消完成。

退款后的资金处理

• 退款仍在处理中时保留清晰可追踪状态。
• 退款成功后，已经产生的结算、师傅压款、钱包收益和分销结果按原订单资金事实冲正。
• 若可用余额不足以完成自动冲正，退款成功事实仍保留，资金差额进入授权管理人员复核，不伪装成退款失败。

九、订单结算、分账、钱包和统计

1. 订单和工单均已完成、没有有效阻塞、没有待支付费用且至少存在一张成功收款单时，系统生成唯一订单结算。
2. 结算依据为订单创建时冻结的分配关系、已确认收费项、成功收款和成功退款净额。历史结算生成后不可因新配置而重算覆盖。
3. 师傅收益先进入压款余额，到期后自动或在合适业务入口幂等释放为可提现余额。
4. 邀请人、业务员和合伙人收益按冻结关系进入微信分账；明确失败按规则进入钱包兜底，长期未知进入授权人工复核。
5. 平台收益和支付手续费进入统一结算事实。
6. 师傅端个人中心和收益明细应按新结算、压款、钱包及退款冲正事实展示净收益。
7. 用户端分销中心的角色、累计收益和明细应读取同一套分销关系及订单结算事实。
8. 管理后台、接口统计和对账均读取同一权威资金事实；统计只是展示结果，不能反向控制支付、退款或结算。
9. 订单资金处理自动触发，不要求客户手工执行自定义业务命令。

十、通知

1. 订单、派单、报价、支付、退款、结算和发票等业务完成后，由统一通知入口生成通知事实。
2. 通知标题、摘要、正文、结构化详情、时间和操作按钮均使用当时已发布模板渲染并保存快照，后续修改模板不改变历史消息。
3. 站内信按用户端或师傅端身份生成独立收件记录，跳转到对应小程序及页面。
4. 同一业务场景不分别维护两套正文；站内信、小程序订阅消息和服务号消息复用统一内容，再按渠道配置投递。
5. 当前未启用的外部微信渠道不生成虚假投递结果；站内信仍应正常可见。

十一、发票与红字处理

1. 订单完成且存在可开票金额时，用户按整张订单申请发票，不自行勾选收费项或填写开票金额。
2. 系统自动按“成功收款减成功退款”计算当前可开票金额，并冻结本次全部可开票收费项明细。
3. 同一订单存在“待处理”“处理中”或“已开票”申请时，不允许重复申请。
4. 管理人员可在开票前取消或驳回，释放本次申请占用；开票后保存发票号码、时间和电子文件，用户可查看或下载。
5. 全部金额已退款时不显示开票入口。
6. 已开票收费项后续退款成功时，系统自动生成关联原发票、退款单、收费项和金额的红字处理任务。
7. 因退款红冲的金额不恢复可开票额度；因抬头等开票错误完成红字修正后，未退款的有效交易额度可以重新申请。

十二、客户验收清单

序号	验收场景	预期结果	结果
1	普通入口下单	来源显示为平台自然来源	□通过 □不通过
2	好友或合作方入口下单	订单冻结正确来源及分配参与人	□通过 □不通过
3	无前置上门费下单	直接生成待接工单	□通过 □不通过
4	有前置上门费下单	先显示待支付上门费，支付后生成工单	□通过 □不通过
5	不匹配服务项目的师傅查看抢单	不显示该工单	□通过 □不通过
6	匹配师傅正常抢单	唯一抢单成功并进入待上门	□通过 □不通过
7	未超时工单由派单员查看	不进入派单员可操作范围	□通过 □不通过
8	超时后派单员接管	暂时退出公共范围，可续期或放回	□通过 □不通过
9	派给不匹配服务项目的师傅	系统拒绝	□通过 □不通过
10	被派师傅接受或拒绝	接受后待上门；拒绝后按规则回流	□通过 □不通过
11	师傅提交到场	系统时间不可改、照片必填、说明可选	□通过 □不通过
12	首次报价无预付款	用户确认后进入施工	□通过 □不通过
13	首次报价有预付款	用户确认并支付后进入施工	□通过 □不通过
14	报价后选择改天上门	释放师傅，列表显示上门时间	□通过 □不通过
15	未确认报价时再次到场	恢复已到场，仍阻塞施工	□通过 □不通过
16	已确认且无待付预付款时再次到场	恢复施工中	□通过 □不通过
17	施工中新增后付费用	用户待确认，施工不停	□通过 □不通过
18	施工中新增预付费用	确认并支付前暂停施工	□通过 □不通过
19	用户确认前师傅修改记录	产生新版本，只展示当前有效版本	□通过 □不通过
20	用户确认或进入支付后修改记录	记录只读，不能覆盖历史	□通过 □不通过
21	师傅提交完工但有待处理费用	显示已提交完工，不提前完成	□通过 □不通过
22	订单详情点击去支付	有待确认先确认；否则进入支付	□通过 □不通过
23	支付上门费、预付款、尾款	分别解除对应门禁并推进业务	□通过 □不通过
24	接单前取消且无已付款	订单和工单直接取消	□通过 □不通过
25	接单前取消且有已付款	原路退款全部成功后取消	□通过 □不通过
26	订单完成	生成一次不可覆盖的订单结算	□通过 □不通过
27	师傅查看收益和明细	净收益、压款和退款冲正一致	□通过 □不通过
28	分销参与人查看收益	身份、累计金额及明细与订单结算一致	□通过 □不通过
29	各关键业务动作完成	对应端收到正确站内消息并可正确跳转	□通过 □不通过
30	完成订单申请发票	按整单自动计算额度并提交成功	□通过 □不通过
31	全额退款订单申请发票	不显示申请入口	□通过 □不通过
32	已开票后退款	生成正确红字处理任务	□通过 □不通过