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.
ElectronClient/tax-guidance/docs/智能导税PAD-功能需求说明书(优化稿).md

10 KiB

智能导税 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 3Composition API
跨端框架 uni-appVue3 编译器)
UI 组件 TuniaoUI、uni-ui 等
样式 SCSS

5.2 开发工具与工程环境

项目 说明
主要 IDE HBuilderXuni-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 寸及以上,横屏支架固定)
操作系统 AndroidHarmonyOS工程已配置鸿蒙应用包名与平板设备类型可按项目需要扩展 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 描述。