项目初始化

09-后台API说明/商户赛事管理接口字段清单.md

@@ -0,0 +1,53 @@
+# 商户赛事管理接口字段清单
+
+## 1. 创建赛事
+- 接口路径：`POST /api/merchant/events`
+- 功能说明：商户创建赛事草稿。
+
+### 请求参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| eventName | string | 是 | 赛事名称 |
+| eventCover | string | 是 | 封面图 |
+| eventIntro | string | 是 | 简介 |
+| location | string | 是 | 比赛地点 |
+| startTime | string | 是 | 开赛时间 |
+| endTime | string | 是 | 结束时间 |
+| signupStartTime | string | 是 | 报名开始时间 |
+| signupEndTime | string | 是 | 报名截止时间 |
+| refundRule | string | 是 | 退款规则 |
+| groupConfigList | array | 是 | 组别配置 |
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| eventId | string | 新创建的赛事ID |
+| eventStatus | string | 当前状态，通常为草稿 |
+
+## 2. 提交赛事审核
+- 接口路径：`POST /api/merchant/events/{eventId}/submit-review`
+- 功能说明：将赛事从草稿提交为待审核。
+
+### 请求参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| eventId | string | 是 | 赛事ID |
+
+### 返回字段
+| 字段 | 类型 | 说明 |
+| --- | --- | --- |
+| eventId | string | 赛事ID |
+| reviewStatus | string | 待审核 |
+
+## 3. 查询报名列表
+- 接口路径：`GET /api/merchant/signups`
+- 功能说明：查询本商户下赛事的报名记录。
+
+### 查询参数
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| eventId | string | 否 | 赛事ID |
+| groupId | string | 否 | 组别ID |
+| signupStatus | string | 否 | 报名状态 |
+| payStatus | string | 否 | 支付状态 |
+| keyword | string | 否 | 姓名/手机号搜索 |