# 商户平台-店铺讨论模块接口文档

## 模块概述

本模块提供店铺讨论功能，支持分页查询一级讨论（主贴）以及一级讨论下的所有回复（仿B站评论模式）。支持逻辑删除、层级归类以及用户信息显示。

---

## 接口列表

1. [发布一级讨论](#接口一发布一级讨论) - 用户在店铺下发起新讨论
2. [回复讨论](#接口二回复讨论) - 用户回复已有讨论
3. [分页获取一级讨论](#接口三分页获取一级讨论) - 分页查询店铺的主讨论列表 (带用户信息)
4. [分页获取回复列表](#接口四分页获取回复列表) - 分页查询回复 (带主贴信息和用户信息)
5. [获取所有讨论列表](#接口五获取所有讨论列表) - 查询店铺所有讨论 (不分页)
6. [删除讨论](#接口六删除讨论) - 根据ID逻辑删除讨论记录

---

## 接口一：发布一级讨论

### 接口信息

- **接口名称**: 发布一级问答讨论 (主贴)
- **接口路径**: `POST /platformStoreDiscussion/postTopic`
- **请求方式**: POST
- **接口描述**: 在指定店铺下发起新的讨论。系统会自动将 `rootId` 设置为生成的主键 ID。

### 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| storeId | Integer | 是 | 店铺ID |
| userId | Integer | 是 | 用户ID |
| content | String | 是 | 讨论内容 |

### 响应参数

```json
{
    "code": 200,
    "success": true,
    "data": true,
    "msg": "发布成功"
}
```

---

## 接口二：回复讨论

### 接口信息

- **接口名称**: 回复问答讨论
- **接口路径**: `POST /platformStoreDiscussion/postReply`
- **请求方式**: POST
- **接口描述**: 对已有讨论进行回复。系统会根据 `parentId` 自动查询并填充 `storeId` 和 `rootId`。

### 请求参数

| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| userId | Integer | 是 | 用户ID |
| content | String | 是 | 讨论内容 |
| parentId | Integer | 是 | 被回复的讨论 ID |

### 响应参数

```json
{
    "code": 200,
    "success": true,
    "data": true,
    "msg": "回复成功"
}
```

---

## 接口三：分页获取一级讨论

### 接口信息

- **接口名称**: 分页获取一级问答讨论列表
- **接口路径**: `GET /platformStoreDiscussion/pageRoot`
- **请求方式**: GET

### 响应参数 (核心部分)

```json
{
    "code": 200,
    "data": {
        "records": [
            {
                "id": 1,
                "content": "主贴内容",
                "userName": "用户昵称",
                "userImage": "用户头像URL",
                "createdTime": "2025-12-30 14:00:00"
            }
        ],
        "total": 100,
        "size": 10,
        "current": 1
    }
}
```

---

## 接口四：分页获取回复列表

### 接口信息

- **接口名称**: 分页获取某条一级问答讨论下的所有回复
- **接口路径**: `GET /platformStoreDiscussion/pageReplies`
- **请求方式**: GET
- **接口描述**: 返回结构包含原主贴信息 (`topic`) 和分页后的回复列表 (`replies`)。注意：`replies` 列表中不包含 `topic` 本身。

---

## 接口五：获取所有讨论列表

### 接口信息

- **接口名称**: 获取店铺问答讨论列表
- **接口路径**: `GET /platformStoreDiscussion/list`
- **请求方式**: GET
- **接口描述**: 不分页获取店铺下所有讨论记录。

---

## 接口六：删除讨论

### 接口信息

- **接口名称**: 删除问答讨论
- **接口路径**: `DELETE /platformStoreDiscussion/delete/{id}`
- **请求方式**: DELETE
- **接口描述**: 根据讨论ID逻辑删除。

---

**文档版本**: v1.3  
**最后更新**: 2025-12-30  
**维护人员**: alien