navgcn_auction 竞拍系统

插件介绍

竞拍系统 是 Xiuno BBS X 的全功能竞拍交易插件，支持发布拍品、积分出价竞拍、一口价购买、保证金机制、虚拟发货和完整的订单交易管理。

核心功能

拍品发布：支持图片上传（最多9张）、分类选择、起拍价/一口价/加价幅度设置、拍卖时间配置、虚拟物品标记
竞拍出价：实时出价、代理出价、自动延长（最后几分钟有出价则延长截止时间）、出价间隔限制
一口价购买：买家可直接以一口价购买，系统即时完成交易扣款、卖家打款、保证金退还，无需额外付款步骤
保证金机制：卖家保证金（按起拍价百分比冻结）、买家参拍保证金（按当前价百分比冻结），拍卖结束/流拍/下架时自动解冻退还
订单管理：完整的订单状态流转（待付款→待发货→待收货→已完成），支持虚拟发货和物流发货，超时未付款自动取消
后台管理：拍品审核、置顶、强制下架，订单管理，保证金记录查看，全局参数配置
发现页集成：自动注册到站点发现页
用户中心：个人中心竞拍入口，我发布的/我参与的/我的订单三个标签页
多语言：简体中文、繁体中文、英文三语支持
定时任务：5分钟自动检查到期拍品、发送结束提醒、处理超时订单

技术架构

维度	说明
插件目录名	`navgcn_auction`（作者_功能标识两段格式）
版本	1.1.0
适配系统	Xiuno BBS X 1.1.x
数据表	5张（拍品/出价/订单/保证金/分类），均使用 `utf8mb4`
前端框架	Bootstrap 5.3 + Tabler Icons
交互方式	前台 htmx 4 + `XN.*` API；后台原生 JS + Bootstrap
Service 类	`NavgcnAuctionService`（静态方法模式，通过 `model_inc_file.php` 注册）
路由注册	前台 `index_route_case_end.php` + `model_route_table_end.php`；后台 `admin_index_route_case_end.php`
发现页注册	`discover_register.php`（自注册，带 `class_exists` 守卫）
定时任务	`model_cron_5_minutes_end.php`

入口 URL

页面	URL
竞拍列表	`?auction-list.htm`
拍品详情	`?auction-detail-{id}.htm`
发布拍品	`?auction-post.htm`
我的竞拍	`?auction-my.htm`
后台管理	`admin/?navgcn_auction-setting.htm`
后台拍品管理	`admin/?navgcn_auction-items.htm`
后台订单管理	`admin/?navgcn_auction-orders.htm`
后台保证金管理	`admin/?navgcn_auction-deposits.htm`

文件结构

navgcn_auction/
├── conf.json              # 插件配置（hooks_rank 等）
├── install.php            # 建表 + 默认分类 + 默认配置
├── uninstall.php          # 删表 + 清配置
├── upgrade.php            # 幂等迁移（SHOW COLUMNS + ALTER TABLE）
├── setting.php            # 后台入口重定向
├── discover_register.php  # 发现页自注册
├── icon.png               # 插件图标
├── model/
│   └── NavgcnAuctionService.php  # 核心业务逻辑（静态方法）
├── route/
│   ├── auction.php              # 前台路由
│   └── admin/auction.php        # 后台路由
├── hook/
│   ├── model_inc_file.php           # Service 注册
│   ├── model_route_table_end.php    # 路由表注册
│   ├── index_route_case_end.php     # 前台路由分发
│   ├── admin_index_route_case_end.php # 后台路由分发
│   ├── model_cron_5_minutes_end.php # 定时任务
│   ├── header_link_after.htm        # CSS 注入
│   ├── my_sidebar_nav_credits_before.htm # 个人中心导航
│   ├── lang_zh_cn_bbs.php           # 简体中文
│   ├── lang_zh_tw_bbs.php           # 繁体中文
│   └── lang_en_us_bbs.php           # 英文
├── view/htm/
│   ├── auction_list.htm         # 竞拍列表页
│   ├── auction_detail.htm       # 拍品详情页
│   ├── auction_post.htm         # 发布/编辑拍品页
│   ├── auction_my.htm           # 我的竞拍页
│   ├── admin_setting.htm        # 后台设置页
│   ├── admin_items.htm          # 后台拍品管理页
│   ├── admin_orders.htm         # 后台订单管理页
│   ├── admin_deposits.htm       # 后台保证金记录页
│   └── admin_nav_tabs.inc.htm   # 后台 Tab 导航组件
├── static/
│   ├── js/auction.js            # 倒计时等前端逻辑
│   └── css/auction.css          # 插件样式
└── README.md                    # 本文件