feat: update documentation content and rebuild static assets for VitePress project

2026-04-01 15:27:24 +08:00
commit f2cd87c42c
518 changed files with 18646 additions and 0 deletions
@@ -0,0 +1,50 @@
+# POS (ZSW) 系统引言与技术指南
+
+::: tip 品牌背景
+**POS (ZSW)** 是本公司自有的门店零售管理系统，全称为“POS 智慧门店管理平台”。本指南旨在协助运营团队掌握后台配置，并为技术团队提供部署参考。
+:::
+
+## 1. 运营快速开始
+本系统的后台管理主要涵盖商品、门店、营销、会员及财务对账。
+- **管理地址**：[http://pos.lotus-wallet.com/](http://pos.lotus-wallet.com/)
+- **核心操作**：请参考后续章节的 `2.登录` 及 `5.商品管理`。
+
+---
+
+## 2. 技术研发与部署
+
+### 2.1 代码维护
+本系统文档及部分前端代码采用 Git 进行版本管理：
+```bash
+git clone https://git.lotus-wallet.com/Loki/zsw-docs.git
+```
+
+### 2.2 容器化部署 (Rainbond 平台)
+系统支持基于 Docker 的自动化构建与发布。
+
+**Dockerfile 示例：**
+```dockerfile
+FROM nginx
+# 将构建产物 dist 目录拷贝至 Nginx 静态资源目录
+COPY ./dist /usr/share/nginx/html
+# 引入自定义 Nginx 配置（用于反向代理及上下载限制）
+COPY ./default.conf /etc/nginx/conf.d/
+EXPOSE 80/tcp
+```
+
+**镜像分发流程：**
+1. **构建本地镜像**：`docker build . -t registry.cn-beijing.aliyuncs.com/zsw2023/pos-system`
+2. **推送至私有仓库 (阿里云)**：
+   ```bash
+   docker login registry.cn-beijing.aliyuncs.com
+   docker push registry.cn-beijing.aliyuncs.com/zsw2023/pos-system
+   ```
+3. **平台构建**：前往 [Rainbond 控制台](http://rainbond.lotus-wallet.com/) 点击“构建”即可完成线上服务的实时更新。
+
+![容器化部署逻辑图](img/rainbond-container.png)
+
+---
+
+## 3. 协作建议
+- **内容维护**：本文档为长期更新项，鼓励所有运营及技术人员共同参与纠错与迭代。
+- **图片规范**：所有文档插图请统一存放在对应目录下的 `img` 文件夹内，并保持命名规则清晰。
@@ -0,0 +1,21 @@
+# 门店收银端登录指南
+
+::: info 终端定位
+门店端（Merchant Terminal）主要面向前台收银员与店员。它提供了极简化的操作界面，支持扫码下单、挂单点菜、交接班及实时订单状态管理。
+:::
+
+## 1. 登录访问
+- **访问地址**：[回乡 POS 门店终端](http://pos.merchant.lotus-wallet.com)
+- **验证方式**：输入分配给该门店的店员账号与密码。
+
+![门店端登录界面](img/image1.png)
+
+---
+
+## 2. 初始准备：开账操作
+**关键步骤**：首次进入系统或更换交接班时，必须执行“开账”。
+1. 登录成功。
+2. 点击【店员交接】。
+3. 点击【开账】并刷新页面，此时系统正式进入可售状态。
+
+![开账操作预览](img/image-1.png)
@@ -0,0 +1,22 @@
+# 门店端：商品快速上下架处理
+
+::: info 场景应用
+在日常营业中，如遇到某个主打菜品或明星单品售罄，店员可直接在门店端执行“下架”，防止用户在小程序前端误下单。
+:::
+
+## 1. 商品状态快速调整
+- **操作路径**：`门店端` -> `商品操作`。
+- **作用**：实时隐藏无法下单的商品或恢复已到货的商品。
+
+### 1.1 执行下架 (Sold Out)
+1. 在“商品分类”中搜索目标商品。
+2. 点击“编辑商品信息”。
+3. **关键开关**：将“是否上架”设为 **否**，同时将“小程序是否显示”设为 **否**。
+4. 保存预览，此时该商品在收银端及小程序将同步消失。
+
+![商品状态编辑](img/image7.png)
+
+---
+
+## 2. 批量库存同步
+对于库存精准管理的门店，建议在下架前核实“库存总量”。如果库存已为 0 且设置了“库存锁定”，系统将自动置灰售罄商品。
@@ -0,0 +1,55 @@
+# 标准收银与结算操作流程
+
+::: tip 运营流程
+一套标准的终端收银流程包含：**开账 -> 下单（堂食/自取） -> 支付（多轨道支付） -> 履约（状态流转）**。
+:::
+
+## 1. 业务下单全流程
+
+### 1.1 开账与交班
+- **必须先进行“开账”**，否则所有收款单据无法进入当前会计周期流水。
+
+### 1.2 点餐下单
+- **点餐方式**：在商品列表中勾选产品。
+- **模式选择**：选择“堂食点餐”（需输入餐号/桌位号）或“自取打包”。
+- **单据出单**：确认后系统自动触发后厨打印机出单。
+
+![下单下单预览](img/image-2.png)
+
+---
+
+## 2. 支付轨道与核算
+
+### 2.1 常见的支付轨道
+| 支付方式 | 操作要领 |
+| :--- | :--- |
+| **现金支付** | 输入实收金额，系统自动找零。部分收银机支持自动开箱。 |
+| **在线支付** | 选择微信/支付宝后，使用扫码枪扫描客户的付款码（二维码/条码）。 |
+| **会员余额** | 输入会员手机号/卡号，验证身份后直接从其余额账户核销。 |
+| **三方/记账** | 仅用于记账联通（如：美团、大众点评已支付单据的线下手动平账）。 |
+
+![支付方式列表](img/image-3.png)
+
+---
+
+## 3. 订单生命周期管理 (状态变更)
+订单的履约过程决定了用户的通知体验。
+
+- **制作中**：下单后自动进入该状态。
+- **待取中 (或待送)**：点击状态变更，系统将推送微信公众号消息提醒用户取餐。
+- **已完成**：**重要！** 只有标记为“已完成”的订单才会计入后台销售报表。
+
+::: warning 结班提醒
+当班结束（交班）前，请务必核查并处理所有订单，将其标记为 **“完成”** 或 **“取消”**。严禁在结班时留存未处理的中间态订单。
+:::
+
+![状态流转界面](img/image-4.png)
+
+---
+
+## 4. 售后退款处理 (退菜管理)
+1. 点击“订单查询”找到对应订单。
+2. 点击“申请退款”。
+3. **退款操作**：勾选具体的退款菜品或整单退款，填写理由，提交至后台（冯美坎/管理员）审核。
+
+![售后退款界面](img/image-5.png)
@@ -0,0 +1,57 @@
+# 联动打印设置与外卖接单配置
+
+::: tip 打印机核心
+高效的收银与出餐离不开打印机的稳定连接。本系统支持飞鹅、商鹏、易联云等主流云打印及本地热敏打印，主要用途涵盖结账小票、后厨配菜单及外卖标签。
+:::
+
+## 1. 打印机档案管理 (新增打印机)
+- **操作路径**：`设置` -> `打印机设置` -> `新增`。
+- **配置要点**：
+  - **设备编码**：通常位于打印机底面标签。
+  - **打印机类型**：正确识别品牌（如飞鹅、商鹏、本地等）。
+
+![新增打印机界面](img/printer.png)
+
+---
+
+## 2. 深度业务绑定 (按场景分配)
+单纯新增打印机后，必须将其绑定至具体的业务场景才能触发打印动作。
+
+### 2.1 结账、订单与厨房单绑定
+- **操作路径**：`系统设置` -> `打印机设置`。
+- **逻辑说明**：可将“结账单”同时绑定至多个打印机（如收银台 + 前台）。
+
+![业务场景绑定](img/printer2.png)
+
+### 2.2 后厨配菜单绑定 (按商品分类)
+- **操作路径**：`运营` -> `商品分组`。
+- **逻辑说明**：每个分类（如“热菜类”）可绑定独立的厨房打印机，实现菜品分档口自动出单。
+- **特别提醒**：新录入商品分类时，请务必同步检查打印机设置，防止漏打。
+
+![配菜单设置](img/printer1.png)
+
+### 2.3 区域与桌位绑定
+- **操作路径**：`门店管理` -> `桌位区域`。
+- **应用场景**：堂食商户可将特定包厢区域的打印指令定向分配至该区域的就近服务台，提升响应速度。
+
+![桌位区域绑定](img/printer3.png)
+
+---
+
+## 3. 外卖自动接单配置 (外域对接)
+
+::: danger 最佳实践原则
+**强烈建议**：请尽量通过厂商官方**公众号**进行自动接单配置（不依赖手机 APP 启动，更稳定），而非通过 APP 蓝牙直连打印。
+:::
+
+### 3.1 配置流程 (以飞鹅/易联云/商鹏为例)
+1. **关注平台公众号**：
+   - 飞鹅：【飞鹅自动接单外卖打印机】
+   - 易联云：【易联云外卖打印机】
+   - 商鹏云：【商鹏助手】
+2. **添加设备**：扫描打印机背面序列号，关联至您的账户。
+3. **平台授权**：在公众号主页选择“绑定店铺”，输入美团或饿了么的商家账号进行授权。
+4. **单据测试**：设置打印份数并点击“测试打印”，确保证常同步。
+
+![飞鹅外卖配置](img/printer/p1.jpg)
+![店铺授权测试](img/printer/p2.jpg)
@@ -0,0 +1,62 @@
+# 多维报表分析与营运决策
+
+::: tip 报表价值
+数据不仅是结果，更是经营的罗盘。本系统提供了从订单流水到单品毛利、从会员充值到门店分账的全方位报表体系。建议各店长每周定期导出“周期报表”进行深度业务复盘。
+:::
+
+## 1. 核心报表矩阵
+
+### 1.1 综合报表：财务对账基准
+- **功能**：详尽展示订单的各种优惠（平台赠送、商户赠送、第三方优惠）、实付金额及退款流水。
+- **对账点**：重点查核“实付金额”与“流水号”，确保每一笔资金流向清晰。
+
+![综合报表界面](img/zhbb.png)
+
+### 1.2 销售报表：品类动销分析
+- **菜品占比图**：直观展示各类产品的营业额比重（如：主食 vs 引流产品）。
+- **时间段分析**：显示全天各营业时段（如早市、午市、晚市）的峰值压力与营收情况。
+- **单品排行榜**：根据销售数量与单价，识别门店的“爆款”与“僵尸款”。
+
+![销售占比分析](img/xsbb1.png)
+![时间段规律统计](img/xsbb2.png)
+
+### 1.3 营收明细：毛利与折扣透视
+- **核心指标**：原价、实收、优惠额及其各自的占比。
+- **价值**：帮助识别营销活动（如满减、打折）是否过度侵蚀了商品毛利。
+
+![营收统计看板](img/ysbb.png)
+
+---
+
+## 2. 周期性经营分析
+
+### 2.1 周期报表 (日/周/月轮转)
+- **订单周期**：每日查看桌均消费、实收收入及折扣率变化。
+- **销售周期**：按商品分组筛选，查看每个品类在不同日期的波动。
+- **单品周期**：追踪特定促销单品的每日转化率。
+
+![经营周期汇总](img/zqbb1.png)
+
+---
+
+## 3. 资金与营销统计
+
+### 3.1 充值报表与周期
+- **监控点**：监控会员储值池的注资速度，区分小程序在线充值与 POS 线下充值。
+- **营销赠送**：核算充值满减活动带来的账面“虚耗”与实际现金入账。
+
+![充值明细表](img/czbb.png)
+
+### 3.2 活动统计表
+- **分析维度**：按促销活动类型（优惠券、活动阶梯减）统计。
+- **效果评估**：通过“执行次数”与“订单原价/实收”对比，评估该活动是否真正带来了营业额增量。
+
+![活动效果分析](img/hdtjbb.png)
+
+---
+
+## 4. 结算与分账 (财务专用)
+- **店铺流水**：显示所有入账、退款、体现记录，是资金链路的最底层审计依据。
+- **门店分账**：针对联营或托管门店，实时查看分账比例、结算金额及分账状态（待审核/已通过/已完成）。
+
+![资金流水追踪](img/dpls.png)
@@ -0,0 +1,63 @@
+# 企业公共网盘使用指南
+
+::: tip 协助与支持
+在使用网盘过程中，如有任何疑问（如账号登录、大文件传输、同步冲突等），请及时在企业微信联系技术团队。
+:::
+
+## 1. 产品形态概览
+
+回乡企业网盘基于群晖（Synology）技术栈，提供两种核心使用形态以满足不同的办公场景：
+
+- **File Station (网页文件管理器)**：提供极致的在线预览体验。支持文件/文件夹的直接上传下载、视频在线播放及图片预览。
+- **Synology Drive (同步协作组件)**：更接近“本地操作”的体验。支持文件多端同步、增量备份以及快速生成外链共享。
+
+---
+
+## 2. 访问与使用方式
+
+### 2.1 网页端 (Web) 访问
+无需安装插件，通过浏览器即可快速完成文件的查阅与简单传输。
+
+#### **File Station: 在线预览与传输**
+- **地址**：[http://pan.yixinhuixiang.com/](http://pan.yixinhuixiang.com/)
+- **特点**：适合临时查阅、在线预览音视频资料。
+
+![File Station 界面预览](img/drive/pan.png)
+
+#### **Synology Drive: 云端同步协作**
+- **地址**：[http://drive.yixinhuixiang.com/](http://drive.yixinhuixiang.com/)
+- **特点**：支持直接在网页端生成“共享链接”分享给他人。
+
+![Drive 网页版界面](img/drive/drive.png)
+
+---
+
+## 3. 客户端使用 (推荐)
+
+为了获得类似“本地硬盘”的操作体验，推荐在办公电脑上安装 **Synology Drive Client** 客户端。
+
+### 3.1 客户端下载
+- [官方下载页 (Synology 官网)](https://www.synology.cn/zh-cn/dsm/feature/drive)
+
+**常用系统快速下载链接 (2024.12 更新)：**
+- ⬇️ [Windows 64位下载](https://cndl.synology.cn/download/Utility/SynologyDriveClient/3.5.1-16102/Windows/Installer/x86_64/Synology%20Drive%20Client-3.5.1-16102-x64.exe?model=RS3614xs%2B&bays=12&dsm_version=7.1.1&build_number=42962)
+- ⬇️ [macOS 下载](https://cndl.synology.cn/download/Utility/SynologyDriveClient/3.5.1-16102/Mac/Installer/synology-drive-client-16102.dmg?model=RS3614xs%2B&bays=12&dsm_version=7.1.1&build_number=42962)
+
+::: warning 温馨提示
+如若上述直接下载链接失效，请根据引导进入官网下载或联系技术支持。
+:::
+
+### 3.2 客户端配置
+安装完成后，请在服务器地址栏输入：
+`drive.yixinhuixiang.com`
+
+- **操作体验**：客户端支持“按需同步”（不占本地硬盘空间，仅在双击打开时下载）和“实时备份”。其操作逻辑与百度网盘、腾讯微云等产品相似。
+
+![客户端同步界面](img/drive/client.png)
+
+---
+
+## 4. 注意事项
+1. **数据安全**：请勿将网盘账号泄露给外部人员。
+2. **共享权限**：在 Drive 生成分享链接时，请务必核实接收人的权限范围（只读/可编辑）。
+3. **版本冲突**：当多人同时编辑同一个 Drive 同步文档时，请注意同步提示以防数据覆盖。
@@ -0,0 +1,33 @@
+# 系统登录与界面概览
+
+::: tip
+商家后台是 POS 业务的核心指挥站。请妥善保管您的员工账号与密码。
+:::
+
+## 1. 登录访问指南
+
+- **访问地址**：[回乡 POS 商家端](https://pos.tenant.lotus-wallet.com)
+- **验证方式**：输入您的商家账号及对应密码即可登录。
+
+![登录界面](img/login.dat)
+
+---
+
+## 2. 后台功能区域分布
+
+登录成功后，您将进入管理主界面。系统分为**上方导航栏**（核心业务切换）与**左边导航栏**（精细化功能配置）。
+
+### 2.1 五大核心业务板块
+| 板块名称 | 主要功能描述 |
+| :--- | :--- |
+| **概况** | 业务仪表盘。实时查看店铺今日营收、订单量、退单统计及资金对比。 |
+| **运营** | 核心业务流。包含店铺基本设置、商品新增与编辑、实时订单处理。 |
+| **营销** | 用户触达工具。可在此设置营销优惠券、推文活动及会员促销规则。 |
+| **报表** | 数据中心。提供多维度的销售统计报表、营收明细分析及员工绩效参考。 |
+| **会员** | 私域资产管理。涵盖会员等级设置、名单维护、储值余额及消费积分查询。 |
+
+---
+
+## 3. 操作小贴士
+1. **多终端同步**：后台所有配置操作在保存后将实时同步至门店扫码设备及 PC 端的 POS 终端。
+2. **退出安全**：若在公用设备操作，离开前请务必点击账户头像执行“退出登录”。
@@ -0,0 +1,32 @@
+# 商品分组与分类策略
+
+::: tip 运营提示
+在上传商品前，请务必先建立“商品分组”。上传商品时勾选对应的分组，既能保持后台条理，也有助于在前端（小程序/APP）展现整洁。
+:::
+
+## 1. 添加商品分类/分组
+- **操作路径**：`运营` -> `商品分组`。
+- **作用**：将商品归类，如“时令蔬菜”、“有机干货”、“酒水饮料”。
+
+### 10.1 核心配置要素
+| 字段名称 | 操作指南 |
+| :--- | :--- |
+| **分类名称** | 建议简短明确，方便在小程序顶部导航栏展示。 |
+| **排序权重** | 输入数值调整排列顺序。数值越大，在前端展示越靠前。 |
+| **收款参数** | 包含商户名称、商户编号、分账比例等（通常由财务/技术人员预设，一般无需手动修改）。 |
+
+---
+
+## 2. 核心开关：是否参与折扣
+
+这是一个极其重要的功能点，直接影响门店利润。
+- **场景应用**：
+  - **是 (开启)**：该分类下的所有商品将受全店满减、会员折扣等营销活动影响。
+  - **否 (关闭)**：例如“酒水类”、“高价值定制类”或其他毛利较低的产品。即便全店打 8 折，该分组下的商品仍将维持原价，受利润保护。
+
+---
+
+## 3. 前端预览与展示
+成功设置后，对应的排序和名称将实时反映在小程序的分层列表中。
+
+![分类配置界面](img/image3.png)
@@ -0,0 +1,43 @@
+# 门店设置与支付配置
+
+::: danger 警告
+店铺收款方式（微信、支付宝）的配置，非专业技术人员请勿在生产环境下轻易变更。错误的设置会导致门店发生无法收款或资金流错乱的严重事故。
+:::
+
+## 1. 门店基础信息维护
+- **操作路径**：`运营` -> `门店列表` -> `编辑`。
+- **作用**：维护店铺名称、营业时间、地址坐标、店铺 Logo 及门面大图。
+
+### 1.1 收单业务类型 (极其重要)
+系统根据收单模式的不同，有不同的订单流转逻辑：
+
+| 业务类型 | 适用场景 | 结算逻辑 |
+| :--- | :--- | :--- |
+| **直付** | 简单的扫码付商户。 | 即时支付。 |
+| **零售** | 零售超市、便利店。 | 先付款后出货，库存即时核减。 |
+| **快消餐饮** | 奶茶、饮品点单，扫码后自取。 | 线上下单并支付，后出餐。 |
+| **普通餐饮** | 堂食扫码点餐（桌位码）。 | **先打单后结算**。支持多次点菜，餐后统一支付。 |
+
+![门店基础配置](img/image.png)
+
+---
+
+## 2. 支付方式管理
+- **操作路径**：`运营` -> `门店` -> `支付方式`。
+
+### 2.1 默认支付轨道
+系统预设了以下 6 种标准支付方式：
+- **混合支付**：支持微信、支付宝。
+- **余额中心**：门店余额、平台余额。
+- **结算凭证**：现金、绿币支付。
+
+### 2.2 自动优惠功能
+在支付方式中开启“自动优惠”后：
+- 若收银员输入的“实付金额”小于“应付金额”，系统将差值部分自动作为该种支付方式的优惠入账（需谨慎开启，防止误操作导致的财务对账不平）。
+
+---
+
+## 3. 页面展示预览
+在管理后台进行配置后，相关信息将实时更新至移动端（小程序/APP）的门店列表展示页。
+
+![支付方式配置界面](img/sts3.png)
@@ -0,0 +1,29 @@
+# 商品基础信息录入
+
+::: info 录入核心
+商品是 POS 系统的基本业务单元。准确填写商品的分组、价格、属性以及限购规则，是库存管理与收银结算的前提。
+:::
+
+## 1. 商品管理概览
+- **操作路径**：`运营` -> `商品` -> `商品管理`。
+- **作用**：全案管理商品上架、下架、基本属性及积分权益。
+
+---
+
+## 2. 核心字段配置指引
+
+| 字段名称 | 操作规范 |
+| :--- | :--- |
+| **商品名称** | 建议直读性强（如：有机红富士苹果）。 |
+| **商品分组** | **必填项**。关联之前建立好的商品分类（如：时令蔬果）。 |
+| **集换卡** | 营销属性。设置后客户在小程序购买本品可自动获取集换卡，用于后期兑换权益。 |
+| **显示渠道** | 默认全部显示。若设置为“仅小程序”，收银端 POS 将无法扫描并下单。 |
+| **限购次数** | 防薅羊毛设置。设置后仅在小程序/APP 端生效。 |
+
+![商品录入主界面](img/image.png)
+
+---
+
+## 3. 注意事项
+- **首图规格**：建议使用 1:1 的白底或实拍精致图，提升列表美感。
+- **关联分组**：若商品未关联分组，系统将无法正确将该品推送至前端展示位。
@@ -0,0 +1,38 @@
+# 款式设置：单品、规格与套餐
+
+::: tip 款式差异
+款式设置决定了用户的选择体验。单款式适用于标品（如：矿泉水），多款式适用于非标品（如：奶茶、咖啡），套餐适用于组合销售（如：超值双人餐）。
+:::
+
+## 1. 款式分类与配置
+
+### 1.1 单款式 (标品配置)
+- **适用场景**：单一规格、单一单价。
+- **配置要点**：直接录入 SKU 编码、售价及库存即可。
+
+![单款式配置](img/spec1.dat)
+
+### 1.2 多款式 (sku 矩阵配置)
+- **适用场景**：奶茶（冰/热、糖度）、服装（S/M/L、红/绿）。
+- **配置要点**：
+  - 点击“新增规格”，输入规格名（例：温度）。
+  - 添加规格值（例：常温、去冰、少冰）。
+  - 为每一个生成的 SKU 组合独立设置价格、库存。
+
+![多款式配置](img/spec2.dat)
+
+### 1.3 套餐 (组合销售配置)
+- **适用场景**：由多款固定产品或可选产品组合而成的定额商品。
+- **配置策略**：
+  - **基础信息**：选择“单款式”并录入套餐总价。
+  - **套餐详情**：点击“套餐选择”，增加分组（例：主食分组、饮品分组）。
+  - **规则设定**：如设置“3 选 1”或“2 选 2”，满足用户的个性化搭配需求。
+
+![套餐设置](img/spec3.png)
+![套餐预览](img/spec4.png)
+
+---
+
+## 2. 运营小知识
+- **库存控制**：多款式模式下，系统支持针对每个具体 SKU 进行库存预警设置。
+- **条码管理**：每个规格均可分配唯一的条码，方便收银扫描时自动识别对应款式。
@@ -0,0 +1,29 @@
+# 商品图文详情编辑
+
+::: info 详情作用
+精美的图文详情是提升转化率的关键。通过详情页，用户可以更直观地了解商品的产品特色、配料成分、产地及食用建议。
+:::
+
+## 1. 详情页配置
+- **操作路径**：`运营` -> `商品` -> `商品详情`。
+- **配置规则**：
+  - **图文混排**：支持插入文字、粗体设置及上传高清图片。
+  - **上传指令**：点击右上角“上传”按钮，选择本地素材库或直接上传新图。
+
+![详情编辑主界面](./img/details2.png)
+
+---
+
+## 2. 预览与生效
+
+1. **保存配置**：完成图文编辑后，点击“保存”以更新商品主档案。
+2. **实时查看**：新设置的图文详情将即时同步至小程序或 APP 端的商品详情页。
+3. **编辑修改**：如需更新促销信息或更换图片，可随时返回该页面进行二次编辑。
+
+![商品显示预览](./img/details1.png)
+
+---
+
+## 3. 注意事项
+- **图片尺寸**：建议详情页图片宽度统一为 **750px**（小程序标准宽度），以保证全屏铺满效果。
+- **文案规范**：注意文字描述的准确性，避免敏感词及违规词使用。
@@ -0,0 +1,28 @@
+# 小程序与门店轮播图配置
+
+::: tip 运营建议
+轮播图是提升门店首屏点击率的核心。建议图片比例统一为 **2:1**，且单张图片大小建议控制在 **500KB** 以内，以保证加载速度。
+:::
+
+## 1. 业务端点分类
+系统将轮播图分为“全局首页”与“单店首页”两种层级，适应不同粒度的营销。
+
+### 1.1 小程序全局首页配置
+- **操作路径**：`运营` -> `小程序配置` -> `首页配置`。
+- **作用**：控制小程序首页最顶层的全局广告位。
+
+![全局轮播配置](img/banner1.png)
+
+### 1.2 店铺详情页轮播配置
+- **操作路径**：`运营` -> `门店管理` -> `轮播`。
+- **配置规则**：
+  - **轮播类型**：设置为“首页轮播”。
+  - **单店差异化**：每个门店可拥有独立的促销海报（如：门店新店开业、单店满减）。
+
+![单店轮播预览](img/banner2.png)
+
+---
+
+## 2. 设置技巧
+- **多图轮播**：支持添加多张图片。根据排序顺序自动轮播。
+- **跳转链接**：大部分轮播位支持点击跳转至特定商品、优惠券页或自定义文案页面，极大提升转化效率。
@@ -0,0 +1,31 @@
+# 订单管理与售后处理指南
+
+::: tip 运营中心
+实时响应客户订单与售后申请是维系用户信任的核心。建议将“订单列表”页面保持在常开状态，以便随时快速筛选交易情况。
+:::
+
+## 1. 业务订单实时查询
+- **操作路径**：`运营` -> `订单` -> `订单列表`。
+- **功能点**：
+  - **检索过滤**：支持按客户名称、订单号、购买时间段及付款金额进行全维度筛选。
+  - **明细查看**：可查看客户购买的具体单品、实付金额及下单终端信息。
+
+---
+
+## 2. 售后记录与退款处理
+- **操作路径**：`运营` -> `订单` -> `售后订单`。
+
+### 2.1 退款流程闭环
+1. **订单筛选**：查看所有标记为“售后中”或“申请退款”的交易。
+2. **原因审核**：核实客户申请退款的理由是否符合门店规则。
+3. **退款操作**：
+   - 如果是微信/支付宝支付，点击“同意退款”后，资金将原路返回给用户。
+   - 商家亦可在特殊情况下（如缺货）主动发起反向退款流程。
+
+![售后管理界面](img/order5.png)
+
+---
+
+## 3. 注意事项
+- **周期限制**：通常系统支持在订单支付后的 72 小时内发起线上原路退款；超过时长的售后建议线下沟通并手动处理。
+- **退款权限**：退款涉及资金流变动，请确保操作人员具备对应的权限（财务或主店长角色）。
@@ -0,0 +1,29 @@
+# 营销活动与体系概览
+
+::: tip 活动导向
+营销活动是门店引流的关键。系统支持“门店活动”（侧重线上/线下全渠道）与“促销活动”（侧重收银端即时调整）两大核心体系。
+:::
+
+## 1. 营销活动分类
+
+### 1.1 门店活动 (全渠道营销)
+- **操作路径**：`营销` -> `门店活动`。
+- **活动类型**：
+  - **满减**：例“满 100 减 10”。
+  - **折扣**：全分类或全场打折。
+  - **兑换/换购**：凭券或积分进行实物兑换。
+- **展示渠道**：可自由勾选在小程序前端展示或仅限收银端店员操作。
+
+![门店活动列表](img/image9.png)
+
+### 1.2 促销活动 (收银端专用)
+- **主要类型**：整单折扣、分类折扣（如：酒水类 9 折）。
+- **应用场景**：收银员在结账时根据现场情况（如：熟客优惠、临期特价）手动勾选。
+
+---
+
+## 2. 运营避坑指南
+- **叠加规则**：请务必核实“分类折扣”与“全局满减”是否可叠加。若不可叠加，建议在商品分类中关闭“参与折扣”开关。
+- **有效期管理**：活动设置成功后，请检查开始与结束时间，防止出现活动未生效或过期未下线的情况。
+
+![促销分类配置](img/image10.png)
@@ -0,0 +1,45 @@
+# 优惠券全流程管理指南
+
+::: tip 优惠券核心
+系统支持 4 种标准的优惠券：满减券、兑换券、折扣券及限定券。灵活运用这四类工具，可以有效锁定新客并提升老客的回头率。
+:::
+
+## 1. 优惠券分类与应用
+- **操作路径**：`营销` -> `优惠券管理`。
+
+| 优惠券类型 | 适用场景 | 例子 |
+| :--- | :--- | :--- |
+| **满减券** | 提升客单价的关键。 | 满 40 减 5 元。 |
+| **兑换券** | 实物引流神器。 | 凭券兑换中杯美式咖啡。 |
+| **折扣券** | 节日大促、指定件数优惠。 | 买 3 件即打 7 折。 |
+| **限定券** | 指定日期/指定商品的闪促。 | 首杯奶茶 10 元限时购。 |
+
+![优惠券列表界面](img/image5.png)
+
+---
+
+## 2. 数量与发放周期 (重点关注)
+编辑优惠券时，请严格设置三个维度的“周期性”限量配置：
+
+1. **商户总量**：该批次券在全店范围内发出的总量（例：总发行 1000 张）。
+2. **个人领取限量**：单个用户在规定周期（日/周/月）内可领取的张数。
+3. **个人使用限量**：单个用户在规定周期内允许使用的最大张数。
+
+![周期配置指引](img/coupon_edit_time.png)
+
+---
+
+## 3. 优惠券捆绑方案
+- **操作路径**：`营销` -> `门店活动` -> `优惠券捆绑`。
+- **应用场景**：
+  - **新客礼包**：新会员注册小程序时，自动赠送绑定的券包。
+  - **任务奖励**：完成特定行为（如分享商品）后自动发券。
+
+![优惠券捆绑预览](img/image7.png)
+
+---
+
+## 4. 后台主动发放
+除了用户领券，商家亦可基于“会员分析”主动将优惠券推送到某个特定会员或全店会员的账户中，激活沉睡用户。
+
+![主动分发界面](img/image6.png)
@@ -0,0 +1,45 @@
+# 集换卡：消费印章与权益兑换
+
+::: tip 集换卡核心
+集换卡（Stamps）是回乡体系中独特的“游戏化营销”工具。目前主要在 **海峡姐妹 APP** 上生效。用户通过购买特定商品或达成金额条件获得“印章（集换点）”，集满后即可兑换超值实物。
+:::
+
+## 1. 印章获取规则设置
+系统支持“按单品购买”或“按满额门槛”两种获取方式。*特别提醒：平台层级的配置优先级高于单品配置。*
+
+### 1.1 方式 A：购买特定商品获取
+- **后台路径**：`运营` -> `商品` -> `商品管理` -> `编辑`。
+- **配置要点**：在商品编辑页找到“集换卡点”，设置每购买 1 件可获得的印章数（通常设置为 1）。
+
+![商品获取设置](img/image123.png)
+
+### 1.2 方式 B：全平台消费满额获取
+- **平台后台路径**：`设置` -> `系统设置` -> `集换卡设置`。
+- **配置策略**：
+  - **满额条件**：如“每满 10 元”获得 1 枚印章。
+  - **优先级**：开启本项后，单品设置将失效，以金额核算为准。
+
+![系统中心设置](img/image321.png)
+
+---
+
+## 2. 奖品池与兑换规则
+印章集齐后的兑换单品需在“积分商城”中独立维护。
+- **后台路径**：`积分商城` -> `商品管理`。
+- **关键配置**：
+  - **价格类型**：选择“仅集换券”。
+  - **积分/现金**：均填写为 0。
+
+![兑换单品配置](img/image132.png)
+
+---
+
+## 3. 用户端使用体验 (海峡姐妹 APP)
+用户可在 APP 的个人中心或首页 Banner 参与集换卡互动。
+
+1. **查阅进度**：在“收集印章页”查看已点入的印章。
+2. **兑换路径**：点击“去逛逛” -> 选择“集换券”标签 -> 选择对应商品进行兑换。
+
+![APP 场景预览](img/phone1.jpg)
+![APP 场景预览](img/phone2.jpg)
+![APP 场景预览](img/phone3.jpg)
@@ -0,0 +1,31 @@
+# 第三方券码核销 (抖音、美团等)
+
+::: danger 财务核销规范
+请务必在收银操作前，首先核销会员在三方平台（如抖音、美团、口碑）的电子券码。防止因操作失误导致的重复核销或异常退款纠纷。
+:::
+
+## 1. 后台配置：新增核销渠道
+- **操作路径**：`商户后台` -> `运营` -> `门店管理` -> `第三方渠道`。
+- **作用**：让收银端识别并处理来自非本系统的券码记录。
+
+### 1.1 核销类型配置
+- **会员余额**：导入三方平台的预存余额。建议将“核销金额”全数录入至“赠送余额”分类，以实现财务在账目上与本系统自有余额的有效区分。
+- **优惠券/票券**：针对单品兑换或定额减免券。
+
+![后台三方配置](img/tenant_third.png)
+
+---
+
+## 2. 前台收银端操作流程 (三方核销)
+1. **选择渠道**：在 POS 界面点击“第三方核销”。
+2. **身份验证**：输入客户关联的手机号码（通常为三方平台预留号码）。
+3. **完成核销**：
+   - 扫描用户三方券码并执行核销动作。
+   - **双向留存**：建议将核销后的凭证再次扫描进回乡系统，供财务后台复核。
+
+![前台核销界面](img/hexiao.png)
+
+---
+
+## 3. 对账提醒
+每个账期结束时，需在后台统计各三方渠道的核销总量，并与三方平台的管理后台导出明细进行二次核对，确保资金结算准确。
@@ -0,0 +1,42 @@
+# 会员管理与历史数据资产核算
+
+::: info 管理目标
+会员是门店运营的核心资产。本章节涵盖了会员基础管理、积分余额规则以及特定子品牌（如：百年川椒光谷店）的历史数据迁移处理办法。
+:::
+
+## 1. 常规会员管理
+- **操作路径**：顶部导航栏 `会员` -> `会员管理`。
+- **核心功能**：
+  - **档案维护**：查看会员手机号、姓名、消费频次及累计金额。
+  - **余额充值**：手动为会员处理储值变更（仅限有权限人员）。
+  - **等级策略**：设置普卡、金卡、钻卡等不同等级的折扣与权益。
+
+---
+
+## 2. 专题：百年川椒历史余额迁移策略
+针对旗下“百年川椒光谷店”由于系统更迭产生的会员余额迁移，请严格执行以下操作规程：
+
+### 2.1 历史背景说明
+- **2016年以前**：使用“志杰收款系统”。数据已整体迁移至回乡 POS 架构。
+- **2016年 - 2020年**：使用“微生活”系统。由于该系统授权已到期，目前数据以 `.xls` 表格形式离线保存。
+
+### 2.2 余额查询与绑定指引
+
+#### **A. 志杰系统会员 (在线自助绑定)**
+1. **获取编码**：运营人员在后台通过手机号/姓名搜索，获取对应“绑定编码”。
+2. **用户操作**：引导客人在“百年川椒”小程序 -> `我的` -> `老会员` 界面，输入绑定编码。
+3. **完成迁移**：验证通过后，志杰系统的余额将自动划转至小程序账户。
+
+![志杰会员绑定流程](img/member_bind.png)
+
+#### **B. 微生活会员 (人工核销与转入)**
+微生活余额由于无法自动对接，采用“先实拨、后补录”的方式：
+1. **现场抵扣**：顾客到店消费时，根据离线表格核实其余额。本次消费直接从余额中抵扣。
+2. **数据上报**：通知信息部人员（冯美坎）更新表格。
+3. **余额注入**：剩余资金将作为“赠送余额”由后台人员人工注入会员小程序账户。
+
+::: warning 特别注意
+微生活系统的离线余额单位为 **“分”**。录入与抵扣时请务必进行 100 倍换算（10000 分 = 100 元）。
+:::
+
+![微生活资料备查](img/weishenghuo.png)