Plan: 商户端看板 — 商户筛选下拉框

Context

商户看板需要支持筛选：全部 / 本商户 / 各子商户，默认"全部"（本商户+子商户），今日数据和近30天数据两张卡片同步联动。

实现策略

现有查询通过 merchant_id IN (SELECT id FROM merchant WHERE id = #{tenantId} OR parent_merchant_id = #{tenantId}) 实现租户级聚合。在此之上叠加一个 scopeId 参数：当非空时追加 AND merchant_id = #{scopeId}，精确过滤到指定商户。

scopeId = null → 全部（当前行为不变）
scopeId = loggedInMerchantId → 仅本商户自己的交易
scopeId = subMerchantId → 仅该子商户

改动清单

1. MerchantMapper — 新增子商户查询

selectSubMerchants(@Param("merchantId") Long merchantId) 返回 List<Map<String,Object>>
XML: SELECT id, merchant_name AS merchantName FROM merchant WHERE parent_merchant_id = #{merchantId} AND status = 1 ORDER BY id

2. TransactionMapper — 6 个方法增加 scopeId 参数

getTenantTodayStats — 加 @Param("scopeId") Long scopeId
getTenantTodayRefundStats — 同上
getTenantTodayDisputeCount — 同上
getTransactionTrend — 同上
getPaymentMethodDistribution — 同上
getStatusDistribution — 同上

3. TransactionMapper.xml — 6 个查询增加 scopeId 条件

每个查询在 tenantId 条件之后追加：

<if test="scopeId != null">AND merchant_id = #{scopeId}</if>

4. MerchantDashboardController — 3 处变更

新增 @GetMapping("/merchants") 返回子商户列表供下拉框
/today 端点：merchantId → resolvedId（根据 scopeId 决定），所有 mapper 调用传入 scopeId
/transaction-trend、/payment-method-distribution、/status-distribution 各加 @RequestParam(required = false) Long scopeId

5. 前端 dashboard.js — API 全部加 scopeId 参数

getSubMerchants() 新增
getTransactionTrend(params) — 已有 params，传 scopeId
getPaymentMethodDistribution(params) — 加 params
getStatusDistribution(params) — 加 params
getTodayStats(params) — 加 params

6. DashboardView.vue — 顶部加下拉框

el-select 三个 option：全部、本商户、各子商户
selectedMerchantId 响应式变量，默认 null（全部）
watch 监听变化，重新 fetch 全部数据
今日和近30天卡片都使用同一个 selectedMerchantId

不涉及

admin 看板
非看板相关的 merchant 接口

验证

下拉默认"全部"，数据与改造前一致
选"本商户"，两个卡片数据更新为仅该商户
选子商户，两个卡片数据更新为仅该子商户
下拉切换后两个区域同步刷新

read-c-users-1-claude-claude-md-before-s-breezy-rivest.md 2.7 KB Постоянная ссылка История Исходник