【商品】商品评价

## 1. 表结构

商品评价由 `yudao-module-product-biz` 后端模块的 `comment` 包实现，表结构如下：

> 省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段

```sql
CREATE TABLE `product_comment` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '评价编号，主键自增',
  
  `user_id` bigint NOT NULL COMMENT '评价人的用户编号，关联 MemberUserDO 的 id 编号',
  `user_nickname` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '评价人名称',
  `user_avatar` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '评价人头像',
  `anonymous` bit(1) NOT NULL COMMENT '是否匿名',
  
  `order_id` bigint DEFAULT '0' COMMENT '交易订单编号，关联 TradeOrderDO 的 id 编号',
  `order_item_id` bigint DEFAULT '0' COMMENT '交易订单项编号，关联 TradeOrderItemDO 的 id 编号',
  
  `spu_id` bigint NOT NULL COMMENT '商品 SPU 编号，关联 ProductSpuDO 的 id',
  `spu_name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '商品 SPU 名称',
  `sku_id` bigint NOT NULL COMMENT '商品 SKU 编号，关联 ProductSkuDO 的 id 编号',
  `sku_pic_url` varchar(256) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '图片地址',
  `sku_properties` varchar(512) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '属性数组，JSON 格式 [{propertId: , valueId: }, {propertId: , valueId: }]',
  
  `scores` tinyint NOT NULL COMMENT '评分星级1-5分',
  `description_scores` tinyint NOT NULL COMMENT '描述星级 1-5 星',
  `benefit_scores` tinyint NOT NULL COMMENT '服务星级 1-5 星',
  `content` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL COMMENT '评价内容',
  `pic_urls` varchar(4096) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '评价图片地址数组',
  
  `visible` bit(1) DEFAULT NULL COMMENT '是否可见，true:显示false:隐藏',
  `reply_status` bit(1) DEFAULT b'0' COMMENT '商家是否回复',
  `reply_user_id` bigint DEFAULT NULL COMMENT '回复管理员编号，关联 AdminUserDO 的 id 编号',
  `reply_content` varchar(1024) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci DEFAULT NULL COMMENT '商家回复内容',
  `reply_time` datetime DEFAULT NULL COMMENT '商家回复时间',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=14 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='商品评价';
```

① `user_id`、`user_nickname`、`user_avatar`、`anonymous` 字段，会员用户相关信息。

② `order_id`、`order_item_id` 字段，交易订单相关信息。下单的每个订单项（商品），都可以评价一次，所以这里可以看到 `order_item_id` 字段。

③ `spu_id`、`spu_name`、`sku_id`、`sku_pic_url`、`sku_properties` 字段，商品 SPU、SKU 相关信息。通过冗余这些商品字段，可以减少关联查询，提高查询效率。

④ `description_scores`、`benefit_scores`、`content`、`pic_urls` 字段，会员用户的评价信息。而 `score` 字段是 `description_scores`、`benefit_scores` 两个字段的平均值。

⑤ `reply_status`、`reply_user_id`、`reply_content`、`reply_time` 字段，商家回复相关信息。

`visible` 字段，控制评价在 uni-app 是否可见，默认为 `true`，可以通过管理后台修改。

## [#](https://doc.iocoder.cn/mall/product-comment/#_2-%E7%AE%A1%E7%90%86%E5%90%8E%E5%8F%B0)2. 管理后台

对应 [商城系统 -> 商品中心 -> 商品评价] 菜单，对应 `yudao-ui-admin-vue3` 项目的 `@/views/mall/product/comment` 目录。

![评价列表](/media/202404/2024-04-26_1622520.5995233571627753.png)

① 点击「添加虚拟评价」按钮，可以给某个商品添加虚拟评价，用于商品详情页的评价展示。

② 点击「回复」按钮，可以回复某个评价。

③ 点击「是否展示」按钮，可以控制评价在 uni-app 是否可见。

## [#](https://doc.iocoder.cn/mall/product-comment/#_3-%E7%A7%BB%E5%8A%A8%E7%AB%AF)3. 移动端

### [#](https://doc.iocoder.cn/mall/product-comment/#_3-1-%E8%AF%84%E4%BB%B7%E5%88%97%E8%A1%A8)3.1 评价列表

① 商品详情页，展示近 3 条评价，由 `yudao-ui-uniapp` 项目的 `pages/goods/components/detail/detail-comment-card.vue` 实现。如下图所示：

![商品详情页-评价列表](/media/202404/2024-04-26_1622520.48339467979650164.png)

② 点击「查看全部」按钮，进入商品评价列表页，由 `yudao-ui-uniapp` 项目的 `pages/goods/comment/list.vue` 实现。如下图所示：

![评价列表](/media/202404/2024-04-26_1622520.7613069950383108.png)

### [#](https://doc.iocoder.cn/mall/product-comment/#_3-2-%E6%B7%BB%E5%8A%A0%E8%AF%84%E4%BB%B7)3.2 添加评价

在订单确认售后后，可以对商品进行评价，由 `yudao-ui-uniapp` 项目的 `pages/goods/comment/add.vue` 实现。如下图所示：

![待评价订单](/media/202404/2024-04-26_1622520.6393787519403558.png)

![添加评价](/media/202404/2024-04-26_1622520.38678756913774615.png)