alien_cloud/alien-store-platform/接口文档/36-店铺问答讨论模块接口.md

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

模块概述

本模块提供店铺讨论功能，允许用户在商户平台上针对特定店铺发表讨论、回复他人讨论，并支持讨论的列表查询和删除。类似于论坛功能，旨在增强用户与店铺之间的互动。

---

接口列表

1. 发表讨论/回复 - 用户发表新讨论或回复已有讨论
2. 获取店铺讨论列表 - 查询指定店铺的所有讨论记录
3. 删除讨论 - 根据ID逻辑删除讨论记录

---

接口一：发表讨论/回复

接口信息

• 接口名称: 发表讨论/回复
• 接口路径: POST /platformStoreDiscussion/post
• 请求方式: POST
• 接口描述: 用户对店铺发表主贴讨论，或对已有讨论进行回复。

请求参数

参数名	类型	必填	说明
storeId	Integer	是	店铺ID
userId	Integer	是	用户ID
content	String	是	讨论内容
parentId	Integer	否	父级讨论ID (发表主贴填0或不传，回复填被回复ID)

请求示例

{
    "storeId": 1,
    "userId": 1001,
    "content": "这家店的服务非常到位，强烈推荐！",
    "parentId": 0
}

响应参数

{
    "code": 200,
    "success": true,
    "data": true,
    "msg": "发表成功"
}

---

接口二：获取店铺讨论列表

接口信息

• 接口名称: 获取店铺讨论列表
• 接口路径: GET /platformStoreDiscussion/list
• 请求方式: GET
• 接口描述: 获取指定店铺下的所有讨论记录，按创建时间倒序排列。

请求参数

参数名	类型	必填	说明
storeId	Integer	是	店铺ID

请求示例

GET /platformStoreDiscussion/list?storeId=1

响应参数

{
    "code": 200,
    "success": true,
    "data": [
        {
            "id": 1,
            "storeId": 1,
            "userId": 1001,
            "content": "这家店的服务非常到位，强烈推荐！",
            "parentId": 0,
            "deleteFlag": 0,
            "createdTime": "2025-12-30 14:00:00",
            "createdUserId": 1001,
            "updatedTime": "2025-12-30 14:00:00",
            "updatedUserId": null
        }
    ],
    "msg": "操作成功"
}

---

接口三：删除讨论

接口信息

• 接口名称: 删除讨论
• 接口路径: DELETE /platformStoreDiscussion/delete/{id}
• 请求方式: DELETE
• 接口描述: 根据讨论ID逻辑删除该条记录。

请求参数

参数名	类型	必填	说明
id	Integer	是	讨论记录ID (路径参数)

请求示例

DELETE /platformStoreDiscussion/delete/1

响应参数

{
    "code": 200,
    "success": true,
    "data": true,
    "msg": "删除成功"
}

---

业务规则说明

1. 父子关系:
   • parentId 为 0 或 null 表示该记录是一条独立的讨论（主贴）。
   • parentId 大于 0 表示该记录是对另一条讨论的回复。
2. 删除逻辑: 采用逻辑删除，更新 delete_flag 字段为 1。
3. 排序规则: 列表接口默认按 created_time 倒序排列，确保最新的讨论显示在最前面。

---

数据库设计 (store_discussion)

字段名	类型	说明
id	int	主键，自增
store_id	int	店铺ID
user_id	int	用户ID
content	text	讨论内容
parent_id	int	父级讨论ID，默认为0
delete_flag	tinyint	删除标记 (0:未删除, 1:已删除)
created_time	datetime	创建时间
created_user_id	int	创建人ID
updated_time	datetime	修改时间
updated_user_id	int	修改人ID

---

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