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