# 交易市场平台 — 承销商小程序接口

> 承销商角色登录 `ruoyi-ui-app` 后，底部导航 **首页 / 订单 / 行情 / 我的** 所用后端接口说明。  
> 鉴权：若依登录 `POST /login`，请求头携带 Token；承销商须后台 **分配账号**（`biz_distributor.sys_user_id`）。

## 模块与 Base Path

| 导航 | 文档 | Base Path | 说明 |
| --- | --- | --- | --- |
| 首页 | [首页接口说明.md](./首页接口说明.md) | `/app/distributor/home` | 四时段：下单数/金额/头数/完成率/成交供应商数/均价 + 金额趋势 |
| 订单 | [订单接口说明.md](./订单接口说明.md) | `/app/distributor/order`、`/app/distributor/yak` | 列表/详情 + 牦牛入场隔离 |
| 行情 | [行情接口说明.md](./行情接口说明.md) | `/app/yakMarket` | **复用**牧民端牦牛行情，无独立路径 |

## 接口一览

### 首页

| 方法 | 路径 |
| --- | --- |
| GET | `/app/distributor/home/dashboard?range=TODAY` |

`range`：`TODAY` | `YESTERDAY` | `DAYS_7` | `DAYS_30`

### 订单

| 方法 | 路径 |
| --- | --- |
| GET | `/app/distributor/order/list?statusTab=ALL` |
| GET | `/app/distributor/order/{id}` |
| GET | `/app/distributor/yak/basic?supplierId=&earTag=` |

`statusTab`：`ALL` | `PENDING` | `COMPLETED`

### 行情（复用）

| 方法 | 路径 |
| --- | --- |
| GET | `/app/yakMarket/yesterday` |
| GET | `/app/yakMarket/stats7` |
| GET | `/app/yakMarket/trend?days=7` |
| GET | `/app/yakMarket/forecast` |
| GET | `/app/yakMarket/daily/list` |

## 前端参考

| 模块 | 可复用代码 |
| --- | --- |
| 行情 | `ruoyi-ui-app/api/yakMarket.js`、`package-a/yak-market/index.vue` |
| 首页/订单 | 承销商分包页面（按产品路由配置） |

## 界面原型

| 页面 | 参考图 |
| --- | --- |
| 首页 | `doc/大屏/Snipaste_2026-06-01_21-09-54.jpg` |
| 订单 | `doc/大屏/Snipaste_2026-06-01_21-17-04.jpg` |

## 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 汇总首页、订单、行情（复用）接口至本目录 |
| 1.1 | 首页汇总增补 `supplierCount`（成交供应商数） |
