ShopX 电商系统操作说明书

## 关于本手册

本说明书适用于 ShopX 电商系统**单店模式**下的后台管理操作，面向平台管理员和运营人员。手册按系统左侧导航菜单的排列顺序逐一说明，涵盖所有功能模块的操作方法。

单店模式下系统内置一个默认商家和店铺，菜单直接进入信息编辑页，无需管理商家和店铺列表。

使用本手册前请确认系统已正确安装部署，并已使用管理员账号登录后台。

---

## 目录

- [第一章 商家管理](#第一章-商家管理)
- [第二章 店铺管理](#第二章-店铺管理)
- [第三章 商品管理](#第三章-商品管理)
- [第四章 订单管理](#第四章-订单管理)
- [第五章 支付管理](#第五章-支付管理)
- [第六章 购物车管理](#第六章-购物车管理)
- [第七章 平台配置](#第七章-平台配置)
- [附录](#附录)

---

## 第一章 商家管理

### 1.1 功能概述

商家是平台的经营主体。单店模式下系统内置默认商家，菜单直接进入商家信息编辑页。本章管理商家的基本信息、媒体资源和标签体系。

**适用场景**：
- 修改商家名称和联系方式
- 管理商家上传的图片素材
- 创建商家自定义标签

---

### 1.2 商家信息编辑

**操作路径**：【商家信息】

#### 1.2.1 页面说明

单店模式下菜单直接进入商家信息编辑页，页面为表单布局，依次排列以下字段：

| 字段 | 控件类型 | 说明 |
|---|---|---|
| 商家名称 | 文本输入 | 商家全称 |
| 联系人 | 文本输入 | 联系负责人姓名 |
| 联系电话 | 文本输入 | 联系电话号码 |
| 商家地址 | 文本输入 | 经营地址 |
| 商家简介 | 文本域 | 商家描述 |
| 商家 Logo | 文件上传 | 品牌标识图片 |
| 关联管理员账号 | 搜索选择 | 绑定的后台管理员 |
| 关联会员账号 | 搜索选择 | 绑定的前台会员 |
| 状态 | 单选 | 启用/禁用 |

#### 1.2.2 操作方法

1. 进入【商家信息】页面
2. 修改需要变更的字段
3. 点击底部「保存」按钮提交

---

### 1.3 专辑管理

**操作路径**：【商家信息】→ 专辑管理

#### 1.4.1 功能说明

对媒体文件进行分组管理，类似于「相册」功能。便于按商品、活动等维度查找图片文件。

**表格列**：专辑名称、封面图片、文件数量、创建时间。

#### 1.4.2 操作方法

- **添加专辑**：点击「添加」，填写专辑名称和描述，上传封面图片，提交
- **删除专辑**：删除专辑不会删除内部的媒体文件，文件变为未分类状态

---

### 1.4 媒体文件

**操作路径**：【商家信息】→ 媒体文件

#### 1.5.1 功能说明

商家上传的所有图片文件的集中管理库。商品主图、详情图、Logo 等统一在此管理。

**表格列**：缩略图预览、文件名、所属专辑、文件大小、上传时间、引用次数。

#### 1.5.2 操作方法

**上传文件**
1. 点击「添加」
2. 支持两种方式：单击选择文件 或 拖拽文件到上传区域
3. 选择所属专辑
4. 上传完成后文件自动出现在列表中

**应用场景**：添加商品时可直接从媒体库选取图片，无需重复上传。替换文件后所有引用位置同步更新。

---

### 1.5 标签管理

**操作路径**：【商家信息】→ 标签管理

#### 1.6.1 功能说明

商家自定义标签体系，可在商品上打标签，用于前端筛选和分类展示。

**表格列**：标签名称、使用次数、创建时间。

#### 1.6.2 操作方法

- **添加标签**：输入标签名称，提交
- **删除标签**：删除后商品上的标签关联同时解除

---

## 第二章 店铺管理

### 2.1 功能概述

店铺是销售前台窗口。单店模式下系统内置默认店铺，菜单直接进入店铺信息编辑页。本章管理店铺信息、客服、地址、运费模板等。

---

### 2.2 店铺信息编辑

**操作路径**：【店铺管理】

#### 2.2.1 页面说明

单店模式下菜单直接进入店铺信息编辑页。表单依次排列以下字段：

| 字段 | 控件类型 | 说明 |
|---|---|---|
| 店铺分类 | 下拉选择 | 从平台预设分类选取 |
| 店铺名称 | 文本输入 | 店铺名称 |
| 店铺英文名 | 文本输入 | 英文名称 |
| 店标 | 文件上传 | 建议尺寸 200×200 |
| 店铺背景图片 | 文件上传 | 背景图 |
| 店铺横幅图片 | 文件上传 | 横幅图 |
| 处理状态 | 单选 | 正常/待审核/关闭等 |
| 是否上线 | 单选 | 上线/下线 |
| 各项评分 | 只读 | 由系统根据用户评价自动计算 |

#### 2.2.2 操作方法

1. 进入【店铺管理】页面
2. 修改需要变更的字段
3. 点击底部「保存」提交

---

### 2.3 店铺客服

**操作路径**：【店铺管理】→ 店铺客服

配置对外展示的客服联系方式。买家在商品页点击「联系客服」时展示此列表。

**字段**：客服昵称、联系方式类型（电话/微信/QQ）、联系方式值、在线时间、排序。

---

### 2.4 店铺地址

**操作路径**：【店铺管理】→ 店铺地址

配置发货地址和退货地址。订单发货时自动选择默认地址。

**字段**：联系人、联系电话、所在地区（省/市/区）、详细地址、地址类型（发货/退货/两者都是）、是否默认。

**应用场景**：
- 多仓库商家，每个仓库独立地址
- 退货地址与发货地址不同（如发往售后中心）

---

### 2.5 运费模板

**操作路径**：【店铺管理】→ 运费模板

#### 2.5.1 功能说明

配置不同地区的运费计算规则。商品编辑时选择适用的运费模板。

#### 2.5.2 计费方式

| 方式 | 说明 | 示例 |
|---|---|---|
| 按件数 | 按商品数量累加运费 | 首件 10 元，续件 5 元 |
| 按重量 | 按商品重量累加运费 | 首重 1kg 8 元，续重 2 元/kg |
| 包邮 | 免运费 | — |
| 固定运费 | 统一金额 | 全场 6 元 |

#### 2.5.3 操作方法

1. 点击「添加」
2. 输入模板名称
3. 选择计价方式
4. 设置默认运费规则（全国通用）
5. 添加指定地区特殊运费（可选）：选择目标省份，设置独立规则
6. 提交

> **注意**：未设置特殊运费的地区按默认规则计算。

---

### 2.6 售后服务（店铺端）

**操作路径**：【店铺管理】→ 售后服务配置

配置售后服务插件和处理售后申请。

---

### 2.7 邮件订阅

**操作路径**：【店铺管理】→ 邮件订阅

管理邮件订阅用户，发送营销邮件。

**功能清单**：查看订阅列表、添加/编辑/删除订阅、预览邮件模板、发送邮件。

**发送流程**：选择目标用户 → 选择模板 → 确认发送。

---

## 第三章 商品管理

### 3.1 功能概述

商品管理是系统的核心模块，覆盖商品从创建、编辑、规格管理、库存维护到评价管理的全生命周期。

**管理范围**：
- 商品基本信息（名称、分类、价格、库存）
- 商品属性与规格（SKU 管理）
- 商品图片与相册
- 虚拟商品（下载类、卡密类）
- 商品评价与心愿单

---

### 3.2 商品列表

**操作路径**：【商品管理】→ 商品管理

#### 3.2.1 页面说明

- **搜索栏**：位于列表上方，包含多个筛选条件
- **操作栏**：添加商品、删除选中按钮
- **数据表格**：展示商品信息
- **底部分页栏**

#### 3.2.2 搜索条件

| 搜索项 | 说明 |
|---|---|
| 商品状态 | 全部/上架/下架 |
| 商品类型 | 实体/虚拟/下载/卡密 |
| 所属店铺 | 搜索选择框 |
| 其他条件 | 价格范围、日期范围等 |

#### 3.2.3 表格列说明

| 列名 | 内容说明 |
|---|---|
| 复选框 | 用于批量操作 |
| 图 | 缩略图 + ID 标签 |
| 产品名称 | 名称 + 平台分类 + 店铺分类 + 徽标 |
| 店铺 | 所属店铺 + 员工 |
| 价格 | 价格区间，标注不参与促销商品 |
| 库存 | 总库存，标注无限库存/预警库存/已售量 |
| 上线 | 切换开关，直接修改上下架状态 |
| 时间 | 创建时间和修改时间 |
| 操作 | 复制、编辑、删除 |

#### 3.2.4 批量操作

勾选多个商品后，可执行：
- 批量上架/下架
- 批量删除
- 批量设置分类

---

### 3.3 添加/编辑商品

**操作路径**：【商品管理】→ 商品管理 → 添加/编辑

#### 3.3.1 页面说明

商品编辑页采用 **Tab 分页** 方式组织，共 4 个标签页。填写完成后点击底部「保存」统一提交。

可通过 URL 参数 `tab=base|attr|spec|gallery` 直接定位到指定标签页。

#### 3.3.2 基础信息（Tab 1）

按行依次排列以下字段：

**第一行**
- 平台分类：从分类树级联选择
- 平台品牌：搜索选择框

**第二行**
- 发货方式：下拉选择
- 运费模板：搜索选择

**第四行**
- 缩略图：上传图片，带预览
- 产品价格：价格 ~ 最高价，单位元
- 总库存：有限/无限 下拉选择 + 数量输入
- 是否上线：上线/下架 单选按钮

**第五行**
- 单位：如&#34;件&#34;&#34;双&#34;&#34;个&#34;
- 徽标：多个用逗号分隔，如&#34;新品,热销&#34;
- 预警库存：低于此值时系统提醒

**第六行**
- 促销活动：参与促销/不参与促销
- 限购方式：不限制/每人/每单
- 限购数量：0 表示不限制

#### 3.3.3 商品属性（Tab 2）

按分组动态管理商品属性，可根据商品类型显示不同的属性组。

**操作**：支持添加/删除属性组、添加/删除属性和属性值。

#### 3.3.4 商品规格（Tab 3）

**操作流程：**
1. 点击「从预设选择」按钮，从平台预设规格库选取规格（如颜色、尺寸）
2. 为每个规格添加具体值（如红色、蓝色、S、M、L）
3. 系统自动根据规格组合生成 SKU 表格（笛卡尔积）

**SKU 表格说明：**

| 列名 | 必填 | 说明 |
|---|---|---|
| 成本价 | 否 | 仅后台可见 |
| 市场价 | 否 | 显示为划线价 |
| 售价 | 是 | 实际销售价格 |
| 库存 | 否 | 该 SKU 独立库存 |
| SKU 编号 | 否 | 商家自定义货号 |
| 重量 | 否 | 用于运费计算，单位克 |

> **提示**：每列底部设有「批量设置」功能——在该列底部的输入框中填入数值，点击上箭头图标即可批量填充整列。

#### 3.3.5 商品相册（Tab 4）

按规格组合分组展示图片上传区域：
- 每个规格组合对应一个上传分组（如&#34;红色-S&#34;）
- 每个分组使用 Dropzone 拖拽上传组件
- 支持「从服务器选择」已有图片

---

### 3.4 货品管理（SKU 管理）

**操作路径**：【商品管理】→ 货品管理

#### 3.4.1 功能说明

每个 SKU（库存量单位）对应商品的一个规格组合，可独立管理价格和库存。

**表格列**：商品名称、规格组合描述、SKU 编码、价格、库存、重量、图片。

#### 3.4.2 业务场景示例

同一款 T 恤，红色 S 码售价 99 元库存 50 件，红色 L 码售价 109 元库存 30 件。买家选择规格后系统扣减对应 SKU 库存。

---

### 3.5 下载项管理

**操作路径**：【商品管理】→ 下载项管理

管理虚拟下载类商品的附件（电子书、软件安装包等）。

**字段**：关联商品、文件名称、文件大小、下载次数、有效期（下单后几天内可下载）。

---

### 3.6 虚拟卡管理

**操作路径**：【商品管理】→ 虚拟卡管理

管理卡密类商品（充值卡、激活码、兑换券）。

**字段**：关联商品、卡号、密码、有效期、状态（未售/已售/已使用）、购买订单号。

**批量导入**：支持粘贴文本或上传 CSV 文件，格式为 `卡号,密码`，每行一条。

> ⚠️ **注意**：买家购买后自动分配卡密。已售卡密不可删除。

---

### 3.7 商品内容模板

**操作路径**：【商品管理】→ 商品内容模板

预设商品详情模板，适用于批量录入同类商品（如电子产品参数表）。创建模板后添加商品时可一键套用再微调。

---

### 3.8 心愿单

**操作路径**：【商品管理】→ 心愿单

统计商品被用户收藏的情况，用于分析受欢迎程度和选品决策。

**表格列**：商品名称、收藏用户数、添加时间。

---

### 3.9 商品评价

**操作路径**：【商品管理】→ 商品评价

#### 3.9.1 功能说明

管理买家对商品的评价。

**表格列**：商品名称、买家昵称、评分（1-5 星）、评价内容、晒图、回复数、评价时间、审核状态。

#### 3.9.2 操作方法

- **回复评价**：点击对应商品的回复按钮，输入回复内容
- **修改/删除评价**：在操作区选择对应操作
- **评价回复管理**：查看/编辑/删除已有回复

---

## 第四章 订单管理

### 4.1 功能概述

覆盖订单从创建到完成的全部生命周期管理，包括订单查询、发货、退款、售后等操作。

**管理范围**：
- 订单查询与详情查看
- 订单发货与物流管理
- 退款处理与售后申请
- 订单备注与状态跟踪

---

### 4.2 订单列表

**操作路径**：【订单管理】→ 订单管理

#### 4.2.1 搜索筛选区

订单列表上方提供 14 个筛选项：

| 筛选条件 | 控件类型 | 说明 |
|---|---|---|
| 订单状态 | 下拉框 | 待付款/待发货/已发货/已完成/已取消/退款中等 |
| 订单类型 | 下拉框 | 按订单类型筛选 |
| 订单买家 | 搜索选择 | 按买家账号查找 |
| 所属商家 | 搜索选择 | 按商家查找 |
| 所属店铺 | 搜索选择 | 按店铺查找 |
| 有无退款 | 下拉框 | 有退款/无退款 |
| 付款方式 | 下拉框 | 支付宝/微信等 |
| 过期订单 | 下拉框 | 已过期/未过期 |
| 过期时间 | 日期输入 | 指定过期时间范围 |
| 付款时间 | 日期输入 | 指定付款时间范围 |
| 下单时间 | 日期输入 | 指定下单时间范围 |
| 外部单号 | 文本输入 | 第三方平台单号 |
| 付款单号 | 文本输入 | 系统付款单号 |
| 订单编号 | 文本输入 | 支持模糊搜索，带搜索按钮 |

#### 4.2.2 表格列说明

| 列名 | 内容说明 |
|---|---|
| 复选框 | 用于批量操作 |
| 订单号 | 订单号、外部单号、创建/更新/过期时间 |
| 店铺 | 店铺名称 + 商家名称 |
| 客户 | 买家账号，可跳转用户主页 |
| 标价 | 售价/市价/成本/优惠 |
| 杂费 | 运费/税费/服务费/其他 |
| 支付 | 金额/时间/方式/途径 |
| 扩展数据 | 订单附加数据 |
| 退款 | 退款金额（有退款时高亮） |
| 状态 | 彩色文字标签 |
| 操作 | 查看详情、删除、退款、查付款状态等 |

#### 4.2.3 操作方法

**查看订单详情**
1. 点击订单操作区的「查看详情」按钮（眼睛图标）
2. 进入订单详情页查看完整信息

**发起退款**
1. 点击操作区的「发起退款」按钮
2. 弹出对话框，填写退款金额和退款原因
3. 提交后系统自动调用支付网关执行退款

**查询付款状态**
用于支付回调丢失时的修复。点击「查付款状态」按钮，系统主动向支付网关查询。

**将订单放入回收站**
点击「放入回收站」按钮，确认后软删除。可在已删订单页面恢复。

#### 4.2.4 批量操作
- 勾选多个订单后点击「放入回收站」批量软删除
- 回收站页面中可批量永久删除

---

### 4.3 订单详情

**操作路径**：【订单管理】→ 订单管理 → 查看详情

订单详情页分为三个信息面板：

#### 4.3.1 订单信息面板

上半部分以表单形式展示以下信息（均为只读）：

| 信息项 | 说明 |
|---|---|
| 订单编号 | 右侧有复制图标，可复制订单号 |
| 商家店铺 | 可跳转前端店铺页 |
| 客户 | 可跳转前端用户主页 |
| 支付方式/途径 | 支付宝/微信等 |
| 市场总价/成本总价 | 金额统计 |
| 售价总价 | 橙色加粗显示 |
| 优惠总额 | 可点击查看优惠详单 |
| 总运费/税费/服务费/其他 | 费用明细 |
| 实付总价 | 绿色加粗。状态为进行中时显示「改价」按钮 |
| 支付时间 | 已支付时显示 |
| 创建/更新/过期时间 | 时间信息 |
| 退款金额 | 可跳转退款单列表 |
| 订单状态 | 彩色标签显示 |

下半部分为两栏布局：
- **左侧**：收货地址（完整地址、收件人、电话）
- **右侧**：发货信息（物流轨迹、发货记录）

#### 4.3.2 商品列表面板

显示订单内全部商品的明细表格。

**表格列**：
- 复选框（多商品时用于选择发货）
- 商品图片（100×100，点击跳转前端商品页）
- 商品名称 + 规格描述 + 定制信息
- 单价 × 数量 + 已发货数 + 已退货数
- 总价 / 实付总价（含运费、税费、服务费、其他）
- 优惠金额
- 重量/体积
- 状态文字

**发货操作**：订单可发货时，面板右上角显示：
- 「发货全部商品」按钮 —— 进入发货页
- 「发货选中商品」按钮 —— 仅发货勾选的商品

#### 4.3.3 备注信息面板

- 展示已有备注列表
- 「添加订单备注」按钮：点击弹出对话框，输入备注内容，选择是否「内部备注」（仅后台可见）

---

### 4.4 订单发货

**操作路径**：【订单管理】→ 订单管理 → 查看详情 → 发货

#### 4.4.1 操作流程

1. 从订单详情页点击「发货」进入发货页
2. 页面按商品类型分组，每组包含以下内容：

**发货方式**
- 下拉选择：物流配送 / 自提 / 无需物流等
- 选择物流配送时显示物流相关字段

**发货说明**
- 文本框，可填写备注

**实体商品额外字段**
- 发货地址：显示当前默认地址，点击「选择」按钮从店铺地址库选取
- 收货地址：显示当前地址，点击「修改」调整，点击「选择」从用户地址库选取

**发货商品**
- 表格列出该组所有商品
- 填写每件商品的发货数量（支持部分发货）

3. 点击底部「保存」完成发货

---

### 4.5 售后服务列表

**操作路径**：【订单管理】→ 售后服务

#### 4.5.1 功能说明

买家提交售后申请后的处理面板。支持退款、退货退款、换货、维修等类型。

> **注意**：需功能门控 `shopx-after-sale-service` 开启。

#### 4.5.2 搜索筛选

- 状态下拉框：筛选不同处理状态的售后单
- 单号搜索框：按售后单号搜索

#### 4.5.3 表格列说明

| 列名 | 说明 |
|---|---|
| 复选框 | 批量删除 |
| ID | 可点击跳转售后详情页 |
| 订单 ID | 可点击跳转关联订单详情 |
| 服务单号 | 系统生成唯一编号 |
| 描述 | 买家填写的售后说明 |
| 金额 | 退款金额或维修费 |
| 售后类型 | 退款/退货退款/换货/维修 |
| 处理状态 | 可点击直接修改状态 |
| 资金状态 | 退款进度或维修金付款状态 |
| 物流状态 | 退货物流进度 |
| 时间 | 创建/更新时间 |
| 操作 | 查看详情、删除 |

> **提示**：处理状态可通过点击状态文字直接修改，即时生效无需刷新页面。

---

### 4.6 退款单列表

**操作路径**：【订单管理】→ 退款单

#### 4.6.1 功能说明

系统退款单据管理，关联支付网关资金操作。

#### 4.6.2 搜索筛选

- 状态下拉框：不限/成功/失败/进行中等
- 单号搜索框：按订单号搜索

#### 4.6.3 表格列说明

| 列名 | 说明 |
|---|---|
| ID | 退款单编号 |
| 单号 | 订单号、退款单号、收银台号、支付网关号 |
| 币种 | 货币单位 |
| 金额 | 订单金额 / 退款金额（粗体）/ 剩余金额 |
| 退款原因 | 原因 + 补充描述 |
| 退款状态 | 彩色徽章显示 |
| 时间 | 创建/修改时间 |
| 操作 | 删除、重试、查询状态、设为已退款 |

#### 4.6.4 操作方法

| 场景 | 操作 | 说明 |
|---|---|---|
| 退款发送失败（状态 sendfailed） | 点击「重试」 | 重新发起退款请求 |
| 退款进行中（状态 inprogress） | 点击「查询退款状态」 | 主动查询支付网关结果 |
| 线下退款 | 点击「设为已退款」 | 填写交易号后手动标记完成 |

---

## 第五章 支付管理

### 5.1 功能概述

集中管理所有付款单据和支付网关回调日志，用于资金对账和故障排查。

---

### 5.2 付款单列表

**操作路径**：【支付管理】→ 付款单

#### 5.2.1 表格列说明

| 列名 | 说明 |
|---|---|
| ID | 付款单编号 |
| 单号/客户/币种 | 包含单号、客户名、币种、类型、支付币种及汇率 |
| 订单数量 | 可点击跳转关联订单列表 |
| 价格 | 总售价、优惠额、运费、税费、实付额等汇总 |
| 方式/途径/状态 | 支付方式 + 支付途径 + 状态文字 |
| 付款时间/交易流水 | 支付时间 + 支付网关交易号 |
| 时间 | 创建/更新时间 |
| 操作 | 查询付款状态、删除 |

#### 5.2.2 查询付款状态

当付款单状态为未支付或支付失败时，操作区显示「查询付款状态」按钮，点击后系统向支付网关查询最新状态。

---

### 5.3 回调记录

**操作路径**：【支付管理】→ 回调记录

#### 5.3.1 功能说明

支付网关异步通知的原始日志。用于排查&#34;用户已付款但订单状态未更新&#34;等问题。

**信息字段**：关联单号、支付网关、回调原始数据、处理状态、回调 IP、回调时间。

#### 5.3.2 排查流程

1. 用户反馈已付款但订单未更新
2. 进入回调记录查看是否有该订单的回调记录
3. 无记录 → 检查支付网关回调地址配置
4. 有记录但处理失败 → 查看错误日志，检查签名验证

---

## 第六章 购物车管理

### 6.1 功能概述

查看所有用户在前端添加的购物车商品，主要用于后台辅助管理和问题排查。

---

### 6.2 购物车列表

**操作路径**：【购物车管理】→ 购物车管理

#### 6.2.1 表格列说明

| 列名 | 说明 |
|---|---|
| 复选框 | 批量删除 |
| ID | 购物车记录编号 |
| 客户/会话 | 已登录用户显示用户名（可跳转用户主页），未登录显示会话 ID |
| 店铺 | 商品所属店铺及商家 |
| 商品/规格 | 商品名、货品名、规格描述 |
| 数量 | 加入购物车的数量 |
| 单价 | 售价/市价/成本 |
| 总价 | 总价/优惠/实付 |
| 状态 | 购物车项目状态 |
| 更新时间 | 最后更新时间 |
| 操作 | 仅删除 |

#### 6.2.2 清理机制

- 用户下单后对应购物车项自动清理
- 超过设定天数（如 30 天）的购物车记录可被系统自动清理
- 用户反馈无法操作时，后台可协助清空指定购物车项

---

## 第七章 平台配置

### 7.1 功能概述

平台级别的全局配置模块。所有设置项影响全部商家和店铺，**仅限平台超级管理员操作**。

---

### 7.2 商品分类（平台级）

**操作路径**：【平台配置】→ 商品分类

#### 7.2.1 功能说明

平台统一的商品分类体系，树形多级结构（通常三级）。所有商家发布商品时从此分类中选择。

#### 7.2.2 页面说明

- 顶部「添加商品平台分类」按钮
- 树形数据表格，支持展开/折叠子分类

#### 7.2.3 表格列说明

| 列名 | 说明 |
|---|---|
| ID | 分类编号 |
| 分类名称 | 点击名称可展开/折叠子分类，子分类延迟加载 |
| 分类说明 | 描述文字 |
| 商品类型 | 关联的商品类型 |
| 创建时间 | 格式：年-月-日 时:分:秒 |
| 热门 | 开关切换，标记热门分类 |
| 显示在菜单 | 开关切换，控制前端展示 |
| 状态 | 开关切换，启用/禁用 |
| 操作 | 添加子分类、编辑、删除 |

#### 7.2.4 操作方法

**添加顶级分类**
1. 点击「添加商品平台分类」
2. 填写分类名称，上级分类留空
3. 设置排序值，上传分类图片
4. 提交

**添加子分类**
1. 在目标分类行点击「添加子分类」
2. 填写名称和排序
3. 提交

> ⚠️ **注意**：有子分类时须先删除子分类才能删除父分类；分类下有商品时提示重新分类。

---

### 7.3 商品品牌

**操作路径**：【平台配置】→ 商品品牌

平台品牌库。商家发布商品时选择品牌。

**字段**：品牌名称、Logo（图片上传）、官网链接、品牌描述、排序、是否启用。

---

### 7.4 商品定制方案

**操作路径**：【平台配置】→ 商品定制方案

> **注意**：需功能门控 `shopx-goods-custom` 开启。

#### 7.4.1 功能说明

允许买家对商品进行个性化定制，支持多种输入类型。

#### 7.4.2 定制项类型

| 类型 | 说明 | 应用示例 |
|---|---|---|
| 单行文本 | 输入一行文字 | 刻字内容 |
| 多行文本 | 多行文字输入 | 定制备注 |
| 单选 | 从多选一 | 字体选择 |
| 多选 | 选多个 | 配件选择（礼盒+贺卡） |
| 图片上传 | 上传定制图 | 印照片 |
| 文件上传 | 上传设计稿 | 文件交付 |

#### 7.4.3 每个定制项的设置

名称、类型、是否必填、选项值列表（单选/多选时）、加价金额、排序。

---

### 7.5 特色商品集

**操作路径**：【平台配置】→ 特色商品集

推荐商品集合，用于首页展示、专题活动等。

**操作流程**：添加集合 → 填写名称/描述/封面 → 搜索并选择关联商品 → 调整排序 → 发布。

---

### 7.6 商品类型

**操作路径**：【平台配置】→ 商品类型

定义平台商品类型。系统预设类型如下：

| 类型 | 特征 |
|---|---|
| 实体商品 | 需要物流配送 |
| 虚拟商品 | 无需物流，在线交付 |
| 下载商品 | 付款后提供文件下载 |
| 卡密商品 | 付款后分配卡号密码 |

---

### 7.7 商品规格（平台级）

**操作路径**：【平台配置】→ 商品规格

全局共享规格定义（如鞋码 36-45、内存容量），所有商家可用。

> **提示**：平台规格全局统一，商家规格仅限本店使用。两者相互独立。

---

### 7.8 规格值

**操作路径**：【平台配置】→ 规格值

为平台规格创建可选值列表，支持设置颜色色值用于前端色块展示。

---

### 7.9 店铺分类（平台级）

**操作路径**：【平台配置】→ 店铺分类

平台级店铺分类，买家可按分类浏览店铺。

---

### 7.10 促销活动

**操作路径**：【平台配置】→ 促销活动

#### 7.10.1 活动类型

| 类型 | 规则 | 示例 |
|---|---|---|
| 满减 | 满 N 元减 M 元 | 满 200 减 30 |
| 折扣 | 打 X 折 | 全场 8 折 |
| 包邮 | 满 N 元包邮 | 满 99 包邮 |
| 秒杀 | 限时特价，库存有限 | 10:00 秒杀 9.9 |
| 满赠 | 满 N 元赠品 | 满 500 送赠品 |

#### 7.10.2 表格列说明

| 列名 | 说明 |
|---|---|
| 复选框 | 批量删除 |
| 状态 | 启用/禁用切换开关 |
| ID | 活动编号 |
| 活动名称 | 营销活动名称 |
| 活动类型 | 满减/折扣/包邮等 |
| 活动时间 | 开始时间 ~ 结束时间 + 预告时间 |
| 叠加其它活动 | 是（绿色勾）/ 否（红色叉） |
| 重复参加次数 | 每人可参与次数 |
| 编辑时间 | 添加时间和更新时间 |
| 操作 | 复制、编辑、删除 |

#### 7.10.3 操作方法

**添加活动**
1. 点击「添加促销活动」
2. 填写基本信息和活动时间范围
3. 配置活动规则（如满减阶梯、折扣率）
4. 选择适用商品范围
5. 提交

> **注意**：到开始时间后活动自动生效。活动时间不可与同类型活动重叠。秒杀活动建议使用独立库存。

---

### 7.11 快递公司

**操作路径**：【平台配置】→ 快递公司

维护快递公司信息。前台下单和后台发货时选择。

**字段**：公司名称、编码（对接快递 API）、官网、排序、是否启用、联系电话。

> ⚠️ **注意**：公司编码必须与快递查询 API 中的编码一致，否则无法查询物流轨迹。

---

### 7.12 物流信息

**操作路径**：【平台配置】→ 物流信息

**功能清单**：
- **查看物流轨迹**：输入运单号查询实时物流信息
- **设计打印模板**：自定义面单布局（商家信息、收件人信息、商品信息位置和字体），不同快递公司可配置不同模板
- **打印物流单**：选择订单和打印模板，批量打印快递面单

---

### 7.13 售后原因

**操作路径**：【平台配置】→ 售后原因

#### 7.13.1 功能说明

配置买家申请售后时可选择的预设原因。

**字段**：原因描述、适用类型（退款/退货退款/换货/全部）、排序、是否启用。

> **提示**：七天无理由退货等法定原因建议保持启用。常用原因排在前面以提升买家选择体验。

---

## 附录

### A. 列表页通用布局

系统所有列表页面遵循统一布局规范：

```
┌──────────────────────────────────────────────┐
│ [添加] [删除选中]    页面标题       刷新     │  ← 顶部操作栏
├──────────────────────────────────────────────┤
│ 筛选条件1  筛选条件2  [搜索]  [重置]        │  ← 搜索筛选区
├──────┬────────┬────────┬────────┬────────────┤
│  ☐   │  列A   │  列B   │  列C   │  操作      │  ← 表头行
├──────┼────────┼────────┼────────┼────────────┤
│  ☐   │ 数据   │ 数据   │ 数据   │ [编辑][删]│  ← 数据行
│  ☐   │ 数据   │ 数据   │ 数据   │ [编辑][删]│
│  ☐   │ 数据   │ 数据   │ 数据   │ [编辑][删]│
├──────┴────────┴────────┴────────┴────────────┤
│ 共 N 条  上一页  1  2  3 ... N  下一页       │  ← 分页栏
└──────────────────────────────────────────────┘
```

### B. 编辑页通用布局

```
┌──────────────────────────────────────────────┐
│  页面标题                          [返回]    │  ← 头部
├──────────────────────────────────────────────┤
│  Tab1  |  Tab2  |  Tab3  |  Tab4            │  ← 标签页（多信息模块时）
├──────────────────────────────────────────────┤
│  字段标题     [输入框 / 下拉框 / 选择]       │  ← 表单行
│  字段标题     [文本域]                       │
│  字段标题     [文件上传]                     │
│  ...                                         │
├──────────────────────────────────────────────┤
│                    [提交]  [重置]             │  ← 按钮区
└──────────────────────────────────────────────┘
```

### C. 按钮/图标速查表

| 图标 | 含义 | 操作说明 |
|---|---|---|
| 铅笔 (fa-pencil) | 编辑 | 进入编辑页面修改数据 |
| 叉号 (fa-times) | 删除 | 删除当前记录 |
| + 号 (fa-plus) | 添加 | 创建新记录 |
| 复制 (fa-copy) | 复制 | 基于当前记录复制创建 |
| 眼睛 (fa-eye) | 查看详情 | 进入详情页 |
| 货车 (fa-truck) | 发货 | 进入订单发货页 |
| 搜索 (fa-search) | 查询状态 | 主动向支付网关查询 |
| 重试 (fa-retweet) | 退款重试 | 重新发起退款请求 |
| 齿轮 (fa-gear) | 配置 | 进入配置页 |
| 信封 (fa-envelope) | 邮件订阅 | 管理邮件订阅 |
| 心形 (fa-heart) | 售后服务 | 查看售后服务 |
| 购物车 (fa-shopping-cart) | 购物车管理 | 购物车菜单图标 |

### D. 功能门控说明

| 门控标识 | 名称 | 影响范围 |
|---|---|---|
| shopx-after-sale-service | 售后服务 | 订单和店铺菜单中的售后功能 |
| shopx-goods-custom | 商品定制 | 平台配置中的定制方案管理 |

### E. 常见问题

**Q：页面显示为空白的可能原因？**
1. 功能门控未开启 → 检查系统设置中的功能门控
2. 权限不足 → 确认账号角色有对应菜单权限

**Q：保存失败如何处理？**
1. 检查必填字段是否填写完整
2. 检查输入格式是否正确（如日期格式、金额格式）
3. 检查是否有同名记录冲突

**Q：删除后能否恢复？**
- 商家/店铺/商品：删除后不可恢复
- 订单：放入回收站后可恢复，永久删除后不可恢复
- 备注/评价：删除后不可恢复

ShopX 电商系统操作说明书

Shopx商城系统

Share this article

Comments (0)

To comment

ShopX 电商系统 操作说明书

Shopx商城系统

Share this article

Comments (0)

To comment

To comment

ShopX 电商系统操作说明书