光宇天数池工单系统需求文档
阅读入口
一、产品概述与业务边界
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 主流程
查看流程图原文
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 全局规则
- 项目固定光宇天数池,渠道固定APP;业务任务、工单、消息、通知事件分别使用稳定标识。
- 新建办理工单先进入KA待认领。认领后,普通资料齐全和安全工单直接进入办理,普通待补录工单补全并校验通过后进入办理。补录沿用原工单,建议收集由KA执行「登记归档」。
- 商家五项档案自动带入,字段独立展示;商家身份、创建操作人、业务目标和KA责任人不得混用。
- 服务端校验数据权限、城市、目标关系、资料、当前状态和版本;前端隐藏入口不能代替鉴权。
- 结果必须有实际依据;已通知、已认领、已完成、已到账分别表达,不互相替代。
- 超时、未回复、通知失败不代表已解决,不自动完结。
- 补录、转派、等待不重置本轮时效;重开增加办理轮次,保留上一轮结果。
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。建议独立为已收集、已归档,不套用办理主状态。通知独立区分待发送、排队、接口受理、送达、失败、未知。历史成功工单的归档仅为归档标记,不新增办结轮次。
查看流程图原文
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 完结与结果
提交完结由服务端验证:
- 操作者是当前认领的KA处理人,具有对应城市、业务及完结权限,工单处于跟进中且版本有效。安全事件城市未明时,按全局安全兜底授权校验。
- 普通业务商家档案、目标关系及场景资料满足要求;实际操作由有权人员执行并有真实结果。
- 处理结果摘要非空,实际办理事实及凭据可追溯,不能只写已转交或正在处理。
- 客诉有核实记录、处理结论及后续安排;通用人工有分诊、后续安排、处理结果及依据;安全有实际处置记录、风险核实及安全完结依据、后续安排。安全完结校验聚焦处置结果和依据,商家档案与普通业务资料按需补充。
- 通知内容无未替换变量、越权敏感信息和无依据的到账承诺。
成功后一次性保存本轮办结事件、操作者、时间、结果及凭据引用并可靠生成通知。失败保留输入,不记办结;通知失败不撤销已真实完成的业务,也不能显示商家已收到。未受理和人工关闭是非成功办结,均需原因及依据;人工关闭仅管理授权人员可执行,不以资料不足代替未受理。
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重新登录流程,越权请求不返回工单详情。
- 从欢迎页、有效会话、记录列表及失效会话均能进入「我的工单」。返回时恢复来源、滚动位置及草稿。
- 原会话唯一匹配时展示当前状态、最新进展时间和摘要,点「查看进度」进入与固定入口一致的详情。多笔先选择,未关联时引导固定入口。
- 会话过期后历史只读,原消息不变。通过固定入口仍可看到同一工单过期后更新的进展、补充要求和结果。
- 四个筛选、八种话术场景及时间取值逐项验收。未受理及已关闭分别展示,重开保留原单号和历史结果,通知失败不影响读取实际已完成的结果。
- 验证授权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 验收标准
- 后台和APP仅展示本期13类业务,字段独立、五项档案自动读取,二级暂存手机号条件必填及授权校验一致。
- 按3.5.2逐项验收四条路径:普通资料齐全由KA认领后直接办理;普通待补录由KA认领并补全校验后办理同一张工单,未校验通过时办理入口不可用;安全工单认领后在资料不全时也可办理;建议收集只执行「登记归档」。
- 多城市不默认取首项,确定后交该城市KA;未知城市有KA兜底,越权城市不可办理。
- 认领须原子校验,未认领不可内部补录或办理;角色切换和权限失效不保留越权入口。
- 重开保留原单及原KA,回待认领,新轮重新认领,历史结果及统计不被覆盖。
- 完结按3.5.3,重复完结不增加轮次事件;建议和归档不计成功办结,跨期重开按3.11.1计算。
- 校验13类模板的工单标签及适用时限。常规认领4个工作小时,客诉、安全和转人工认领1个工作小时,建议16个工作小时登记归档。安全即时通知KA,认领后即可处置并记录实际进展,最终按3.5.3校验实际处置和风险核实依据。
- 校验8个或16个工作小时的目标完成时间及建议归档截止,等待期间持续按相应口径计时。截止前2个自然小时对未结束事项只提醒一次,办结、已归档和无固定完成截止事项不发送该提醒。发送失败不记为送达。
- 手机固定标题及操作栏,表单屏内滚动,最后字段、错误及键盘下的当前输入可见。
- 校验不在本期范围的入口、状态、动作和专用字段均不可调用;服务端与界面规则一致。
- 商家侧两条查询路径、24小时后只读、授权隔离、状态话术和异常反馈按3.12.5验收。
- 后台「业务办理看板」位于「业务工单」上方,可查询按办结期统计的指标。KA APP原型移除业务办理看板页面及入口。
- 按同一筛选和列表顺序验证两种导出范围。从非首页发起、调整每页条数或改变筛选后,前N页仍从第1页计算;超出可导出页数时提示,空列表不生成文件。
5.2 开发依赖
上线前确认真实商家档案映射、KA城市人员和值班兜底、企业工作日历、通知回执与故障恢复、原值存储权限、容量及保留规范。已有历史数据按内部映射保留追溯,不在新建表单恢复旧业务。试点验证认领、补录、重开、轮次统计及安全通知的端到端证据后开放相应能力。