# LiteMall 轻商城 - 管理员使用手册

---

## 一、快速入门

### 1.1 登录后台
访问 `http://你的服务器IP:3001/admin`

**默认登录信息：**
| 角色 | 账号 | 密码 |
|------|------|------|
| 超级管理员 | admin | admin888 |

> ⚠️ **首次使用请务必修改默认管理员密码！**

### 1.2 界面布局说明

管理后台分为三大部分：

**左侧导航栏**：按照功能模块分组组织，包括主菜单（仪表盘、商品、订单、会员）、运营（分销、营销、AI客服、数据统计、导出、库存预警）、系统（设置、操作日志、通知管理）三组。

**顶部工具栏**：显示当前页面标题和用户菜单（头像、退出登录）。

**主内容区**：展示当前模块的详细内容和操作界面。

### 1.3 修改管理员密码

1. 登录后台
2. 点击顶部右侧管理员头像 → 选择「退出登录」
3. 重新登录后，进入「系统设置 → 安全设置」修改密码
4. 填写旧密码和新密码，点击保存

---

## 二、仪表盘

仪表盘展示商城核心运营数据概览：

| 指标 | 说明 |
|------|------|
| 今日订单 | 当天新下单数量 |
| 今日销售额 | 当天已完成支付的总金额 |
| 总用户数 | 注册用户总数（不含管理员） |
| 待发货 | 等待发货的订单数 |
| 退款售后 | 等待审核的退款申请数 |
| 库存不足 | 库存量 ≤ 10 的商品数 |

同时展示近7日销售趋势图（ECharts 图表），以及快捷操作入口。

---

## 三、商品管理

### 3.1 商品列表

商品管理页面以表格形式展示所有商品，支持：

- **搜索**：按商品名称搜索
- **筛选**：按上架/下架状态筛选
- **分页**：每页20条，支持翻页

表格列包含：商品（图片+名称+副标题）、价格、库存、销量、状态（上架/下架标签）、创建时间、操作。

### 3.2 新增商品

点击「✚ 新增商品」按钮，在弹出的对话框中填写：

**基本信息 Tab：**
- 商品名称（必填，≤200字）
- 副标题（选填，营销卖点）
- 分类（选择已有分类）
- 单位（如：件、个、条）
- 售价（必填，>0）
- 原价（选填）
- 库存数量
- 排序值（数字越小越靠前）
- 商品图片（支持图片URL）
- 商品属性：新品、热销、推荐（多选）

**详情描述 Tab：**
- 支持HTML格式的商品详情描述
- 可粘贴图文混排的商品详情

### 3.3 编辑商品

在商品列表点击「编辑」按钮，可修改商品所有信息，包括：
- 基本信息修改
- SKU规格编辑（支持多规格：颜色、尺寸等）
- 规格值管理

### 3.4 商品上下架

点击「上架」或「下架」按钮切换商品状态：
- 上架：用户端可见可购买
- 下架：用户端不可见

### 3.5 删除商品

点击「删除」按钮，确认后永久删除商品及其SKU、规格数据。**删除不可恢复，请谨慎操作。**

### 3.6 商品复制

在商品详情页或管理端支持一键复制商品，快速创建相似商品。

### 3.7 批量操作

- **批量上下架**：勾选多个商品，点击批量操作按钮
- **批量更新库存**：支持一次性更新多个商品的库存数量

### 3.8 分类管理

在商品管理模块中管理的分类：
- 分类支持多级（支持pid层级关系）
- 支持分类名称、图标、图片、排序设置
- 分类下架后，关联商品在前端不显示该分类

---

## 四、订单管理

### 4.1 订单处理流程

```
用户下单 → 待付款 → 付款 → 待发货 → 发货 → 已发货 → 用户确认收货 → 已完成
                                    ↓
                              退款中 → 审核 → 已退款 / 已驳回
```

### 4.2 订单状态说明

| 状态 | 说明 | 管理员可操作 |
|------|------|-------------|
| 待付款 | 用户已下单但未支付 | 无操作（可手动关闭） |
| 待发货 | 已支付，等待商家发货 | 发货（填写快递信息） |
| 已发货 | 已填快递单号，等待用户签收 | 无操作 |
| 已完成 | 用户确认收货，交易完成 | 无操作 |
| 退款中 | 用户申请退款 | 审核通过 / 驳回退款 |
| 已退款 | 退款已审核通过 | 无操作 |
| 已关闭 | 订单取消或超时未支付 | 无操作 |

### 4.3 发货操作

1. 在订单列表找到状态为「待发货」的订单
2. 点击「发货」按钮
3. 填写快递公司名称和快递单号
4. 点击「确认发货」，订单状态变为「已发货」

### 4.4 查看订单详情

点击「详情」按钮可查看：
- 订单号、下单时间、状态
- 收货人信息（姓名、电话、地址）
- 商品明细（商品名、单价、数量、小计）
- 支付信息（支付金额、优惠金额、运费）
- 快递信息（快递公司、运单号）
- 操作日志（订单全生命周期记录）

### 4.5 退款处理

当有退款申请时，管理员可在订单列表中看到「退款中」状态的订单：

1. **审核通过**：确认退款，系统自动将订单标记为「已退款」
2. **驳回退款**：需填写驳回原因，订单恢复为原状态

### 4.6 订单搜索

支持按以下条件搜索订单：
- **状态筛选**：待付款/待发货/已发货/已完成/已关闭
- **关键词搜索**：订单号、收货人姓名、收货人手机号

### 4.7 超时订单处理

系统内置定时任务，每5分钟检查一次超时未支付订单：
- 超时时间：30分钟（可在代码中配置）
- 自动关闭超时订单，归还商品库存
- 记录订单日志（"系统自动关闭超时订单"）

---

## 五、会员管理

### 5.1 会员列表

展示所有注册用户的信息，包括：

| 字段 | 说明 |
|------|------|
| 用户 | 头像、昵称、手机号 |
| 等级 | 当前会员等级名称 |
| 余额 | 账户余额（可用于消费支付） |
| 总消费 | 累计消费金额 |
| 订单数 | 累计下单数量 |
| 团队 | 分销团队人数 |
| 注册时间 | 用户注册日期 |

支持按昵称/手机号搜索会员。

### 5.2 会员等级配置

系统默认四个等级，支持自定义：

| 等级 | 默认名称 | 经验值门槛 | 折扣 |
|------|---------|-----------|------|
| Lv.1 | 普通用户 | 0 | 10折（无折扣） |
| Lv.2 | 白银会员 | 500 | 9折 |
| Lv.3 | 黄金会员 | 2,000 | 8.5折 |
| Lv.4 | 钻石会员 | 8,000 | 8折 |

管理员可：
- 新增等级（自定义名称、经验值、折扣率）
- 编辑现有等级
- 删除等级（慎用）

### 5.3 会员套餐管理

系统默认套餐（可自定义）：

| 套餐名称 | 类型 | 价格 | 赠送等级 | 赠送经验 |
|---------|------|------|---------|---------|
| 白银月卡 | 月卡 | 39.00元 | 白银会员 | 500 |
| 黄金月卡 | 月卡 | 69.00元 | 黄金会员 | 2,000 |
| 钻石月卡 | 月卡 | 119.00元 | 钻石会员 | 8,000 |

会员购买套餐后自动升级等级、增加经验值，等级折扣实时生效。

### 5.4 用户编辑

管理员可直接修改用户信息：
- 昵称、手机号
- 会员等级
- 账户状态（正常/禁用）
- 账户余额

---

## 六、分销管理

### 6.1 开启分销

1. 进入「系统设置 → 模块开关」
2. 找到「分销体系」模块，开启开关
3. 进入「分销管理」配置详细参数

### 6.2 分销配置

| 配置项 | 默认值 | 说明 |
|--------|-------|------|
| 是否开启分销 | 开启 | 全局开关 |
| 自动结算天数 | 7天 | 订单完成后N天自动结算佣金 |
| 最低提现金额 | 10元 | 分销员申请提现的最低金额 |
| 提现手续费率 | 0% | 提现时扣除的手续费比例 |

### 6.3 分销等级

| 等级 | 名称 | 条件 | 一级佣金 | 二级佣金 | 三级佣金 |
|------|------|------|---------|---------|---------|
| Lv.1 | 普通分销商 | 注册即享 | 5% | 2% | 1% |
| Lv.2 | 高级分销商 | 团队≥10人 + 团队销售≥5000元 | 8% | 3% | 1.5% |
| Lv.3 | 金牌分销商 | 团队≥50人 + 团队销售≥50000元 | 12% | 5% | 2% |

### 6.4 分销商管理

查看所有已绑定上下级关系的分销商列表：
- 昵称、手机号
- 团队人数
- 佣金总额
- 总消费金额

### 6.5 佣金记录

查看所有佣金明细：
- 关联订单号
- 分销商信息
- 商品金额
- 佣金金额
- 状态（待结算 / 已结算）

管理员可手动结算待结算佣金。

### 6.6 提现审核

查看分销商的提现申请：
- 申请人信息
- 提现金额（含手续费）
- 收款账户信息
- 状态（待审核 / 已通过 / 已拒绝）

管理员操作：
- **审核通过**：确认提现，从用户余额中扣除
- **驳回提现**：需填写驳回原因，解冻用户余额

---

## 七、营销工具

### 7.1 优惠券管理

支持三种优惠券类型：

| 类型 | 说明 | 示例 |
|------|------|------|
| 满减券 | 满一定金额减固定金额 | 满100减20 |
| 折扣券 | 享受折扣 | 全场8折 |
| 代金券 | 直接抵扣固定金额 | 10元代金券 |

优惠券配置字段：
- 名称、类型、面值
- 满额条件（满减券使用）
- 最大优惠金额（折扣券使用）
- 发放总量、每人限领数量
- 有效期（天数或起止时间）

### 7.2 秒杀活动

配置限时秒杀：
- 选择参与秒杀的商品
- 设置秒杀价格
- 设置秒杀库存
- 每人限购数量
- 活动开始时间和结束时间

### 7.3 拼团活动

配置拼团购买：
- 选择参与拼团的商品
- 设置拼团价格
- 最低成团人数
- 活动开始时间和结束时间

---

## 八、AI客服管理

### 8.1 启用AI客服

1. 进入「系统设置 → AI客服」配置区域
2. 开启「AI客服开关」
3. 配置欢迎语和兜底回复

### 8.2 知识库管理

在「AI客服」模块中管理知识库条目：

| 字段 | 说明 |
|------|------|
| 分类 | 如：物流、退换货、商品咨询 |
| 问题 | 用户可能问的问题 |
| 答案 | 自动回复的内容 |
| 关键词 | 逗号分隔，用于匹配用户消息 |
| 权重 | 匹配优先级，数字越大优先级越高 |

**批量导入**：支持通过接口批量导入知识库数据。

### 8.3 AI客服工作流程

```
用户发送消息 → 关键词匹配知识库 → 找到匹配条目 → 返回答案
                                ↓
                           未匹配 → 自动回复已开启 → 返回兜底回复
                                ↓
                           未匹配 → 自动回复已关闭 → 不回复
```

---

## 九、数据统计

### 9.1 销售趋势

支持按日/周/月查看销售趋势：
- 销售额曲线
- 订单数量柱状图
- 平均客单价

### 9.2 热销商品TOP

展示销量最高的商品排行：
- 商品名称、图片
- 销售数量、销售金额
- 订单数

### 9.3 用户增长

查看用户注册趋势：
- 每日新增用户数
- 支持时间段切换

### 9.4 会员统计

- 总用户数、VIP用户数、VIP占比
- 会员等级分布
- 会员收入统计

### 9.5 订单状态分布

以饼图形式展示订单状态分布：
- 待付款、待发货、已发货、已完成、已关闭等

### 9.6 数据导出

支持导出 CSV 格式数据：

**订单导出**：订单号、下单时间、状态、支付金额、商品总额、优惠金额、支付方式、收货人、电话、地址、备注、用户信息

**用户导出**：用户ID、昵称、手机号、余额、累计消费、订单数、经验值、团队人数、等级、注册时间

**商品导出**：商品ID、名称、售价、原价、成本价、库存、销量、状态、分类

### 9.7 库存预警

- 展示库存低于阈值（默认10件）的商品和SKU
- 支持自定义预警阈值

---

## 十、系统设置

### 10.1 基本信息设置

| 配置项 | 说明 |
|--------|------|
| 站点名称 | 商城名称，前台显示 |
| 站点Logo | 商城LOGO图片URL |
| 站点描述 | 网站描述，SEO用途 |
| ICP备案号 | 底部显示 |
| 客服电话 | 前台联系显示 |
| 客服邮箱 | 前台联系显示 |

### 10.2 支付配置

**微信支付配置：**
- AppId：微信开放平台/公众号APPID
- 商户号：微信支付商户号
- API密钥：32位密钥

**支付宝配置：**
- AppId：支付宝开放平台应用APPID
- 应用私钥：商户私钥
- 支付宝公钥：支付宝公钥

### 10.3 分享设置

- 分享标题
- 分享描述
- 分享图片

### 10.4 轮播图管理

管理首页轮播图：
- 标题
- 图片URL
- 链接地址
- 排序值

### 10.5 CMS页面管理

管理静态页面内容：
- 关于我们
- 隐私政策
- 服务条款
- 支持自定义页面（type=custom）

### 10.6 模块开关

独立控制8大功能模块的开启/关闭：

| 模块 | 说明 |
|------|------|
| 会员体系 | 会员等级、套餐、折扣 |
| 分销体系 | 三级分销、佣金 |
| AI客服 | 智能客服、知识库 |
| 在线支付 | 微信支付、支付宝 |
| 订单售后 | 退款、退货 |
| 优惠券 | 优惠券发放和使用 |
| 秒杀 | 限时秒杀活动 |
| 拼团 | 团购活动 |

### 10.7 运营模式切换

| 模式 | 说明 |
|------|------|
| 测试模式 | 模拟支付，方便调试（默认） |
| 正式模式 | 接入真实支付，正式运营 |

### 10.8 管理员管理

- 查看管理员列表
- 新增管理员（手机号+密码）
- 禁用/启用管理员
- 删除管理员（超级管理员不可删除）

### 10.9 角色权限

| 角色 | 权限 |
|------|------|
| 超级管理员 | 全部权限 |
| 运营 | 商品、订单、用户、营销、分销、AI |
| 财务 | 订单、用户、分销、统计、导出 |
| 客服 | 订单、用户、AI |

### 10.10 数据备份

**手动备份**：点击「立即备份」创建当前数据快照
**自动备份**：系统自动保留最近7天的备份（可配置）
**恢复备份**：选择备份文件点击「恢复」（恢复后需重启服务）

### 10.11 运行日志

查看服务器端运行日志，支持刷新和清除。

### 10.12 操作日志

记录所有管理员的关键操作：
- 商品添加、编辑、删除、上下架
- 订单发货
- 系统配置修改

支持按模块筛选和分页查看。

### 10.13 登录日志

记录所有登录尝试：
- 成功/失败状态
- 手机号
- IP地址
- 设备信息(UA)
- 失败原因
- 登录时间

支持按结果（成功/失败）筛选。

### 10.14 通知管理

- 查看所有系统通知
- 发送系统通知（可发送给全站用户）

---

## 十一、运费模板

支持三种计费方式：

| 类型 | 说明 |
|------|------|
| 按件 | 首件费用 + 续件费用 |
| 按重 | 首重费用 + 续重费用 |
| 包邮 | 达到指定金额免运费 |

---

## 十二、移动端用户操作指南

### 12.1 首页浏览

- 轮播广告：自动播放，点击跳转
- 商品分类：点击进入分类页面
- 限时秒杀：限时特价商品展示
- 推荐商品：管理员推荐的商品展示

### 12.2 商品搜索

支持按商品名称关键词搜索，结果列表展示商品图片、名称、价格。

### 12.3 商品详情

查看商品完整信息，包括：
- 商品图片轮播
- 商品名称、价格、副标题
- 规格选择（如颜色、尺寸）
- 数量选择
- 商品详情（图文描述）
- 加入购物车 / 立即购买

### 12.4 购物车

- 查看购物车商品列表
- 修改商品数量
- 删除商品
- 选中/取消选中商品
- 批量结算

### 12.5 下单支付

1. 确认收货地址
2. 选择使用优惠券
3. 查看订单金额明细（商品总额、优惠金额、实付金额）
4. 选择支付方式
5. 确认下单

### 12.6 订单管理

- 查看订单列表（按状态筛选）
- 查看订单详情和操作日志
- 取消订单（待付款状态）
- 确认收货（已发货状态）
- 申请退款

### 12.7 会员中心

- 查看/编辑个人信息
- 收货地址管理
- 我的收藏
- 我的优惠券
- 会员等级和权益
- 购买会员套餐

### 12.8 分销推广

- 分销概况（团队人数、佣金统计）
- 邀请好友（生成分享链接）
- 佣金记录
- 申请提现
- 团队列表

### 12.9 AI客服

- 创建咨询会话
- 发送消息
- 查看AI自动回复
- 查看历史消息记录

---

## 十三、安全设置

### 13.1 密码策略

- 密码最小长度：6位
- 密码最大长度：32位
- 需包含字母或数字

### 13.2 登录安全

- 登录频率限制：每IP每15分钟最多10次尝试
- 登录失败记录日志（含IP和UA信息）
- 支持图形验证码

### 13.3 API安全

- 全局限流：每IP每15分钟最多1000次请求
- 参数清洗：自动过滤SQL注入和XSS攻击字符
- Helmet安全头保护
- JWT Token认证（7天有效期）
- 角色权限校验
