【商品】商品评价

1. 表结构
商品评价由 dtpc-module-product-biz 后端模块的 comment 包实现，表结构如下：
> <span style="font-family:楷体">省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段</span>

> <span style="font-family:楷体">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='商品评价';
</span>

① 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，可以通过管理后台修改。

## 2. 管理后台
对应 [商城系统 -> 商品中心 -> 商品评价] 菜单，对应dtpc-ui-admin-vue3 项目的 @/views/mall/product/comment 目录。
![](/media/202408/2024-08-28_152941_275523.png)

① 点击「添加虚拟评价」按钮，可以给某个商品添加虚拟评价，用于商品详情页的评价展示。
② 点击「回复」按钮，可以回复某个评价。
③ 点击「是否展示」按钮，可以控制评价在 uni-app 是否可见。

## 3. 移动端
#3.1 评价列表
① 商品详情页，展示近 3 条评价，由dtpc-ui-uniapp 项目的 pages/goods/components/detail/detail-comment-card.vue 实现。如下图所示：

![](/media/202408/2024-08-28_153012_955907.png)
② 点击「查看全部」按钮，进入商品评价列表页，由 dtpc-ui-uniapp 项目的 pages/goods/comment/list.vue 实现。如下图所示：

![](/media/202408/2024-08-28_153028_125860.png)

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

![](/media/202408/2024-08-28_153049_126428.png)

![](/media/202408/2024-08-28_153303_407223.png)