# 评价管理 — 功能需求说明

> 本文档在《评价管理功能需求-草稿》基础上整理，并关联 **《关联需求分析.md》** v1.6、平台侧 **《订单管理功能需求》** v1.0.1、《会员管理功能需求》** v1.0.1、《商品管理功能需求》** v1.3.3；C 端 **《我的订单功能需求》** v1.0、《商品详情内页功能需求》** v1.0、《店铺主页功能需求》**；商家 **《全部订单功能需求》** v1.0、《商家端店铺上下文接口说明》做边界与流程对齐。  
> 范围：**店铺经营管理端 · 商品管理 · 评价管理** 对 **当前店铺** 下买家 **已提交商品评价** 的列表、查看、**商家回复**、**删除（逻辑删除）**。  
> **说明：** 本文档 **仅描述功能需求与业务规则**；不涉及数据库结构、接口定义及技术实现细节。  
> **命名区分：** 评价 **由 C 端会员在订单完成后提交**；本模块为 **商家端读写（回复/删除）**；C 端 **发表评价** 在 **我的订单**；C 端 **展示评价** 在 **商品详情** 等只读页。

---

## 1. 模块定位

### 1.1 业务目标

在农资商城 **店铺经营管理端（Web）· 商品管理** 提供 **评价管理** 能力，使 **店铺管理员**（商户经营账号及已授权子管理员）能够：

- 浏览 **当前店铺** 收到的全部 **买家评价**；
- **查看** 评价详情（内容、晒图、评分、评价对象、关联订单信息）；
- 对评价进行 **商家回复**（C 端可见）；
- 对不当评价执行 **删除**（逻辑删除，C 端不再展示）；
- 通过 **回复状态** 等条件筛选，提升客服与运营效率。

**不包含（本期或与它模块分工）：**

| 能力 | 说明 |
|------|------|
| **买家发表/修改评价** | **C 端 · 我的订单**（MO-EV1～MO-EV3） |
| **平台全站评价审核/屏蔽** | **非本期**；商家删除仅影响 **本店评价** C 端可见性 |
| **追评、买家修改评价** | C 端 **非本期**（我的订单 §15） |
| **订单履约、售后** | 见 **发货管理 / 全部订单 / 售后** 专册 |
| **商品发品、上下架** | 见 **商品列表**；评价区展示 **评价快照** 商品信息 |
| **店铺综合评分算法配置** | C 端 **聚合展示**（店铺主页/商品详情）；本模块 **不配置** 公式 |

### 1.2 与草稿的对应关系

| 草稿条目 | 定稿处理 |
|----------|----------|
| §1 列表字段 | §6.1 |
| §2 操作（查看/回复/删除） | §7～§9 |
| §3 按当前店铺查询 | §1.5、§2.5 |
| §4 店铺上下文 | §2.5、§13 |
| §5 异常返回 | **不纳入** |
| §6 技术栈 | **不纳入** |

> **说明：** 本草稿与《评价管理功能需求-草稿.md》（同目录）**能力一致**；菜单归属 **商品管理** 一级模块（与 **商品列表**、**店铺商品分类** 等并列）；**不另立** 订单管理下第二套评价菜单。

### 1.3 在用户链中的位置

```text
【C 端】下单 → 支付 → 履约 → 确认收货 → 订单已完成
            ↓
【C 端 · 我的订单】买家提交评价（星级+文本+晒图，**一行一评**）
            ↓
【存储】评价归属 shop_id（本店订单产生）
            ↓
【商家 · 本模块】列表 / 查看 / 回复 / 删除
            ↓
【C 端 · 商品详情】评价区展示（含商家回复）
            ↓
【C 端 · 店铺主页/详情】店铺评分等聚合展示（只读，另册统计口径）
```

| 关联模块 | 关系 | 边界说明 |
|----------|------|----------|
| **C 端 · 我的订单** | **上游写入** | 仅 **已完成** 订单可评；**一行一评**（按 `order_item_id`） |
| **C 端 · 商品详情** | **下游只读** | 展示 **未删除且 C 端可见** 的评价；**GD14** |
| **商家 · 全部订单** | 关联只读 | 详情可展示 **来源订单编号**；**不可** 在订单页代替本模块回复 |
| **平台 · 订单管理** | 间接 | 评价前置条件：订单 **已完成**（O7） |
| **平台 · 会员管理** | 间接 | 会员昵称等 **读评价快照**；**不维护** 会员档案 |
| **商家 · 商品管理** | **本模块归属** | 菜单挂载 **商品管理**；与商品列表、店铺商品分类等并列 |
| **商品档案** | 间接 | 评价对象展示 **提交时商品快照**；商品后续改图 **不影响** 已评展示 |

### 1.4 数据范围

- **纳入：** 请求上下文 **当前店铺** 下、买家 **已提交** 且 **未被逻辑删除** 的评价（列表默认 **含** 已回复/未回复）；
- **排除：** 其他店铺评价；**尚未提交** 的「待评价」订单（属于 C 端 **我的订单**，**不在** 本列表）；
- **上下文：** 页头展示 **当前店铺名称**（只读）；切换店铺后列表 **整页刷新**。

### 1.5 使用端与角色

| 端 | 可操作角色 | 能力 |
|----|------------|------|
| **店铺经营管理端** | **商户经营账号** | 本模块全部能力 |
| **店铺经营管理端** | 员工（子管理员） | 由 **角色管理** 决定菜单与按钮（查看/回复/删除） |
| **C 端** | 买家会员 | **发表评价**（我的订单）；**不可** 访问商家端 |
| **平台管理端** | 平台管理员 | **本期无** 独立评价管理菜单；**不替代** 商家回复 |

---

## 2. 关联需求分析

### 2.1 与《关联需求分析》— 用户链

| 关联点 | 定稿 |
|--------|------|
| 用户链 | 订单 **已完成** 后产生评价；本模块处理 **评价产生之后** 的商家侧动作 |
| O7 完成时点 | **买家确认收货** → 已完成；**之后** 才可评价（MO-EV1） |
| O11 消费统计 | 与评价 **无写关联**；统计在 **已完成** 时已完成 |
| 供给链 | 评价对象商品信息为 **快照**；商品下架 **不删除** 已有评价 |

### 2.2 与 C 端《我的订单功能需求》

| 项 | 定稿 |
|----|------|
| 评价入口 | **已完成** 订单；**待评价 / 已评价** 为 **订单维度附加态** |
| 评价内容 | **星级必填**；文本、图片 **选填**（MO-EV2 区域规则） |
| 一行一评 | 同一订单明细行 **仅可提交一次**；提交后 **买家不可修改**（追评 **非本期**） |
| 取消评价页 | 订单仍为 **已完成**、评价态 **待评价**；**不出现在** 本模块列表 |
| 本模块触发 | **仅当买家提交成功** 后，评价进入商家列表 |

### 2.3 与 C 端《商品详情内页功能需求》— GD14

| 项 | 定稿 |
|----|------|
| 详情页 | 默认 **最新 2 条** 评价摘要 |
| 全部评价页 | **该商品** 全部可见评价；**最新倒序** |
| 展示字段 | 用户头像、评价内容、晒图、评分、商品图（快照） |
| 商家回复 | C 端 **有回复则展示** 在评价下方；**由本模块维护** |
| 删除后 | 商家 **逻辑删除** 的评价 **不在** C 端列表/摘要中出现 |

### 2.4 与平台《订单管理》《会员管理》

| 项 | 定稿 |
|----|------|
| 订单状态 | 评价对应订单须曾达到 **已完成**；列表 **只读展示** 订单编号 |
| 会员信息 | 展示评价提交时 **会员昵称快照**；**非** 实时拉会员中心 |
| 平台订单模块 | **不提供** 商家回复；**不重复** 维护评价内容 |

### 2.5 与《商家端店铺上下文接口说明》

| 项 | 定稿 |
|----|------|
| 当前店铺 | 登录后须 **选定当前店铺**；列表 **仅当前店** |
| 经营账号 | 多店可 **切换**；切换后 **整页刷新** |
| 员工账号 | 绑定 **单店**；**不可** 切换 |
| 未选店铺 | **不可** 进入本模块 |

### 2.6 与 C 端《店铺主页功能需求》— 评分

| 项 | 定稿 |
|----|------|
| 店铺评分 | 通常由 **已完成订单评价聚合**；本模块 **不编辑** 评分字段 |
| 建设阶段 | 评价模块未上线前 C 端可 **占位/隐藏**；与本模块 **上线后** 数据一致 |

---

## 3. 业务概念

| 概念 | 说明 |
|------|------|
| 评价 | 买家对 **一笔已完成订单** 提交的一次性 **文字/星级/晒图** 反馈 |
| 一行一评 | 每笔订单 **每个商品行** 至多一条有效评价；防重复提交 |
| 评价对象 | 被评 **商品** 在提交时的 **主图、名称、规格** 快照 |
| 晒图 | 买家上传的评价图片；列表/详情 **可预览** |
| 回复状态 | **未回复** / **已回复**（商家是否已填写回复） |
| 商家回复 | 店铺针对该条评价的 **公开回复**；C 端 **可见** |
| 逻辑删除 | 商家 **删除** 后，评价在 **本店列表与 C 端展示中消失**；**不可** 由买家 **再次评价** 同一订单 |

---

## 4. 功能结构

```text
商品管理（商家端）
└── 评价管理（当前店铺）
    ├── 评价列表（字段展示 + 回复状态 + 检索）
    ├── 查看详情
    ├── 商家回复（新增/修改回复）
    └── 删除评价（逻辑删除 · 二次确认）
```

---

## 5. 评价来源与状态（协作口径）

### 5.1 评价产生流程

```text
【C 端】订单已完成
    ↓
买家进入「评价」→ 填写星级（必填）、文本、图片（选填）
    ↓
提交成功 → 写入评价（归属当前订单.shop_id）
    ↓
【商家 · 本模块】列表可见；回复状态 = 未回复
    ↓
【C 端 · 商品详情】该商品评价区可见（GD14）
```

### 5.2 本模块不涉及的状态

| 状态 | 说明 | 所在模块 |
|------|------|----------|
| 待评价 | 已完成但未提交评价 | C 端 **我的订单** |
| 已关闭订单 | **不可** 评价 | C 端 **我的订单** |

### 5.3 操作权限矩阵

| 操作 | 未回复 | 已回复 | 已逻辑删除 |
|------|:------:|:------:|:----------:|
| 查看 | ✓ | ✓ | **列表不可见**（审计策略另定） |
| 回复 | ✓ | ✓（**可修改**，见 §8） | — |
| 删除 | ✓ | ✓ | — |

---

## 6. 评价列表

### 6.1 列表字段（定稿 · 对齐草稿 §1）

| 字段 | 说明 |
|------|------|
| 会员名称 | 买家 **提交时昵称快照** |
| 评价对象 | **商品主图**、**商品名称**、**商品规格**（快照） |
| 评价内容 | 文本摘要（过长 **截断**；详情看全文） |
| 晒图 | 有图时展示 **缩略/角标**；无图为空 |
| 评分 | **1～5 星**（若 C 端提交含评分） |
| 评价时间 | 买家 **提交时间** |
| 回复状态 | **未回复** / **已回复** |
| 操作 | **查看**、**回复**、**删除** |

- 默认 **评价时间降序**（最新在前）。
- 一单多商品时，C 端 **按商品行分别评价**；商家列表 **一条评价对应一行商品** 快照。

### 6.2 高级检索（定稿 · 补充）

| 条件 | 说明 |
|------|------|
| 回复状态 | 全部 / **未回复** / **已回复** |
| 评分 | 1～5 星（可选） |
| 商品名称 | 模糊（匹配评价对象快照名称） |
| 会员名称 | 模糊 |
| 评价时间 | 起止日期 |

- 检索范围 **始终限定当前店铺**。
- 支持 **重置** 条件。

### 6.3 列表行为

- 切换店铺或刷新后 **重新加载**。
- 无数据时展示空状态（如「暂无买家评价」）。
- 回复/删除成功后 **即时刷新** 当前行或列表。

---

## 7. 查看详情

### 7.1 范围

列表中 **全部未删除** 评价均可 **查看详情**。

### 7.2 详情内容（建议分区）

| 分区 | 内容 |
|------|------|
| 评价信息 | 评分、评价正文、晒图（**可预览大图**）、评价时间 |
| 评价对象 | 商品主图、名称、规格（**快照**） |
| 买家信息 | 会员名称（快照）；**不展示** 买家手机号（除非产品另定脱敏规则） |
| 关联订单 | **订单编号**（只读）；可选 **跳转** 全部订单详情 |
| 商家回复 | 回复正文、回复时间、回复人（若已回复）；未回复时提示 **待回复** |

### 7.3 边界

- **不可修改** 买家评价正文、星级、晒图。
- **不可** 在此页 **替买家补发** 评价。

---

## 8. 商家回复

### 8.1 前置条件

- 评价归属 **当前店铺**。
- 评价 **未被逻辑删除**。

### 8.2 回复表单

| 字段 | 必填 | 说明 |
|------|:----:|------|
| 回复内容 | 是 | 文本；长度上限由产品/前台校验（建议 ≤500 字） |

| 规则 | 说明 |
|------|------|
| 首次回复 | 回复状态 **未回复 → 已回复** |
| 修改回复 | **已回复** 评价 **允许修改** 回复内容（v1 定稿）；**不** 改变评价本身 |
| 记录 | 须记录 **回复时间**；**回复人** 为当前登录商家账号 |
| C 端 | 保存成功后，商品详情/全部评价页 **展示** 回复在评价下方 |

```text
商家点击「回复」
    → 填写/修改回复内容
    → 确认提交
    → 回复状态 = 已回复
    → C 端同步可见
```

---

## 9. 删除评价

### 9.1 前置条件

- 评价归属 **当前店铺**。
- 评价 **尚未** 被逻辑删除。

### 9.2 规则

| 项 | 定稿 |
|----|------|
| 确认 | **二次确认**；提示删除后 C 端 **不可见** |
| 效果 | **逻辑删除**；从本模块列表 **移除** |
| 买家侧 | 该 **商品行** **仍视为已评价**；**不可** 再次提交（一行一评） |
| C 端展示 | 商品详情/全部评价 **不再展示** 该条 |
| 物理清除 | **不做**；供后续审计/平台监管（若建设） |

```text
商家点击「删除」
    → 二次确认
    → 逻辑删除
    → 列表刷新；C 端不可见
```

---

## 10. 本模块不可做能力

| 能力 | 负责方 | 说明 |
|------|--------|------|
| 买家提交评价 | **C 端 · 我的订单** | MO-EV1～3 |
| 追评、买家改评 | **非本期** | 我的订单 §15 |
| 平台全站屏蔽/审核 | **非本期** | 可后续单独立项 |
| 修改买家评价内容 | **禁止** | 仅回复/删除 |
| 查看其他店铺评价 | **禁止** | shop 隔离 |
| 订单发货/售后 | **订单模块** | |
| 配置店铺评分公式 | **非本期** | C 端聚合 |

---

## 11. 业务规则汇总

| 编号 | 规则 |
|------|------|
| **RM1** | 列表与操作范围 = **当前店铺** 评价 |
| **RM2** | 仅展示买家 **已提交** 的评价；**不含** C 端「待评价」 |
| **RM3** | **一行一评**；删除后买家 **不可** 再评同一 **order_item** |
| **RM4** | 评价对象、会员名为 **提交快照** |
| **RM5** | **未回复/已回复** 均可 **回复**；已回复 **可修改** 回复（v1） |
| **RM6** | **删除** = 逻辑删除 + 二次确认；C 端 **不可见** |
| **RM7** | 列表默认 **评价时间降序** |
| **RM8** | 高级检索含 **回复状态** 及草稿列表相关维度 |
| **RM9** | 详情 **不可改** 买家评价正文/星级/晒图 |
| **RM10** | 切换店铺后 **整页刷新** |
| **RM11** | 员工须具 **菜单/按钮权限** |
| **RM12** | 与 C 端 **共用评价数据**；回复/删除 **即时影响** C 端展示 |

---

## 12. 页面与交互要点

| 场景 | 要求 |
|------|------|
| 未回复 | 回复状态 **高亮** 或筛选预设「未回复」 |
| 晒图 | 列表缩略图；详情 **点击预览** |
| 回复 | 弹窗或抽屉；已回复时 **回显** 原内容可编辑 |
| 删除 | 二次确认；明确 **不可恢复 C 端展示** |
| 空状态 | 无评价 / 检索无结果分场景提示 |
| 权限 | 无权限 **隐藏** 按钮或提示 |
| 关联订单 | 订单编号 **可点击** 跳转全部订单详情（可选） |

---

## 13. 与关联模块协作流程

```text
【C 端】确认收货 → 已完成
    ↓
【C 端 · 我的订单】提交评价
    ↓
【商家 · 评价管理】列表 → 查看 / 回复 / 删除
    ↓
【C 端 · 商品详情】GD14 展示（含商家回复）

并行：
【商家 · 全部订单】只读查看来源订单
【商品管理】商品编辑 **不改变** 已评快照展示
```

---

## 14. 草稿对照与修订说明

| 草稿条目 | 本文档处理 |
|----------|------------|
| §1 列表字段 | §6.1 |
| §2 查看/回复/删除 | §7～§9 |
| §3 按店铺查询 | §1.4、§2.5 |
| §4 店铺上下文 | §2.5、RM10 |
| §5～§6 异常/技术栈 | **不纳入** |
| 补充回复状态检索 | §6.2 |
| 补充 C 端/详情协作 | §2、§5 |
| 一行一评/删除语义 | §3、§9、RM3 |
| 同目录草稿 | §1.2 **能力一致、菜单归商品管理** |

---

## 15. 非本期范围

| 项 | 说明 |
|----|------|
| **追评、买家修改评价** | C 端非本期 |
| **平台评价审核、敏感词、举报** | 另册 |
| **商家批量回复/批量删除** | 非本期 |
| **评价导出 Excel** | 非本期 |
| **店铺评分权重配置** | C 端聚合另册 |
| **按订单行分别评价** | **已实现**（C 端 v1.2） |
| **接口、数据库、技术栈** | **不纳入** |

---

## 16. 修订记录

| 版本 | 说明 |
|------|------|
| **v1.2** | 对齐 C 端 **一行一评**、列表 `items[]` 全量展示 |
| **v1.0** | 首版定稿；对齐草稿 §1～§4；关联 C 端我的订单/商品详情 GD14、平台订单 O7、关联需求分析用户链；明确一行一评、回复可改、逻辑删除语义 |
| **v1.1** | 模块目录由 **订单管理** 调整至 **商品管理**；菜单归属商品管理一级模块 |

---

*文档版本：v1.2（定稿）· 目录：`doc/店铺后台/商品管理/评价管理/` · C 端见《我的订单功能需求.md》v1.1、《商品详情内页功能需求.md》v1.0*
