# 交易市场平台 — 供应商小程序接口

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

## 模块与 Base Path

| 导航 | 文档 | Base Path | 说明 |
| --- | --- | --- | --- |
| 首页 | [首页接口说明.md](./首页接口说明.md) | `/app/supplier/home` | 四时段交易/结算统计 + 金额趋势 + 实时牦牛状态 |
| 订单 | [订单接口说明.md](./订单接口说明.md) | `/app/supplier/order`、`/app/supplier/settlement` | 交易订单与待结算单列表/详情（含明细） |
| 行情 | [行情接口说明.md](./行情接口说明.md) | `/app/yakMarket` | **复用**牧民端牦牛行情，无独立路径 |

## 接口一览

### 首页

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

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

### 订单

| 方法 | 路径 |
| --- | --- |
| GET | `/app/supplier/order/list?statusTab=ALL` |
| GET | `/app/supplier/order/{id}` |
| GET | `/app/supplier/settlement/list` |
| GET | `/app/supplier/settlement/{id}` |

| 界面 Tab | `statusTab` / 接口 |
| --- | --- |
| 全部订单 | `order/list?statusTab=ALL` |
| 待支付 | `order/list?statusTab=PENDING` |
| 待结算 | `settlement/list` |
| 已完成 | `order/list?statusTab=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` |
| 首页/订单 | 供应商分包页面（按产品路由配置） |

## 界面原型

| 页面 | 参考图 |
| --- | --- |
| 首页 | [Snipaste_2026-06-01_21-03-22.jpg](./Snipaste_2026-06-01_21-03-22.jpg)、`doc/大屏/Snipaste_2026-06-01_21-03-22.jpg` |
| 订单 | [Snipaste_2026-06-01_22-03-24.jpg](./Snipaste_2026-06-01_22-03-24.jpg)、`doc/大屏/Snipaste_2026-06-01_22-03-24.jpg` |
| 行情 | `doc/交易市场平台/市场行情登记/Snipaste_2026-05-23_22-14-59.jpg` |

## 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 汇总首页、订单接口至本目录 |
| 1.1 | 补充行情（复用 `/app/yakMarket`）完整说明；README 与承销商目录结构对齐 |
