竞拍系统插件

竞拍系统：用户发布拍品（支持一口价）、买家出价/代理出价，保证金冻结与自动解冻，到期结算生成订单，金币支付/发货/收货，含后台审核。

• 插件标识：auction
• 版本：1.0.0
• 兼容环境：ZsAdmin（ThinkPHP 8）+ 社区插件 + 消息插件 + 金币服务

功能特性

• 发布拍品，支持起拍价、加价幅度、一口价、图片上传。
• 自定义竞价结束时间，精确到分钟（最长 7 天）。
• 买家出价/代理出价，被超出按最低必要价自动应价。
• 卖家/买家保证金冻结，被超出立即解冻，成交转为保证金抵扣。
• 到期结算生成订单，买家在付款时限内手动付款。
• 金币支付、卖家发货、买家收货、超时自动确认收货。
• 拍品审核机制，后台可开启/关闭审核。
• 后台拍品、订单、保证金、分类管理。
• 定时任务 + 页面懒触发双通道扫描。

目录结构

auction/
├── AuctionPlugin.php          # 插件入口：配置、导航、资源、定时逻辑
├── helpers.php                # 全局辅助函数（auction_url / auction_asset）
├── plugin.json                # 插件元信息
├── install.sql                # 数据表定义
├── routes.php                 # 前台 + 后台路由
├── README.md
├── controller/
│   ├── Index.php              # 前台：发布、上传、出价、订单接口
│   └── admin/Index.php        # 后台：拍品、审核、订单、保证金、分类
├── service/
│   ├── Auction.php            # 发布、出价、代理、一口价、结算、支付
│   ├── Margin.php             # 卖家/买家保证金冻结、释放、抵扣
│   └── Ticker.php             # 到期结算、超时取消、自动收货、结束提醒
├── static/
│   ├── auction.css            # 前台布局样式
│   ├── auction.js             # 前台交互
│   └── auction-nav.js         # 导航入口行为
└── view/
    ├── admin/index.html       # 后台管理页
    └── front/
        ├── index.html         # 竞拍大厅
        ├── detail.html        # 拍品详情
        ├── publish.html       # 发布拍品
        └── mine.html          # 我的竞拍

安装

1. 将打包后的 auction.zip 上传到站点升级/插件安装并安装。
2. 安装完成后插件会自动创建数据表与种子分类（数码 / 收藏 / 虚拟物品 / 其他）。
3. 在「插件管理 → 竞拍系统」开启插件并调整配置。

配置项

使用说明

前台

• 入口：顶栏「竞拍」或社区「竞拍大厅」。
• 发布拍品：填写标题、描述、分类、图片、价格，选择竞价结束时间后提交。
• 出价：填写价格出价；也可设置代理出价上限自动应价。
• 一口价：填写一口价后，买家可直接以该价格成交。
• 我的竞拍：查看我发布的、我参与的、我的订单。

订单流程

1. 竞拍到期或触达一口价后生成「待付款」订单。
2. 买家在付款时限内手动付款，已冻结保证金自动抵扣差额。
3. 卖家发货（虚拟物品/快递）。
4. 买家确认收货，卖家保证金退还，货款结算给卖家。
5. 超过付款时限未付款：订单取消、拍品流拍、买家/卖家保证金退还（无罚没）。

定时任务

推荐使用 crontab 定任务扫描：

# 每分钟执行一次
* * * * * php /站点路径/think auction:tick

未配置 crontab 时，前台页面访问会触发懒扫描（节流 5 分钟）。

数据表

• auction_category：竞拍分类
• auction_item：竞拍拍品
• auction_bid：竞拍出价
• auction_order：竞拍订单
• auction_deposit：竞拍保证金明细

变更记录

• 1.0.0

 - 首个正式版本。

 - 支持竞价结束时间自定义（分钟级），此前为固定竞拍天数。

 - 移除后台重复参数配置，统一由插件配置管理。

 - 支持 PJAX 页面加载条件下上传与提交功能。