光宇天数池工单系统需求文档V3.6

光宇天数池工单系统需求文档

阅读入口

项目 内容
需求版本 V3.6
更新日期 2026-11-19
适用范围 光宇出行APP、既有补仓系统内光宇天数池模块
阅读对象 系统部、后台与APP研发、机器人研发、测试、KA负责人
规则依据 业务范围、工单标签、认领与提醒时限、城市路由、重开、办结统计及商家工单进度查询规则

一、产品概述与业务边界

1.1 背景与目标

在现有补仓工单系统内承接商家通过APP智能助手提出的办理诉求,支持授权KA代创建。资料、责任、进度、实际结果和通知可追溯,后台及APP读取同一服务端状态。每次独立请求有稳定任务编号;重复消息、补录、催办、重开不得生成重复工单。

1.2 建设范围

本期包含13类业务模板,按3.2.1归为5种工单标签:9类常规工单,建议、客诉、安全及转人工工单各1类。常规、客诉和转人工共用普通办理流程:资料齐全时创建待认领工单,KA认领后直接办理;资料不全时创建待补录工单,KA认领并补全资料后办理同一张工单。安全工单直接待认领,认领后即可办理,补充资料按需进行。建议生成收集记录,由KA执行「登记归档」。

全部业务责任由KA项目组承担,按实际业务城市匹配城市KA负责人。工单业务配置仅管理员可用,KA只显示业务工单入口。业务工单统一列表包含办理工单和建议记录;待补录为普通工单的资料状态筛选,流转记录只在详情内查看。

1.3 与原系统的关系

复用登录、组织权限、列表、附件、通知和时间线中可用的能力,不预设新建物理系统或数据库。原补仓业务保持独立,光宇办理不套用柜组、空仓、在柜、差值、补货计划及电池目标量等字段。页面继续采用原补仓系统的蓝色操作、深色后台侧栏和APP白色卡片风格。

1.4 名词说明

名词 定义
业务任务 一次独立请求,贯穿采集、工单、补录、结果和重开
工单 已持久化且有KA承接责任的办理记录,主状态与资料状态分别记录
待补录工单 普通办理所需资料尚不完整的工单。创建时主状态为待认领,认领后主状态为跟进中,资料通过校验前处于补录环节
KA负责人 对本次业务城市及工单办理负责的授权KA人员
办理轮次 首次办理为第1轮,每次重开增加1轮,不增加工单数
办结 一轮处理结束,包括成功完成、未受理和非成功人工关闭
成功办结率 在统计期结束处理的全部办理轮次中,成功完成的占比

二、产品流程与全局规则

2.1 主流程

业务处理主流程
G A 商家提出诉求 B 识别诉求类型 A->B S 立即安全提示并通知KA B->S 紧急安全事件 F 保存建议收集记录 B->F 建议收集 D 读取商家档案并采集业务资料 B->D 普通业务办理 C 直接回答或说明业务范围 B->C 无需登记 S1 创建安全工单 直接待认领 S->S1 S2 KA认领安全工单 S1->S2 S3 直接办理安全工单 补充资料可选 S2->S3 M 回填实际结果及依据 S3->M F1 KA登记归档 F->F1 E 必填资料齐全并校验通过 D->E E->D 未齐且未达建单条件 G 创建普通待认领工单 E->G 是 H 创建待补录工单 主状态待认领 E->H 否且触发建单 I KA认领普通工单 G->I L 进入工单办理 I->L L->M I1 KA认领待补录工单 H->I1 K 核实补全原单资料 I1->K K->L 校验通过 K1 记录缺项并继续补录 K->K1 仍缺项 K1->K N 按3.5.3完结 生成结果通知 M->N O 商家反馈未解决 N->O Q 保留本轮办结及通知记录 O->Q 否 R 原单重开 原KA负责人 第N加1轮 O->R 是 R1 原单回到待认领 按本轮规则办理 R->R1
查看流程图原文
flowchart TD
 A[商家提出诉求] --> B{识别诉求类型}
 B -->|紧急安全事件| S[立即安全提示并通知KA]
 S --> S1[创建安全工单 直接待认领]
 S1 --> S2[KA认领安全工单]
 S2 --> S3[直接办理安全工单 补充资料可选]
 B -->|建议收集| F[保存建议收集记录]
 F --> F1[KA登记归档]
 B -->|普通业务办理| D[读取商家档案并采集业务资料]
 B -->|无需登记| C[直接回答或说明业务范围]
 D --> E{必填资料齐全并校验通过}
 E -->|未齐且未达建单条件| D
 E -->|是| G[创建普通待认领工单]
 G --> I[KA认领普通工单]
 I --> L[进入工单办理]
 E -->|否且触发建单| H[创建待补录工单 主状态待认领]
 H --> I1[KA认领待补录工单]
 I1 --> K[核实补全原单资料]
 K -->|校验通过| L
 K -->|仍缺项| K1[记录缺项并继续补录]
 K1 --> K
 S3 --> M[回填实际结果及依据]
 L --> M[回填实际结果及依据]
 M --> N[按3.5.3完结 生成结果通知]
 N --> O{商家反馈未解决}
 O -->|否| Q[保留本轮办结及通知记录]
 O -->|是| R[原单重开 原KA负责人 第N加1轮]
 R --> R1[原单回到待认领 按本轮规则办理]

本期办理工单按业务城市匹配KA负责人,城市未知时按3.3.1进入KA兜底。普通资料未齐时按3.4.1的收集触发规则创建待补录工单。安全提示和KA通知即时触发,安全资料缺项可在处置过程中按需记录或补充。既有工单触发安全线索时,按3.3.3沿用原工单。建单或通知失败保留事件、原因及恢复入口,按实际结果反馈商家。

2.2 全局规则

  1. 项目固定光宇天数池,渠道固定APP;业务任务、工单、消息、通知事件分别使用稳定标识。
  2. 新建办理工单先进入KA待认领。认领后,普通资料齐全和安全工单直接进入办理,普通待补录工单补全并校验通过后进入办理。补录沿用原工单,建议收集由KA执行「登记归档」。
  3. 商家五项档案自动带入,字段独立展示;商家身份、创建操作人、业务目标和KA责任人不得混用。
  4. 服务端校验数据权限、城市、目标关系、资料、当前状态和版本;前端隐藏入口不能代替鉴权。
  5. 结果必须有实际依据;已通知、已认领、已完成、已到账分别表达,不互相替代。
  6. 超时、未回复、通知失败不代表已解决,不自动完结。
  7. 补录、转派、等待不重置本轮时效;重开增加办理轮次,保留上一轮结果。

2.3 全局交互

列表返回保留筛选和滚动位置。提交防重,失败保留输入并显示原因。有未保存内容时离开提示。条件必填实时联动并由服务端复核;空白文本不视为已填写。敏感数据默认脱敏,无权原文与附件不下发。页大小、导出容量沿用宿主有效规范。

三、功能需求

3.1 角色、权限与数据范围

角色 主要能力 限制
商家 提出请求、补充本人材料、查询、催办、反馈未解决 仅本人及授权对象,不操作内部工单办理
城市KA负责人、KA处理人 认领、核实、补录、办理、组内转派、回填、完结及建议归档 按授权城市及队列;没有配置管理权限
KA备岗、项目组负责人 承接异常、人员失效及超时兜底;管理授权范围内人工关闭 不扩大商家和城市数据权限
系统管理员 模板、人员路由和时效配置,发布、启停及配置导出 管理身份不自动授予业务办理权
机器人服务账号 请求登记、创建、资料追加、状态查询、催办事件 不代替KA认领、办理、填报结论或完结

商家层级、城市范围及代理关系由可信登录和档案提供,用户自报不能授予权限。一级商家可以代理获授权二级商家的暂存配置;二级商家直接申请开票、暂存或担保修改时给予联系上游商家的指引,不假装已进入正常办理。

3.2 业务模板与字段规则

3.2.1 模板清单

工单标签 业务类型 可提出者 承接方式
常规工单 申请新商户 商家 业务城市KA负责人认领办理
常规工单 子账号开通 商家 业务城市KA负责人认领办理
常规工单 开票申请 一级商家 业务城市KA负责人认领办理
常规工单 修改商家暂存配置 一级商家 业务城市KA负责人认领办理
常规工单 修改商家担保方式 一级商家 业务城市KA负责人认领办理
常规工单 非待激活状态充值错误退回 商家 业务城市KA负责人认领办理
常规工单 骑手逾期金额免除 商家 业务城市KA负责人认领办理
常规工单 电池丢失 商家 业务城市KA负责人认领办理
常规工单 骑手归属车行查询 商家 业务城市KA负责人认领办理
建议工单 建议与需求反馈 商家 KA登记归档,无需认领
客诉工单 客诉争议 商家 业务城市KA负责人认领办理
安全工单 紧急安全事件 商家 KA安全紧急队列认领
转人工工单 通用转人工 商家 业务城市KA负责人认领办理

系统按生效的业务模板确定标签,并随工单或建议记录保存。认领与归档时限按标签匹配3.10.2。普通待补录工单沿用业务模板标签,待补录仍是资料状态。既有工单切换为安全紧急模式时,当前按安全工单标签执行,原标签留痕。

3.2.2 业务采集字段

下表是业务资料,不替代3.2.4的商家档案。普通业务必填资料不足时按3.4.1创建待补录工单,认领后补全。安全事件执行3.3.3的直接认领办理路径。未通过资格与授权的申请保留真实原因,继续受实际办理限制。

模板 需向用户收集的必填、条件槽位 自动关联说明或场景选填项(通用必填另见3.2.4) 校验与边界
申请新商户 业务员姓名、业务员手机号、渠道名称、渠道类型、签约主体、负责人姓名、负责人手机号、负责人身份证号 商家五项身份信息由系统自动带入 渠道类型:车行、站点、个人;签约主体:公司、个人;手机号11位数字;身份证18位;不增加营业执照统一必填
子账号开通 姓名、手机号、身份证号 所属商家ID、名称等由系统关联;属于办理条件必填,缺失交KA补全,不要求用户填写内部ID 手机号11位数字;身份证18位,不能改为后六位
开票申请 订单号、订单截图、付款截图至少一种;发票类型、企业名称、企业税号、电话号码、开户银行、地址 银行账户号码为场景选填;通用商家档案按第3.2.4节自动带入并校验 企业电话允许固定电话,不能统一按11位手机校验;不新增采购单号、开票金额作为统一前置必填
修改商家暂存配置 目标账户类型、修改后的暂存方式;目标为二级账户时必填目标二级商家手机号 当前主账户沿用商家档案;不同二级目标按手机号校验授权并关联。申请商家电话不能替代目标电话 一级商家可代理授权二级商家。选择二级时手机号标必填并校验11位数字;空值、非数字或长度错误标为待补录,认领补全前不得办理或普通完结;修改当前一级账户不要求该号码
修改商家担保方式 修改后的担保方式 当前商家沿用五项自动档案;不同目标商家按授权关系另行关联五项档案,不向用户索取内部ID 可选方式与实际商家系统一致;不强制增加原方式和变更原因为前置字段
非待激活状态充值错误退回 骑手手机号 订单状态与退款依据由有权人员查询核实 仅此模板承接非待激活状态;待激活先提供已有自助指引,仍无法处理则按原任务人工承接
骑手逾期金额免除 骑手手机号 逾期费用、订单及免除依据由人工核实 业务语义为逾期金额免除,不把逾期天数、担保方式或原因新增为统一前置必填
电池丢失 骑手手机号、骑手免押方式 设备、订单与定位信息按权限查询或后补 仍由KA收口;设备编号不是首次登记的统一前提
骑手归属车行查询 骑手手机号 订单和车行关系由授权人员查询 返回查询结果前校验查询者与目标骑手信息的访问权限
建议与需求反馈 业务场景、具体功能需求或期望效果 原始描述、会话引用与附件 开放式描述;保存为需求收集记录,不承诺排期和实现结果

未明确的业务枚举、金额范围、资料长度上限及实名真实性能力,须由实际业务接口确认,不将样例作为正式约束。

3.2.3 场景处理字段

场景 首次采集 KA办理及完结要求
客诉争议 问题经过为核心项;争议点选填;不清楚时创建待补录 核实记录、处理结论、后续安排分别填写,无后续明确记录无需后续
紧急安全事件 已知情况、关键词、收到时间及来源;无用户前置必填 认领后直接办理,商家档案和业务缺项按需补充。完结按3.5.3记录实际处置、风险核实依据及后续安排
通用转人工 待解决问题、原因、原任务及已收信息 人工分诊、KA后续安排、实际处理结果及依据,不以已转交作为成功完成

事发时间与是否仍在发生分别存储;设备、电池、订单编码分别存储。通用人工原业务模板名称和版本由系统关联,不向用户索取内部编码。

不需人工办理的政策说明等直接回答。待激活充值错误优先使用现有自助路径,失败后按原任务人工承接;定位及骑手信息查询须校验访问权限。不将未纳入本期的业务借通用人工模板恢复为实际业务流程。

3.2.4 商家五项自动档案

字段 字段名 来源及校验
商家ID merchant_id 档案读取、只读,不手工编造
商家姓名 merchant_name 档案读取、非空;KA核实修正留存依据及前后值
电话 merchant_contact_mobile 档案读取、11位数字,展示脱敏
城市范围 merchant_city_ids 完整非空集合,不默认取第一项
账户层级 merchant_account_level 档案读取,按可信层级校验业务资格

申请人就是商家,不再另设一组申请人或联系人资料。五项是普通业务实际办理和完结的完整性条件;缺项创建待补录,不能以未知或空字符串当作完整。创建人、时间和KA操作人单独审计。

3.2.5 业务目标与城市

为当前商家办理时不重复显示目标商家资料。修改二级商家暂存时,目标账户选二级后,其手机号显示必填标识,校验11位数字及代理关系,关联目标商家五项档案;发起商家电话不能替代目标电话。未关联或超权不得办理。新商户尚未存在时不伪造目标ID。

本次业务城市由授权业务对象解析,唯一城市自动带入;多城市不能默认取首项,不能唯一解析时由用户确认或KA核实。目标必须在授权城市范围,确定后交对应城市KA负责人。城市不明先进入KA兜底待认领,安全提示及KA紧急通知不延迟。

3.2.6 补全及审计

KA只能在授权范围内核实姓名、电话及当前工单资料快照,不自动修改商家主档。ID、城市范围和账户层级等可信绑定由档案服务修复。普通待补录工单补全后在原单重新校验,保留原值、来源、依据、操作者及时间。安全资料按需在原单补充,确实无法取得时可记录核实情况。

3.2.7 字段及必填标识

所有字段独立显示。必填明确区分建议收集保存、实际业务办理和完结阶段;不把不向用户采集等同于选填。条件必填随目标类型或凭据组联动。企业电话允许固定电话,不按手机号格式统一拦截。附件失败不误记完整;订单号、订单截图、付款截图满足至少一项即可,不另增统一采购单号要求。

3.2.8 建议及待补录详情

建议使用统一详情,展示商家档案、场景、期望效果、原文、附件、提交及归档人和时间。已收集记录提供「登记归档」操作,执行后进入已归档。归档幂等,归档后仍可查询,不显示认领、办理或完结按钮。

普通待补录工单展示资料缺项及来源,主状态可以是待认领或跟进中。KA认领后进入补录环节,补全并校验通过后,原工单进入办理环节。安全工单的可选缺项仅作为资料信息展示,不进入普通待补录分支。

3.3 KA承接、城市路由与安全处理

3.3.1 责任规则

收口组固定KA项目组。根据本次业务城市匹配有效城市KA负责人及候选人员;人员须具备该城市和相应安全队列权限。承接负责人和当前认领处理人分别记录。安全缺城市走KA全局安全兜底,普通缺城市走KA全局兜底。

3.3.2 人员与转派

配置适用城市、业务范围、城市负责人、候选人、备岗、兜底、通知账号及生效期。人员失效不能静默清空责任,由KA管理责任人显式接管。组内转派仅限有该城市授权的KA,填写原因,原编号、资料及累计等待不变;转派生效后进入新责任人待认领。城市核实变更需重新校验授权并转接该城市KA。

重开正常由原KA负责人重新认领重办,普通处理人不得借转派改变这一规则;原负责人失效时由KA管理负责人有依据地接管并留痕。

3.3.3 安全事件

任何阶段出现安全线索立即提示和通知KA。新安全工单直接以「待认领」创建,资料缺失或城市未明时由相应安全队列或全局安全兜底承担,授权KA认领成功后直接进入办理。商家档案和业务缺项可在处置中按需补充,无需先完成补录或等待商家回复。

原业务已有工单时沿用原工单和任务,记录风险触发时间并切换安全紧急模式。已有具备相应权限的KA认领时可直接处置;需要更换承接人时,原单进入安全队列待认领。安全处置与原申请办理结果分别记录,原申请继续办理时仍遵循其业务规则。

3.4 采集、创建与补录

3.4.1 采集与创建

普通业务创建持久任务,读取商家档案和可授权的目标关系,保存原文、附件及来源。已有信息不重复询问。连续2次收集后必填仍不全、连续2次提取失败,或从首次持久登记起满24个自然小时仍未齐全时,按最先发生的条件创建待补录工单,主状态为待认领。首次主动提问不计一次失败,用户的有效回应缺项记一次,重复投递不计新轮次。

普通业务资料齐全并校验通过时,直接创建普通待认领工单。超时仍保留原资料,晚到补充关联原任务及工单。授权KA代建可直接保存普通待补录工单。安全事件立即提示并通知KA,按3.3.3直接进入安全待认领。建议保存为已收集记录,进入「登记归档」路径。

3.4.2 幂等及异常

按项目、任务和操作幂等键防止重复建单;消息ID去重。同一会话不同目标是独立请求,同一任务补录和重开不是新请求。疑似重复只提示KA核实关联,保留原编号。

工单服务不可用时保留可靠登记事件与KA兜底,状态明确待同步或失败,恢复后关联原任务,不报告虚假建单成功。

3.4.3 附件

追加保存文件元信息、任务引用、上传人、时间、权限及实际上传状态,不覆盖原材料。唯一有效凭据上传失败时资料不完整;有替代有效凭据可继续。无关消息不自动入单,关联不明先确认。附件及会话访问须单独鉴权。

3.5 状态、办理与完结

3.5.1 状态模型

主状态 含义与出口
pending 待认领 已持久化、有KA承接或兜底;KA认领后进入跟进中
following 跟进中 KA已认领。普通待补录工单先补录,普通资料齐全及安全工单可直接办理,按实际结果办结
resolved 已完成 本轮业务成功完成;未解决可重开至待认领
rejected 未受理 经KA核实不符合范围或资格,记录依据及用户指引
closed 人工关闭 KA管理授权的例外关闭,记录非成功性质和原因,不记成功

资料状态独立为complete、incomplete、unverified。建议独立为已收集、已归档,不套用办理主状态。通知独立区分待发送、排队、接口受理、送达、失败、未知。历史成功工单的归档仅为归档标记,不新增办结轮次。

工单状态流转
G start pending pending start->pending 创建普通、待补录或安全工 单 following following pending->following KA原子认领 following->pending KA组内转派后待认领 following->following 普通待补录先补齐 安全可 直接办理 resolved resolved following->resolved 满足3.5.3并回填真实 结果 rejected rejected following->rejected 核实未受理并记录指引 closed closed following->closed KA管理人员例外关闭并记 非成功 resolved->pending 原KA负责人重开 新一轮 待认领
查看流程图原文
stateDiagram-v2
 [*] --> pending: 创建普通、待补录或安全工单
 pending --> following: KA原子认领
 following --> following: 普通待补录先补齐 安全可直接办理
 following --> pending: KA组内转派后待认领
 following --> resolved: 满足3.5.3并回填真实结果
 following --> rejected: 核实未受理并记录指引
 following --> closed: KA管理人员例外关闭并记非成功
 resolved --> pending: 原KA负责人重开 新一轮待认领

3.5.2 认领与办理

认领检查角色、城市、队列、状态及版本并原子更新,先成功者获得责任。浏览、商家补充材料和消息送达不触发认领。未认领时不能提交内部补录或办理写操作;商家仍可追加本人资料,但不能覆盖KA结论。

分支 创建或登记 KA操作及下一步
普通业务,资料齐全 创建待认领工单,资料状态为完整 点击「认领」,成功后进入跟进中,直接进入办理环节
普通业务,资料不全 创建待补录工单,主状态为待认领 点击「认领」,成功后进入跟进中并打开补录环节。核实补全且服务端校验通过后,启用原工单的办理操作。仍缺项时保留已填写的内容,继续补录
紧急安全事件 立即提示并通知KA,创建安全待认领工单 点击「认领」,成功后直接进入安全办理。允许按需补充资料,缺项不关闭办理入口
建议收集 保存已收集记录 点击「登记归档」,成功后显示已归档;无需认领

普通待补录工单在资料未通过校验前不得开始实际办理或成功完结。请求补充记录缺项、通知和责任,等待期间保留当前责任。办理与完结分别操作,回填实际进展和结果。重开保留原负责人、原单和历史结果,增加轮次,回到待认领;新轮时效从重开起算,总历时从首次收到起算。

3.5.3 完结与结果

提交完结由服务端验证:

  1. 操作者是当前认领的KA处理人,具有对应城市、业务及完结权限,工单处于跟进中且版本有效。安全事件城市未明时,按全局安全兜底授权校验。
  2. 普通业务商家档案、目标关系及场景资料满足要求;实际操作由有权人员执行并有真实结果。
  3. 处理结果摘要非空,实际办理事实及凭据可追溯,不能只写已转交或正在处理。
  4. 客诉有核实记录、处理结论及后续安排;通用人工有分诊、后续安排、处理结果及依据;安全有实际处置记录、风险核实及安全完结依据、后续安排。安全完结校验聚焦处置结果和依据,商家档案与普通业务资料按需补充。
  5. 通知内容无未替换变量、越权敏感信息和无依据的到账承诺。

成功后一次性保存本轮办结事件、操作者、时间、结果及凭据引用并可靠生成通知。失败保留输入,不记办结;通知失败不撤销已真实完成的业务,也不能显示商家已收到。未受理和人工关闭是非成功办结,均需原因及依据;人工关闭仅管理授权人员可执行,不以资料不足代替未受理。

3.6 后台工单工作台

光宇天数池菜单的「业务办理看板」位于「业务工单」上方,展示办理工单总量、成功办结、办结轮次、成功办结率、办理进度分布及主要业务类型。办结指标可按日期查询,按3.11.1计算。工单总量、办理进度分布及主要业务类型展示当前工单数据。

统一列表支持业务类型、主状态、资料状态、城市、当前KA、关键字筛选,安全优先排序。展示编号、创建时间、业务类型、城市、商家、KA负责人、当前处理人、主状态、资料状态及操作,独立列显示。建议可查详情和归档,待补录可查缺项并认领。无独立建议、待补录或流转列表页面。

详情分工单信息和流转记录,包含商家五项自动资料及来源、模板名称与版本、业务字段、附件、缺项、KA责任、本轮时效、进度、历史轮次和通知状态。按3.5.2提供认领后办理、补录或建议「登记归档」入口;安全详情在办理区保留按需补充操作。创建、保存进度、请求补充、提交完结、未受理、转派、催办、重开、管理关闭及通知重试按权限和状态显示。

完结统一引用3.5.3;补录不重复转单;日志可追加不可覆写。返回原列表保留筛选和位置,空数据说明暂无符合条件记录。

3.7 工单业务配置

3.7.1 入口及配置

仅管理员可进入或调用配置读写、启停、导出接口。KA只显示业务工单,直接访问配置链接须拒绝;管理权限失效即关闭配置页面并清理未保存内容。管理员身份不自动获得业务处理权。

列表仅展示业务类型、模板名称、模板版本及操作。管理员选择本期业务,填写名称,版本只读;适用城市、字段规则、KA人员及已确认时效在编辑内维护。可复制具名模板,新任务按生效匹配规则选择;同城市同业务多模板冲突需显式优先级,不靠前端顺序。

3.7.2 版本与追溯

状态为草稿、已启用、已停用。缺有效承接、备岗或兜底等必要配置不允许发布。实质修改发布递增版本,未变更不递增;历史工单保留创建时模板名称、版本、字段和规则快照。停用阻止新建命中,不隐藏历史工单。系统内部生成业务类型及模板唯一标识,页面和业务导出不显示编码,旧标识仅内部映射。

3.8 APP入口与手机交互

内部KA通过任务管理的业务工单统一列表认领和处理,数据列表沿用同一业务口径。办理统计在后台「业务办理看板」查看。商家通过智能助手提出请求,商家侧进度查询入口及规则见3.12。APP不提供配置管理。

KA办理原型采用390×844参考视口并适配实际可视区域:状态栏和标题固定,内容在屏内纵向滚动,一级页面保留底部导航;详情顶部返回、底部固定当前操作,不叠加一级导航。补录、办理和转派用手机内全屏表单,短城市选项用底部弹层。字段16px,触控区至少44px,键盘弹出后当前字段及错误可见。表单联动保留已填内容和滚动位置。

离线保存临时输入并提示未同步,重新进入读取服务端最新版本;并发冲突返回最新责任和状态,不能旧页面覆盖。详情内展示同一服务端时间线,返回保留列表筛选。

3.9 通知与结果回传

事件 接收对象 要求
创建及待补录 对应城市KA候选人员、负责人或KA兜底 保留真实投递状态
安全线索 KA安全值班、备岗及该城市KA负责人,未知城市全局安全兜底 立即触发,不等建单、资料或认领
请求补充 原商家 说明缺项并绑定原单
认领、转派、重开 相应KA责任人员 重开指向原KA负责人
办结 原商家 按实际结果通知,不将未受理或人工关闭描述为成功
目标完成前提醒 3.10.4定义的当前处理人或KA承接人员 有完成或归档截止时间且尚未结束时,于截止前2小时提醒一次
技术故障 系统维护人和KA兜底 技术告警不替代业务责任

可靠保存通知事件、渠道、目标、模板版本、尝试及回执。接口受理不等于送达,只有真实回执可标送达。内部人工通知按现有APP失败重试2次后进入已验证的内部兜底通道;结果回传的重试退避由通知接口规范确认,不混用未经验证次数。重试沿用事件ID,不增加工单。原会话不可达保留待通知及授权重试入口,商家仍可通过3.12的固定入口查看已记录的办理进展与结果。

3.10 时效、提醒与催办

3.10.1 日历与计时

以下为本期确认默认规则,配置和工单保留策略版本。凡表中标为工作小时的时限,按中国标准时间周一至周五09:00—12:00、13:00—18:00计算,每日8小时,节假日及调休使用企业日历。日历缺失时展示待配置并通知维护。安全认领按工作小时计算,即时提示、通知和认领后的安全进展按连续自然时间计算。

本期不提供人工暂停或延期操作。等待商家、系统恢复或内部核实持续计时,记录原因和下一跟进时间;工作日历扣除非工作时段不是暂停。转派、补录、催办不重置本轮时间。重开启动新轮次,保留旧轮截止、超时及办结事件;总历时不重置。

3.10.2 采集及阶段目标

工单标签 阶段 时限 起止与动作
常规工单、客诉工单、转人工工单 普通业务资料采集 连续2次收集不完整或提取失败,最长24个自然小时 按3.4.1,最先触发的条件创建待补录工单
常规工单 工单认领 4个工作小时 本轮创建或重开进入KA队列至认领成功
客诉工单 工单认领 1个工作小时 本轮创建或重开进入KA队列至认领成功
安全工单 工单认领 1个工作小时 新建或重开进入KA安全队列至认领成功。已有工单切换为安全模式且需要重新认领时,从进入安全待认领起算
转人工工单 工单认领 1个工作小时 本轮创建或重开进入KA队列至认领成功
建议工单 登记归档 16个工作小时 从收到建议到KA登记归档,无需认领

3.10.3 各业务目标与安全时效

业务 内部办理目标
申请新商户、开票、非待激活充值错误退回、电池丢失、客诉、通用人工 每轮起点后16工作小时,包含认领等待
子账号、暂存配置、担保方式、逾期金额免除、骑手归属查询 每轮起点后8工作小时,包含认领等待
建议收集 收到后16工作小时内归档,单独统计

上述是KA内部办理目标,不作为到账保证,不自动关闭未处理事项。

安全阶段 时效及动作
安全提示 首次识别后立即
KA通知 端到端P95小于30秒,以可核验接收端证据衡量,不以入队代替
KA认领 按3.10.2,从进入安全待认领起1个工作小时内
首次核实及进展记录 从本轮安全认领成功起30个自然分钟内。已有授权处理人直接处置时,从切换为安全紧急模式起算
持续进展 未结案每1个自然小时记录进展,从上一条有效进展起算
最终结案 不设统一强制风险解除时间,按3.5.3实际核实及处置依据判断

安全提示和通知在识别风险后即时触发。KA值班须覆盖全天,认领后按3.3.3直接处置。安全结案按实际核实及处置依据判断。

3.10.4 到期提醒及催办

系统的到期提醒和自动催办合并为一次通知,统一在目标完成时间前2小时触发。先按3.10.3及企业日历算出具体的办理完成或建议归档截止时间,再从该时刻倒推2个自然小时。例如目标完成时间为15:00,提醒时间为13:00。

触发时的状态 提醒对象及处理
办理工单未办结,已认领 提醒当前KA处理人及城市KA负责人
办理工单未办结,尚未认领 提醒KA候选人员及城市KA负责人。无明确城市时通知对应KA兜底
建议尚未归档 提醒负责登记归档的KA
办理已结束或建议已归档 跳过本次提醒
安全工单无固定完成截止 无法安排截止前提醒,按3.3.3即时提示并通知KA

同一工单同一轮次或同一建议记录只生成一次到期提醒。发送前核验当前目标截止和状态,失败按原事件重试,办结或归档后停止发送。各阶段记录实际进展及超期状态,系统仅安排目标完成或归档截止前的一次定时提醒。商家及授权KA可按实际需求在原单主动发起催办,重复提交复用同一来源事件。主动催办及到期提醒均不重置目标时间、不增加办理轮次。

3.11 统计、导出与批量边界

3.11.1 指标定义

成功办结率 = 统计期内成功完成的办理轮次数 ÷ 统计期内全部办结的办理轮次数 × 100%。按有效办结时间落入区间计数,不按新建时间截取。成功、未受理、非成功人工关闭进入分母;仅成功进入分子。建议归档、未办结、成功后归档不进入分母;分母为0显示暂无数据。

工单总量按ticket_id去重,包含待补录工单,不包含建议记录。办结量按ticket_id与cycle_no去重,重复提交不新增事件。待认领和待补录分别是主状态与资料维度,可以重叠,不能相加为互斥总数。

重开保留上一轮历史办结,增加新轮并回待认领。11月办结、12月重开不回改11月统计;12月再次办结计12月新轮,工单量仍是一张。同周期多轮分别计入办结次数,界面明确单位为轮。安全、常规可分开统计;建议单独展示归档量和归档时长。

同时展示重开量(期内发生重开的独立工单数)与重开事件次数;重开率以统计期办结事件中,在期末前至少被再次重开的轮次数/该期办结轮次数计算,按统计截止时点展示,不与成功办结率混用。通知受理、送达、失败和未知分别计数,统计先做数据权限过滤。

3.11.2 导出及批量

「业务工单」的「导出当前列表」支持「全部当前筛选结果」和「前N页」。两种范围均按发起导出时的用户权限、已应用筛选、时间范围及列表排序执行。「前N页」从第1页开始,按当前每页条数计算,N为不超过筛选结果总页数的正整数。弹窗展示筛选记录数、每页条数、总页数和预计导出条数。结果为空时提示无数据可导出。

导出默认脱敏,访问原值须单独授权、登记用途并留痕。超出单次容量时提示减少筛选范围或选择更少的页数,保留原筛选,不静默截断。导出任务提供进度、失败原因及受限下载,容量与文件有效期按宿主规范。首期逐单办理。

3.12 光宇智能助手商家工单进度查询

商家可在有效的原会话中询问办理进度,也可从「我的工单」主动查看。两条路径根据同一工单编号读取工单服务的最新状态、进展和结果。原会话失效或通知未送达时,固定入口仍可查询当前账号有权查看的工单。

3.12.1 入口与原型

入口路径为光宇出行APP → 选择商家 → 商家端 → 光宇智能助手 → 我的工单 → 工单详情。「我的工单」位于白色顶栏下方的快捷操作区,欢迎页与「记录」并排,会话和记录页与左侧的「首页」或「记录」对齐。在欢迎页、有效会话、记录列表和失效会话只读详情均可进入。入口固定在消息滚动区域上方,保留独立触控区;从工单列表返回时恢复进入前的页面、阅读位置及未发送草稿。

商家侧界面沿用验收截图里的白色顶栏、机器人头像、对话气泡、记录卡片和底部输入区。原型使用440×956参考视口,实际页面适配宿主设备。下列链接为独立商家侧原型,使用演示工单。

3.12.2 会话查询与24小时失效

场景 处理规则
工单已创建 仅在工单服务确认持久化成功后,原会话展示业务名称、工单编号和「查看进度」。仍在同步或创建失败时按3.4.2提示实际状态
原会话有效且唯一匹配 根据原会话和业务任务查找当前账号有权查看的工单。回复当前状态、最新进展时间和一句进展摘要,附「查看进度」打开该工单详情
原会话匹配多笔 展示匹配单据的业务名称、提交时间和工单编号,供商家选择。选中后进入对应工单详情
无可关联工单 引导进入「我的工单」。新会话没有关联任务时,询问历史工单进度也走固定入口;查询请求不触发创建工单、转派或催办
原会话已失效 由助手服务端按24小时会话有效性判断。原对话只读,保留原文和原时间,隐藏输入区。底部显示「该会话已失效,工单仍可查看」,点「前往我的工单」进入固定列表
直接进入「我的工单」 使用当前APP登录态和商家上下文获取工单,无需打开历史会话、输入工单号或向助手提问

会话有效期用于判断能否续接原会话。工单按自身权限和数据保留规则查询,资料收集时效及工单办理时效各按既有规则计算。历史回复保留当时的状态和时间,打开工单详情时读取最新数据。

3.12.3 列表、详情及权限

页面或规则 要求
我的工单 显示当前商家有权查看的业务办理工单,包括归属本商家的授权KA代建工单。默认「全部」,另有「办理中」「待补充」「已结束」筛选。按最近一次商家可见的进展时间倒序,无进展取提交时间。建议与需求反馈按原规则收集和归档,不纳入办理工单列表
工单卡片 展示业务名称、工单编号、办理城市、提交时间、当前状态、最新进展时间和摘要,点卡片进入详情
工单详情 展示工单信息、与列表一致的状态、最新进展及商家可见时间线。待补充时展示缺项和指引;办结时展示办理结果或原因及适用的后续指引。返回时保留列表筛选和滚动位置
对外时间线 仅展示商家可见的事件,如已提交、已开始办理、商家补充要求、可公开进展、办结结果和重新办理。实际进入办理环节时才记录「已开始办理」。重开沿用原单号,详情保留上一轮可见结果,列表仍为一条
服务端鉴权 列表、详情及会话查询均按登录账号、当前商家和授权对象校验。单号或深链接不能授予权限;切换商家清理旧列表、详情及会话查询结果的展示缓存。商家接口不得下发内部备注、认领与转派明细、考核时效、未授权附件或敏感原文

3.12.4 商家可见状态与会话话术

会话回复按「当前状态」「最新进展时间」「一句进展摘要」展示,末尾附「查看进度」。时间取与摘要对应的商家可见事件时间;内部更新或通知重试不改写对外时间。

工单状态或事件 商家状态 对应筛选 最新进展时间取值 助手话术
已创建,待KA认领 已提交 办理中 工单创建成功时间 您的{业务名称}申请已提交,正在等待处理。
KA已进入办理环节 办理中 办理中 最近一次可展示的进展时间,无更新时取实际开始办理时间 您的{业务名称}申请正在办理,{已核实的最新进展}。
本轮已向商家提出补充要求,仍待提供 待补充 待补充 本次补充要求发出时间 请补充{缺少的资料},以便继续办理您的{业务名称}申请。
商家已提交补充资料,待KA核实 按当前办理阶段显示 办理中 补充资料保存成功时间 已收到您补充的{资料名称},接下来将核实资料。
原单重开,待认领或重新跟进 重新办理中 办理中 原单重开时间,有后续可展示进展时取最新进展时间 您的{业务名称}申请已重新进入办理流程,仍可用原工单编号查看进度。
已成功完结 已完成 已结束 实际办结时间 您的{业务名称}申请已办理完成,{实际办理结果}。
核实后未受理 未受理 已结束 未受理决定记录时间 经核实,您的{业务名称}申请因{具体原因}未能受理,{后续指引}。
人工关闭 已关闭 已结束 工单关闭时间 本次{业务名称}工单已关闭,关闭原因为{具体原因}。

先展示本轮办结结果。普通未结束工单仍需商家补件时,优先展示「待补充」;其余按重开、待认领或跟进中的办理阶段展示。安全工单仅缺可选补充资料时显示当前办理状态,按需展示补充提示。仅内部待补录且当前无需商家行动时,同样展示对应办理状态。资料确已保存、仍需KA核实且商家无其他待补充项时,使用「已收到」话术,按当前阶段显示「已提交」「办理中」或「重新办理中」。内部转派不单列商家状态,已公开进展继续可查。

模板变量使用工单服务返回的商家可见数据。普通待补录工单已认领、仍在核实资料且无需商家行动时,摘要显示「正在核实资料,核实后继续办理」。已进入办理环节但暂无可展示的新进展时,回复「您的申请正在办理」,使用最近一次可展示的进展时间。未受理仅在有明确后续办法时追加指引,已完成仅展示实际办理结果。

开票查询回复示例:

当前状态 办理中
最新进展时间 11月18日14:20
已核实您提交的发票抬头和税号,正在办理开票。
查看进度

3.12.5 异常反馈与验收

仅在列表查询成功且无记录时显示空态。接口或网络异常显示「进度暂时无法获取」和重试入口;仍有当前商家的授权缓存时标明上次更新时间。登录失效走宿主APP重新登录流程,越权请求不返回工单详情。

  1. 从欢迎页、有效会话、记录列表及失效会话均能进入「我的工单」。返回时恢复来源、滚动位置及草稿。
  2. 原会话唯一匹配时展示当前状态、最新进展时间和摘要,点「查看进度」进入与固定入口一致的详情。多笔先选择,未关联时引导固定入口。
  3. 会话过期后历史只读,原消息不变。通过固定入口仍可看到同一工单过期后更新的进展、补充要求和结果。
  4. 四个筛选、八种话术场景及时间取值逐项验收。未受理及已关闭分别展示,重开保留原单号和历史结果,通知失败不影响读取实际已完成的结果。
  5. 验证授权KA代建工单正常归属,切换商家及直接访问越权单号时不串单。空态、失败重试、缓存时间及登录失效状态可区分。

四、数据、接口与非功能需求

4.1 安全与审计

身份及权限可信获取,附件、原文、导出与所有写接口单独鉴权。日志及通知脱敏,必要原值加密受限存储。更正、认领、转派、重开、完结、配置、原值查看及导出记录操作者、原因、前后值、时间及版本,不覆盖历史。保留周期、原值存取、附件有效期遵循公司已确认规范,未确认能力不得默认开放。

4.2 关键数据字段

字段 类型 规则
business_project、source_channel enum 光宇天数池、APP
business_task_id、source_event_id、message_id string 原任务关联及去重
ticket_id string 工单唯一,补录、转派、重开不变
business_type_id、template_id、template_version string 系统内部标识及创建快照,不显示编码
ticket_tag enum 按3.2.1保存模板标签,用于匹配认领或归档时限。安全模式切换保留原标签记录
merchant_id/name/contact_mobile/city_ids/account_level 独立字段 3.2.4五项规则,不拼成一个字段
target_merchant_context object 不同目标时按授权关联,普通自身办理不重复展示
business_city_id、owner、assignee、fallback_owner string 业务城市、负责KA、当前认领者、KA兜底分开保存
fields、missing_fields、profile_snapshot、field_sources object/array 自动和采集缺项分别记录、保存来源及版本
status、info_status enum 主状态与资料状态独立
cycle_no、cycle_started_at、cycle_ended_at、cycle_outcome int/time/enum 办理轮次稳定记录,唯一约束ticket_id加cycle_no
first_received_at、created_at、claimed_at、reopened_at time 总历时与本轮时效分别计算
handling_records、result_summary、attachments object/text/array 实际依据、结果及文件引用
sla_policy_version、calendar_version、phase_due_at string/object 策略与日历版本,分别记录认领、目标完成或归档截止。提醒时刻由完成或归档截止倒推2小时
waiting_reason、next_followup_at text/time 等待不暂停,记录原因与跟进
notification_events、notification_status array/enum 实际尝试和回执,事件幂等
row_version、updated_at int/time 乐观锁与修改时间

4.3 逻辑数据及接口

可映射已有工单底座,不预设物理表。至少具备模板版本、采集任务、工单、办理轮次事件、KA路由与人员、受限附件、通知及不可覆写审计。新轮办结不覆盖旧轮结果,重试复用轮次事件ID。

身份档案接口返回五项资料、代理关系、城市及来源版本;工单接口提供创建、认领、补录、转派、进度、完结、重开及时间线;机器人仅调用受限登记查询接口;通知中心提供渠道与实际回执;APP会话提供原任务结果展示;文件服务处理授权上传下载。关键响应包括业务结果、稳定编号、最新状态和版本、缺项、错误原因、可重试性,HTTP成功不代替业务成功。

商家侧查询复用工单服务,提供授权范围内的列表、详情和原会话关联查询。服务端返回按3.12筛选后的状态、进展时间、摘要、适用的缺项或结果指引及可见时间线。会话关联以服务端验证的会话、业务任务和工单关系为准,APP和机器人按同一状态映射展示。

4.4 异常处理

普通资料未齐按3.4.1创建待补录工单,城市不明由KA兜底。安全缺项或城市不明按3.3.3进入安全队列,安全工单服务故障仍执行提示与KA通知并可靠保存事件,恢复后关联。认领并发冲突返回最新责任人及版本;人员失效由KA管理负责人接管;实际业务失败继续跟进并保留原因;通知失败独立重试不更改结果;重开原负责人失效走KA兜底,不留空责任;无权请求拒绝且不返回敏感原文。

4.5 性能、容量与分析

安全通知沿用P95小于30秒目标,记录接收端证据。列表、写入、附件容量及导出阈值按宿主标准和实际压测确认。并发测试覆盖认领、补录、转派、办结和重开幂等。采集、创建、认领、补录、进度、重开、轮次办结、通知和配置事件包含任务、工单、轮次、城市、角色、时间及结果,不写敏感明文。企业日历和值班配置须在上线前核实,原型的本地日历与模拟通知不能当作真实接口验收结果。

五、验收与能力启用

5.1 验收标准

  1. 后台和APP仅展示本期13类业务,字段独立、五项档案自动读取,二级暂存手机号条件必填及授权校验一致。
  2. 按3.5.2逐项验收四条路径:普通资料齐全由KA认领后直接办理;普通待补录由KA认领并补全校验后办理同一张工单,未校验通过时办理入口不可用;安全工单认领后在资料不全时也可办理;建议收集只执行「登记归档」。
  3. 多城市不默认取首项,确定后交该城市KA;未知城市有KA兜底,越权城市不可办理。
  4. 认领须原子校验,未认领不可内部补录或办理;角色切换和权限失效不保留越权入口。
  5. 重开保留原单及原KA,回待认领,新轮重新认领,历史结果及统计不被覆盖。
  6. 完结按3.5.3,重复完结不增加轮次事件;建议和归档不计成功办结,跨期重开按3.11.1计算。
  7. 校验13类模板的工单标签及适用时限。常规认领4个工作小时,客诉、安全和转人工认领1个工作小时,建议16个工作小时登记归档。安全即时通知KA,认领后即可处置并记录实际进展,最终按3.5.3校验实际处置和风险核实依据。
  8. 校验8个或16个工作小时的目标完成时间及建议归档截止,等待期间持续按相应口径计时。截止前2个自然小时对未结束事项只提醒一次,办结、已归档和无固定完成截止事项不发送该提醒。发送失败不记为送达。
  9. 手机固定标题及操作栏,表单屏内滚动,最后字段、错误及键盘下的当前输入可见。
  10. 校验不在本期范围的入口、状态、动作和专用字段均不可调用;服务端与界面规则一致。
  11. 商家侧两条查询路径、24小时后只读、授权隔离、状态话术和异常反馈按3.12.5验收。
  12. 后台「业务办理看板」位于「业务工单」上方,可查询按办结期统计的指标。KA APP原型移除业务办理看板页面及入口。
  13. 按同一筛选和列表顺序验证两种导出范围。从非首页发起、调整每页条数或改变筛选后,前N页仍从第1页计算;超出可导出页数时提示,空列表不生成文件。

5.2 开发依赖

上线前确认真实商家档案映射、KA城市人员和值班兜底、企业工作日历、通知回执与故障恢复、原值存储权限、容量及保留规范。已有历史数据按内部映射保留追溯,不在新建表单恢复旧业务。试点验证认领、补录、重开、轮次统计及安全通知的端到端证据后开放相应能力。