# 预检取号列表「一键体检 / 智能提醒」数据需求分析

> 视角：产品经理（现场导税作业，不以技术方案为先）  
> 依据：参考图中进厅人员表格的 **一键体检**、**智能提醒** 两列，对照当前紫云智能导税 PAD「预检取号」能力。  
> 说明：图中栏名为「一键体检」；现场口头常称「一键提醒」。本文按图中展示内容定义需求，统一称为 **一键体检**。  
> 本文只说明 **要什么数据、为什么要、怎么用**，不涉及源代码。

---

## 1. 要解决什么问题

导税员在取号前需要 **3～5 秒内** 判断：

1. 这个人/关联企业有没有风险、欠申报、违法违章，要不要先提醒再办？  
2. 这个人是什么身份标签、历史上评价好不好，沟通时要注意什么？

当前 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 口径必须产品拍板的问题（否则研发会对不齐）

1. **关联企业范围**：只算法人，还是办税员、财务负责人、股东都算？图中有「21户关联企业」，更像是全角色汇总。  
2. **预警颜色标准**：红/蓝对应局方哪套风险模型（税收风险、信用、还是大厅自定义）？  
3. **未申报时间窗**：本征期、近 12 个月，还是全部历史？  
4. **未处理违法违章**：是否含已送达未缴款、听证中、复议中？  
5. **一人多证/曾用名**：是否按历史证件合并？  

这些不定，数据源给了也没法验收。

### 4.4 数据源（产品侧依赖，不指定实现）

通常来自税务核心或外挂风控，而不是排队叫号库：

- 金税三期 / 电子税务局：登记、申报、违法违章  
- 风险/信用系统：红黄蓝预警  
- 现有「健康报告」页：可能已有部分结论，但 **HTML 报告 ≠ 列表结构化字段**，需要单独的摘要接口  

当前 PAD 仅有「按身份证换健康报告 URL」，**不能直接支撑列表摘要**。

---

## 5. 「智能提醒」需要什么数据

产品目标：告诉导税员 **这个人是谁、过去在大厅体验如何**，避免对差评客投诉式沟通、对专业服务人员用错话术。

### 5.1 列表摘要（每行必出）

| 摘要项 | 参考图文案 | 所需底层数据 | 展示规则建议 |
|--------|------------|--------------|----------------|
| 人员标签 | 「标签: 涉税专业服务人员」 | 标签编码 + 标签名称，可多个 | 无标签显示「暂无标签」；多个时取优先级最高的 1～2 个 |
| 评价次数 | 「评价: 20次」 | 历史有效评价总次数 | 0 次显示「暂无评价」 |
| 最低评价 | 「最低评价: 非常满意 / 不满意」 | 历史最低一档评价等级 | 无评价则不展示该行 |
| 分档次数 | 「非常满意: 18次」「基本满意: 1次」「不满意: 1次」 | 各评价档位计数 | 与大厅评价器档位对齐 |

图中档位至少包括：非常满意、基本满意、不满意。需与现有窗口评价器档位（如 0～6 星或三档/五档）做 **映射表**，否则列表文案和窗口评价对不上。

### 5.2 点击下钻

| 需要的数据 | 用途 |
|------------|------|
| 标签全量列表及来源（系统打标 / 人工打标） | 解释为什么是「专业服务人员」 |
| 评价明细：时间、大厅、窗口、票号、档位、是否文字评语 | 判断差评是否偶发 |
| 最近一次差评原因（若有） | 导税话术准备 |
| 可选：历史办税频次、常办业务类型 | 主动分流（如常来代开） |

### 5.3 口径必须产品拍板的问题

1. **评价统计范围**：本大厅、本市、全省？跨大厅是否共享？  
2. **时间窗**：全部历史还是近 1 年？  
3. **最低评价**：取最低档，还是近 N 次中的最低？  
4. **标签来源**：金三职业资格、实名身份、大厅自定义？谁维护、谁能改？  
5. **未实名 / 未采集**：能否出标签和评价？建议不能则明确提示。

### 5.4 数据源

- 排队叫号：窗口评价器回写的票号评价（本系统相对可控）  
- 统一身份 / 实名：人员标签  
- 可能还有局方纳税人画像平台  

当前票号详情已有「单票评价」，但 **没有按身份证汇总的历史评价画像**，智能提醒栏无法只靠单票数据完成。

---

## 6. 列表接口应返回的最小数据包（产品验收用）

建议在预检核验列表 **每条记录上附带摘要对象**，避免导税员一屏 10 人再打 20 次外部查询。

### 6.1 一键体检摘要 `healthSummary`

| 字段含义 | 类型 | 必填 |
|----------|------|------|
| 是否可体检 | 是/否 | 是 |
| 不可体检原因 | 文案（无身份证/未采集/接口失败） | 否 |
| 关联企业户数 | 数字 | 可体检时必填 |
| 红色预警户数 | 数字 | 可体检时必填 |
| 蓝色预警户数 | 数字 | 可体检时必填 |
| 其他色预警户数 | 数字（若有黄/橙） | 否 |
| 未处理违法违章条数 | 数字 | 可体检时必填 |
| 未申报条数 | 数字 | 可体检时必填 |
| 摘要生成时间 | 时间 | 建议有，避免过期数据 |

颜色名称按局方标准扩展，不要写死只有红蓝。

### 6.2 智能提醒摘要 `smartReminder`

| 字段含义 | 类型 | 必填 |
|----------|------|------|
| 是否可生成提醒 | 是/否 | 是 |
| 主标签列表 | 名称数组（最多 2 个用于列表） | 否 |
| 评价总次数 | 数字 | 是（可为 0） |
| 最低评价档位 | 枚举文案 | 有评价时必填 |
| 各档位次数 | 档位→次数 | 有评价时必填 |

### 6.3 性能与时效（产品约束）

| 约束 | 建议 |
|------|------|
| 列表刷新 | 预检页约 15 秒静默刷新，摘要必须能批量带出或短缓存 |
| 超时 | 单行外部画像超过 1～2 秒则该行显示「体检生成中/失败」，不能拖死整表 |
| 缓存 | 同一身份证当日可缓存摘要；取号成功或采集成功后应刷新 |
| 失败 | 明确「查询失败」与「查询成功但无风险」两种空态，禁止都显示成空白 |

---

## 7. 交互与权限（数据之外但影响要哪些字段）

| 点 | 产品要求 | 对数据的影响 |
|----|----------|----------------|
| 点击摘要 | 打开详情（可用现有健康报告页，或新做成结构化详情） | 详情接口需要企业清单、明细列表 |
| 红户是否阻断取号 | 若「先辅导再取号」，需要风险等级字段做前端提示，不必直接禁点取号 | 至少要有最高风险色 |
| 脱敏 | 列表不展示完整税号、法人手机；详情可按权限展示 | 列表用脱敏，详情用完整 |
| 日志 | 导税员点开体检/提醒应可审计 | 需要操作人、纳税人身份证哈希、时间 |

---

## 8. 与现有 PAD 能力的差距

| 现有能力 | 能否支撑两栏 | 缺口 |
|----------|----------------|------|
| 预检核验列表（姓名/身份证/手机/票号/核验结果） | 只能提供查询主键 | 无风险摘要、无评价汇总 |
| 健康报告 URL | 可作「下钻详情」候选 | 不是结构化摘要，不能直接铺进表格 |
| 窗口评价（按票号） | 是评价明细的数据来源之一 | 缺按人汇总、缺最低评价、缺分档计数 |
| 实名采集状态 | 影响能否查到金三数据 | 需在摘要里体现「未采集则无法体检」 |

---

## 9. 分期建议（便于排期）

### P0（没有这些，栏位不成立）

1. 身份证号可用时，返回关联企业户数、分色预警户数、未处理违法违章数、未申报数  
2. 按人汇总：评价次数、最低档、分档次数  
3. 两种空态：无法查询 / 查询成功无数据  
4. 列表批量带摘要，保证刷新不卡

### P1

1. 点击进入分户风险和企业清单  
2. 人员标签  
3. 与健康报告详情打通（摘要 + 原报告）

### P2

1. 欠税、非正常户、发票异常等扩展指标  
2. 差评原因、常办业务  
3. 红户取号前提示话术模板

---

## 10. 验收标准（产品可用）

对照参考图，同一纳税人在列表中应能同时看到类似信息：

- 一键体检：`N户关联企业` + `预警: X户红色 / Y户蓝色` + `M条未处理违法违章` + `K条未申报`（无则按空态文案）  
- 智能提醒：`标签: xxx` + `评价: N次` + `最低评价: xxx` + 各档次数  

点开后能核对企业清单或评价明细；无身份证或未采集时有明确原因，不出现「空白=没问题」。

---

## 11. 需要业务/局方确认的清单（开会用）

1. 「一键体检」官方栏名是否沿用图中名称，还是改成「一键提醒」  
2. 关联企业统计角色范围  
3. 预警色标准与数据提供系统  
4. 未申报、违法违章的时间窗与状态范围  
5. 评价是否跨大厅汇总、档位如何映射  
6. 标签由谁维护  
7. 列表摘要是否允许展示具体条数（有的局方只允许「有/无」）  
8. 详情是否继续用现有健康报告页，还是大厅自建结构化页  

以上 8 条不确定，接口字段无法定稿。