You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
13 KiB
13 KiB
预检取号列表「一键体检 / 智能提醒」数据需求分析
视角：产品经理（现场导税作业，不以技术方案为先）
依据：参考图中进厅人员表格的 一键体检、智能提醒 两列，对照当前紫云智能导税 PAD「预检取号」能力。
说明：图中栏名为「一键体检」；现场口头常称「一键提醒」。本文按图中展示内容定义需求，统一称为 一键体检。
本文只说明 要什么数据、为什么要、怎么用，不涉及源代码。
1. 要解决什么问题
导税员在取号前需要 3～5 秒内 判断：
- 这个人/关联企业有没有风险、欠申报、违法违章，要不要先提醒再办？
- 这个人是什么身份标签、历史上评价好不好，沟通时要注意什么？
当前 PAD 预检列表只有核验结果、票号、健康报告入口，列表内看不到结构化风险摘要和历史服务画像。健康报告是整页外链，不适合作为「一眼扫描」信息。
图中两栏的产品价值是：把报告结论压成列表摘要，把详情留给点击下钻。
2. 列表栏位定义（对照参考图）
| 栏位 | 现场用途 | 展示形态 | 是否必须可点 |
|---|---|---|---|
| 一键体检 | 税务/合规风险扫描摘要 | 多行短文案 + 颜色预警 | 是，点开看明细 |
| 智能提醒 | 人员标签 + 历史服务评价画像 | 多行短文案 | 建议可点，看评价明细 |
不合规辅导（图中另有一列）不在本次范围。
3. 身份主键：先对齐「查谁」
两栏都不是排队系统自己能算出来的，必须先锁定 自然人身份，再关联企业和历史办税记录。
3.1 查询主键（必选）
| 数据项 | 说明 | 当前 PAD 是否已有 |
|---|---|---|
| 身份证号 | 自然人唯一检索键；列表已脱敏展示，接口侧需明文或安全令牌 | 有（idCard） |
| 姓名 | 辅助核对，防串人 | 有 |
| 实名核验记录 UID | 对应本次进厅/核验流水，便于追溯「哪一次进厅」 | 有（uid） |
| 手机号 | 用于短信提醒、评价匹配辅助 | 有（可能为空，采集后才有） |
3.2 建议补齐的关联键
| 数据项 | 为什么需要 |
|---|---|
| 纳税人识别号 / 统一社会信用代码列表 | 一人多户，体检要按「关联企业」汇总 |
| 人员身份类型 | 自然人 / 办税员 / 中介 / 代理记账，影响提醒话术和权限 |
| 实名采集状态 | 图中姓名旁「已采集 / 未采集」；未采集时部分金三数据可能查不到 |
| 本次进厅时间 / 票号 | 把体检结果挂在「这一次进厅」上，避免和历史进厅混淆 |
产品结论： 没有可靠身份证号，这两栏应显示「暂无法体检 / 暂无提醒」，而不是空白让导税员误以为「没问题」。
4. 「一键体检」需要什么数据
产品目标：用 3～6 条短句 回答「这个人关联的企业现在健不健康」。
4.1 列表摘要（每行必出）
| 摘要项 | 参考图文案 | 所需底层数据 | 展示规则建议 |
|---|---|---|---|
| 关联企业户数 | 「2户关联企业」 | 该身份证作为法人/财务/办税员/股东等角色关联的企业数量 | 0 户时写「无关联企业」 |
| 风险预警分色户数 | 「预警: 1户红色」「预警: 3户蓝色」 | 每户风险等级（红/黄/蓝/绿或局方标准色）及户数 | 只展示非绿色的汇总；多种颜色分行或同行分隔 |
| 未处理违法违章条数 | 「12条未处理违法违章」 | 未办结/未处理的违法违章记录数 | 0 可不展示或灰字「无违法违章」 |
| 未申报条数 | 「1条未申报」 | 当期或历史未申报税种/申报任务数 | 需约定统计口径：本期未申报 vs 全部未申报 |
以上四项是图中 最低可交付摘要。没有这四项，栏位无法复现参考效果。
4.2 点击下钻（导税真正要看的）
列表只给结论。点「一键体检」后，至少要能看到：
| 分组 | 需要的数据 | 用途 |
|---|---|---|
| 关联企业清单 | 企业名称、税号、登记状态、与该人的关系（法人/财务负责人/办税员等） | 确认提醒对象是哪几户 |
| 分户风险 | 每户风险色、风险标签名称、风险产生时间、是否已处置 | 决定红户是否优先辅导 |
| 违法违章明细 | 违法类型、文书号/编号、发生日期、处理状态、所属税种 | 告知纳税人「还有哪些没处理」 |
| 申报情况 | 税种、所属期、申报期限、申报状态（未申报/已申报/逾期） | 提醒当期该报未报 |
| 可选增强 | 欠税余额、非正常户、注销办理中、发票异常、信用等级 | 大厅高频问询，可二期 |
4.3 口径必须产品拍板的问题（否则研发会对不齐）
- 关联企业范围：只算法人，还是办税员、财务负责人、股东都算？图中有「21户关联企业」，更像是全角色汇总。
- 预警颜色标准：红/蓝对应局方哪套风险模型（税收风险、信用、还是大厅自定义）？
- 未申报时间窗：本征期、近 12 个月，还是全部历史？
- 未处理违法违章：是否含已送达未缴款、听证中、复议中？
- 一人多证/曾用名：是否按历史证件合并？
这些不定，数据源给了也没法验收。
4.4 数据源（产品侧依赖，不指定实现）
通常来自税务核心或外挂风控，而不是排队叫号库：
- 金税三期 / 电子税务局：登记、申报、违法违章
- 风险/信用系统：红黄蓝预警
- 现有「健康报告」页：可能已有部分结论，但 HTML 报告 ≠ 列表结构化字段，需要单独的摘要接口
当前 PAD 仅有「按身份证换健康报告 URL」，不能直接支撑列表摘要。
5. 「智能提醒」需要什么数据
产品目标：告诉导税员 这个人是谁、过去在大厅体验如何，避免对差评客投诉式沟通、对专业服务人员用错话术。
5.1 列表摘要（每行必出）
| 摘要项 | 参考图文案 | 所需底层数据 | 展示规则建议 |
|---|---|---|---|
| 人员标签 | 「标签: 涉税专业服务人员」 | 标签编码 + 标签名称，可多个 | 无标签显示「暂无标签」；多个时取优先级最高的 1～2 个 |
| 评价次数 | 「评价: 20次」 | 历史有效评价总次数 | 0 次显示「暂无评价」 |
| 最低评价 | 「最低评价: 非常满意 / 不满意」 | 历史最低一档评价等级 | 无评价则不展示该行 |
| 分档次数 | 「非常满意: 18次」「基本满意: 1次」「不满意: 1次」 | 各评价档位计数 | 与大厅评价器档位对齐 |
图中档位至少包括：非常满意、基本满意、不满意。需与现有窗口评价器档位（如 0～6 星或三档/五档）做 映射表，否则列表文案和窗口评价对不上。
5.2 点击下钻
| 需要的数据 | 用途 |
|---|---|
| 标签全量列表及来源（系统打标 / 人工打标） | 解释为什么是「专业服务人员」 |
| 评价明细：时间、大厅、窗口、票号、档位、是否文字评语 | 判断差评是否偶发 |
| 最近一次差评原因（若有） | 导税话术准备 |
| 可选：历史办税频次、常办业务类型 | 主动分流（如常来代开） |
5.3 口径必须产品拍板的问题
- 评价统计范围：本大厅、本市、全省？跨大厅是否共享？
- 时间窗：全部历史还是近 1 年？
- 最低评价：取最低档，还是近 N 次中的最低？
- 标签来源：金三职业资格、实名身份、大厅自定义？谁维护、谁能改？
- 未实名 / 未采集：能否出标签和评价？建议不能则明确提示。
5.4 数据源
- 排队叫号：窗口评价器回写的票号评价（本系统相对可控）
- 统一身份 / 实名：人员标签
- 可能还有局方纳税人画像平台
当前票号详情已有「单票评价」，但 没有按身份证汇总的历史评价画像，智能提醒栏无法只靠单票数据完成。
6. 列表接口应返回的最小数据包（产品验收用）
建议在预检核验列表 每条记录上附带摘要对象，避免导税员一屏 10 人再打 20 次外部查询。
6.1 一键体检摘要 healthSummary
| 字段含义 | 类型 | 必填 |
|---|---|---|
| 是否可体检 | 是/否 | 是 |
| 不可体检原因 | 文案（无身份证/未采集/接口失败） | 否 |
| 关联企业户数 | 数字 | 可体检时必填 |
| 红色预警户数 | 数字 | 可体检时必填 |
| 蓝色预警户数 | 数字 | 可体检时必填 |
| 其他色预警户数 | 数字（若有黄/橙） | 否 |
| 未处理违法违章条数 | 数字 | 可体检时必填 |
| 未申报条数 | 数字 | 可体检时必填 |
| 摘要生成时间 | 时间 | 建议有，避免过期数据 |
颜色名称按局方标准扩展，不要写死只有红蓝。
6.2 智能提醒摘要 smartReminder
| 字段含义 | 类型 | 必填 |
|---|---|---|
| 是否可生成提醒 | 是/否 | 是 |
| 主标签列表 | 名称数组（最多 2 个用于列表） | 否 |
| 评价总次数 | 数字 | 是（可为 0） |
| 最低评价档位 | 枚举文案 | 有评价时必填 |
| 各档位次数 | 档位→次数 | 有评价时必填 |
6.3 性能与时效（产品约束）
| 约束 | 建议 |
|---|---|
| 列表刷新 | 预检页约 15 秒静默刷新，摘要必须能批量带出或短缓存 |
| 超时 | 单行外部画像超过 1～2 秒则该行显示「体检生成中/失败」，不能拖死整表 |
| 缓存 | 同一身份证当日可缓存摘要；取号成功或采集成功后应刷新 |
| 失败 | 明确「查询失败」与「查询成功但无风险」两种空态，禁止都显示成空白 |
7. 交互与权限（数据之外但影响要哪些字段）
| 点 | 产品要求 | 对数据的影响 |
|---|---|---|
| 点击摘要 | 打开详情（可用现有健康报告页，或新做成结构化详情） | 详情接口需要企业清单、明细列表 |
| 红户是否阻断取号 | 若「先辅导再取号」，需要风险等级字段做前端提示，不必直接禁点取号 | 至少要有最高风险色 |
| 脱敏 | 列表不展示完整税号、法人手机；详情可按权限展示 | 列表用脱敏，详情用完整 |
| 日志 | 导税员点开体检/提醒应可审计 | 需要操作人、纳税人身份证哈希、时间 |
8. 与现有 PAD 能力的差距
| 现有能力 | 能否支撑两栏 | 缺口 |
|---|---|---|
| 预检核验列表（姓名/身份证/手机/票号/核验结果） | 只能提供查询主键 | 无风险摘要、无评价汇总 |
| 健康报告 URL | 可作「下钻详情」候选 | 不是结构化摘要，不能直接铺进表格 |
| 窗口评价（按票号） | 是评价明细的数据来源之一 | 缺按人汇总、缺最低评价、缺分档计数 |
| 实名采集状态 | 影响能否查到金三数据 | 需在摘要里体现「未采集则无法体检」 |
9. 分期建议（便于排期）
P0（没有这些，栏位不成立）
- 身份证号可用时，返回关联企业户数、分色预警户数、未处理违法违章数、未申报数
- 按人汇总：评价次数、最低档、分档次数
- 两种空态：无法查询 / 查询成功无数据
- 列表批量带摘要，保证刷新不卡
P1
- 点击进入分户风险和企业清单
- 人员标签
- 与健康报告详情打通（摘要 + 原报告）
P2
- 欠税、非正常户、发票异常等扩展指标
- 差评原因、常办业务
- 红户取号前提示话术模板
10. 验收标准（产品可用）
对照参考图，同一纳税人在列表中应能同时看到类似信息：
- 一键体检：
N户关联企业+预警: X户红色 / Y户蓝色+M条未处理违法违章+K条未申报（无则按空态文案） - 智能提醒：
标签: xxx+评价: N次+最低评价: xxx+ 各档次数
点开后能核对企业清单或评价明细；无身份证或未采集时有明确原因，不出现「空白=没问题」。
11. 需要业务/局方确认的清单（开会用）
- 「一键体检」官方栏名是否沿用图中名称，还是改成「一键提醒」
- 关联企业统计角色范围
- 预警色标准与数据提供系统
- 未申报、违法违章的时间窗与状态范围
- 评价是否跨大厅汇总、档位如何映射
- 标签由谁维护
- 列表摘要是否允许展示具体条数（有的局方只允许「有/无」）
- 详情是否继续用现有健康报告页，还是大厅自建结构化页
以上 8 条不确定，接口字段无法定稿。