添加报表

openspec/specs/bank-report/spec.md

@@ -0,0 +1,70 @@
+# 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** 点击入口跳转至报表列表页面
+