一、功能概述
本地供应商评价功能是小象买菜系统中连接消费者与本地供应商的重要桥梁，通过收集用户反馈，帮助平台优化供应商管理，提升商品质量和服务水平。
二、核心功能模块
1. 评价维度设计
- 商品质量：新鲜度、包装完整性、规格准确性
- 配送服务：准时率、配送员态度、包装保护
- 价格合理性：性价比、市场对比
- 售后服务：退换货处理、问题响应速度
- 供应商诚信度：缺货通知、重量准确性
2. 评价流程设计
```
用户下单 → 收到商品 → 评价入口触发 → 多维度评分 → 文字评价 → 图片上传(可选) → 提交评价
```
3. 评价展示机制
- 供应商主页：展示综合评分和各维度评分
- 商品详情页：显示该商品的历史评价摘要
- 搜索排序：评价权重影响供应商搜索排名
三、技术实现方案
1. 数据库设计
```sql
CREATE TABLE supplier_evaluations (
id BIGINT PRIMARY KEY AUTO_INCREMENT,
user_id BIGINT NOT NULL,
supplier_id BIGINT NOT NULL,
order_id BIGINT NOT NULL,
overall_rating TINYINT NOT NULL CHECK (overall_rating BETWEEN 1 AND 5),
quality_rating TINYINT NOT NULL CHECK (quality_rating BETWEEN 1 AND 5),
delivery_rating TINYINT NOT NULL CHECK (delivery_rating BETWEEN 1 AND 5),
price_rating TINYINT NOT NULL CHECK (price_rating BETWEEN 1 AND 5),
service_rating TINYINT NOT NULL CHECK (service_rating BETWEEN 1 AND 5),
comment TEXT,
images VARCHAR(1000), -- 存储图片URL，逗号分隔
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
FOREIGN KEY (user_id) REFERENCES users(id),
FOREIGN KEY (supplier_id) REFERENCES suppliers(id),
FOREIGN KEY (order_id) REFERENCES orders(id)
);
```
2. 后端API设计
```
POST /api/evaluations/create
- 参数: orderId, ratings(各维度评分), comment, images
- 返回: 评价ID
GET /api/suppliers/{id}/evaluations
- 参数: page, size
- 返回: 评价列表(含评分统计)
GET /api/evaluations/my
- 返回: 用户历史评价列表
```
3. 前端实现要点
- 评价页面：星级评分组件、文本输入框、图片上传控件
- 评价列表：分页展示、评分统计图表
- 评价提醒：订单完成后3天推送评价提醒
- 评价审核：敏感词过滤、图片合规性检查
四、关键业务逻辑
1. 评价权限控制
```python
def can_evaluate(user_id, order_id):
检查订单是否已完成且未评价过
order = Order.query.filter_by(id=order_id, user_id=user_id, status=completed).first()
if not order:
return False
检查是否已评价过
evaluation = Evaluation.query.filter_by(order_id=order_id).first()
return evaluation is None
```
2. 评分计算与展示
```javascript
// 计算供应商平均评分
function calculateAverageRating(evaluations) {
const sum = evaluations.reduce((total, eval) => {
return total + eval.overallRating;
}, 0);
return evaluations.length > 0 ? sum / evaluations.length : 0;
}
// 评分星级展示
function renderStars(rating) {
const fullStars = Math.floor(rating);
const hasHalfStar = rating % 1 >= 0.5;
const emptyStars = 5 - fullStars - (hasHalfStar ? 1 : 0);
// 返回包含全星、半星和空星的HTML
}
```
3. 评价审核机制
- 自动过滤敏感词
- 图片AI识别违规内容
- 人工复核可疑评价
五、供应商端功能
1. 供应商评价看板
- 总体评分趋势图
- 各维度评分详情
- 正面/负面评价标签云
- 评价响应功能
2. 评价响应流程
```
收到新评价 → 查看评价详情 → 内部讨论 → 回复用户 → 用户确认 → 问题闭环
```
六、数据应用
1. 供应商评级体系
```
综合评分 = 商品质量*0.4 + 配送服务*0.3 + 价格合理性*0.2 + 售后服务*0.1
评级标准:
- 4.5分及以上: 金牌供应商
- 4.0-4.4分: 银牌供应商
- 3.5-3.9分: 铜牌供应商
- 3.5分以下: 需改进供应商
```
2. 评价数据分析
- 每周生成供应商表现报告
- 识别高频投诉问题
- 跟踪改进措施效果
七、实施计划
1. 需求分析与设计：2周
- 确定评价维度和权重
- 设计数据库结构
- 制定API规范
2. 开发阶段：4周
- 后端评价服务开发
- 前端评价页面开发
- 供应商管理后台开发
3. 测试阶段：2周
- 功能测试
- 性能测试
- 用户体验测试
4. 上线与优化：1周
- 灰度发布
- 收集用户反馈
- 迭代优化
八、预期效果
1. 提升平台商品质量和服务水平
2. 增强用户对平台的信任度
3. 帮助优质供应商获得更多订单
4. 建立公平透明的供应商评估体系
5. 为采购决策提供数据支持
九、后续迭代方向
1. 增加评价标签系统（如"包装精美"、"配送快"等）
2. 开发评价有奖机制，提高用户评价积极性
3. 引入供应商回复评价功能
4. 开发评价真实性验证机制
5. 实现基于评价的智能推荐系统
通过完善的本地供应商评价系统，小象买菜可以构建更健康的生鲜电商生态，实现消费者、供应商和平台的三方共赢。
广告
