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