VIO v4 管理后台 - 用户指南

欢迎使用 VIO v4 管理后台。本指南涵盖租户管理、用户、代币、优惠券等全部管理端功能。

---

目录

1. 登录
2. 忘记密码
3. 仪表盘
4. 用户
5. 代币
6. 代币持有者
7. 代币分析
8. 优惠券
9. 活动
10. 空投
11. 交易记录
12. 结算
13. 子公司
14. 品牌设置
15. 角色
16. 员工
17. 门店管理
18. 通知
19. 新闻资讯
20. PIN 访问
21. API 文档
22. 设置
23. 会员等级
24. 商品管理
25. 订单管理

---

1. 登录

租户管理员与子公司管理员使用的登录页。可使用已注册的邮箱或手机号，配合密码登录。

如何使用：

1. 在浏览器中打开带租户 slug 的管理后台地址
2. 在表单顶部用标签页选择电子邮件或电话
3. 邮箱：输入管理员邮箱。手机：选择国家区号，再输入手机号（仅数字）
4. 输入密码
5. 可选：勾选记住我保持登录；需要重置密码时点击忘记密码？
6. 点击登录进入仪表盘

电子邮件标签页

电话标签页（先选国家/地区代码，再填手机号）

---

2. 忘记密码

忘记管理员密码时在此重置。流程同时支持邮箱与手机：先请求一次性验证码，再输入 6 位 OTP，最后设置新密码（至少 6 个字符）。

如何使用：

1. 在登录页点击忘记密码？（或直接打开对应租户的忘记密码 URL）
2. 选择电子邮件或电话，输入已注册的邮箱或手机号（手机需含区号）
3. 点击发送验证码，在邮箱或短信中查收 6 位验证码
4. 在六个输入框中输入 OTP（可粘贴完整验证码）
5. 输入并确认新密码后提交，完成重置
6. 在成功页使用返回登录，再用新密码登录

请求验证码（选择电子邮件或电话，填写标识后发送）

输入验证码（6 位 OTP；可粘贴或逐位输入）

设置新密码（长度以界面提示为准；确认须一致）

---

3. 仪表盘

首页总览：KPI 统计卡片、所选日期范围内的分析图表、近期代币活动、可选的小程序快捷入口，以及跳转到用户、代币、优惠券与品牌等页面的快捷操作。

如何使用：

1. 使用右上角日期范围选择器切换统计区间；图表与数字会随区间刷新
2. 点击四张统计卡之一 — 总用户数、活跃代币、优惠券、交易记录 — 进入对应模块
3. 查看用户增长图（总用户数 vs 新用户）与交易量柱状图（铸造、转账、销毁）
4. 查看代币分布饼图与近期活动列表；可用查看全部打开完整交易页
5. 若租户配置了带管理端地址的小程序，可从小程序网格进入
6. 使用快捷操作：管理用户、管理代币、创建优惠券、自定义品牌直达对应页面

---

4. 用户

管理租户会员账号：浏览、搜索、筛选、创建用户（角色说明见下）、导出 CSV，以及行内操作。

如何使用：

1. 使用筛选栏右上角的搜索框 — 可匹配显示名、邮箱、手机号、钱包地址
2. 用角色、状态下拉缩小列表；用日期范围按账号创建时间筛选；点击清除重置筛选
3. 在允许时点击右上创建用户（在导出旁）。填写邮箱或手机、密码、显示名。
4. 角色（必填）：会员 — 标准会员端用户；若租户使用分支机构可指定可选子公司。子公司管理员 — 管理一个分支；必须选择子公司（该角色必填）。租户管理员 — 可管理整个租户；仅租户级管理员在创建用户时可分配此角色（子公司管理员不能创建另一名租户管理员）。
5. 点击导出用户列表选择导出模式：用户概览 (CSV) 或代币到期明细 (CSV)（含代币与周期选项）— 再点导出下载
6. 每行最右侧 ⋮：查看详情打开详情（联系方式、钱包、余额、优惠券），编辑修改资料与角色，停用 / 启用控制账号状态
7. 可选：若侧栏或书签暴露，可用已订阅用户或活跃会员（/users/subscribed、/users/active-members）进入预筛选列表

注册来源

注册来源列显示该用户账号是如何进入系统的，便于区分后台创建与自助注册，以及门店/活动拉新效果。

显示	含义
由系统创建	账号由管理员或系统侧流程创建，而非用户自助注册。例如：在本后台点击创建用户、创建员工/子公司管理员、SSO 首次登录建号，或通过 External API 同步的用户。
直接注册	用户在会员端或公开注册页自行注册，且未关联门店或营销活动。
门店名称	用户通过门店专属注册链接或二维码注册，列中显示门店名。
活动名称	用户通过营销活动链接或落地页注册，列中显示活动名。

若同时涉及门店与活动，系统按 门店 > 活动 > 直接注册 的优先级记录。

导出用户列表 → 用户概览 (CSV) 中也会包含注册来源。

用户列表

创建用户（弹窗 — 凭据、显示名、角色、可选子公司）

---

5. 代币

管理代币类型、供应量、公司余额、铸造与共享。可切换网格/列表视图、搜索代币，并在每行 ⋮ 中使用查看详情、编辑（已创建代币）、查看分析、查看持有者、设为默认、销毁代币。

代币创建

代币创建由超级管理员在超级管理后台完成。如需新建代币，请联系超级管理员或平台支持。代币创建后会出现在您的代币列表中供管理使用。

如何使用：

1. 在网格与列表布局间切换，用搜索框按名称或符号查找代币
2. 对你发行的代币，按界面流程使用铸造 / 批量等工具向用户分配供应（含 CSV 或粘贴列表等可用方式）
3. 点击行上 ⋮ — 查看详情查看完整信息；对已创建代币可使用编辑、查看分析、查看持有者
4. 设为默认（星标）将租户默认会员代币设为当前行；在另一代币成为默认前，当前默认行不可再次被选为默认
5. 销毁代币打开弹窗：选择持有者、数量、可选备注并确认 — 或按权限使用其他行操作

代币列表

---

6. 代币持有者

针对某一代币：页头显示名称/符号、持有者总数与总供应量，以及查看分析按钮。表格列出每位持有者及其余额（可发送）（与账面总额）、最近到期日、供应占比 %、最后活动，以及批次与调整操作。支持搜索、导出 CSV、返回代币。

如何使用：

1. 从代币 → ⋮ → 查看持有者进入，或直接访问 /tokens/{tokenId}/holders。用返回代币返回列表
2. 阅读摘要：持有者总数与总供应量；点击右上角查看分析打开该代币分析
3. 使用**搜索持有者…**筛选表格；数据多时用底部分页
4. 查看列：持有者（姓名与邮箱）、余额（可发送）（可发送量与账面总额）、最近到期日（日期时间或"无到期日"）、带进度条的供应占比 %、最后活动
5. 每行：点击批次打开批次明细（有效期等）；在角色允许时点击调整调整余额
6. 点击导出 CSV 下载持有者报表

持有者表

批次（弹窗 — 每位持有者的批次分解、生效/过期标签、余额对账）

调整余额（弹窗 — 发送或回收、数量、原因）

---

7. 代币分析

单代币分析：返回代币、日期范围（如过去 30 天）、查看持有者、摘要卡片（总供应量、持有者总数、区间内交易笔数与交易量）、交易量折线图、交易类型环形图、前几大持有者与近期交易（各含查看全部）、以及公司代币批次（未过期批次 / 已过期批次标签与批次表）。

如何使用：

1. 从代币 → ⋮ → 查看分析进入，或访问 /tokens/{tokenId}/analytics。用返回代币返回列表
2. 设置日期范围 — 摘要与图表随区间刷新。点击查看持有者打开该代币持有者页
3. 阅读四张摘要：总供应量、持有者总数、区间内交易笔数、交易量（该区间总量）
4. 查看交易量（折线）与交易类型（环形：铸造、转账等）。使用前几大持有者与近期交易；有查看全部时可展开完整列表
5. 在公司代币批次查看批次总数及查看过期交易记录（如有）。切换未过期批次与已过期批次；表格含批次 ID、数量、剩余、创建时间、到期与状态
6. 阅读标签下方说明：未过期仍包含未到过期时间但已耗尽的批次

---

8. 优惠券

优惠券全生命周期：顶层四个区域（目录、兑换与使用、分析、品牌标签）、状态筛选、网格/列表、搜索、对自有优惠券的批量操作、页眉按码核销、分析图表，以及多步创建/编辑向导。

页面顶部有四个主标签：

• 优惠券 — 租户目录。分为我的优惠券（你创建的优惠券）与优惠券网络（见下）。其下在线、离线、已过期按上架/下架与是否已过结束日筛选。可按分类、品牌标签、访问类型（公开 / 私有 / 共享）筛选，按优惠券名搜索，切换网格 / 列表。在列表视图中选中多行可出现批量条激活 / 停用（视角色权限）。
• 兑换与使用 — 优惠券兑换（会员消耗代币把优惠券存入钱包）与这些优惠券的使用/核销记录列表（界面提供处可搜索与导出）。
• 分析 — 优惠券表现摘要与图表。
• 品牌标签 — 管理我的品牌标签（从平台加入、用于优惠券的品牌）与平台品牌标签（浏览平台池并加入你的选择）。

在主要优惠券流程页右上角，按码核销以弹窗打开店员按码使用（核销）流程 — 不在优惠券行 ⋮ 菜单内。在角色允许时创建优惠券打开创建向导。

优惠券网络（在优惠券标签下我的优惠券下方）

优惠券网络不是独立路由 — 它是同一目录标签上我的优惠券****下方的第二块区域。说明文案为"来自合作伙伴的公开和共享优惠券"。该池展示来自其他租户或平台目录的优惠券，供会员在配置允许时发现与兑换。你不能在这里创建这些优惠券，主要查看。网络优惠券行 ⋮ 仅查看详情 — 无编辑优惠券、复制、上/下线操作（这些仅适用于我的优惠券）。

如何使用：

1. 用顶部四个主标签在目录（优惠券）、兑换与使用、分析、品牌标签（最后一项含我的品牌标签 / 平台品牌标签）间切换。
2. 在优惠券中在我的优惠券与优惠券网络间工作，再用在线 / 离线 / 已过期及分类、品牌、访问类型、搜索筛选；切换网格/列表，在列表多选且角色允许时使用批量上架/下架。
3. 在允许时点击创建优惠券打开向导 — 名称、类型、数值、日期、可见性、门店、核销方式、图片、条款、共享选项 — 保存或发布。
4. 行 ⋮：对我的优惠券，菜单为查看详情、编辑优惠券、复制，然后是当前在线时的下线或离线时的上线操作。优惠券网络行 ⋮ 仅查看详情。按码核销请使用页眉按码核销，不要期待在 ⋮ 里。
5. 兑换与使用查看兑换与使用表；分析看仪表盘；品牌标签维护创建优惠券可用的品牌。

优惠券核销方式：供应商码池（QR Code 与优惠码）

当优惠券核销方式为 QR Code 或优惠码时，优惠券通过上传 CSV 维护一批由供应商提供的码，而不是全员共用一张静态二维码图。系统每条码存一条记录，每次核销从池中分配唯一一条码给该会员（会员端表现为点击获取码等操作后展示供应商码）。

上传券码（创建向导）

• 出现上传券码区域：拖拽或点击上传 CSV；支持 CSV / TXT，单文件最大 5 MB（见界面提示）。
• 下载模板 — 下载示例：每行一个码，可无表头（若首行为 code / codes / voucher / id 会被当作表头跳过）。
• 选中文件后显示文件名、大小，可用 X 移除。
• 优惠券数量会根据文件内去重后的有效行数自动填充。
• 保存新建优惠券后，码会导入码池。若使用固定上限，请与 CSV 行数对齐。

编辑优惠券

• QR Code / 优惠码同样提供上传券码；新文件会追加入库（重复码跳过）。
• 界面展示码池总数 / 可用 / 已分配。若兑换上限大于已上传的总码数，保存会被 API 拒绝 — 请补充 CSV 或降低上限。
• **兼容说明：**历史 QR Code 数据可能仍仅有单张图片路径；新流程在管理端以 CSV 为准。

VIO Code、URL、手动、直充等类型不依赖该 CSV 码池。

截图（主标签）

优惠券 — 目录标签（上方我的优惠券，向下滚动可见优惠券网络；在线 / 离线 / 已过期与筛选作用于目录列表）

兑换与使用

分析

品牌标签（子标签我的品牌标签 / 平台品牌标签在此屏）

创建优惠券（向导 — 详情、类型、数值、日期、可见性、门店、核销方式、条款）

---

9. 活动

单一营销活动屏上的活动构建器：活动列表或网格、筛选（状态、代币、公开/私有）、搜索、创建活动、单行操作。创建/编辑使用弹窗：排期、关联代币、横幅图，以及两个开关：启用与公开营销页面（无需登录即可访问）（创建时的完整文案；编辑时同款设置用较短标签公开营销页面）。

状态徽章 vs 启用开关：****启用复选框控制活动是否整体启用。卡片/行上彩色状态药丸（进行中、已排期、已结束、未启用）为计算得出：若启用关闭 → 未启用；若开启 → 开始前为已排期，结束后为已结束，否则进行中。因此表单里的"启用"与仅靠日期显示的"进行中"状态芯片不一定是同一含义。

公开营销页面：开启公开营销页面（无需登录即可访问）时，该活动在会员端的营销 URL 可不登录访问（参见弹窗中活动 QR Code 说明）。关闭时视为不通过该公开页分享。

活动上的优惠券：当前 UI 无独立顶层活动优惠券标签 — 通过列表视图的管理或网格 ⋮ 的管理优惠券按活动挂载/编辑优惠券。会打开大弹窗，标题**「…」中的优惠券**，步骤管理优惠券 → 确认后保存。

**数量与最大数量列：**每行优惠券有一个 Qty（数量）输入框和一个 Max Qty（最大数量）开关。当 Max Qty 关闭时，Qty 可编辑，表示该活动的自定义兑换上限。当 Max Qty 首次开启时，Qty 自动填充优惠券当前的剩余库存（总量减去已兑换量）；保存后该值固定，不会随优惠券被兑换而自动减少。若优惠券库存为无限则显示 ∞。

**库存指示器：**每行优惠券在相关时显示库存状态标签：

• Out of Stock（红色标签）— 优惠券全局剩余库存为 0（已被所有活动/租户完全兑换）
• Low Stock（黄色标签）— 优惠券全局剩余库存 ≤ 10

这些指示器同时显示在活动优惠券管理弹窗（所有公司的优惠券）和优惠券页面（创建公司的网格和列表视图）。

二维码与链接：行/卡上 QR 图标与 ⋮ 中查看 QR Code 打开活动 QR Code 弹窗（下载 PNG、营销 URL、复制、新标签打开）。⋮ 还提供复制营销 URL、打开营销页面、编辑活动、允许时的删除。

如何使用：

1. 浏览营销活动列表或网格；按状态（与计算药丸一致：进行中 / 已排期 / 已结束 / 未启用）、代币、公开/私有筛选；按名称搜索；如有则切换网格/列表。
2. 创建活动（允许时）：名称、描述、兑换所用代币、横幅图（限额见应用内）、开始/结束日期和时间。启用启用以使活动在日期约束下可运行。需要可分享的免登录会员链接时启用公开营销页面（无需登录即可访问）。保存。
3. 从 ⋮ 编辑活动修改同字段。用管理 / 管理优惠券增删优惠券并设置数量与代币定价；UI 要求在第二步确认时完成确认。
4. 用 QR 图标或查看 QR Code 打开活动 QR Code；按需从 ⋮ 使用复制营销 URL 或打开营销页面。
5. 允许时 ⋮ 出现删除；会移除活动及其优惠券关联（确认界面警告）。

截图

营销活动（列表/网格 — 实际数据因租户而异）

创建活动（弹窗 — 代币、排期、启用、公开营销页面（无需登录即可访问））

活动 QR Code（弹窗 — QR Code、下载 QR Code、营销 URL、使用方法）

管理优惠券（弹窗 — 标题**「…」中的优惠券**，步骤管理优惠券 → 确认）

---

10. 空投

列出历史与进行中的空投（代币或优惠券派发）。可按类型/状态搜索筛选、打开详情、删除草稿，并从大型向导弹窗创建新批次 — 无单独 /airdrop/create；创建自此页进入。

如何使用：

1. 用搜索与筛选浏览表格（如空投类型、状态：草稿、发送中、已发送、失败）
2. 允许时点击创建空投活动打开向导 — 选择代币或优惠券模式、接收人（CSV 上传与/或选人）、金额与文案
3. 确认摘要并排入发送；允许时草稿可从 ⋮ 删除
4. 点击行或查看打开详情弹窗查看进度、接收人拆分与失败信息
5. 对符合条件行使用删除或其他 ⋮ 操作清理失败或草稿活动

空投列表

创建空投（向导 — 代币或优惠券、接收人、金额）

---

11. 交易记录

租户级代币交易台账：全文搜索、代币/类型/状态筛选、日期范围、CSV 导出，以及内容丰富的消息列（可含备注、错误、引用标签、代币批次变动与到期日提示）。

消息列 — 从上到下可显示：可选备注；失败时红色错误信息；可选引用标签（关联对象类型）；API 返回 relatedLots 时的批次块（见下）。无内容时单元格为 -。

批次 — 代币余额按批次跟踪。在消息内，铸造、转账、奖励等类型可出现批次行（UI 仅对这些流完整渲染借记/贷记）。你可能看到：

• 扣款批次 — 发送方批次扣减（代币单位）。若 API 嵌入完整批次数据，其下会有紧凑的到期日；否则可能仅短批次 ID 标签。
• 入账批次 — 新开或接收方批次及金额。
• 拆分至 N 个批次 · 合计 — 单笔交易触碰多个批次时的汇总行与合计；各批次下列出并左侧缩进以示拆分。

点击批次标签（包裹图标与批次 ID 尾段）打开浮层：批次 ID（可复制）、剩余 / 原始余额、状态（有效、已过期或已耗尽）、与行内提示一致的到期日。

到期日 — 每行批次下小字到期日后跟日历日期（yyyy-MM-dd）或无到期日。批次已过期（状态或日期）时日期可显示为红色。这是批次自身到期，不是交易时间戳（账变时间看日期列）。

消息列（截图） — 表格横向滚动使消息可见；自动截图最多 10 行数据以保持图片紧凑（见 capture-transactions-message.js）。你租户上可能显示备注、-、批次行或优惠券文案。

如何使用：

1. 用搜索匹配用户、哈希或表格暴露的其他字段
2. 按代币、交易类型（铸造、转账、销毁、奖励、兑换、过期）、状态缩小范围；用日期选择器设区间
3. 使用导出或下载将当前结果导出 CSV（导出可在可用处附加紧凑的扣款/入账批次 ID 与到期片段）
4. 阅读消息中的备注、失败、引用与批次 / 到期日；点击批次标签查看详情并复制 ID
5. 其他页面深链可能带 tokenId、type 或 status — 筛选从 URL 初始化

---

12. 结算

财务结算与跨租户优惠券计费：顶部摘要卡，其后主标签 — 平台费用、应收明细、应付明细、发票，以及（开启电商模块后）商品结算 — 摘要数据上可选日期范围筛选。

如何使用：

1. 选择日期范围（如有）以刷新结算摘要、费用与跨租户优惠券明细
2. 在平台费用查看平台费、维护费与按需计费
3. 打开应收明细或应付明细查看你方用户核销其他租户优惠券（或反向）的金额
4. 切换到发票列账单并按方案下载 PDF 或查看条目
5. 使用各分区顶部币种标签与合计与财务记录对账

截图（主标签）

平台费用 — 维护费、按代币计费、兑换制/使用制费用等（取决于计费模型）。

费率类型

平台支持以下可变服务费费率类型：

费率类型	标签显示	计算方式
每单位	$X.XX /代币 或 /次兑换	每笔固定金额
百分比	X%（发行价值） 或 X%（结算价）	交易结算金额的百分比
代币价值百分比	X%（代币价值）	代币价格 × 代币法币汇率的百分比，若代币锚定法币与计费币种不一致则自动换算；无代币价格时退回最低收费

商品结算标签（电商）

仅当电商模块启用后显示。单独的电商净额摘要卡（VIO 应付给租户时显示绿色，租户应付给 VIO 时显示红色）点击后打开此标签；标签内以表格逐笔列出每一次成交/退款，表格上方附有汇总条：

汇总字段	说明
销售总额	该时间段内的订单总额（法币支付 + 积分支付折算法币 + 优惠券抵扣）
佣金	按租户配置的佣金比例/最低收费（见超级管理后台指南）基于销售总额计算的平台佣金
平台代收法币	平台 Stripe 账户实际代收的法币金额（仅在平台代收模式下非零 —— 见超级管理后台指南「支付收款模式」一节）
净额	租户的结算净头寸 —— 平台代收法币超过应付佣金时为VIO 应付租户（正数），佣金超过平台代收法币时为租户应付 VIO（负数）

每行展示订单日期、可点击的订单号（跳转到该订单详情页）、商品、会员，以及该订单的积分支付（含法币折算）、法币支付、优惠券抵扣、订单总额与佣金明细；退款行会高亮显示并以负数呈现。可使用搜索按订单号或商品名筛选。

提示： 只要电商模块已启用，电商净额卡片始终单独显示。当电商结算币种与你的主计费币种一致时，该净额也会并入整体净结算总额（标注为“含电商”）；若币种不同，则电商金额不会计入该总额，以避免跨币种混合计算。

应收明细 — 其他租户用户使用你方优惠券时的应收金额（有行时可导出 CSV）。

应付明细 — 你方用户使用其他租户优惠券时的应付金额。

发票 — 已开具发票（可下载 PDF 时可用）。

---

13. 子公司

分支机构层级：在树形与网格视图间切换，创建子公司、上传 logo、校验 slug、可选开通子管理员账号，并按分支管理用户。

如何使用：

1. 切换树形 / 网格浏览组织图或卡片布局
2. 点击添加或添加子公司打开表单 — 名称、代称、联系人、地址、logo、可选专属管理员凭据
3. 在行 ⋮ 中查看、编辑、启用/停用、删除，或打开该分支的会员列表弹窗
4. 在父级下创建时，保存前在界面确认父子关系
5. 复制或记录各子公司代称 — 其会出现在该分支会员端与管理后台 URL 中

子公司（树形或网格）

添加子公司（表单 — 名称、代称、联系人、logo、可选分支管理员）

---

14. 品牌设置

上传标准与浅色主题 logo，调整主色/辅色/强调色/背景色/文字色，选择字体族，编辑租户显示名并保存 — 当前会话可立即看到主题刷新。

如何使用：

1. 进入页面预览当前颜色与 logo
2. 用选择器上传新 logo（含深色背景用的浅色变体）
3. 按品牌规范调整十六进制颜色与字体
4. 若法定/营销名称变更，更新租户名称字段
5. 点击保存等待确认；门户主题可能立即应用新色

---

15. 角色

自定义员工角色：搜索筛选目录，从模块化权限网格创建或编辑权限集，将用户指派到角色，并停用不再需要的角色。

如何使用：

1. 按角色名搜索并按启用/停用筛选；分页浏览
2. 点击创建角色命名角色并勾选细粒度权限（资源与操作）
3. 使用 ⋮ → 查看详情查看、编辑改权限、管理用户挂载员工，或允许时删除
4. 通过打开现有角色的编辑并只改差异来复用模板
5. 保存后若员工菜单未立即更新，可请其重新登录

角色列表

创建角色（弹窗 — 角色名与权限网格）

---

16. 员工

租户管理用户：可搜索表格、角色筛选、每页条数、CSV 导出，以及用于新增、编辑、移除员工并分配自定义角色的弹窗。

如何使用：

1. 按姓名或邮箱搜索；按分配角色筛选；大团队可调每页行数
2. 点击添加员工（或等价入口）邀请人员 — 填写身份信息并挂载一个或多个自定义角色
3. 用行操作编辑员工角色或按策略停用/删除
4. 需要离线名册审计时导出列表
5. 若组织要求，在门户外汇总密码重置或 MFA

员工列表

添加员工（弹窗 — 身份与自定义角色）

---

17. 门店管理

与侧栏门店管理（/stores）一致。门店登记：仪表盘统计、搜索、状态筛选、分页、CSV 导出，以及创建/编辑每家门店的弹窗。

如何使用：

1. 查看摘要块中的总数、运营中/已停业与注册数
2. 按状态搜索筛选；长列表分页浏览
3. 创建或编辑门店以在表单中填写名称、地址、地理/图钉、营业时间等元数据
4. 在门店行点击 QR 图标（提示查看 URL 与 QR Code）打开门店 URL 与 QR Code — 复制注册 URL、新标签打开，或打印二维码用于店内物料
5. 导出目录给运营，或关停已关闭门店

门店列表

创建新门店（向导弹窗 — 详情、地图、确认）

门店 URL 与 QR Code（对话框 — 注册 URL、QR Code、复制）

---

18. 通知

与侧栏通知一致。向会员端用户发送推送通知、查看订阅统计并广播消息。

如何使用：

1. 查看推送通知订阅统计
2. 查看订阅用户数与订阅率
3. 撰写广播通知的标题与正文
4. 选择通知分类（新闻与更新或促销）
5. 可选填写点击通知后打开的链接 URL
6. 向所有订阅用户发送广播

推送通知（订阅统计、广播表单 — 标题、富文本、分类、可选链接 — 及发送结果）

---

19. 新闻资讯

为会员创建与管理新闻文章、公告与更新。支持富媒体、分类、标签、草稿/发布工作流、定时发布、列表筛选以及在会员端置顶。

如何使用：

1. 在表格中查看全部文章：标题、分类、关联活动（如有）、状态、发布日、点赞数与操作
2. **搜索：**用搜索框匹配列表关键词；停止输入后不久刷新并回到第 1 页
3. 筛选：用状态（所有状态、草稿、已发布、未发布）与/或分类（所有分类、公告、活动、促销、更新、其他）筛选；每次变更重载并回到第 1 页。有筛选时点击清除重置两个下拉与第 1 页
4. 置顶：在操作列用图钉图标 — 提示置顶或取消置顶 — 置顶或取消（置顶行标题旁显示小图钉）。需要 news → edit 权限
5. 新建文章：标题、摘要、富文本正文、图片、视频、分类与标签
6. 存草稿或立即发布；设置发布日/时间与可选到期日/时间以定时与自动隐藏
7. 在操作列中按权限发布、取消发布、编辑、预览或删除

新闻列表

创建资讯（弹窗 — 内容、媒体、排期）

---

20. PIN 访问

管理用于核销优惠券的店员 PIN 码（前缀、权限如优惠券核销或代币领取、状态）。筛选、分页、创建、编辑、删除，并在允许时显示掩码 PIN（眼睛图标）。

如何使用：

1. 查看页顶租户 PIN 前缀（若 API 返回）以便员工了解码格式
2. 按状态与权限类型筛选表格；用分页切换页
3. 点击创建（或创建 PIN）打开弹窗 — 按表单设置标签、权限范围、使用限额与有效期
4. 用行操作编辑、删除或在审计时切换 PIN 明文显示（眼睛图标）
5. 及时停用或移除已泄露 PIN；新活动应使用新生成的码
6. 同一套 PIN 也可通过 External API（/staff-pins，需 staff_pins scope）列出、创建、更新与校验

PIN 列表

创建 PIN（弹窗 — 标签、权限、限额）

---

21. API 文档

与侧栏 API 文档（/api-docs）一致。门户内外部 API（/external/v1）参考：顶部基础 URL 横幅，其次第二列标签（页内侧栏）按区域切换 — 身份验证、优惠券、用户、营销活动、代币、分析、店员 PIN。各分区含说明（如有）、端点卡片、参数、示例 JSON 与示例 curl。API 密钥在设置 → API 密钥创建，不在此页。

如何使用：

1. 需要从蓝色横幅复制确切外部前缀时使用基础 URL
2. 点击页内左侧列（主应用侧栏下方）的标签打开该资源文档 — 顺序：身份验证 → 优惠券 → 用户 → 营销活动 → 代币 → 分析 → 店员 PIN
3. 在身份验证下阅读如何发送 X-API-Key、限流与响应包结构
4. 在其他标签展开或滚动端点卡片 — 查看路径、查询/正文字段与示例响应
5. 在代码块上使用复制粘贴到终端或 Postman
6. 需要创建或轮转密钥时在大屏左下使用前往设置进入 API 密钥管理

身份验证

优惠券

用户

营销活动

代币

分析

---

22. 设置

只读租户资料、功能开关与你登录可见的计费摘要；以及自助 API 密钥管理（创建、权限范围、一次性复制、撤销）、界面语言、可选数据导出。数据导出可能显示"即将推出"。

如何使用：

1. 查看账号信息（你的资料）与租户信息（名称、代称、状态、联系人）
2. 浏览功能 — 开关多为说明性质；实际启停由平台运营控制
3. 阅读账单信息：维护费、生效计费模型与合同展示费率（每单位、百分比或代币价值百分比）。代币价值百分比类型的费用会自动按代币锚定法币与计费币种之间的汇率换算
4. 在语言（地球图标）下选择 English、繁體中文 或简体中文 — 管理后台界面立即切换；当前语言显示勾选。选择保存在本浏览器（i18n）
5. 在 API 密钥下点击创建密钥，输入标签，选择权限范围（优惠券、用户、营销活动、代币、分析、店员 PIN），一次性复制密钥，轮转时撤销旧密钥
6. 可选：在危险区域使用导出（若租户暴露数据导出）— 应用可能显示进度或"即将推出"

设置

创建 API 密钥（弹窗 — 标签、权限范围、一次性密钥复制）

---

23. 会员等级

管理忠诚度计划的会员等级 — 配置会员如何赚取成长值、在各等级间晋升，以及享受各等级专属权益。页面展示统计横幅、最多五个等级的列表（按权重排序），以及成长值规则配置面板。此模块仅在租户启用会员等级功能开关后可见。

如何使用：

1. 在侧边栏中点击会员等级
2. 查看统计横幅：已注册会员总数、近 30 天内赋予的成长值、近 30 天内的交易数 — 点击任意卡片可打开详情抽屉
3. 浏览等级列表：每行显示该等级的颜色标识、名称、升级所需成长值、成长值倍率与折扣率；点击某行可展开该等级的会员列表
4. 若尚未创建任何等级，可点击初始化启动三步设置向导：第一步配置等级名称与阈值，第二步配置成长活动，第三步预览确认
5. 当等级数量少于五个且你拥有 create 权限时，点击**+ 添加等级**打开新建等级弹窗
6. 点击等级行上的编辑（铅笔）图标，更新名称、颜色、所需成长值、倍率、折扣率、等级类型或到期设置
7. 点击删除（垃圾桶）图标移除等级 — 基础等级不可删除
8. 在成长值规则区域，针对各活动类型（优惠券兑换、互动参与、完善资料）分别开启或关闭，并调整每次积分与每日上限；点击更新保存

---

24. 商品管理

对应侧边栏中的商品管理（/products）。仅当平台超级管理员为你的租户开启电商功能模块后才可见。列表展示商品封面图、名称/SKU、分类、价格、库存与状态，支持搜索、分类与状态筛选、批量上下架，并提供多分区的新建/编辑表单。

如何使用：

1. 使用搜索框、分类下拉与状态下拉（已上架 / 已下架）筛选列表
2. 点击新建商品（在拥有权限时）打开商品表单，或点击某一行 / 编辑修改已有商品
3. 填写名称、富文本描述与条款、最多 10 张图片（第一张为封面图）以及所属分类
4. 设置定价：法币价格、可选的固定积分价格，以及是否允许积分抵扣（买家结算时用积分抵扣部分法币价格）；可选择统一定价（所有规格同价）或按规格定价（每个规格独立定价）
5. 可选：添加最多 3 组规格（例如颜色、尺码）及其选项值 —— 表单会自动生成每种组合对应的一行；为每个规格设置 SKU、库存（或不限库存）、启用状态，以及可选的价格/重量覆盖值
6. 设置配送范围 —— 全球配送或限定国家/地区 —— 用于结算时校验收货地址是否在配送范围内
7. 当至少有一张图片、有效价格、以及非零库存（不限库存商品除外）后，可将状态设为已上架；已下架的商品对会员端不可见
8. 使用行内操作 —— 编辑、上架/下架、复制（打开预填充的草稿，始终保存为已下架状态）、删除（若商品存在未完成订单则被阻止）—— 或勾选多行使用批量上架/下架操作栏

提示： 用于积分定价的积分代币由超级管理员在为租户（或子公司）开启电商模块时统一设定 —— 详见超级管理后台指南。

---

25. 订单管理

对应侧边栏中的订单管理（/orders）。电商模块的订单台账：支持搜索、订单状态筛选、日期范围筛选、CSV 导出，并提供包含发货、取消与退款操作的订单详情页。

如何使用：

1. 使用状态筛选标签（全部、待支付、待发货、已发货、已完成、已取消、退款中、已退款）按订单状态筛选；使用搜索框与日期范围选择器进一步缩小范围
2. 点击导出将筛选后的列表下载为 CSV（订单号、状态、会员、商品/规格/数量、币种、法币/积分/优惠券金额、支付方式、物流公司、运单号、时间戳）
3. 点击某一行或眼睛图标打开订单详情 —— 商品项、收货地址、支付明细（法币、积分、优惠券，以及具体由哪个 Stripe 账户收款），以及订单时间线
4. 对待发货订单点击发货，填写物流公司（可从预设列表选择或手动输入）与运单号 —— 操作后订单状态变为已发货；之后可使用修改物流信息更正物流公司/运单号
5. 对待支付或待发货订单使用取消，将该订单占用的库存、积分与优惠券退还给会员
6. 对待发货、已发货或退款中的订单使用退款，审批或拒绝会员的退款申请 —— 批准退款会通过原收款的 Stripe 账户退还法币，并退还积分与优惠券，同时可选择是否将退回的商品重新入库；拒绝退款则将订单恢复为此前状态，并附上你的审核备注

---

需要帮助？

若你在使用管理功能时遇到问题或有疑问，请联系系统管理员或超级管理员。

---

本指南于 2026-04-13 由脚本自动生成。