Files
shop-toy/openspec/specs/bank-report/spec.md
2025-12-25 17:18:12 +08:00

3.2 KiB
Raw Blame History

bank-report Specification

Purpose

TBD - created by archiving change add-bank-report. Update Purpose after archive.

Requirements

Requirement: Report List Display

系统 SHALL 在银行端提供报表列表页面,展示所有可供下载的报表清单,分为四个主要板块:多维统计、访客报表、营销报表、权益管理。

Scenario: User views report list

  • WHEN 用户访问报表列表页面
  • THEN 系统显示四个报表分类板块
  • AND 每个板块包含对应的报表条目
  • AND 所有报表条目均可点击

Scenario: Report categories display correctly

  • WHEN 报表列表页面加载完成
  • THEN 多维统计板块显示:按支行统计、按网点统计、按部门统计、按人员统计、按客户统计
  • AND 访客报表板块显示:支行访客报表、网点访客报表、人员访客报表
  • AND 营销报表板块显示:小额贷业绩报表、小额贷营销汇总、消费贷营销报表、三农部支行汇总、三农部营销报表、公司部营销汇总表
  • AND 权益管理板块显示:我赠送的记录、全员赠送记录、权益二维码

Requirement: Report Navigation

系统 SHALL 支持用户从报表列表页面点击任意报表条目跳转至报表下载页面,并传递报表类型标识。

Scenario: User clicks report item

  • WHEN 用户点击报表列表中的任意报表条目
  • THEN 系统跳转至报表下载页面
  • AND 传递所选报表的类型标识ID 或名称)至下载页面

Requirement: Report Download Page

系统 SHALL 提供报表下载页面,支持日期维度筛选和 Excel 文件下载。

Scenario: Download page displays with default date

  • WHEN 用户进入报表下载页面
  • THEN 页面顶部显示日期维度筛选区(按日、按月、按季、自定义)
  • AND 默认选中"按日"选项
  • AND 显示当前系统日期(默认为 2025-12-25
  • AND 显示"EXCEL"格式标识
  • AND 显示"点击下载"按钮
  • AND 页面底部显示使用帮助说明

Scenario: User changes date dimension

  • WHEN 用户切换日期维度选项(按日/按月/按季/自定义)
  • THEN 系统更新日期显示格式
  • AND 用户可根据选定的维度修改日期

Scenario: User downloads report

  • WHEN 用户选择日期并点击"点击下载"按钮
  • THEN 系统发起下载请求
  • AND 模拟文件生成过程
  • AND 显示下载成功提示
  • AND 提示用户可以点击手机右上角的【...】进行转发或保存文件

Requirement: Report Data Mock

系统 SHALL 使用 mock 数据模拟报表下载功能,无需真实后端接口。

Scenario: Mock data generation

  • WHEN 用户请求下载报表
  • THEN 系统使用 mock 数据模拟文件生成
  • AND 模拟下载延迟(约 500ms
  • AND 返回下载成功状态

Requirement: Report Entry in Dashboard

系统 SHALL 在银行端仪表盘添加报表功能入口。

Scenario: Dashboard displays report entry

  • WHEN 用户访问银行端仪表盘
  • THEN 快捷操作区域显示"报表下载"入口
  • AND 点击入口跳转至报表列表页面