71 lines
3.2 KiB
Markdown
71 lines
3.2 KiB
Markdown
# 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** 点击入口跳转至报表列表页面
|
||
|