|
|
# 紫云智能导税 PAD 客户端 — 产品介绍
|
|
|
|
|
|
## 一、产品概述
|
|
|
|
|
|
**紫云智能导税**（tax-guidance）是一款面向办税服务大厅的 **PAD 端业务操作客户端**，由 uni-app 构建，支持 Android / iOS / HarmonyOS 等多端部署。产品以横屏大屏交互为主，为导税员、窗口人员及大厅管理人员提供 **预检取号、实名核验、票号管理、大厅监控与参数配置** 等一体化能力。
|
|
|
|
|
|
客户端通过公网统一网关对接 **紫云 HES 排队叫号系统（pad-api）**，采用 `tag + map` 标准化报文与 **HMAC-SHA256 签名校验**，保障业务请求安全、可追溯，适用于税务局办税服务厅、政务服务中心等场景。
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 产品名称 | 紫云智能导税 |
|
|
|
| 当前版本 | 1.0.0 |
|
|
|
| 运行形态 | PAD / 平板 App（横屏优先） |
|
|
|
| 技术栈 | uni-app + Vue 3 + TuniaoUI |
|
|
|
| 后端对接 | 紫云 HES 公网统一入口 `/public` |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 二、产品定位与价值
|
|
|
|
|
|
### 2.1 定位
|
|
|
|
|
|
办税大厅 **现场导税与排队业务的前台操作终端**，连接纳税人身份核验、业务取号、窗口调度与大厅运营数据，减少多系统切换，提升导税效率与大厅可视化管理水平。
|
|
|
|
|
|
### 2.2 核心价值
|
|
|
|
|
|
- **一站式导税操作**：首页聚合高频功能，大厅概况实时刷新，关键指标一目了然。
|
|
|
- **实名核验与取号联动**：核验记录查询、人脸结果展示、按业务直接取号，形成完整业务闭环。
|
|
|
- **大厅透明化运营**：窗口与自助机状态监控、系统参数在线维护，便于现场快速调整。
|
|
|
- **安全合规接入**：除登录外，业务请求统一签名；全链路 `traceId` 支持问题追踪与审计。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 三、适用对象与使用场景
|
|
|
|
|
|
| 角色 | 典型场景 |
|
|
|
|------|----------|
|
|
|
| 导税员 / 预审人员 | 纳税人信息登记、预检取号、查看核验结果与人脸照片 |
|
|
|
| 窗口管理人员 | 票号查询与导税、健康报告查看、预约签到 |
|
|
|
| 大厅管理员 | 大厅参数配置、窗口/设备状态监控、回签与优先取号 |
|
|
|
| 网格员 | 现场协调与辅助导税（功能入口预留扩展） |
|
|
|
|
|
|
**典型场景示例：**
|
|
|
|
|
|
1. 纳税人到厅 → 导税员在「预检取号」流程中录入信息 → 选择业务类型取号 → 打印或推送票号信息。
|
|
|
2. 已实名核验记录 → 在「预检取号」列表中按姓名/身份证/手机号查询 → 查看核验说明与人脸照片 → 一键取号。
|
|
|
3. 管理员查看「大厅概况」→ 进入大厅详情掌握窗口排队与设备空闲情况 → 在「大厅控制」中调整营业时间等系统参数。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 四、功能模块说明
|
|
|
|
|
|
### 4.1 登录与首页
|
|
|
|
|
|
**登录**
|
|
|
|
|
|
- 账号密码登录，对接 `pad.auth` 认证接口。
|
|
|
- 登录成功后保存 Token 与用户信息，进入智能导税首页。
|
|
|
|
|
|
**智能导税首页**
|
|
|
|
|
|
- **大厅概况**（左侧指标卡片，约 30 秒自动刷新）
|
|
|
- 当前等候人数
|
|
|
- 今日预约人数
|
|
|
- 空闲窗口数
|
|
|
- 空闲自助机数
|
|
|
- 点击任意指标可跳转「大厅详情」查看明细
|
|
|
|
|
|
- **功能入口**（右侧操作区）
|
|
|
- **预检取号**：进入实名核验与取号业务主流程
|
|
|
- **票号管理**：当日票号列表、筛选与导税操作
|
|
|
- **网格员**：网格员相关功能（可扩展）
|
|
|
- **信息推送**：消息推送能力
|
|
|
- **大厅控制**：大厅系统参数配置
|
|
|
- **回签优先**：票号回签与优先（插队）取号
|
|
|
- 部分入口为预留功能，便于后续版本扩展
|
|
|
|
|
|
- **用户区**：右上角显示当前登录人头像与姓名，支持退出登录。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.2 预检取号（核心业务）
|
|
|
|
|
|
路径：`预检取号` → 列表查询 → 取号 / 健康报告 / 预约签到
|
|
|
|
|
|
**实名核验记录查询**
|
|
|
|
|
|
- 支持按 **姓名、身份证号、手机号** 模糊查询；条件为空时可查询全部记录（分页）。
|
|
|
- 列表展示：姓名、身份证（脱敏）、手机号（脱敏）、核验结果、核验时间。
|
|
|
- **核验结果** 展示后端返回的 `baishuiResp` 文案（如人脸比对结果说明）。
|
|
|
- 支持 **查看照片**：弹窗展示 `faceImg` Base64 人脸抓拍图。
|
|
|
|
|
|
**取号**
|
|
|
|
|
|
- 点击「取号」→ 选择业务类型 → 调用取号接口。
|
|
|
- 若当前记录无手机号，先弹窗补录手机号再取号。
|
|
|
- 请求携带：业务 ID、身份证、姓名、手机号、核验记录 `uid` 等。
|
|
|
- 取号成功提示票号（如 `R0008`），并展示预计等候、办理窗口等信息。
|
|
|
|
|
|
**健康报告**
|
|
|
|
|
|
- 根据纳税人身份证获取健康报告 URL，在弹窗内嵌展示报告页面。
|
|
|
|
|
|
**预约签到**
|
|
|
|
|
|
- 查看预约信息（姓名、身份证、手机号、预约时间段）并确认签到。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.3 业务选择与取号（纳税人自助流程）
|
|
|
|
|
|
路径：信息录入 → 业务选择 → 确认取号
|
|
|
|
|
|
- 展示当前纳税人姓名，网格化展示可办 **业务类型列表**（接口动态加载）。
|
|
|
- 选择业务后确认取号，成功弹窗展示排队号码、业务类型、预计等候、办理窗口等。
|
|
|
- 支持打印小票、推送消息（按现场设备与后端能力对接）。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.4 票号管理
|
|
|
|
|
|
- 企业/个人用户 Tab、状态筛选（等候中、已完成、预约号等）。
|
|
|
- 支持时间、业务类型、票号关键字筛选。
|
|
|
- 列表展示企业名称、纳税人、票号及状态，支持 **导税** 跳转导税模块。
|
|
|
- 可查看 **税务健康检查报告**、票号详情弹窗。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.5 大厅详情（hallInfo）
|
|
|
|
|
|
- **窗口状态监控**：人工窗口列表，展示窗口名称、可办业务、当前票号、状态（空闲/忙碌等）、等候人数。
|
|
|
- **自助办税设备**：设备名称、使用状态（空闲/使用中/维护中）。
|
|
|
- 顶部 **刷新** 按钮，实时拉取监控数据。
|
|
|
- 数据来源于 `pad.window` 等排队系统接口。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.6 大厅控制（hallManagment）
|
|
|
|
|
|
- 以表格形式展示大厅 **系统参数**（参数名称、Key、当前值）。
|
|
|
- 支持弹窗编辑参数值（Key 与名称只读），修改前二次确认。
|
|
|
- 修改成功后自动刷新列表，对接 `pad.hallSystem` 参数维护接口。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.7 回签优先（sign-priority）
|
|
|
|
|
|
**回签**
|
|
|
|
|
|
- 输入或扫码票号，执行回签（复号）操作。
|
|
|
|
|
|
**优先取号**
|
|
|
|
|
|
- 按业务类型网格选择，生成优先（插队）票号。
|
|
|
|
|
|
---
|
|
|
|
|
|
### 4.8 其他模块
|
|
|
|
|
|
| 模块 | 说明 |
|
|
|
|------|------|
|
|
|
| 今日进厅 | 进厅数据统计与查询 |
|
|
|
| 今日预约 | 预约数据查询与管理 |
|
|
|
| 导税 | 从票号管理进入的导税辅助流程 |
|
|
|
| 信息推送 | 向纳税人推送排队/办理消息 |
|
|
|
| 网格员 | 网格员现场协作（持续建设） |
|
|
|
| 多合一 / 预留功能 | 版本规划中 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 五、系统架构与对接方式
|
|
|
|
|
|
### 5.1 部署架构
|
|
|
|
|
|
```
|
|
|
┌─────────────────┐ HTTPS ┌──────────────────┐ 内网 ┌─────────────┐
|
|
|
│ PAD 客户端 │ ──────────────► │ 公网统一网关 │ ───────────► │ HES pad-api │
|
|
|
│ (本客户端) │ POST /public │ (tag 路由) │ │ 排队叫号服务 │
|
|
|
└─────────────────┘ └──────────────────┘ └─────────────┘
|
|
|
│
|
|
|
▼
|
|
|
POST /api/sign
|
|
|
(HMAC-SHA256 签名)
|
|
|
```
|
|
|
|
|
|
- 客户端 **不直连** 内网 HES，统一访问公网 `/public` 入口。
|
|
|
- 网关根据 **`tag` + `map.path`** 转发至内网具体接口。
|
|
|
- 业务请求（除登录外）先调用签名服务获取 `signature`，再携带 `timestamp`、`nonce` 发起业务调用。
|
|
|
|
|
|
### 5.2 主要接口标签（Tag）
|
|
|
|
|
|
| Tag | 典型能力 |
|
|
|
|-----|----------|
|
|
|
| `pad.auth` | 登录、用户信息 |
|
|
|
| `pad.hallSystem` | 大厅概况、系统参数、监控指标 |
|
|
|
| `pad.business` | 业务类型、健康报告 |
|
|
|
| `pad.ticket` | 取号、票号列表、核验查询、回签、优先取号 |
|
|
|
| `pad.window` | 窗口与设备监控 |
|
|
|
| `pad.appointment` | 预约相关 |
|
|
|
| `pad.sign` | 请求签名计算 |
|
|
|
|
|
|
### 5.3 统一返回约定
|
|
|
|
|
|
- HTTP 200 且业务 `code === 200` 视为成功。
|
|
|
- 失败时客户端统一 Toast 提示，并在控制台输出详细错误日志便于排查。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 六、安全与可靠性
|
|
|
|
|
|
| 能力 | 说明 |
|
|
|
|------|------|
|
|
|
| 身份认证 | Bearer Token，登录接口免签名、免 Token |
|
|
|
| 请求签名 | HMAC-SHA256，参数深度排序后参与签名，防篡改与重放（含 timestamp、nonce） |
|
|
|
| 敏感信息展示 | 身份证、手机号列表脱敏显示 |
|
|
|
| 操作确认 | 参数修改、预约签到等关键操作二次确认 |
|
|
|
| 链路追踪 | 每次请求自动生成 `traceId`，便于与网关、后端日志关联 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 七、终端与体验设计
|
|
|
|
|
|
- **横屏布局**：`pages.json` 全局配置横屏，适配办税大厅 PAD 支架与柜台场景。
|
|
|
- **大屏触控**：功能按钮分区明确，色块区分业务类型，降低误触。
|
|
|
- **固定顶栏**：业务子页面顶栏固定，返回与刷新操作始终可见。
|
|
|
- **自动刷新**：首页大厅概况定时刷新，管理人员无需手动刷新即可掌握现场态势。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 八、技术规格摘要
|
|
|
|
|
|
| 类别 | 说明 |
|
|
|
|------|------|
|
|
|
| 框架 | uni-app（Vue 3 Composition API） |
|
|
|
| UI 组件 | TuniaoUI、uni-ui |
|
|
|
| 状态与存储 | 本地 Storage（Token、userInfo） |
|
|
|
| 网络封装 | 统一 `request` 模块（签名、错误处理、Loading） |
|
|
|
| 目标平台 | Android App、iOS App、HarmonyOS（按 uni-app 工程配置） |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 九、版本规划说明
|
|
|
|
|
|
当前版本 **1.0.0** 已具备登录、首页概况、预检取号、票号管理、大厅监控、大厅参数、回签优先等核心能力。首页及部分子模块保留 **预留功能** 入口，用于后续扩展：
|
|
|
|
|
|
- 更多统计分析与大屏联动
|
|
|
- 自助机远程控制、打印设备深度集成
|
|
|
- 网格员任务派发、多合一办事流程
|
|
|
|
|
|
---
|
|
|
|
|
|
## 十、总结
|
|
|
|
|
|
紫云智能导税 PAD 客户端是紫云办税服务大厅数字化体系中的 **现场作业终端**，将身份核验、排队取号、窗口监控与参数运维集中在一套横屏应用中，并通过统一网关与安全签名机制与 HES 后端稳定对接。产品面向导税与管理双线角色设计，兼顾操作效率、现场可视化与系统可维护性，是提升办税大厅服务品质与运营效率的重要工具。
|
|
|
|
|
|
---
|
|
|
|
|
|
*文档根据当前代码库（tax-guidance）与《ZIYUN_PAD(HES)接口清单与CURL验证》整理，随版本迭代可同步更新功能列表与接口说明。*
|
