|
|
@@ -1,6 +1,142 @@
|
|
|
# KK-U
|
|
|
|
|
|
+## 项目信息
|
|
|
|
|
|
• 编辑工具增强: search_and_replace 和 insert_content 工具已得到改进，并从实验性状态毕业
|
|
|
|
|
|
cp ../proto/game.proto proto/game.proto
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+# 农贸市场匹配交易系统文档
|
|
|
+
|
|
|
+## 概述
|
|
|
+
|
|
|
+本文档基于 `/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
|
notfff