|
|
# 智能导税 PAD — 功能需求说明书（优化稿）
|
|
|
|
|
|
> 依据：合同附件《紫云智慧办税大厅排队取号系统功能需求说明书》原「3. 智能导税 PAD」章节，并结合当前 **紫云智能导税（tax-guidance）** 客户端实现能力修订。
|
|
|
> 说明：本文仅描述功能与技术参数，不涉及源代码。
|
|
|
|
|
|
---
|
|
|
|
|
|
## 1. 产品定位
|
|
|
|
|
|
**智能导税 PAD** 是导税员 / 预审人员 / 大厅管理员在办税服务大厅使用的 **横屏平板业务终端**，部署于取号区或导税台。
|
|
|
|
|
|
产品对接紫云 HES 排队叫号系统（经公网统一网关），覆盖 **登录认证、大厅概况、预检取号、普通取号、实名采集、票号管理、大厅监控、参数维护、回签优先、信息推送** 等现场作业能力，实现身份核验与排队取号业务闭环。
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 产品名称 | 紫云智能导税 |
|
|
|
| 版本 | 1.0.0 |
|
|
|
| 运行形态 | PAD / 平板 App（横屏优先） |
|
|
|
| 适用场景 | 税务局办税服务厅、政务服务中心 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 2. 功能需求
|
|
|
|
|
|
### 2.1 登录与会话
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 账号登录 | 支持用户名 + 密码登录；登录成功后进入智能导税首页 |
|
|
|
| 凭证保持 | 登录成功后本地保存访问令牌与用户信息；支持记住账号密码便于再次登录 |
|
|
|
| 会话续期 | 应用从锁屏 / 后台回到前台时，自动校验或刷新登录态；短时锁屏应尽量保持登录，避免频繁重登 |
|
|
|
| 退出登录 | 首页用户区支持退出；退出后清除登录态并返回登录页 |
|
|
|
| 运行日志 | 支持在用户菜单中查看客户端运行日志，便于现场排查网络、登录与接口问题；支持清空日志 |
|
|
|
|
|
|
### 2.2 智能导税首页
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 大厅概况 | 展示当前等候人数、今日预约人数、空闲窗口数、空闲自助机数；支持定时自动刷新 |
|
|
|
| 概况下钻 | 点击概况指标可进入大厅详情，查看窗口与自助设备状态 |
|
|
|
| 功能入口 | 提供预检取号、票号管理、普通取号、信息推送、回签优先、网格员等入口（部分为预留扩展） |
|
|
|
| 用户信息 | 右上角展示当前登录人员姓名 / 头像 |
|
|
|
|
|
|
### 2.3 预检取号（核心）
|
|
|
|
|
|
面向已完成或待完善实名核验的纳税人，由导税员查询记录并完成取号、采集与报告查看。
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 条件查询 | 支持按姓名、身份证号、手机号模糊查询；支持分页 |
|
|
|
| 列表展示 | 展示姓名、身份证（脱敏）、手机号（脱敏）、票号、核验结果文案、核验时间 |
|
|
|
| 查看照片 | 有人脸抓拍信息时，可弹窗查看人脸照片 |
|
|
|
| 实名采集 | 当核验结果文案包含「未采集」时显示「采集」按钮；填写手机号（必填）、电子邮箱、固定电话后提交实名采集保存；成功后回填手机号并隐藏采集按钮 |
|
|
|
| 健康报告 | 根据身份证获取并弹窗展示税务健康检查报告 |
|
|
|
| 取号 | 选择业务类型后取号；无手机号时须先补录；取号成功提示票号，并刷新列表 |
|
|
|
| 列表刷新 | 页面停留期间支持定时自动刷新核验列表，保证现场数据时效 |
|
|
|
|
|
|
### 2.4 普通取号
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 入口 | 首页「普通取号」直接打开业务选择弹窗（无需先进入预检列表） |
|
|
|
| 手机号必填 | 普通取号须先填写手机号码 |
|
|
|
| 业务选择 | 展示可办业务及各业务当前等候人数；每次打开时刷新等候人数 |
|
|
|
| 取号类型 | 普通取号与预检取号在业务侧区分类型（如 normal / realname），分别满足大厅不同取号场景 |
|
|
|
|
|
|
### 2.5 票号管理
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 分类筛选 | 支持企业 / 个人等分类及等候中、已完成、预约号等状态筛选 |
|
|
|
| 条件筛选 | 支持按时间、业务类型、票号关键字等条件查询 |
|
|
|
| 详情与导税 | 支持查看票号详情；可进行导税相关操作或跳转导税辅助流程 |
|
|
|
| 健康报告 | 支持查看关联纳税人的税务健康检查报告 |
|
|
|
|
|
|
### 2.6 大厅详情（监控）
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 窗口监控 | 展示人工窗口名称、可办业务、当前票号、状态（空闲 / 忙碌等）、等候人数 |
|
|
|
| 自助设备 | 展示自助办税设备名称及使用状态（空闲 / 使用中 / 维护中等） |
|
|
|
| 手动刷新 | 支持一键刷新监控数据 |
|
|
|
|
|
|
### 2.7 大厅控制（参数维护）
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 参数列表 | 表格展示大厅系统参数名称、Key、当前值 |
|
|
|
| 参数修改 | 支持弹窗编辑参数值（Key / 名称只读）；修改前二次确认；保存后刷新列表 |
|
|
|
|
|
|
### 2.8 回签优先
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 回签（复号） | 支持输入或扫码票号，确认后执行回签 |
|
|
|
| 优先取号 | 按业务类型网格选择，生成优先（插队）票号 |
|
|
|
|
|
|
### 2.9 信息推送与小票模板
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 语音呼叫 | 按票号、窗口等信息发起语音呼叫 |
|
|
|
| 信息屏推送 | 向同步屏 / 综合屏推送文字内容 |
|
|
|
| 短信推送 | 向指定手机号发送短信内容 |
|
|
|
| 小票模板 | 支持加载、编辑样式并保存打印小票模板配置 |
|
|
|
|
|
|
### 2.10 其他与扩展
|
|
|
|
|
|
| 功能点 | 需求说明 |
|
|
|
|--------|----------|
|
|
|
| 今日进厅 / 今日预约 | 支持进厅与预约相关数据查询（按大厅业务需要开放入口） |
|
|
|
| 网格员 / 多合一 / 预留功能 | 预留扩展入口，便于后续版本增加现场协作与综合办事能力 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 3. 典型业务场景（PAD）
|
|
|
|
|
|
### 场景 A：预检取号
|
|
|
|
|
|
1. 导税员登录 PAD，进入「预检取号」
|
|
|
2. 按姓名 / 身份证 / 手机号查询核验记录
|
|
|
3. 查看核验结果；如提示「未采集」，完成实名采集
|
|
|
4. 必要时查看人脸照片、健康报告
|
|
|
5. 选择业务类型取号，纳税人凭票等候叫号
|
|
|
|
|
|
### 场景 B：普通取号
|
|
|
|
|
|
1. 首页点击「普通取号」
|
|
|
2. 填写手机号，选择业务类型
|
|
|
3. 取号成功后提示票号
|
|
|
|
|
|
### 场景 C：大厅运维
|
|
|
|
|
|
1. 首页查看等候与空闲窗口概况
|
|
|
2. 进入大厅详情核对窗口 / 自助机状态
|
|
|
3. 在大厅控制中调整营业时间等系统参数
|
|
|
4. 需要时在回签优先中处理复号或插队
|
|
|
|
|
|
---
|
|
|
|
|
|
## 4. 非功能与安全要求
|
|
|
|
|
|
| 类别 | 要求 |
|
|
|
|------|------|
|
|
|
| 交互形态 | 横屏大屏触控布局，适配柜台支架与导税台操作 |
|
|
|
| 数据脱敏 | 列表中身份证、手机号须脱敏展示 |
|
|
|
| 身份认证 | 业务接口携带登录令牌；登录接口除外 |
|
|
|
| 请求安全 | 业务请求经统一网关，采用签名校验（防篡改 / 防重放）；支持链路追踪标识 |
|
|
|
| 可靠性 | 锁屏或短暂切后台后应尽量自动续会话；鉴权失效时明确提示并引导重新登录 |
|
|
|
| 可运维性 | 提供客户端运行日志查看与清空能力，便于现场排障 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 5. 技术参数
|
|
|
|
|
|
### 5.1 开发语言与框架
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 开发语言 | JavaScript / TypeScript（前端页面以 Vue SFC 为主） |
|
|
|
| 前端框架 | Vue 3（Composition API） |
|
|
|
| 跨端框架 | uni-app（Vue3 编译器） |
|
|
|
| UI 组件 | TuniaoUI、uni-ui 等 |
|
|
|
| 样式 | SCSS |
|
|
|
|
|
|
### 5.2 开发工具与工程环境
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 主要 IDE | HBuilderX（uni-app 官方推荐）；亦可配合 Visual Studio Code / Cursor 进行源码编辑 |
|
|
|
| 包管理 / 构建 | 遵循 uni-app 工程规范（HBuilderX 发行打包 / 云打包或本地打包） |
|
|
|
| 版本管理 | Git |
|
|
|
| 目标 AppID | 以工程 `manifest` 配置为准（当前工程标识：紫云智能导税） |
|
|
|
|
|
|
### 5.3 开发环境建议
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 操作系统 | Windows 10/11（开发机）；可配合 macOS（若需 iOS 相关调试） |
|
|
|
| Node.js | 建议使用当前 LTS 版本（与 uni-app / HBuilderX 兼容） |
|
|
|
| 调试终端 | Android 平板 / HarmonyOS 平板真机；HBuilderX 标准基座或自定义调试基座 |
|
|
|
| 联调后端 | 紫云 HES pad-api（经公网统一 `/public` 网关）；开发 / 生产网关地址按部署环境配置 |
|
|
|
|
|
|
### 5.4 运行环境
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 终端设备 | 办税大厅 PAD / 平板（推荐 10 寸及以上，横屏支架固定） |
|
|
|
| 操作系统 | Android；HarmonyOS（工程已配置鸿蒙应用包名与平板设备类型）；可按项目需要扩展 iOS |
|
|
|
| 屏幕方向 | 横屏（应用全局横屏配置） |
|
|
|
| 网络 | 可访问公网统一业务网关（HTTPS/HTTP 以部署为准） |
|
|
|
| 关联硬件（可选） | 人脸识别 / 身份证核验一体机（用于实名核验数据采集，与 PAD 业务联动）；打印机（小票，按现场对接） |
|
|
|
|
|
|
### 5.5 对接与接口形态
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 接入方式 | 客户端 → 公网统一网关 `/public` → 内网 HES pad-api |
|
|
|
| 报文约定 | `tag + path + query/body` 标准化报文 |
|
|
|
| 安全机制 | Bearer Token；业务请求 HMAC-SHA256 签名（含 timestamp、nonce）；登录等少数接口可免签 |
|
|
|
| 主要业务域（示例） | 认证（auth）、大厅系统（hallSystem）、业务类型（business）、票号（ticket）、窗口监控（window）、预约（appointment）、实名采集（smz）、打印（print）等 |
|
|
|
|
|
|
### 5.6 部署方式
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|------|------|
|
|
|
| 安装形态 | 各大厅按需安装多台 PAD 客户端 |
|
|
|
| 升级方式 | 应用商店 / 内网安装包 / MDM 分发（按甲方现场规范） |
|
|
|
| 与整体系统关系 | 作为紫云排队取号体系中的「导税端」终端，与中心管理平台、大厅边缘服务、窗口呼叫终端、广播同步屏协同工作 |
|
|
|
|
|
|
---
|
|
|
|
|
|
## 6. 与附件原文对照说明（修订要点）
|
|
|
|
|
|
相对合同附件原「3. 智能导税 PAD」条目，本优化稿主要补充：
|
|
|
|
|
|
1. **预检取号细节**：查询字段、脱敏、人脸照片、健康报告、列表自动刷新
|
|
|
2. **实名采集**：按「未采集」文案触发采集登记（手机号必填等）
|
|
|
3. **普通取号**：与预检取号分流，强调手机号必填与等候人数刷新
|
|
|
4. **信息推送 / 小票模板**：语音、信息屏、短信、模板维护
|
|
|
5. **登录会话与运维日志**：续会话、退出、日志查看
|
|
|
6. **技术参数专章**：开发语言、工具、开发 / 运行环境、网关对接方式
|
|
|
|
|
|
---
|
|
|
|
|
|
*本优化稿供更新《紫云智慧办税大厅排队取号系统功能需求说明书》中「智能导税 PAD」章节使用；如需回填 Word/PDF 正文，可直接替换原第 3 节及相关部署表中 PAD 描述。*
|
