# 承销商 — 行情（移动端 / 小程序）

## 1. 说明

承销商底部导航 **「行情」** **复用**牧民端牦牛行情接口，**不新增** `/app/distributor/**` 行情路径。

| 项 | 值 |
| --- | --- |
| Base Path | **`/app/yakMarket`** |
| 数据表 | `biz_market_daily_quote`、`biz_trade_market` |
| 鉴权 | 需登录；**不区分**牧民/承销商角色 |
| 数据权限 | 全市场公开行情，**不按** `distributor_id` 过滤 |

> 后台登记时，交易市场名称须与主数据 **巴青牦牛交易市场** 一致。

### 1.1 前端复用

| 项 | 路径 |
| --- | --- |
| API 封装 | `ruoyi-ui-app/api/yakMarket.js` |
| 页面参考 | `package-a/yak-market/index.vue` |

---

## 2. 昨日主行情

`GET /app/yakMarket/yesterday`

查询 **行情日期 = 服务器当前日期前一天** 的单条记录。

**响应 `data`**

| 字段 | 说明 |
| --- | --- |
| `avgPrice` | 均价 |
| `priceUnit` | 单位枚举：`1` 元/头，`2` 元/斤 |
| `priceUnitName` | 单位中文 |
| `quoteDate` | 行情日期 `yyyy-MM-dd` |

无数据时 `data` 为 `null`。

---

## 3. 近 7 日统计

`GET /app/yakMarket/stats7`

统计区间：**昨日往前共 7 个自然日**（含昨日），按 `avg_price` 聚合。

**响应 `data`**

| 字段 | 说明 |
| --- | --- |
| `avgPrice7` | 7 日均价（算术平均） |
| `minPrice7` / `maxPrice7` | 7 日最低/最高均价 |
| `minQuoteDate` / `maxQuoteDate` | 对应行情日期 |
| `minQuoteDateLabel` / `maxQuoteDateLabel` | 展示用 `MM-dd` |
| `priceUnit` / `priceUnitName` | 取区间内最新行情日的单位 |
| `createTime` | 区间内记录的最大 `create_time` |

---

## 4. 价格走势

`GET /app/yakMarket/trend`

| 参数 | 必填 | 说明 |
| --- | --- | --- |
| `days` | 否 | `7` 或 `30`，默认 `7` |

返回 **截至昨日** 的 `days` 个自然日内、按 `quote_date` **升序** 的折线点。

**响应 `data` 数组元素**

| 字段 | 说明 |
| --- | --- |
| `quoteDate` | 行情日期 |
| `quoteDateLabel` | 图表横轴 `MM-dd` |
| `avgPrice` | 均价 |

---

## 5. 价格预测

`GET /app/yakMarket/forecast`

取 **昨日** 记录的看涨/看平/看跌概率（百分比）。

**响应 `data`**

| 字段 | 说明 |
| --- | --- |
| `probRise` | 看涨 % |
| `probFlat` | 看平 % |
| `probFall` | 看跌 % |

---

## 6. 每日行情列表

`GET /app/yakMarket/daily/list`

| 参数 | 说明 |
| --- | --- |
| `pageNum` / `pageSize` | 分页，默认 1 / 10 |

**排序**：`quote_date` 降序。

**响应**：标准 `TableDataInfo`，`rows` 元素字段：

| 字段 | 说明 |
| --- | --- |
| `id` | 主键 |
| `quoteDate` | 行情日期 |
| `tradeMarketName` | 交易市场名称 |
| `marketLocation` | 市场位置 |
| `priceMin` / `priceMax` | 最低价 / 最高价 |
| `priceUnit` / `priceUnitName` | 单位 |
| `supplyStatusName` | 出栏情况 |
| `changeFactorsText` | 变化因素 |
| `trendPrediction` | 走势预测（看涨/看平/看跌） |
| `outboundAdvice` | 出栏建议 |

---

## 7. 界面参考

`doc/交易市场平台/市场行情登记/Snipaste_2026-05-23_22-14-59.jpg`

## 8. 修订记录

| 版本 | 说明 |
| --- | --- |
| 1.0 | 承销商行情 Tab 复用 `/app/yakMarket`；本文收录完整接口字段（同源 `doc/app/牦牛行情`） |
