交易市场平台（供应商）

baqing-admin/src/main/java/com/ruoyi/web/modules/trading/domain/dto/AppDistributorTradeSummaryDto.java

@@ -15,6 +15,9 @@ public class AppDistributorTradeSummaryDto
 
     private Long totalHeads;
 
+    /** 已完成订单的去重供应商数 */
+    private Long supplierCount;
+
     public Long getOrderCount()
     {
         return orderCount;
@@ -54,4 +57,14 @@ public class AppDistributorTradeSummaryDto
     {
         this.totalHeads = totalHeads;
     }
+
+    public Long getSupplierCount()
+    {
+        return supplierCount;
+    }
+
+    public void setSupplierCount(Long supplierCount)
+    {
+        this.supplierCount = supplierCount;
+    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/trading/domain/vo/AppDistributorTradeSummaryVo.java

@@ -22,6 +22,9 @@ public class AppDistributorTradeSummaryVo
     /** 近期交易均价（元/头，2 位小数） */
     private BigDecimal avgUnitPrice;
 
+    /** 成交供应商数（已完成订单去重 supplier_id） */
+    private long supplierCount;
+
     public long getOrderCount()
     {
         return orderCount;
@@ -71,4 +74,14 @@ public class AppDistributorTradeSummaryVo
     {
         this.avgUnitPrice = avgUnitPrice;
     }
+
+    public long getSupplierCount()
+    {
+        return supplierCount;
+    }
+
+    public void setSupplierCount(long supplierCount)
+    {
+        this.supplierCount = supplierCount;
+    }
 }

baqing-admin/src/main/java/com/ruoyi/web/modules/trading/support/AppDistributorHomeSupport.java

@@ -125,6 +125,7 @@ public final class AppDistributorHomeSupport
         long orderCount = raw != null && raw.getOrderCount() != null ? raw.getOrderCount() : 0L;
         long completed = raw != null && raw.getCompletedCount() != null ? raw.getCompletedCount() : 0L;
         long heads = raw != null && raw.getTotalHeads() != null ? raw.getTotalHeads() : 0L;
+        long supplierCount = raw != null && raw.getSupplierCount() != null ? raw.getSupplierCount() : 0L;
         BigDecimal amount = raw != null && raw.getTotalAmount() != null
                 ? raw.getTotalAmount() : BigDecimal.ZERO;
 
@@ -132,6 +133,7 @@ public final class AppDistributorHomeSupport
         vo.setOrderCount(orderCount);
         vo.setTotalAmount(amount);
         vo.setTotalHeads(heads);
+        vo.setSupplierCount(supplierCount);
         vo.setCompletionRate(ratioPercent(completed, orderCount));
         vo.setAvgUnitPrice(avgUnitPrice(amount, heads));
         return vo;

baqing-admin/src/main/resources/mapper/trading/AppDistributorTradeMapper.xml

@@ -14,7 +14,8 @@
         select count(*) as orderCount,
                coalesce(sum(case when o.order_status = '1' then 1 else 0 end), 0) as completedCount,
                coalesce(sum(o.total_amount), 0) as totalAmount,
-               coalesce(sum(o.total_heads), 0) as totalHeads
+               coalesce(sum(o.total_heads), 0) as totalHeads,
+               count(distinct case when o.order_status = '1' then o.supplier_id else null end) as supplierCount
         from biz_trade_order o
         where <include refid="orderInRange"/>
     </select>

baqing-admin/src/test/java/com/ruoyi/web/modules/trading/service/impl/AppDistributorHomeServiceImplTest.java

@@ -42,6 +42,7 @@ class AppDistributorHomeServiceImplTest
         summary.setCompletedCount(1L);
         summary.setTotalAmount(new BigDecimal("36800"));
         summary.setTotalHeads(3L);
+        summary.setSupplierCount(1L);
         when(appDistributorTradeMapper.selectTradeSummary(any(), any(), any())).thenReturn(summary);
         when(appDistributorTradeMapper.selectHourlyAmountTrend(any(), any(), any()))
                 .thenReturn(Collections.emptyList());
@@ -51,6 +52,7 @@ class AppDistributorHomeServiceImplTest
         assertEquals("今日", vo.getRangeName());
         assertEquals(AppDistributorHomeRules.TREND_GRANULARITY_HOUR, vo.getTrendGranularity());
         assertEquals(2L, vo.getSummary().getOrderCount());
+        assertEquals(1L, vo.getSummary().getSupplierCount());
         assertEquals(24, vo.getAmountTrend().size());
     }
 }

baqing-admin/src/test/java/com/ruoyi/web/modules/trading/support/AppDistributorHomeSupportTest.java

@@ -29,9 +29,11 @@ class AppDistributorHomeSupportTest
         raw.setCompletedCount(2L);
         raw.setTotalAmount(new BigDecimal("36800"));
         raw.setTotalHeads(3L);
+        raw.setSupplierCount(2L);
 
         AppDistributorTradeSummaryVo vo = AppDistributorHomeSupport.buildSummary(raw);
         assertEquals(4L, vo.getOrderCount());
+        assertEquals(2L, vo.getSupplierCount());
         assertEquals(0, new BigDecimal("36800").compareTo(vo.getTotalAmount()));
         assertEquals(3L, vo.getTotalHeads());
         assertEquals(0, new BigDecimal("50.0").compareTo(vo.getCompletionRate()));

doc/app/交易市场平台（承销商）/README.md

@@ -7,7 +7,7 @@
 
 | 导航 | 文档 | Base Path | 说明 |
 | --- | --- | --- | --- |
-| 首页 | [首页接口说明.md](./首页接口说明.md) | `/app/distributor/home` | 四时段交易统计 + 金额趋势 |
+| 首页 | [首页接口说明.md](./首页接口说明.md) | `/app/distributor/home` | 四时段：下单数/金额/头数/完成率/成交供应商数/均价 + 金额趋势 |
 | 订单 | [订单接口说明.md](./订单接口说明.md) | `/app/distributor/order`、`/app/distributor/yak` | 列表/详情 + 牦牛入场隔离 |
 | 行情 | [行情接口说明.md](./行情接口说明.md) | `/app/yakMarket` | **复用**牧民端牦牛行情，无独立路径 |
 
@@ -60,3 +60,4 @@
 | 版本 | 说明 |
 | --- | --- |
 | 1.0 | 汇总首页、订单、行情（复用）接口至本目录 |
+| 1.1 | 首页汇总增补 `supplierCount`（成交供应商数） |

doc/app/交易市场平台（承销商）/首页接口说明.md

@@ -22,6 +22,18 @@
 
 `GET /app/distributor/home/dashboard`
 
+一次请求返回**当前 `range` 时段**的汇总指标与金额趋势；小程序四个 Tab（今日 / 昨日 / 7日 / 30日）分别传对应 `range` 各请求一次。
+
+| 需求项 | 实现 |
+| --- | --- |
+| 分时段查 `biz_trade_order`（承销商=本人） | `range` + 当前登录绑定的 `distributor_id` |
+| 累计下单数 / 采购总金额 / 已购牦牛数 | `summary.orderCount` / `totalAmount` / `totalHeads` |
+| 订单完成率 | `summary.completionRate`（已完成 ÷ 下单数） |
+| 成交供应商数 | `summary.supplierCount`（已完成订单 `supplier_id` 去重） |
+| 近期交易均价 | `summary.avgUnitPrice`（总金额 ÷ 头数） |
+| 今日/昨日金额趋势（按小时） | `trendGranularity=HOUR`，`amountTrend` 24 点 |
+| 7日/30日金额趋势（按天） | `trendGranularity=DAY`，连续自然日补零 |
+
 ### 2.1 请求
 
 | 参数 | 位置 | 必填 | 说明 |
@@ -30,9 +42,10 @@
 
 ### 2.2 统计口径
 
-- 仅统计 **`distributor_id` = 当前承销商** 且 **`del_flag = 0`** 的订单。
-- 时段按订单 **`create_time`**（下单时间）落在对应自然日区间内统计。
+- 仅统计 **`biz_trade_order.distributor_id` = 当前承销商** 且 **`del_flag = 0`** 的订单。
+- 时段按订单 **`create_time`**（下单时间）落在对应自然日区间内统计（今日/昨日为当日 00:00:00～23:59:59）。
 - **7日**：`[今日-6日, 今日]` 共 7 个自然日；**30日**：`[今日-29日, 今日]` 共 30 个自然日。
+- **已完成**：`order_status = '1'`。
 
 ### 2.3 响应 `data`
 
@@ -49,10 +62,11 @@
 
 | 字段 | 说明 |
 | --- | --- |
-| `orderCount` | 累计下单数 |
-| `totalAmount` | 采购总金额（元） |
-| `totalHeads` | 已购牦牛数（头） |
-| `completionRate` | 订单完成率（%），已完成数 ÷ 下单数，`order_status=1` 为已完成；下单数为 0 时为 0 |
+| `orderCount` | 累计下单数（时段内全部订单笔数） |
+| `totalAmount` | 采购总金额（元，时段内 `total_amount` 合计） |
+| `totalHeads` | 已购牦牛数（头，时段内 `total_heads` 合计） |
+| `completionRate` | 订单完成率（%），已完成笔数 ÷ 下单数；下单数为 0 时为 0 |
+| `supplierCount` | 成交供应商数（时段内**已完成**订单的 `supplier_id` 去重计数） |
 | `avgUnitPrice` | 近期交易均价（元/头），`totalAmount / totalHeads`；头数为 0 时为 0 |
 
 **`amountTrend[]`**
@@ -85,6 +99,7 @@ GET /app/distributor/home/dashboard?range=TODAY
       "totalAmount": 36800.00,
       "totalHeads": 3,
       "completionRate": 50.0,
+      "supplierCount": 1,
       "avgUnitPrice": 12266.67
     },
     "amountTrend": [