适用版本：2026-09 版 | 后台地址：演示环境 https://mall-admin.yingri.tech ，本地开发 http://localhost:18600
本手册按后台左侧菜单的顺序写，每节先说"这个页面干什么"，再说"怎么做一件具体的事"。
1. 登录与账号
| 账号类型 | 说明 |
|---|---|
超级管理员 admin |
全部权限。密码不在仓库里，问交付人员 |
只读演示 demo / demo123 |
能看全部商城页面，任何保存/删除操作后端都会拒绝（返回 403）。给客户试用用 |
- 登录需要图形验证码，看不清点一下图片换一张。
- 浏览器用 Chrome / Edge / Safari 新版本即可，不支持 IE。
- 忘记密码没有自助找回，需要管理员在数据库或系统管理里重置。
安全提醒：新建任何非超管账号时，务必确认它的角色权限，EasyAdmin 自带的「系统管理/系统监控」接口默认只校验登录、不校验细粒度权限。
2. 菜单总览
登录后左侧共六个中心：
| 中心 | 页面 | 用途 |
|---|---|---|
| 数据中心 | 商城概览 | 营业额、订单、会员 KPI 与趋势图 |
| 商品中心 | 商品管理、商品分类、品牌管理、规格管理、商品评价 | 卖什么、怎么归类、评价维护 |
| 订单中心 | 订单管理、售后管理、物流管理、运费模板 | 从下单到发货、退款、运费规则 |
| 营销中心 | 优惠券、营销活动、秒杀管理、拼团管理、砍价管理、预售管理、新人礼 | 所有促销玩法 |
| 会员中心 | 会员管理、积分商城、分销管理 | 客户资产与推广 |
| 运营中心 | 首页运营、消息管理 | 小程序首页内容与站内消息 |
另有「日志管理」：商城操作日志、会员登录日志、支付流水、积分流水、余额流水、订单改价记录、定时任务执行记录。出了问题先查这里。
3. 上架第一个商品
顺序很重要：先有分类 → （可选）品牌、规格 → 再建商品。
3.1 建分类（商品中心 → 商品分类）
- 分类是树形，最多建到三级（例：手机数码 → 手机 / 平板电脑）。
- 「是否显示」关掉后，小程序首页分类宫格和分类页都不再出现该分类。
- 分类图标建议传 1:1 的小图（PNG），首页宫格会用到。
3.2 建品牌 / 规格（可选）
- 品牌管理：给商品打品牌标，小程序详情页会显示，并支持按品牌筛选。
- 规格管理：先定义规格组（如「颜色」「容量」）和可选值，建商品时直接挑，不用每次重打。
3.3 建商品（商品中心 → 商品管理 → 新增）
必填与要点：
| 字段 | 说明 |
|---|---|
| 商品名称 / 副标题 | 副标题显示在详情页价格下方 |
| 分类 | 必选，决定小程序分类页能不能找到它 |
| 主图 / 图片列表 | 主图用于列表卡片，图片列表是详情页轮播 |
| 价格 / 市场价 | 价格是展示价（取 SKU 最低价）；市场价是划线价 |
| 是否多规格 | 关闭＝单规格（系统自动生成一个默认 SKU）；开启＝逐条维护 SKU |
| SKU（多规格时） | 每个 SKU 独立价格、库存、编码；商品总库存 = 各 SKU 库存之和 |
| 单件重量 | 只有运费模板按重量计费时才用得上 |
| 运费模板 | 不选＝用默认模板 |
| 商品详情 | 富文本，小程序详情页底部展示 |
| 状态 | 上架才会在小程序出现；下架立即隐藏，但不影响已有订单 |
上架后自检三件事：小程序首页/分类页能不能搜到、详情页价格和库存对不对、加购能不能下单。
3.4 改价与改库存
- 日常改价直接编辑商品/SKU。
- 库存以 SKU 为准，下单时原子扣减、取消自动回补，不要手动对着总库存改。
4. 订单处理（最常用）
4.1 订单状态
| 状态码 | 名称 | 含义 |
|---|---|---|
| 0 | 待付款 | 下单未支付。普通订单 30 分钟、秒杀订单 15 分钟 未付自动取消并回补库存 |
| 10 | 待发货 | 已付款，等商家发货 |
| 20 | 待收货 | 已发货。买家不确认的话，发货 7 天后系统自动确认收货 |
| 30 | 已完成 | 确认收货，可评价、可申请售后 |
| 40 | 售后中 | 有售后单在处理 |
| -1 | 已取消 | 超时/买家取消/商家取消 |
| -2 | 已退款 | 退款完成 |
超时时间和自动收货天数是后端配置项（
MALL_ORDER_PAY_TIMEOUT_MINUTES/MALL_SECKILL_PAY_TIMEOUT_MINUTES/MALL_AUTO_RECEIVE_DAYS），需要改找技术。
4.2 发货
- 订单中心 → 订单管理，按状态筛「待发货」。
- 点「发货」，选物流公司、填快递单号，确认。
- 系统建发货单并写入物流轨迹，买家小程序里立刻能查到。
- 多单一起发：勾选多条 → 「批量发货」。
注意：拼团单在成团前不能发货，预售单在预计发货日之前默认不允许发货（需要强制发货时由技术侧开启）。
4.3 改价（只能改待付款订单）
订单详情 → 「改价」，可调整商品金额或运费。改价会写入「订单改价记录」日志，买家看到的是改后的应付金额。
4.4 备注
订单详情 → 「备注」，仅商家可见，用于记录客服沟通结果。
4.5 手动跑一次生命周期
订单管理页有「执行生命周期」入口，会立即执行一次：超时未付取消、拼团结算、自动确认收货、佣金结算。平时系统每小时自动跑，不用管。
5. 售后与退款
流程：买家在小程序申请 → 后台「售后管理」审核 → 同意后退款/收退货 → 完成。
- 审核：进入售后详情，看凭证图和申请理由，选择同意或拒绝（拒绝要写原因）。
- 退款：同意后点「退款」。仅退款直接退；退货退款要等买家回寄并填单号后再退。
- 库存回补：退货退款完成时按明细数量回补 SKU 库存并扣回销量，系统做了幂等，不会重复回补。
- 当前为模拟退款（不对接真实支付通道），真实退款需要接入微信支付商户号后再开。
6. 物流
- 物流管理：维护可选的物流公司列表；按订单查看/补充物流轨迹。
- 轨迹是演示用的手动/模拟数据，尚未对接真实快递平台 API。
7. 运费模板（订单中心 → 运费模板）
- 支持按件数或按重量计费，可给不同省份设不同首件/续件价格。
- 支持满额包邮；也可以设置不配送区域，买家地址落在该区域会直接拒单。
- 可设一个默认模板；商品不指定模板时用默认。
- 活动订单（秒杀/拼团等）不收运费，但仍然遵守"不配送区域"规则。
8. 营销中心
8.1 优惠券
- 类型：满减券（满 X 减 Y）和折扣券（打 N 折，可设最高优惠）。
- 使用范围：全场 / 指定商品 / 指定分类。范围内商品的金额才计入门槛与抵扣。
- 发放：买家在小程序「领券中心」自行领取，可设每人限领张数、总量、有效期。
- 停用：改状态为停用后，领券中心不再展示，但已领取的券仍可用。
8.2 营销活动（满减满折 / 限时折扣）
- 满减满折：可设多档（满 300 减 30 / 满 600 减 80），系统自动取最优一档，不叠加。
- 限时折扣：指定商品在活动时间内按折扣价卖，可设每人限购；超出限购的部分按原价。
- 限时折扣商品不再参与满减满折，避免叠加过头。
8.3 秒杀（营销中心 → 秒杀管理）
- 先建场次（如 10:00 场、14:00 场），场次决定小程序会场的 tab。
- 再建活动：选商品和 SKU、秒杀价、库存、限购数、所属场次，保存后点「发布」才会生效。
- 同一 SKU 在同一时间段只能参加一个秒杀，冲突会被拦下。
- 秒杀单不参与优惠券、积分抵扣和会员折扣。
8.4 拼团
- 建活动：选商品 SKU、几人成团、拼团价、有效期（多久不满员算失败）、可选团长优惠。
- 「团列表」看每个团的进度；可以提前结束（模拟成团）或处理过期团。
- 到期未成团：系统自动退款（模拟退款，余额原路退回并扣回赠送积分）。
8.5 砍价
- 建活动：选商品、原价、底价、每次砍价金额区间、有效期、每日自砍次数上限。
- 买家发起后邀请好友助力，砍到底价即可下单；也可以设置"随时可买"。
- 「砍价记录」可以看每个人砍到哪一步；过期记录由定时任务自动失效。
8.6 预售
- 支持两种发货方式：固定日期发货 或 付款后 N 天发货。
- 可设限购，防超卖。
- 预计发货日前后台默认不允许发货；到日期系统会提醒买家一次。
8.7 新人礼
- 配置新会员首次登录自动发放的优惠券和积分，系统按会员维度去重，只发一次。
- 老会员按「生效时间」之后首次登录来判断是否发放。
- 小程序首页首次进入会弹一次领取窗。
9. 价格是怎么算出来的
买家在确认订单页看到的金额，是按固定顺序算出来的，理解这个顺序能解释 90% 的"为什么优惠不对"：
商品原价
→ 限时折扣价（如果有活动且未超限购）
→ 满减满折（多档取最优一档，不与限时折扣叠加）
→ 优惠券（门槛按满减之后的金额判断，范围内商品才算）
→ 会员等级折扣
→ 积分抵扣（最多抵"商品应付金额"的 20%，运费不参与）
→ 加运费（按运费模板；满额包邮则免）
= 实付金额
10. 会员中心
10.1 会员管理
- 列表可按昵称/手机号筛选，详情能看订单、积分、余额。
- 可禁用会员（禁用后无法下单）。
- 可手动调整积分或余额（加减都行），每次调整都会写流水，写清楚原因便于对账。
10.2 会员等级
- 维护等级名称、升级所需成长值、等级折扣率。
- 会员达到成长值自动升级，等级折扣在结算时自动生效。
10.3 积分商城
- 积分商品：设置所需积分、库存、上下架。支持实物和优惠券两类。
- 兑换记录：实物兑换需要在后台点「发货」；券类兑换即时到账。
- 签到：配置每日签到奖励与连续签到周期奖励；「签到记录」可查。
10.4 分销管理
- 分销员：审核申请、冻结、调整等级。
- 佣金：支付后按"实付 - 运费"生成佣金，确认收货后进入冻结期，到期结算；也可以在后台点「立即结算」。
- 提现：审核 → 打款，打款会写余额流水。
- 等级与素材：配置不同等级的佣金比例；上传推广素材给分销员转发。
11. 运营中心
11.1 首页运营
- 轮播图：小程序首页顶部 banner，可设排序、跳转和上下架。
- 公告：首页公告条，点击进公告详情。
- 资讯：文章列表与详情，适合放使用指南、活动说明。
11.2 消息管理
- 站内消息：可单发给某个会员，也可群发。买家在小程序「消息」里看，首页有未读角标。
- 消息模板：支付成功、发货、取消、售后、成团、佣金到账等事件的文案模板，可编辑并发测试。
- 订阅消息：配置微信订阅消息模板 ID。没配置时系统跳过，不会报错，也不会弹授权窗。
12. 数据中心（商城概览）
- 顶部 KPI：营业额、订单数、会员数等，带环比。
- 图表：销售趋势、订单状态分布、热销商品 TOP10、会员增长、优惠券使用情况。
- 数据是实时查库，不做缓存，大促期间刷新会略慢属正常。
13. 日志管理
| 日志 | 什么时候看 |
|---|---|
| 商城操作日志 | 谁改了商品/订单/活动，改了什么 |
| 会员登录日志 | 会员登录来源与失败原因 |
| 支付流水 | 对账，确认某笔订单是否真的支付成功 |
| 积分流水 / 余额流水 | 会员说"积分少了/余额不对"时核查 |
| 订单改价记录 | 核查客服改价 |
| 定时任务执行记录 | 超时取消、自动收货、佣金结算有没有正常跑 |
14. 常见问题
商品上架了，小程序搜不到？ 检查三点：商品状态是否上架、所属分类是否显示、关键词是否匹配商品名/副标题（搜索是按名称和副标题模糊匹配）。
库存显示不对？ 商品总库存是各 SKU 库存汇总，只改总库存不生效。下单会立即锁库存，取消/超时会回补。
优惠券买家说用不了？ 依次看：券是否在有效期、是否达到门槛（门槛按满减后的金额算）、券的使用范围是否包含购物车里的商品、是否是秒杀/拼团等不参与优惠的活动单。
活动创建了没生效？ 秒杀和预售建完要点发布；所有活动都要检查开始/结束时间和商品 SKU 是否选对。
图片显示不出来？
图片走后端 /media 目录；换了服务器或域名要确认 nginx 映射正常，不要直接改数据库里的文件名。
演示账号点保存没反应？
demo 是只读账号，所有写操作后端直接拒绝。要真改数据请用超管登录。
15. 目前还没有的功能（重要）
- 微信支付未接入：现在是模拟支付，真实收款需要企业/个体户主体 + 微信支付商户号。
- 单商户：没有多商家入驻、店铺、分账体系，所有商品都属于同一个卖家。
- 没有独立商家账号体系：后台目前是超管 + 只读演示账号，没有"每个商家只看自己数据"的权限拆分。
- 退款、快递轨迹均为模拟；搜索为数据库模糊匹配，未做分词与全文检索。