一、功能概述 本地供应商评价功能是小象买菜系统中连接消费者与供应商的重要桥梁，通过收集用户反馈帮助优化供应链管理，提升商品质量和服务水平。 二、核心功能模块 1.评价维度设计 -商品质量：新鲜度、包装完整性、规格准确性 -配送服务：准时率、配送态度、包装保护 -价格合
一、功能概述
本地供应商评价功能是小象买菜系统中连接消费者与供应商的重要桥梁，通过收集用户反馈帮助优化供应链管理，提升商品质量和服务水平。
二、核心功能模块
1. 评价维度设计
- 商品质量：新鲜度、包装完整性、规格准确性
- 配送服务：准时率、配送态度、包装保护
- 价格合理性：性价比、市场竞争力
- 售后服务：退换货处理、问题响应速度
2. 评价方式
- 星级评分：1-5星整体评分
- 多维度打分：针对上述各维度分别评分
- 文字评价：用户可自由描述体验
- 图片上传：支持上传商品照片作为评价依据
3. 评价流程
1. 订单完成后自动触发评价邀请（短信/APP推送）
2. 用户进入评价页面选择评分和填写内容
3. 提交后系统进行内容审核（敏感词过滤）
4. 审核通过后评价展示在供应商页面
三、技术实现方案
1. 数据库设计
```sql
CREATE TABLE supplier_ratings (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
supplier_id BIGINT NOT NULL,
user_id BIGINT NOT NULL,
order_id BIGINT NOT NULL,
overall_rating TINYINT NOT NULL COMMENT 1-5星,
quality_rating TINYINT COMMENT 商品质量评分,
delivery_rating TINYINT COMMENT 配送评分,
price_rating TINYINT COMMENT 价格评分,
service_rating TINYINT COMMENT 服务评分,
comment TEXT COMMENT 文字评价,
images VARCHAR(500) COMMENT 图片URL列表，JSON格式,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
status TINYINT DEFAULT 1 COMMENT 0-待审核 1-已展示 2-已隐藏,
FOREIGN KEY (supplier_id) REFERENCES suppliers(id),
FOREIGN KEY (user_id) REFERENCES users(id),
FOREIGN KEY (order_id) REFERENCES orders(id)
);
```
2. 后端API设计
```
GET /api/suppliers/{id}/ratings 获取供应商评价列表
POST /api/ratings 提交新评价
PUT /api/ratings/{id}/status 审核评价（管理员）
```
3. 关键算法实现
供应商综合评分计算
```python
def calculate_supplier_rating(supplier_id):
获取最近90天的有效评价
ratings = SupplierRating.objects.filter(
supplier_id=supplier_id,
status=1,
created_at__gte=datetime.now()-timedelta(days=90)
)
if not ratings.exists():
return 0
计算加权平均分（可根据业务调整权重）
total = sum(r.overall_rating for r in ratings)
count = ratings.count()
可选：按评价时间加权（近期评价权重更高）
...
return round(total / count, 1)
```
评价内容审核（敏感词过滤）
```python
def filter_sensitive_words(text):
sensitive_words = ["差评", "投诉", "垃圾", "骗子"] 实际应从数据库读取
for word in sensitive_words:
if word in text:
return False, f"评价包含敏感词: {word}"
return True, ""
```
四、前端实现要点
1. 评价页面UI组件
```jsx
// 评价表单组件示例
function RatingForm({ order }) {
const [rating, setRating] = useState(5);
const [comment, setComment] = useState();
const [images, setImages] = useState([]);
const handleSubmit = async () => {
// 调用提交评价API
const result = await postRating({
orderId: order.id,
overallRating: rating,
comment,
images
});
if (result.success) {
alert(评价提交成功);
}
};
return (
