🚀 智慧加油站 SaaS 操作帮助手册

📖 阅读指南

本手册按"谁来做、什么时候做、怎么做"重新组织。每章顶部用 品牌 门店 员工 标注角色。

角色与权限速览

三个最常被问到的"在哪儿"

章节快速跳转

🧭 菜单 / 子菜单 / TAB 导航

后台大多数页面都遵循同一套结构：左侧菜单决定你在哪个业务模块，顶部 Tab 代表当前开着的页面，内容区上半部分是筛选与按钮，下半部分是列表或表单。先认清这四层，后面看所有菜单都会快很多。

常见 TAB 怎么理解

📝 新增页填写总则

本系统大多数添加 / 编辑页都是同一种结构：左边是字段名，右边是输入框、选择器、上传器和说明文案。判断一个字段该怎么填，优先看四件事：是否必填、作用范围、是否会影响前台展示、保存后是否立刻生效。

不同新增页，先盯哪些字段

🔐 登录与首页

🖥️ 后台登录（管理员）品牌门店

1. 电脑浏览器打开 https://你的域名/admin.php
2. 输入账号 + 密码 + 验证码 → 登录
3. 登录后默认进入 智慧加油站 → 数据总览，可看见今日营业额、加油升数、新增会员等 KPI

📱 员工端登录（手机 App / 小程序）员工

1. 员工在手机扫描门店张贴的员工端二维码，或在微信小程序搜"加油站"
2. 选择 员工/管理员入口，输入手机号 + 密码（密码 ≥ 6位）
3. 登录后进入员工工作台：开班 / 收银 / 核销 / 订单 / 我的

📊 后台首页（数据总览）

🌅 一日工作流（推荐阅读）

下面三张工作清单是按真实使用场景整理的，建议三类角色第一次使用本系统时按顺序练习一遍。

👨‍💼 一线员工的一天 员工

🏪 店长的一天 门店

1. 早班：登录后台 → 检查"昨日交班对账"，确认现金/微信/支付宝实收一致。
2. 9:00：根据当日油价指导调整门店油价（基本信息→油品管理→价格管理）。
3. 10:00：审核员工昨日提成、查看加油升数排行（报表统计→员工业绩）。
4. 13:00：检查油品库存预警，必要时录入采购入库。
5. 15:00：根据天气/客流，发布临时促销活动或临时优惠券。
6. 18:00：交班对账，导出当日报表存档。

🏢 品牌运营的一天 品牌

1. 看 大屏看板：所有门店实时营业额/加油升数/库存预警一屏感知。
2. 每周一 统一调价：批量调整全网油品挂牌价（也可对个别异常门店单独覆盖）。
3. 每月 策划营销：会员日/秒杀/拼团/优惠券模板设计，下发到指定门店。
4. 季度 对账结算：导出各支付通道分账明细给财务。
5. 处理品牌级客诉、审核新员工开通、维护品牌门头/装修模板。

🏪 门店管理 品牌

路径：门店管理 → 门店列表

每个连锁站点对应一条门店记录。这里是品牌总部建店的入口。

新增门店步骤

1. 点 ＋ 添加门店 → 录入门店名称、门店编码（连锁内唯一）。
2. 填地址：选择省/市/区 → 详细地址 → 在地图上拖动定位获取经纬度（H5/小程序"附近门店"用）。
3. 上传 门店 LOGO 与 顶图 Banner（H5 头部展示）。
4. 填 营业时间、联系电话。
5. 保存后默认停业状态，需点击 编辑 切换为营业中。
6. 建议接着配置：支付通道（操作列「支付通道」按钮）+ 油价（操作列「油价」按钮）。

门店添加页字段说明

⛽ 基本信息（油品 / 价格 / 员工 / 排班）

1. 油机管理 / 油枪管理 门店

使用场景：新装/扩建一台加油机，或新增/更换油枪时录入。

1. 基本信息 → 油机管理 → 添加：填油机编号、品牌型号、所属门店、岛号位置。
2. 油枪管理 → 添加：选所属油机 → 给每个油枪填编号（1#/2#/A1）→ 关联油品。
3. 启用后才能在"开班"时被员工挂枪、被加油订单选中。

2. 油品管理 品牌

路径：基本信息 → 油品管理

使用场景：上新油品（如新增 98#/天然气/电），定义分类、单位、初始价格。

1. 点 ＋ 添加，填油品名称（如 95#汽油），编码（如 G95），选燃料分类（汽油/柴油/电/天然气），单位（升/千克）。
2. 表单底部可一并设置 初始挂牌价。
3. 保存后回到列表，操作列出现 价格管理 + 油价设置。

油品新增字段说明

3. 价格管理 品牌门店 ⭐ 重点

三种价格的关系（覆盖优先级：门店 ＞ 品牌 ＞ 国标）

修改品牌挂牌价

1. 基本信息 → 油品管理，找到要改的油品行。
2. 点该行操作列 价格管理 → 弹出价格设置面板。
3. 输入新的挂牌价（必填）、会员价（可选）、生效时间（默认立即）。
4. 点 保存。所有未单独设置门店油价的门店从该时刻起按新价销售。
5. 右上角 价格历史 可查询过去所有调价记录与操作人。

修改单个门店油价（覆盖品牌价）

1. 方式 A：油品管理 → 操作列 油价设置（已自动带上当前油品过滤）。
2. 方式 B：门店管理 → 该门店行操作列 油价。
3. 点 ＋ 添加 选油品 + 输入挂牌价/会员价 + 选目标门店（支持一次勾选多个门店批量更新）。
4. 保存。该门店从下一笔订单按门店价计费；如想取消门店覆盖、回归品牌价，删除该条记录即可。

4. 充电桩 / 电枪 / 电价 门店

新能源加油站使用，结构与油品类似：电桩→电枪→电价（含峰谷分时）。在 基本信息 同级菜单。

5. 员工管理 门店 ⭐ 重点

添加员工步骤

1. 基本信息 → 员工管理 → ＋ 添加员工。
2. 选所属门店（品牌账号才能跨店选；门店账号自动锁定本店）。
3. 填姓名 + 手机号（这就是员工以后登录员工 App 的账号）。
4. 设密码（≥6 位，告诉员工首次登录用）。
5. 选角色：店长 · 收银员 · 加油员 · 洗车员 · 管理员。
6. 如果是加油员，勾选其负责的油枪（多选）——影响其在 App 端能选到哪几把枪。
7. 保存。回到列表，点该员工行的「收款码」下载二维码贴在岗位上，顾客扫码后业绩自动归此员工。

员工添加页字段说明

6. 员工排班 门店

路径：基本信息 → 员工排班

按周/月给员工排早/中/晚班，影响"开班"时可选员工范围。

1. 选择排班周期（默认本周）。
2. 每名员工的每天格子里，下拉选 早班 / 中班 / 晚班 / 休。
3. 批量复制：可一键将本周排班复制到下周。
4. 保存后即生效，员工在 App 看到当天的班次。

📦 油品采购 / 库存 门店

采购入库

1. 基本信息 → 油品采购 → 添加采购单。
2. 选门店、油品、采购升数、单价、供应商、批次号；可上传发票照片。
3. 保存即自动入库，更新库存与加权平均成本。

库存查询

路径：基本信息 → 库存查询 · 实时显示各油品剩余升数 / 成本 / 报警阈值，低于阈值在首页徽章红点提示。

💴 收银开单 员工门店

入口：后台顶部固定按钮 ＋ 收银开单，或员工 App 底部 收银 tab。

收银操作步骤

1. 选 油枪（仅显示当前班次该员工绑定的枪）。
2. 输 金额（系统按当前油价反算升数）或直接输 升数。
3. 扫描会员码 / 输入手机号 → 系统自动匹配会员等级折扣。
4. 系统自动跑促销引擎挑出对会员最划算的"券+活动"组合，无需人工选择。
5. 选 支付方式（微信/支付宝/现金/储值/扫码），确认支付。
6. 支付成功 → 自动出小票 → 自动语音播报"微信收款 ¥XX 元"。

🧾 订单管理 门店员工

订单列表

路径：订单管理 → 加油订单 / 充值订单 / 商品订单 / 积分兑换 / 退款订单 / 撤单

🖨️ 重打印小票 员工 ⭐

使用步骤（员工 App / 后台通用）

1. 进入 订单 列表（员工 App 底部"订单"，或后台订单管理）。
2. 找到要补打的订单，点该行的 🖨️ 重打。
3. 系统识别设备：
   • 商米 V2 PRO / V1 / D2/D3：直接送给内置热敏打印机出纸。
   • 普通 Android + 蓝牙打印机：尝试本地打印代理 (端口 13528)。
   • 后台浏览器：调用后台模板，发送给该门店配置的云打印机。
4. 打印成功 toast 提示 "原始打印 / 第N次打印 成功"，记录写入打印日志。

退款单 / 退款审批

1. 订单管理 → 退款订单，先看订单类型（油品 / 商品 / 充值）和退款原因。
2. 审批通过后，系统会按订单类型回滚对应的数据：余额、积分、库存、支付单退款状态。
3. 充值退款尤其要核对 赠送金额 / 赠送积分 是否需要一并扣回。
4. 如启用了退款扣回积分规则，审批后会自动回收该订单赠送的积分。

撤单记录 / 取消审批

路径：订单管理 → 撤单

这个页面和退款单不同，它是对“取消订单申请”的审批中心。当前代码里主要处理 充值订单 和 商品订单 的取消。

发票管理

路径：订单管理 → 发票管理

用于集中处理待开票、已开票和驳回记录。重点字段有 发票号、订单号、发票抬头、发票类型、状态、邮箱。

1. 待开票时先核对抬头、税号、邮箱和订单号。
2. 确认开票后上传电子发票图片或二维码，系统会把状态改成 已开票。
3. 会员填写了邮箱且上传了发票图时，系统会自动邮件通知。
4. 如信息不合规，走 驳回，并补驳回原因。

👥 会员管理

会员列表 门店

路径：会员管理 → 会员列表

使用场景：客户报手机号查询余额/积分；店长/品牌人工充值/赠送积分/调等级。

会员类型（卡种） 品牌门店

路径：会员管理 → 会员类型

会员类型是会员体系的“底层卡种”，决定这张卡是否支持余额、积分、折扣、充值赠送、有效期、适用油品范围。如果你要做储值卡、积分卡、折扣卡，先看这里。

积分规则 品牌门店

路径：会员管理 → 积分规则

积分规则用于定义“消费怎么送积分、哪些等级加赠、哪些门店或油品适用”。会员类型可以挂一套积分规则，方便按卡种区分积分玩法。

1. 先定义规则名称和规则编号，方便品牌统一维护。
2. 设置基础积分规则，例如 消费 1 元送 1 分、指定油品双倍积分。
3. 如果有等级加赠，再配置 level_bonus 或阶梯规则。
4. 保存后，把该规则绑定到会员类型或运营活动中使用。

会员等级 品牌

路径：会员管理 → 会员等级

定义品牌的等级体系：普通/银卡/金卡/钻石…，每级配升级条件（成长值区间）、折扣率（如 95 折）、积分倍率（如双倍）、专属权益。

新增等级步骤

1. 点 ＋ 添加，填等级名（"金卡"）、序号（数字越大越高级）。
2. 填升级条件：最低成长值 ~ 最高成长值。
3. 填权益：折扣率（如 0.95）、积分倍率（如 2.0）。
4. 选/上传 等级图标、等级颜色。
5. 勾选 权益（生日礼/月月返/专属客服…）。
6. 保存后会员消费时按该等级折扣自动结算。

会员等级字段说明

折扣策略 品牌门店

路径：会员管理 → 折扣策略

这里用于配置便利店商品 / 服务对不同会员类型和会员等级的折扣规则，不是加油卡种折扣。适合做“金卡便利店 9 折、钻石会员洗车 8.5 折”这类规则。

会员券包 品牌门店

路径：会员管理 → 会员券包

会员券包不是建券模板，而是把已经定义好的券按批次发给指定会员或指定会员类型。这个页面适合做“本周给金卡会员统一发一批券”的运营动作。

1. 先确保 优惠券模板 已经建好并启用。
2. 进入 会员券包 点 ＋ 添加，选择发放模式：指定会员 或 按会员类型。
3. 填写批次名称、券类型、适用范围、总发放量、目标会员范围。
4. 发放前可用 预估行为会员 看大概覆盖到哪些人。
5. 发出后，可在详情里查看该批次下所有会员券，也可 作废单张 或 作废整批。

🎯 营销活动 品牌门店

🎫 优惠券设置（详）⭐

路径：营销活动 → 优惠券模板

10 种券类型用什么场景？

建券完整步骤（示例：满 200 减 20）

1. 营销活动 → 优惠券模板 → ＋ 添加。
2. 范围选 通用，名称填"满200减20·汽油专享"。
3. 类型选 满减券，满 200 元，减 20 元。
4. 总发放量 10000，每人限领 2，有效 15 天（领取日起算）。
5. 使用说明填"满 200 元可用，限 92#/95# 汽油"。
6. 保存。注意：仅创建模板还不会发到会员手上，需要通过下面的"促销活动 / 充值赠送 / 签到奖励 / 推广奖励"任一渠道发放。

优惠券模板字段说明

🎁 促销活动设置（详）⭐

路径：营销活动 → 促销活动

16 种活动玩法

建活动步骤（示例：周三会员日 92# 88 折）

1. 营销活动 → 促销活动 → ＋ 添加。
2. 名称"周三会员日·92# 8.8 折"，分类选 会员日。
3. 有效期：例如 2026-04-21 ~ 2026-12-31，循环规则勾选"每周三全天"。
4. 适用门店：勾选所有门店或指定。
5. 适用油品：勾选 92#。
6. 适用会员等级：勾选"银卡及以上"（防止羊毛党）。
7. 规则：折扣 0.88。
8. 勾选奖励发券（可选）：消费后再赠一张满减券留客。
9. 上传活动 横幅图（H5/小程序首页展示）。
10. 保存并启用。次日 H5 首页和收银开单页将自动展示，符合条件订单自动生效。

促销活动字段说明

⚡ 限时秒杀

路径：营销活动 → 限时秒杀

1. 新建秒杀活动，选 商品类型：油品 / 商品 / 充值套餐 / 优惠券。
2. 填 原价 / 秒杀价 / 总库存 / 每人限购。
3. 设置 开抢时间 + 持续时长（默认 60 分钟）+ 预热时长（默认 30 分钟）。
4. 预热时间到 → H5 倒计时；开抢时间到 → 用户可下单。

✂️ 砍价

用户发起砍价，邀请好友帮砍至最低价后下单。配 原价 / 最低砍至 / 总库存 / 助力人数上限 / 每刀砍价区间。

👨‍👩‍👦 团购 / 拼团

用户开团后邀请他人加入，达到最低成团人数后所有人按团购价享受。配团购价、最低成团数、最大人数、库存。

📅 每日签到

路径：营销活动 → 签到配置

配每日签到奖励（积分/优惠券/余额），支持连续签到加倍（连续 7 天双倍奖）。

🎮 小游戏（互动营销）

内置 18 个游戏模板：大转盘、砸金蛋、翻牌、刮刮乐、老虎机、记忆配对、答题、九宫格…

1. 营销活动 → 游戏配置 → ＋ 选模板。
2. 设置每日参与次数、获奖概率、消耗积分/次。
3. 配奖品池（实物 / 优惠券 / 积分 / 余额，含未中奖项）。
4. 发布后 H5/小程序的"每日福利"位自动出现入口。

🔗 推广分销

会员邀请新人注册或消费，获得佣金/积分奖励。设置奖励规则、查看上下级关系、佣金发放记录、排行榜。

✅ 服务核销 员工 ⭐

入口：员工 App / H5 → 核销 tab

核销操作步骤

1. 顾客出示卡券二维码（在 H5/小程序"我的卡券"打开）。
2. 员工 App → 核销 tab → 点 📷 扫码核销。
3. 对准二维码扫描；如无法扫描可手动输入券码 → 查询。
4. 系统显示订单详情；如需按量核销（油品类秒杀），输入核销升数。
5. 点 ✅ 确认核销 → 核销成功，自动语音播报"核销成功，金额 X 元"。
6. 商米机器自动出小票；其他设备可点 🖨️ 打印小票 手动打印。
7. 顶部 全部记录 → 可查看全店所有核销历史，带筛选（类型/日期/员工/关键词）。

🕐 班次 / 交接班 员工门店

开班

1. 到岗后进入 员工 App → 开班。
2. 选本班负责的油枪（多选）+ 录入每把枪的开班抄表数。
3. 开班后所有该枪订单自动挂到此班，业绩归属于本人。

交接班 / 班次小结

1. 下班前 员工 App → 班次 → 交接班。
2. 录入交班抄表数，系统自动算"售出升数 = 交班 - 开班"。
3. 核对应收金额（订单合计）与实收（现金 + 微信 + 支付宝 + 储值）→ 差异自动标红。
4. 店长在后台 班次管理 可看所有交班记录、做二次审核。

🛒 商品 / 积分商品 / 充值套餐 门店

商品管理

1. 先建 商品分类（如"便利店/汽车用品/食品饮料"）。
2. 到 商品管理 → 商品 SKU → ＋ 添加，填名称、SKU 码、价格/会员价、库存、上传主图详情图。
3. 启用上架，立即在 H5 商城"热门商品"区显示。

积分商品

路径：商品管理 → 积分商品 · 会员可用积分兑换。支持纯积分 或 积分 + 现金 两种模式。

充值套餐

路径：商品管理 → 充值套餐

1. 新建套餐"充500送50"，填实充金额 500、赠送金额 50（也可送积分/优惠券）。
2. 设每会员限购、上下架时间。
3. H5/小程序的"充值"页和后台收银员都能选用。

🎨 店铺装修 品牌

路径：店铺装修 → 设计器 · 通过拖拽方式自定义 H5/小程序的首页布局。

1. 选择 模板（内置多套或克隆）→ 进入设计器。
2. 从左侧组件库拖入：轮播 / 油价 / 优惠券 / 限时秒杀 / 商品 / 积分商城 / 充值 / 富文本 / 视频 / 客服 等。
3. 拖到中间画布后，右侧编辑组件属性（标题、颜色、关联数据来源）。
4. 支持多页面分别配置。
5. 保存并发布，H5/小程序立即生效（缓存 5 分钟）。

🖨️ 打印管理（含商米 V2 PRO）门店 ⭐

打印机配置

路径：打印管理 → 打印机配置

1. ＋ 添加打印机。
2. 选品牌：商米（Sunmi） / 飞蛾 / 易联云 / 中崎 / 本地代理（Tauri）。
3. 填 SN（设备序列号）/ Token（云打印用）。
4. 选用途：收银小票 / 厨打 / 标签 / 后厨。
5. 测试打印 → 成功后启用。

商米 V2 PRO 接入要点

排查"重打印没反应"

1. 确认设备品牌：在 App 关于页或设备 系统设置→关于本机 看品牌是否为 SUNMI。
2. 授予权限：设置 → 应用管理 → 加油站 App → 权限 → 全部允许。
3. 打印服务：商米打印服务是系统应用，正常预装。
4. 装纸：检查是否有热敏纸、出纸口盖子是否合上（未合上会黄灯提示）。
5. 升级 App：v3.0 之前的版本"重打"按钮只记日志、不真正打印；请升级到最新版。
6. 查日志：后台 打印管理 → 打印日志 看记录是否有"打印失败"原因。

小票模板

路径：打印管理 → 小票模板 · 自定义店头/订单字段/页脚二维码等。

打印日志

路径：打印管理 → 打印日志 · 查看所有打印记录与失败原因，可一键重打。

📊 报表与统计 品牌门店

常用报表

导出报表

大部分报表右上角有 📥 导出 Excel，按门店/时间筛选后导出。

🖥️ 大屏看板 品牌

路径：大屏看板 → 选择/新建看板

用于办公室大屏 / 总部展厅实时展示。组件可拖拽配置：营业额数字、油品销量饼图、加油站地图、近期订单滚动条、员工排行榜。WebSocket 实时推送，无需刷新。

💬 AI 客服 品牌

路径：客服管理 → 客服配置

1. 选择 AI 服务商（DeepSeek / 通义 / GLM / 豆包 / Kimi / MiniMax / 混元 / 千帆 / 星火 / OpenAI）填 ApiKey/模型名。
2. 到 知识库 上传问答语料（油价咨询/营业时间/优惠规则…）。
3. 到 关键词回复 配置常见问题秒回。
4. 会员在 H5/小程序"客服"对话即用。

📱 微信公众号 品牌

• 公众号配置：填 AppID / Secret / Token，绑定服务器地址。
• 自定义菜单：在线编辑公众号底部菜单。
• 素材管理：上传图文/图片/视频。
• 关键词回复：设置自动回复规则。

💳 支付设置 品牌

路径：支付设置

• 全局支付配置：开启/关闭通道（微信/支付宝/银联/拉卡拉/通联/聚合）。
• 门店支付配置：门店级单独商户号（不同门店收款入不同账户）。
• 支付路由：按金额/订单类型/门店分配到不同通道（费率优化）。
• 分账设置：自动按比例分账给品牌/门店/员工。
• 结算：T+1 / T+0 自动结算。
• 回调日志：支付通知失败时手动重试。

⚙️ 系统配置 品牌

路径：系统设置 → 系统配置

这里是全站配置总入口。当前页面顶部每个按钮就是一个 TAB 配置组，例如站点信息、个人资料、会员设置、积分设置、充值设置、订单设置、优惠券、小票设置、发票设置、短信设置、公众号、小程序、H5、APP、客服设置、地图设置。

权限继承与保存规则

同一项配置按 门店 ＞ 品牌 ＞ 平台 顺序取值。门店没改就用品牌，品牌没改就用平台默认。所以你看到的值不一定是“自己手填的值”，也可能是上级继承下来的。

• 保存本组：只保存当前 TAB
• 一键重置本组：把当前组恢复到上级默认
• 备份菜单：菜单异常或权限结构变动时使用
• 系统维护：清缓存、到期活动处理、订单维护等

各 TAB 主要做什么

个人资料 TAB 怎么填

公众号 / 小程序 / H5 / APP 这几组最容易填错什么

📲 H5 / 小程序前端

会员触达端，所有页面由 店铺装修 配置。

前端页面和后台配置怎么对上

❓ 常见问题 FAQ

Q1：油价改了为什么 H5 没刷新？

A：油价缓存 5 分钟，可在 系统设置 → 系统维护 点 清理缓存 立即生效。

Q2：员工管理在哪里？

A：在 基本信息 一级菜单下（与"油品管理"并列），不是在"会员"或"系统设置"。

Q3：员工怎么登录？

A：用手机号（添加员工时填的）+ 密码登录员工 App。忘记密码可由店长在员工管理里重置。

Q4：商米 V2 PRO 重打印没反应？

A：见 打印管理 → 商米排查清单。常见原因：① App 版本旧（v3.0 之前未真正出纸）② 权限未授予 ③ 缺纸 / 盖子未合 ④ 设备非 Sunmi 但启用了 Sunmi 模式。

Q5：UniApp 首页商品变成一列？

A：v3.0 已修复（改用 CSS Grid）。如仍出现，请清缓存重新打开 App。

Q6：员工核销没看到记录？

A：员工 App 核销 tab 顶部"全部记录 →"可查看全店核销历史（已对齐 H5）。

Q7：促销活动和优惠券会重复优惠吗？

A：不会。系统按"对会员最优"算法挑出一组应用，可在活动里勾选"是否可叠加"控制。

Q8：门店油价不生效？

A：确认门店油价是否填写并启用；优先级 门店 ＞ 品牌 ＞ 国标。

Q9：怎么群发优惠券给所有会员？

A：先建券模板 → 建一个"全场直减"或"会员日"促销活动 → 勾选"奖励发券"→ 关联券模板 → 启用。所有触发条件的会员将自动收到。

Q10：交班时金额对不上？

A：检查是否有未关账的扫码支付（顾客已付但回调延迟），可在支付设置→回调日志手动重试；或在订单管理找到该订单确认状态。