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.

11 KiB

Raw Permalink Blame History Unescape Escape

紫云智能导税 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 支持问题追踪与审计。

三、适用对象与使用场景

角色	典型场景
导税员 / 预审人员	纳税人信息登记、预检取号、查看核验结果与人脸照片
窗口管理人员	票号查询与导税、健康报告查看、预约签到
大厅管理员	大厅参数配置、窗口/设备状态监控、回签与优先取号
网格员	现场协调与辅助导税（功能入口预留扩展）

典型场景示例：

纳税人到厅 → 导税员在「预检取号」流程中录入信息 → 选择业务类型取号 → 打印或推送票号信息。
已实名核验记录 → 在「预检取号」列表中按姓名/身份证/手机号查询 → 查看核验说明与人脸照片 → 一键取号。
管理员查看「大厅概况」→ 进入大厅详情掌握窗口排队与设备空闲情况 → 在「大厅控制」中调整营业时间等系统参数。

四、功能模块说明

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验证》整理，随版本迭代可同步更新功能列表与接口说明。

11 KiB Raw Permalink Blame History Unescape Escape