# 牦牛行情（移动端）

## 1. 概述

| 项 | 说明 |
| --- | --- |
| Base Path | `/app/yakMarket` |
| 数据表 | `biz_market_daily_quote`、`biz_trade_market` |
| 鉴权 | 需登录（**不区分**牧民/承销商/供应商角色；交易市场角色账号登录后可直接调用） |
| 查询范围 | `del_flag=0`；交易市场 `market_name=巴青牦牛交易市场`（不按生长阶段过滤） |
| 承销商「行情」 | **复用**本 Base Path；说明见 `doc/app/交易市场平台（承销商）/行情接口说明.md` |
| 供应商「行情」 | **复用**本 Base Path；说明见 `doc/app/交易市场平台（供应商）/行情接口说明.md` |

> 后台登记时，交易市场名称须与主数据 **巴青牦牛交易市场** 一致；生长阶段按实际品类（犊牛/架子牛/屠宰牛等）登记即可。

## 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`、小程序 `package-a/yak-market/index.vue`。