需求文档

简介

为财务申请页面添加商家选择功能，使总后台管理员能够代表任意商家提交结算申请，而普通商家用户仍只能为自己提交申请。

术语表

System: 共享平台商城系统
SuperAdmin: 总后台管理员，拥有最高权限的系统管理员
MerchantUser: 商家用户，只能管理自己商户的普通用户
MerchantSelector: 商家选择器，用于选择目标商家的下拉选择组件
BalanceLogApplyPage: 财务申请页面（accountLogApply.vue）
StoreAPI: 商家信息接口，用于获取商家列表和详情

需求

需求 1

用户故事: 作为总后台管理员，我希望能够在财务申请页面选择任意商家，以便代表该商家提交结算申请。

验收标准

WHEN SuperAdmin访问BalanceLogApplyPage THEN System SHALL显示MerchantSelector组件
WHEN SuperAdmin选择一个商家 THEN System SHALL加载该商家的信息和余额
WHEN SuperAdmin更改选择的商家 THEN System SHALL更新显示的商家信息和可提现余额
WHEN SuperAdmin提交申请 THEN System SHALL使用选中商家的user_id创建提现记录
WHEN MerchantUser访问BalanceLogApplyPage THEN System SHALL隐藏MerchantSelector并自动加载当前登录商家信息

需求 2

用户故事: 作为总后台管理员，我希望商家选择器支持搜索和分页，以便快速找到目标商家。

验收标准

WHEN SuperAdmin在MerchantSelector中输入关键词 THEN System SHALL根据商家名称或手机号进行模糊搜索
WHEN MerchantSelector显示商家列表 THEN System SHALL支持远程搜索和分页加载
WHEN MerchantSelector显示商家选项 THEN System SHALL显示商家名称、手机号和余额信息
WHEN SuperAdmin清空MerchantSelector THEN System SHALL清空商家信息表单

需求 3

用户故事: 作为系统，我需要根据用户角色判断是否显示商家选择器，以确保权限隔离。

验收标准

WHEN System加载BalanceLogApplyPage THEN System SHALL检查当前用户是否为SuperAdmin
WHEN 用户角色为SuperAdmin THEN System SHALL显示MerchantSelector并要求选择商家
WHEN 用户角色为MerchantUser THEN System SHALL隐藏MerchantSelector并使用当前登录商家信息
WHEN SuperAdmin未选择商家 THEN System SHALL禁用提交按钮并提示"请先选择商家"

需求 4

用户故事: 作为总后台管理员，我希望查看的申请记录能够根据选中的商家进行过滤，以便查看该商家的历史申请。

验收标准

WHEN SuperAdmin选择一个商家 THEN System SHALL加载该商家的申请记录
WHEN SuperAdmin更改选择的商家 THEN System SHALL刷新申请记录列表显示新商家的记录
WHEN SuperAdmin未选择商家 THEN System SHALL显示空的申请记录列表
WHEN MerchantUser访问页面 THEN System SHALL只显示当前登录商家的申请记录

需求 5

用户故事: 作为开发者，我需要后端API支持商家列表查询，以便前端实现商家选择功能。

验收标准

WHEN 前端请求商家列表 THEN StoreAPI SHALL返回包含商家ID、名称、手机号和余额的数据
WHEN 前端传入搜索关键词 THEN StoreAPI SHALL根据商家名称或手机号进行模糊匹配
WHEN 前端传入分页参数 THEN StoreAPI SHALL返回分页后的商家列表
WHEN 前端请求商家详情 THEN StoreAPI SHALL返回指定商家的完整信息包括余额