一、功能概述
商品评价功能是电商平台提升用户体验、增强用户信任、优化商品管理的重要模块。在叮咚买菜系统中，该功能允许用户对购买的商品进行评分和文字评价，为其他用户提供参考，同时帮助平台和商家改进商品和服务。
二、核心功能设计
1. 评价入口
- 订单完成后触发：在用户确认收货后，系统自动推送评价提醒（APP推送、短信、站内信）
- 多入口设计：
- 订单详情页"去评价"按钮
- 商品详情页"用户评价"板块
- 个人中心"我的评价"入口
2. 评价内容
- 评分系统：
- 商品整体评分（1-5星）
- 分项评分（新鲜度、包装、配送速度等）
- 文字评价：
- 必填简短评价（20-200字）
- 可选上传图片（最多3张）
- 标签评价：
- 预设标签快速选择（如"新鲜"、"包装完好"、"配送快"等）
- 自定义标签输入
3. 评价展示
- 商品详情页：
- 平均评分展示
- 评价数量统计
- 精选评价轮播
- 按标签筛选评价
- 搜索结果页：
- 评分排序选项
- 高评分商品特殊标识
4. 评价管理
- 用户端：
- 查看/修改/删除自己的评价
- 举报不当评价
- 平台端：
- 评价审核机制（敏感词过滤、图片审核）
- 评价数据分析
- 商家回复管理
三、技术实现方案
1. 数据库设计
```sql
CREATE TABLE product_reviews (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
user_id BIGINT NOT NULL,
order_id BIGINT NOT NULL,
product_id BIGINT NOT NULL,
overall_rating TINYINT NOT NULL COMMENT 1-5分,
freshness_rating TINYINT COMMENT 新鲜度评分,
packaging_rating TINYINT COMMENT 包装评分,
delivery_rating TINYINT COMMENT 配送评分,
content TEXT COMMENT 评价内容,
images VARCHAR(1000) COMMENT 图片URL列表，JSON格式,
is_anonymous TINYINT DEFAULT 0 COMMENT 是否匿名,
create_time DATETIME NOT NULL,
update_time DATETIME NOT NULL,
status TINYINT DEFAULT 0 COMMENT 0-待审核 1-已发布 2-已删除
);
CREATE TABLE review_tags (
id INT PRIMARY KEY AUTO_INCREMENT,
tag_name VARCHAR(50) NOT NULL,
use_count INT DEFAULT 0
);
CREATE TABLE user_review_tags (
review_id BIGINT NOT NULL,
tag_id INT NOT NULL,
PRIMARY KEY (review_id, tag_id)
);
```
2. 后端服务
- 评价提交服务：
```java
@PostMapping("/api/reviews")
public ResponseEntity<?> submitReview(@RequestBody ReviewSubmissionDTO dto) {
// 参数校验
// 用户购买验证
// 敏感词过滤
// 图片审核
// 保存评价
// 更新商品评分
// 触发评价奖励（如有）
return ResponseEntity.ok().build();
}
```
- 评价查询服务：
```java
@GetMapping("/api/products/{productId}/reviews")
public ResponseEntity
getProductReviews(
@PathVariable Long productId,
@RequestParam(defaultValue = "1") Integer page,
@RequestParam(defaultValue = "10") Integer size) {
// 分页查询评价
// 计算平均评分
// 统计标签分布
return ResponseEntity.ok(reviewList);
}
```
3. 前端实现
- 评价页面：
```javascript
// React示例
function ReviewForm({orderId}) {
const [rating, setRating] = useState(5);
const [content, setContent] = useState();
const [images, setImages] = useState([]);
const handleSubmit = async () => {
const formData = {
orderId,
rating,
content,
images,
// 其他字段...
};
await api.submitReview(formData);
// 跳转成功页
};
return (
value={rating}
onChange={setRating}
/>
