# 农贸市场匹配交易系统文档

## 概述

本文档基于 `/app/Module/Mex/docs/1.1.md` 的内容分析，详细描述了农贸市场交易系统的匹配交易机制和规则。

## 核心交易规则

### 1. 价格限制机制

#### 最低价（保底价）
- **卖出限制**：用户卖出价格必须 **等于或低于** 系统设置的最低价
- **执行方式**：满足条件的卖单会立即成交（秒卖机制）
- **系统回收**：卖出的商品由系统直接回收，无需撮合

#### 最高价（参考价）
- **买入参考**：用户买入价格必须 **高于** 系统设置的最高价才能成交
- **价格发现**：最高价仅作为参考，实际成交价格由市场决定
- **动态调整**：用户需要根据实际成交情况调整出价

### 2. 撮合交易机制

#### 基于系统仓库的撮合
- **非订单撮合**：不是基于用户挂单的直接撮合
- **系统中介**：所有交易都通过系统仓库进行
- **防止转移**：避免用户通过多账号进行资产转移

#### 价格优先原则
- **价高者得**：买方出价越高，优先级越高
- **数量匹配**：按照价格优先、时间优先的原则进行匹配
- **部分成交**：支持订单的部分成交和排队机制

### 3. 订单数量保护

#### 保护阈值设置
- **后台配置**：管理员可设置订单数量保护阈值（如300个）
- **大单限制**：超过阈值的订单不参与匹配交易
- **防止操控**：防止大户通过大额订单操控市场

#### 隐藏机制
- **不对外展示**：保护阈值不向用户公开
- **防止做局**：用户无法通过已知阈值进行市场操控

### 4. 计划任务执行

#### 定时撮合
- **执行频率**：每5-10分钟执行一次撮合交易
- **批量处理**：一次性处理所有符合条件的订单
- **系统稳定**：避免实时撮合对系统性能的影响

### 5. 交易大厅显示

#### 成交记录展示
- **只显示成功**：交易大厅只显示已成交的订单
- **不显示等待**：等待中的订单不在大厅显示
- **用户昵称**：显示交易用户昵称和交易详情

#### 价格透明度
- **成交价格**：显示实际成交价格
- **市场发现**：用户可通过成交记录了解市场真实价格
- **策略调整**：帮助用户调整交易策略

### 6. 市场调控机制

#### 管理员干预工具
- **隐形操作**：管理员可进行不显示在交易大厅的买卖操作
- **市场调节**：通过增加或减少市场供应量调控价格
- **优先级设置**：管理员操作具有更高优先级

#### 操作方式
- **卖出调控**：向市场投放商品，增加供应量
- **买入调控**：从市场回收商品，减少供应量
- **日志记录**：所有调控操作都有详细日志记录

## 技术实现要点

### 1. 数据结构设计
- 订单表：记录用户买卖订单
- 仓库表：记录系统商品库存
- 成交表：记录所有成交记录
- 配置表：存储价格限制和保护阈值

### 2. 核心算法
- 价格验证算法
- 撮合匹配算法
- 数量保护算法
- 优先级排序算法

### 3. 安全机制
- 防刷单机制
- 防操控机制
- 数据一致性保证
- 异常处理机制

## 业务流程

### 卖出流程
1. 用户提交卖出订单
2. 系统验证价格是否符合最低价要求
3. 符合条件的订单立即成交
4. 商品进入系统仓库
5. 记录成交信息并显示在交易大厅

### 买入流程
1. 用户提交买入订单
2. 系统验证价格和数量保护阈值
3. 订单进入撮合队列
4. 计划任务执行撮合匹配
5. 成交后从系统仓库扣除商品
6. 记录成交信息

### 撮合流程
1. 计划任务启动
2. 获取所有待撮合的买入订单
3. 按价格优先级排序
4. 匹配系统仓库库存
5. 执行成交并更新数据
6. 生成成交记录

## 注意事项

1. **价格策略**：用户需要根据实际成交记录调整价格策略
2. **数量控制**：大额订单可能因保护机制无法成交
3. **时间延迟**：撮合交易存在5-10分钟的延迟
4. **市场风险**：价格波动和供需变化的风险
5. **系统维护**：定期检查和调整系统参数

---

**文档生成时间**：2025年06月11日 20:23
**基于文档**：`/app/Module/Mex/docs/1.1.md`
**文档版本**：v1.0