Browse Source

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

master
Boom 2 days ago
commit
f2cd87c42c
  1. 35
      .antigravity/BASELINE.md
  2. 14
      .gitignore
  3. 98
      .vitepress/config.mts
  4. 67
      .vitepress/theme/LanguageSwitcher.vue
  5. 3
      .vitepress/theme/custom.css
  6. 16
      .vitepress/theme/index.ts
  7. 9
      Dockerfile
  8. 31
      api-examples.md
  9. 22
      app/1.移动APP介绍.md
  10. 46
      app/2.平台端积分商城.md
  11. 44
      app/3.填问卷送券.md
  12. 36
      app/4.好生意商家版APP/1.App下载使用.md
  13. 30
      app/4.好生意商家版APP/3.扫码核销.md
  14. 50
      app/4.好生意商家版APP/4.订单管理.md
  15. BIN
      app/4.好生意商家版APP/img/hexiao.png
  16. BIN
      app/4.好生意商家版APP/img/image-dd.png
  17. BIN
      app/4.好生意商家版APP/img/image-hx.png
  18. BIN
      app/4.好生意商家版APP/img/image-hx1.png
  19. BIN
      app/4.好生意商家版APP/img/image-sy.png
  20. BIN
      app/4.好生意商家版APP/img/image-sy1.png
  21. BIN
      app/4.好生意商家版APP/img/image-tk.png
  22. BIN
      app/4.好生意商家版APP/img/image-tkcl.png
  23. BIN
      app/4.好生意商家版APP/img/image.png
  24. BIN
      app/4.好生意商家版APP/img/image1.png
  25. BIN
      app/4.好生意商家版APP/img/image2.png
  26. BIN
      app/4.好生意商家版APP/img/login.png
  27. BIN
      app/4.好生意商家版APP/img/shouq.png
  28. BIN
      app/4.好生意商家版APP/img/shouye1.png
  29. BIN
      app/img/cm1.png
  30. BIN
      app/img/cm2.png
  31. BIN
      app/img/cm3.png
  32. BIN
      app/img/cm4.png
  33. BIN
      app/img/cm5.png
  34. BIN
      app/img/cm7.png
  35. BIN
      app/img/ques-1.png
  36. BIN
      app/img/ques-2.png
  37. BIN
      app/img/ques-3.png
  38. BIN
      app/img/ques-4.png
  39. BIN
      app/img/ques.png
  40. 18
      build.bat
  41. 18
      build.sh
  42. 6
      bxg/1.一心回乡小程序后台.md
  43. 48
      bxg/2.古桑园小程序说明.md
  44. 73
      bxg/3.回乡饱岛美食街.md
  45. 29
      bxg/4.美食街退款说明.md
  46. BIN
      bxg/img/gsy-1.png
  47. BIN
      bxg/img/gsy-2.png
  48. BIN
      bxg/img/gsy-3.png
  49. BIN
      bxg/img/meishijrf.png
  50. BIN
      bxg/img/msj.png
  51. BIN
      bxg/img/msj1.png
  52. BIN
      bxg/img/msj2.png
  53. BIN
      bxg/img/msj3.png
  54. BIN
      bxg/img/msj4.png
  55. BIN
      bxg/img/msj5.png
  56. BIN
      bxg/img/msj6.png
  57. BIN
      bxg/img/msj7.png
  58. BIN
      bxg/img/msj8.png
  59. BIN
      bxg/img/msj9.png
  60. 35
      crm/1.登录系统.md
  61. 67
      crm/2.客户管理.md
  62. 51
      crm/3.任务管理.md
  63. 41
      crm/4.财务管理.md
  64. BIN
      crm/img/image-1.png
  65. BIN
      crm/img/image-10.png
  66. BIN
      crm/img/image-11.png
  67. BIN
      crm/img/image-12.png
  68. BIN
      crm/img/image-13.png
  69. BIN
      crm/img/image-14.png
  70. BIN
      crm/img/image-15.png
  71. BIN
      crm/img/image-16.png
  72. BIN
      crm/img/image-17.png
  73. BIN
      crm/img/image-18.png
  74. BIN
      crm/img/image-19.png
  75. BIN
      crm/img/image-2.png
  76. BIN
      crm/img/image-20.png
  77. BIN
      crm/img/image-21.png
  78. BIN
      crm/img/image-22.png
  79. BIN
      crm/img/image-23.png
  80. BIN
      crm/img/image-24.png
  81. BIN
      crm/img/image-25.png
  82. BIN
      crm/img/image-26.png
  83. BIN
      crm/img/image-27.png
  84. BIN
      crm/img/image-29.png
  85. BIN
      crm/img/image-3.png
  86. BIN
      crm/img/image-30.png
  87. BIN
      crm/img/image-31.png
  88. BIN
      crm/img/image-32.png
  89. BIN
      crm/img/image-33.png
  90. BIN
      crm/img/image-34.png
  91. BIN
      crm/img/image-35.png
  92. BIN
      crm/img/image-36.png
  93. BIN
      crm/img/image-37.png
  94. BIN
      crm/img/image-4.png
  95. BIN
      crm/img/image-41.png
  96. BIN
      crm/img/image-42.png
  97. BIN
      crm/img/image-43.png
  98. BIN
      crm/img/image-44.png
  99. BIN
      crm/img/image-45.png
  100. BIN
      crm/img/image-46.png
  101. Some files were not shown because too many files have changed in this diff Show More

35
.antigravity/BASELINE.md

@ -0,0 +1,35 @@
# Project Baseline: VitePress Integration
## Global Architecture
- **Framework**: VitePress
- **Platform**: Node.js
- **Styling**: Vanilla CSS (VitePress Defaults)
## Business Logic
- Static documentation site for sports, programming, and business systems (CRM, ERP, BPM, etc.).
## Project Status
- [x] Directory initialized.
- [x] VitePress project structured.
- [x] Custom "运动百科" (Sports Encyclopedia) theme applied (Now expanded to general Knowledge Base).
- [x] Full "跑步指南" (Running Guide) page restored.
- [x] Full "编程知识库" (Scientific Internet Access Guide) page implemented.
- [x] **New**: Migrated 8 business system folders (approx. 570 files) from `docs/` to root.
- [x] **New**: Integrated business systems into Navigation and Sidebar (multi-sidebar configuration).
- [x] **New**: Added `.gitignore` to exclude `node_modules`, build artifacts, and environment files.
## Dependencies
- `vitepress`: ^1.6.4
- `vue`: ^3.5.31
## Pending Tasks
- [x] **New**: Unified "hxzx" project name to "回乡甄选" across documentation and configuration.
- [x] **New**: Localized and standardized "zsw" (POS), "app", "bxg", "odoo", "erp", and "crm" directories.
- Renamed markdown files and subfolders to Chinese with numeric prefixes for correct sidebar sorting.
- Optimized and beautified all contents in "hxzx", "erp", and "crm" using VitePress features.
- [x] **New**: Removed "sports" section and revamped homepage (`index.md`) to reflect the new "回乡知识中心" (Hui Xiang Knowledge Center).
- [ ] Implement "Programming" section content.
- [ ] Complete sidebar entries for all business system sub-pages.
- [ ] Fine-tune the documentation layout for business systems.

14
.gitignore vendored

@ -0,0 +1,14 @@
node_modules
.vitepress/dist
.vitepress/cache
.DS_Store
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
.env
.env.local
.env.*.local
dist/
.idea/
.vscode/

98
.vitepress/config.mts

@ -0,0 +1,98 @@
import { defineConfig } from 'vitepress'
import fs from 'node:fs'
import path from 'node:path'
// 递归获取目录下所有 markdown 文件作为侧边栏项
function getSidebarItems(dir: string, base: string) {
const items: any[] = []
const fullPath = path.resolve(__dirname, '..', dir)
if (!fs.existsSync(fullPath)) return []
const files = fs.readdirSync(fullPath)
files.forEach(file => {
const filePath = path.join(fullPath, file)
const stat = fs.statSync(filePath)
if (stat.isDirectory()) {
if (file === 'img' || file === 'image') return
const subItems = getSidebarItems(path.join(dir, file), base)
if (subItems.length > 0) {
items.push({
text: file,
collapsed: true,
items: subItems
})
}
} else if (file.endsWith('.md')) {
const name = file.replace('.md', '')
if (name.toLowerCase() === 'index') return
items.push({
text: name,
link: `/${dir}/${name}`.replace(/\\/g, '/')
})
}
})
// 排序:按文件名中的数字排序(如 1.登录,2.管理)
return items.sort((a, b) => {
const getNum = (s: string) => {
const m = s.match(/^(\d+)/)
return m ? parseInt(m[1]) : 999
}
return getNum(a.text) - getNum(b.text)
})
}
// https://vitepress.dev/reference/site-config
export default defineConfig({
title: "回乡知识中心", // 修改为更具品牌感的名称
description: "探索编程与业务系统的魅力",
head: [
['script', { src: 'https://cdn.jsdelivr.net/npm/opencc-js@1.0.5/dist/umd/full.js' }]
],
themeConfig: {
// https://vitepress.dev/reference/default-theme-config
nav: [
{ text: '首页', link: '/' },
{ text: '编程', link: '/programming/' },
{
text: '业务系统',
items: [
{ text: 'CRM 系统', link: '/crm/1.登录系统' },
{ text: 'ERP 系统', link: '/erp/1.登录系统' },
{ text: 'Odoo 系统', link: '/odoo/1.Odoo简介' },
{ text: '回乡甄选', link: '/hxzx/1.登录后台' },
{ text: '移动 APP', link: '/app/1.移动APP介绍' },
{ text: '回乡BPM', link: '/bxg/1.一心回乡小程序后台' },
{ text: 'POS', link: '/zsw/1.引言' }
]
}
],
sidebar: {
'/programming/': [
{
text: '编程',
items: [
{ text: '编程知识库', link: '/programming/' }
]
}
],
// 自动生成的业务系统侧边栏
'/crm/': [{ text: 'CRM 系统', items: getSidebarItems('crm', 'crm') }],
'/erp/': [{ text: 'ERP 系统', items: getSidebarItems('erp', 'erp') }],
'/hxzx/': [{ text: '回乡甄选', items: getSidebarItems('hxzx', 'hxzx') }],
'/app/': [{ text: '移动 APP', items: getSidebarItems('app', 'app') }],
'/bxg/': [{ text: '回乡BPM', items: getSidebarItems('bxg', 'bxg') }],
'/odoo/': [{ text: 'Odoo 系统', items: getSidebarItems('odoo', 'odoo') }],
'/zsw/': [{ text: 'POS', items: getSidebarItems('zsw', 'zsw') }]
},
socialLinks: [
{ icon: { svg: '<svg role="img" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path fill="currentColor" d="M12.914 2.622C12.33 2.152 11.666 2 11 2s-1.33.152-1.914.622L2.344 8.21C1.865 8.592 1.5 9.172 1.5 9.778v10.3c0 .878.718 1.59 1.601 1.59h5.183c.121 0 .219-.098.219-.22v-6.326c0-.528.428-.956.953-.956h2.89c.525 0 .953.428.953.956v6.326c0 .122.099.22.219.22h5.183c.883 0 1.601-.712 1.601-1.59v-10.3c0-.606-.365-1.186-.844-1.568l-6.745-5.588z"/></svg>' }, link: 'http://bdhp.yixinhuixiang.com' }
]
},
vite: {
assetsInclude: ['**/*.dat']
}
})

67
.vitepress/theme/LanguageSwitcher.vue

@ -0,0 +1,67 @@
<script setup>
import { onMounted } from 'vue'
const toggleLanguage = () => {
if (typeof OpenCC === 'undefined') {
console.error('OpenCC not loaded')
return
}
const currentMode = localStorage.getItem('lang-mode') || 's2t'
const config = currentMode === 's2t'
? { from: 'cn', to: 'tw' }
: { from: 'tw', to: 'cn' }
const converter = OpenCC.Converter(config)
const root = document.querySelector('#VPContent') || document.body
const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null, false)
let node
while (node = walker.nextNode()) {
node.textContent = converter(node.textContent)
}
localStorage.setItem('lang-mode', currentMode === 's2t' ? 't2s' : 's2t')
}
onMounted(() => {
//
})
</script>
<template>
<button class="lang-btn" @click="toggleLanguage">
/
</button>
</template>
<style scoped>
.lang-btn {
display: flex;
align-items: center;
padding: 0 12px;
height: 32px;
font-size: 14px;
font-weight: 500;
color: var(--vp-c-text-1);
background: var(--vp-c-bg-soft);
border: 1px solid var(--vp-c-divider);
border-radius: 8px;
cursor: pointer;
transition: all 0.25s;
margin-left: 12px;
}
.lang-btn:hover {
border-color: var(--vp-c-brand-1);
color: var(--vp-c-brand-1);
}
@media (max-width: 768px) {
.lang-btn {
margin: 8px 0;
width: 100%;
justify-content: center;
}
}
</style>

3
.vitepress/theme/custom.css

@ -0,0 +1,3 @@
:root {
--vp-nav-logo-height: 24px;
}

16
.vitepress/theme/index.ts

@ -0,0 +1,16 @@
import { h } from 'vue'
import DefaultTheme from 'vitepress/theme'
import LanguageSwitcher from './LanguageSwitcher.vue'
import './custom.css'
export default {
extends: DefaultTheme,
Layout: () => {
return h(DefaultTheme.Layout, null, {
'nav-bar-content-after': () => h(LanguageSwitcher),
})
},
enhanceApp({ app }) {
app.component('LanguageSwitcher', LanguageSwitcher)
}
}

9
Dockerfile

@ -0,0 +1,9 @@
FROM docker.1ms.run/library/nginx:latest
# 将 VitePress 构建产物拷贝到 Nginx 目录
COPY .vitepress/dist /usr/share/nginx/html
# 暴露 80 端口
EXPOSE 80
CMD ["nginx", "-g", "daemon off;"]

31
api-examples.md

@ -0,0 +1,31 @@
# Runtime API Examples
This page demonstrates some of the runtime APIs provided by VitePress.
## Site Data
The site data contains information about the entire site, such as the title and description.
<script setup>
import { useData } from 'vitepress'
const { site, theme, page, frontmatter } = useData()
</script>
```vue
<script setup>
import { useData } from 'vitepress'
const { site, theme, page, frontmatter } = useData()
</script>
<pre>{{ site }}</pre>
```
<pre>{{ site }}</pre>
## Frontmatter
The frontmatter of the current page.
<pre>{{ frontmatter }}</pre>

22
app/1.移动APP介绍.md

@ -0,0 +1,22 @@
# 移动 APP 与平台运营概览
::: tip 产品矩阵
回乡移动端体系涵盖了面向消费者的 **“回乡甄选/海峡姐妹 APP”** 以及面向商家的 **“好生意商家版 APP”**。本指南主要介绍平台端的营销逻辑与商户端的移动化管理。
:::
## 1. 平台端核心功能
平台端(管理后台)为移动 APP 提供了强大的营销支撑,包括:
- **积分商城系统**:支持积分、集换卡及纯现金等多种兑换模式。
- **问卷营销系统**:实现“填问卷 -> 领优惠券”的自动化闭环。
- **私域流量运营**:通过优惠券捆绑,精准触达不同生命周期的用户。
---
## 2. 快速导航
- [2. 平台端积分商城](./2.平台端积分商城)
- [3. 填问卷送券操作步骤](./3.填问卷送券)
- [4. 好生意商家版 APP 指南](./4.好生意商家版APP/1.App下载使用)
::: info 协助与反馈
如果您在配置 APP 相关跳转链接或营销规则时遇到困难,请在企业微信联系 308 办公室技术支持。
:::

46
app/2.平台端积分商城.md

@ -0,0 +1,46 @@
# 平台端积分商城与资产核销
::: info 商城核心
积分商城是提升用户活跃度(DAU)的关键工具。它支持客户使用积攒的“积分”或“集换卡(印章)”进行实物兑换、优惠券兑领或现金差额购买。
:::
## 1. 业务分类预设
在创建积分商品前,必须先确立所属分类。系统预设了以下 3 类核心分类:
- **福利卡**:针对特定会员等级发放。
- **积分兑换**:标准积分消耗渠道。
- **集换卡**:专门用于“集章兑换”场景。
![分类管理界面](img/cm1.png)
---
## 2. 积分商品管理 (添加与配置)
- **操作路径**:`商城管理` -> `积分商品` -> `添加`
- **关键参数说明**
- **允许兑换次数/周期**:设置防滥用机制。例如“次数 2,周期 7 天”,即每位用户每周限兑 2 次。设置为 0 则不限次数。
- **支付方式选择**:四选一模式(积分+现金、仅积分、仅集卡券、仅现金)。
- **上架状态**:勾选“上架”并保存后,商品将即时同步至回乡 APP 首页的积分专区。
![商品编辑详情](img/cm2.png)
![商品库存与价格](img/cm3.png)
---
## 3. 面额与优惠券捆绑 (核心营销链路)
如果您的积分商品是虚拟资产(如:10 元代金券),则需要执行“捆绑”动作:
1. **预设券包**:在 `营销管理` -> `优惠券列表` 中创建目标优惠券。
2. **执行捆绑**:前往 `营销管理` -> `优惠券捆绑`
3. **关联操作**:找到 **“积分商品”** 栏,点击新增,将上述券与积分商品进行 1:1 或 1:N 绑定。
4. **生效逻辑**:当客户在 APP 点击兑换并成功扣除积分后,绑定的优惠券将自动发放至其个人账户。
![优惠券捆绑指引](img/cm4.png)
![绑定成功预览](img/cm5.png)
---
## 4. 订单与对账
- **操作路径**:`积分商城` -> `订单管理`
- **功能描述**:商家可实时监控所有兑换详情,包括兑换人、兑换时间、使用的积分量及核销状态。
![兑换订单列表](img/cm7.png)

44
app/3.填问卷送券.md

@ -0,0 +1,44 @@
# 问卷调研与自动化送券操作指南
::: tip 营销场景
为了深入了解市场需求或收集客户满意度,商家可发起在线问卷。作为福利,客户在完成答卷后将自动跳转并领取一张优惠券。
:::
## 1. 问卷编辑与管理
- **操作后台**:[回乡问卷管理后台](https://wj.lotus-wallet.com/)
- **核心逻辑**:设计题目 -> 确认问卷名称(用于后续在 CRM 平台端捆绑)。
---
## 2. 投放与自定义跳转配置
在问卷编辑完毕后,必须配置“投放与分享”中的自定义链接跳转逻辑。
1. **进入设置**:点击 `设置` -> `投放与分享`
2. **自定义跳转**:开启并修改跳转链接,将正确的优惠券领券地址填入。
![问卷投放设置](img/ques.png)
---
## 3. 标准链接格式说明
为了确保跳转后能正确识别优惠券及用户信息,必须遵循以下标准 URL 规范:
### 3.1 静态跳转链接 (基础版)
- **格式**:`https://hx.lotus-wallet.com/questionnaireGift.html?code=[问卷名称]`
- **说明**:问卷名称必须与平台端“优惠券捆绑”中的编号完全一致。
- **示例**:若捆绑编号为 `hello`,则链接为 `https://hx.lotus-wallet.com/questionnaireGift.html?code=hello`
![问卷名称关联](img/ques-1.png)
### 3.2 携带用户信息 (进阶版)
如果您在问卷中收集了用户的手机号码,可以使用 `CONCATENATE` 函数将参数携带至领券页,实现精准发券。
- **格式**:`https://hx.lotus-wallet.com/questionnaireGift.html?code=[您的编号]&mobile=[手机号码参数]`
![带参数跳转](img/ques-3.png)
---
## 4. 前端展示预览
设置成功后,当用户回答完最后一个题目并点击“提交”时,页面将毫秒级自动跳转至领券页面,提升用户获得感。
![领券成功页面](img/ques-4.png)

36
app/4.好生意商家版APP/1.App下载使用.md

@ -0,0 +1,36 @@
# 好生意 App:下载、安装与快速上手
::: tip 软件简介
“好生意”是一款专为门店经营者打造的一站式生意管理软件。它集成了库存管理、实时记账、营销核销及订单退款处理,旨在通过移动化办公降低商家的经营成本。
:::
## 1. 获取软件 (下载安装)
### 1.2 iPhone (iOS) 用户
- **操作步骤**:打开 `App Store` 应用商店。
- **搜索关键词**:输入 **“好生意”**。
- **安装**:点击获取并安装。
### 1.1 Android (安卓) 用户
- **官方下载地址**:[点击前往下载页面](http://application.lotus-wallet.com/haoshengyi)
- **直接安装**:进入页面后点击“下载安装”按钮。如手机提示“风险来源”,请在设置中选择“允许来自此来源的应用”。
---
## 2. 登录与初始化
1. **隐私协议**:启动 App 后,请先阅读并点击“同意”《好生意用户隐私协议》。
2. **账号身份验证**
- 输入您的手机号码/管理员账号。
- 输入对应密码并勾选服务协议。
3. **选择服务门店**:首次登录成功后,系统会弹出绑定的门店列表。请点击您当前需要管理的门店进入首页。
![登录引导界面](img/login.png)
![门店选择列表](img/image1.png)
---
## 3. 首页工作台布局
App 采用简洁的磁贴式布局,顶部显示实时营业概况,中部为核心工具(扫一扫、订单、报表),底部为消息与个人中心。
![App 首页布局图](img/image-sy.png)

30
app/4.好生意商家版APP/3.扫码核销.md

@ -0,0 +1,30 @@
# 高效扫码与票券核销指南
::: tip 场景应用
“扫一扫”是门店最常用的功能。好生意 App 对扫码核销逻辑进行了深度优化,系统会自动识别条码/二维码类型(团购券、代金券、提货码),无需店员手动切换,实现一秒秒录。
:::
## 1. 功能路径
- **快捷入口**:点击 App 首页底部的“扫一扫”或右上角的“扫码”图标。
![扫码入口预览](img/image-sy1.png)
---
## 2. 操作动作与授权
### 2.1 首次开启
- **权限申请**:首次点击扫一扫时,请在系统弹出的对话框中选择“允许”或“使用应用时允许”相机访问权限。
- **配置失败建议**:如若不小心点击了拒绝,请前往手机系统的 `设置` -> `应用管理` -> `好生意` 手动打开相机权限。
### 2.2 自动核销流程
1. **对准码位**:将扫码框对准客户提供的电子券码。
2. **详情确认**:系统识别后会弹出核销详情(券面值、有效期)。
3. **完成扣减**:点击“核销使用”,系统会自动扣减对应资产并生成核销流水。
::: warning 注意事项
如果该券码已被核销过,系统将弹出“重复核销”警告,保障商家的结算安全。
:::
![相机授权指引](img/shouq.png)
![核销确认弹窗](img/hexiao.png)

50
app/4.好生意商家版APP/4.订单管理.md

@ -0,0 +1,50 @@
# 移动端订单管理与精简售后处理
::: tip 工作流核心
随时随地处理用户订单、筛选流水、核实库存以及响应退款申请。好生意 App 提供了从付款对账到售后退款的全生命周期管理功能。
:::
## 1. 业务订单实时查询
- **操作路径**:点击底部菜单栏 `订单`
- **作用**:全案检索及处理在线支付订单。
![订单列表主页](img/image-dd.png)
---
## 2. 逆向流程:退款申请与审核
### 2.1 申请退款 (商家代客发起)
- **场景**:缺货、停产或特殊情况。
- **操作流程**
1. 在 `订单列表` -> `已付款` 界面找到对应订单。
2. 点击“申请退款”并选择原因。
3. 如涉及部分退款,可直接进行“修改金额”操作。
4. 点击“确定退款”后,申请将同步至财务后台审核。
### 2.2 处理退款 (店员/店长审核)
- **场景**:用户已发起线上退款申请。
- **操作流程**
1. 进入 `订单退款` -> `待审核`
2. 点击“去处理”核实具体明细。
3. **选择结果**:点击“同意退款”或“拒绝并填写驳回原因”。
![退款申请界面](img/image-tk.png)
![退款处理流程](img/image-tkcl.png)
---
## 3. 票券核销明细与手动处理
对于无法扫码(码模糊)的情况,可使用手动核销功能:
1. **列表检索**:在 `票券核销` -> `票券列表` 界面,根据手机号或券码号进行模糊查询。
2. **多状态过滤**:如需快速找到可使用券,点击“状态”筛选项并勾选“可使用”。
3. **确认核销**:在详情页勾选对应的单次核销项目,确认无误后点击“确认核销”。
![票券列表汇总](img/image-hx.png)
![票券详细配置](img/image-hx1.png)
---
## 4. 特别说明
- **报表对齐**:移动端处理的订单与 PC 端后台数据实时同步。
- **通知机制**:所有的退款同意/拒绝都会同步推送消息至用户的“回乡甄选”公众号或小程序。

BIN
app/4.好生意商家版APP/img/hexiao.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

BIN
app/4.好生意商家版APP/img/image-dd.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

BIN
app/4.好生意商家版APP/img/image-hx.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

BIN
app/4.好生意商家版APP/img/image-hx1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

BIN
app/4.好生意商家版APP/img/image-sy.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

BIN
app/4.好生意商家版APP/img/image-sy1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

BIN
app/4.好生意商家版APP/img/image-tk.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 63 KiB

BIN
app/4.好生意商家版APP/img/image-tkcl.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

BIN
app/4.好生意商家版APP/img/image.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

BIN
app/4.好生意商家版APP/img/image1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

BIN
app/4.好生意商家版APP/img/image2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 76 KiB

BIN
app/4.好生意商家版APP/img/login.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 68 KiB

BIN
app/4.好生意商家版APP/img/shouq.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

BIN
app/4.好生意商家版APP/img/shouye1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 65 KiB

BIN
app/img/cm1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 13 KiB

BIN
app/img/cm2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 49 KiB

BIN
app/img/cm3.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 29 KiB

BIN
app/img/cm4.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

BIN
app/img/cm5.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 53 KiB

BIN
app/img/cm7.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

BIN
app/img/ques-1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 30 KiB

BIN
app/img/ques-2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 19 KiB

BIN
app/img/ques-3.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 23 KiB

BIN
app/img/ques-4.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 129 KiB

BIN
app/img/ques.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 28 KiB

18
build.bat

@ -0,0 +1,18 @@
@echo off
set IMAGE_NAME=registry.cn-beijing.aliyuncs.com/zyh5/docs
echo [1/3] Building VitePress...
call npm run build
if %ERRORLEVEL% NEQ 0 (
echo Build failed!
exit /b %ERRORLEVEL%
)
echo [2/3] Building Docker image...
docker build -t %IMAGE_NAME% .
echo [3/3] Pushing to Registry...
docker push %IMAGE_NAME%
echo Done!

18
build.sh

@ -0,0 +1,18 @@
#!/bin/bash
IMAGE_NAME="registry.cn-beijing.aliyuncs.com/zyh5/docs"
echo "[1/3] Building VitePress..."
npm run build
if [ $? -ne 0 ]; then
echo "Build failed!"
exit 1
fi
echo "[2/3] Building Docker image..."
docker build -t $IMAGE_NAME .
echo "[3/3] Pushing to Registry..."
docker push $IMAGE_NAME
echo "Done!"

6
bxg/1.一心回乡小程序后台.md

@ -0,0 +1,6 @@
---
sidebar_position: 0
sidebar_label: 一心回乡小程序后台
title: 一心回乡小程序后台
---
## **一心回乡小程序后台**

48
bxg/2.古桑园小程序说明.md

@ -0,0 +1,48 @@
---
sidebar_position: 1
sidebar_label: 古桑园小程序使用说明
title: 古桑园小程序使用说明
---
## 古桑园商家端
### 注册和登录
古桑园商家端主要操作使用WEB浏览器,进入:https://pos.tenant.lotus-wallet.com/ 登录操作账号,
商家登录成功后可编辑店铺信息,上下架产品,管理商品信息,查看所有订单并处理订单退款等;并添加门票等
### 订单退款
古桑园订单退款需要两步操作,分别是 经营者发起退款申请, 古桑园管理员同意退款申请后,等待支付渠道退款。
商家操作:
商家需要退款时,使用微信小程序搜索“一心回乡商户管理“,或通过二维码直接扫码进入,登录对应账户,在”订单“标签页内,找到对应金额订单,点击“申请退款”。
![Alt text](img/gsy-3.png)
管理员操作:
商户提交退款申请后,需要更高权限在商家端通过后,才可退款。
1.使用 PC 打开浏览器输入地址:https://pos.tenant.lotus-wallet.com/
2.使用具有退款权限的账户登录,选择标签 :运营->订单->售后订单,找到对应商户提交的退款申请,选择同意,订单会在 5 分钟内从原支付路径退款给客户.
如果商户余额不足退款,此时退款申请将不能通过,并提示错误,请等待有新的额度进入后再次操作退款。
## 客户购票
客户微信搜索古桑园小程序或扫码进入首页,点击购票,选择预约时间,填写信息付款购票
打开页面‘我的’票券,即可查看相应票券,并出示给工作人员核销;点击‘全部’页面即可查看所有购买记录
## 门票核销
使用微信搜索小程序《一心回乡商户管理》,使用设定的商家账户登入。
使用小程序-核销票券图标打开拍摄状态,将手机对准客人出示券码,核销成功后,商家端小程序会播报《核销成功》提示,客人端会显示票券已核销。核销记录中可查看全部票券核销状态。
![Alt text](img/gsy-1.png) ![Alt text](img/gsy-2.png)
## 商家报表
全部门店小计:http://report.lotus-wallet.com/jmreport/view/818671972569427968
全部订单明细:http://report.lotus-wallet.com/jmreport/view/818651627011551232
每日核销:http://report.lotus-wallet.com/jmreport/view/819813637522829312

73
bxg/3.回乡饱岛美食街.md

@ -0,0 +1,73 @@
---
sidebar_position: 2
sidebar_label: 回乡饱岛美食街
title: 回乡饱岛美食街
---
## 回乡饱岛美食街
微信搜索小程序:回乡饱岛美食街,
该程序主要功能:用户可以浏览饱岛美食街内所有的店铺,查看榜单推荐的店铺,收藏店铺,并进行下单消费;
小程序码 : ![Alt text](img/msj.png)
*****
### 上新店铺
商家端登录美食街账号,点击【门店设置】,添加门店,编辑门店信息,营业时间,地址等;添加成功后如图所示,
![Alt text](img/msj1.png)
*****
### 上传商品
上传门店商品具体操作步骤请参照商家端设置文档;
### 门店图及门店详情图
小程序上每个门店都会展示门店门面图,门店轮播图,以及店铺详情图,需要在商家端设置;
在商家端选择需要编辑的门店,点击编辑【基本信息】,添加门面图和店铺详情图,设置成功后即可展示在小程序上;
![Alt text](img/msj3.png)
*****
#### 门店轮播图
门店轮播图一般展示在每个门店的上方,在【运营】--【门店管理】--【轮播】进行添加设置;类型选择首页轮播,添加成功后在小程序展示为图所示;
![Alt text](img/msj5.png)
*****
### 小程序轮播图
小程序首页会有轮播图的展示,在商家端 【小程序配置】--【首页配置】--【首页轮播图】 进行添加;
![Alt text](img/msj6.png)
*****
### 小程序榜单
小程序上共有四个榜单,全部榜,推荐榜,必吃榜,必喝榜,这些榜单上的门店顺序可以进行调整;
全部榜单顺序的更改在【门店设置】详情里的排序处
推荐榜,必吃榜,必喝榜,在【运营】--【小程序配置】--【首页配置】--【餐饮美食】处进行编辑更改
![Alt text](img/msj7.png)
*****
### 小程序推文
小程序板块 饱岛新鲜事 需要在商家端设置图文,选择所有门店,打开【营销】-【活动推文】,新增活动,填写相关内容,设置图片文章,一个活动对应一篇推文,如需多篇图文进行轮播,可设置多个活动;如该推文是对于某个门店的营销,可选择关联对应门店,设置成功后用户点击该文章时可选择进入该门店;
![Alt text](img/msj8.png)
*****
### 发现美食
在小程序首页上,有一个板块是推荐的具体商品,用户可点击进入该店铺直接购买,如需调整推荐商品,在商家端具体操作步骤如下;
选择所有门店,【小程序配置】-【首页配置】-【首页商品】,配置选择需要放在首页的商品;
![Alt text](img/msj9.png)
### 退款
如有客户需要退款且没有任何纠纷,可让用户在小程序找出该笔订单点申请退款,商家在企业微信上登录账号后,选择该门店操作同意退款,款项将会原路退回;

29
bxg/4.美食街退款说明.md

@ -0,0 +1,29 @@
---
sidebar_position: 3
sidebar_label: 回乡饱岛美食街退款操作说明
title: 回乡饱岛美食街退款操作说明
---
## 回乡饱岛美食街退款操作说明
美食街订单退款需要用户在小程序上点击申请退款,商家登录企业微信操作同意退款后,款项会按支付原渠道退回客户账户。
### 用户操作
客户在美食街小程序下单付款后,如对订单有疑问,可与商家商议进行申请退款,且订单在 【待使用状态】时才允许申请;找到该笔订单,打开订单详情页点击【申请退款】按钮,等待商家操作同意退款,付款将原路退回;
若订单状态已经自动更改为 【已完成】,则不支持客户在用户端主动申请,商家可记录下来订单编号反馈给运营,由更高权限者统一在商家端进行操作;
*****
### 商家操作
客户申请完成后,商家打开企业微信, 找到 ***工作台*** >***回乡*** ,点击 **门店操作** > **美食街退款通道**,选择对应门店登录, 登录后可在 【待处理栏】 查看到所有客户申请退款的记录, 商家需仔细核对订单编号和金额后再操作同意退款, 点击同意后款项会从原渠道退回客户账号, 退款完成后订单可在 【已退款栏】 查看;
商家需要注意的是;
1. 请仔细对比客人付款流水单号及操作金额,防止退款错误。
2. 退款同意后,款项将在1分钟左右通过客人原支付渠道退还。
3. 拒绝退款的订单,可以不进行操作,每日0点未被处理的退款将会被自动全部拒绝。
4. 执行的退款操作将留存你的企业微信信息,注意正确操作。
![Alt text](img/meishijrf.png)

BIN
bxg/img/gsy-1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 293 KiB

BIN
bxg/img/gsy-2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 292 KiB

BIN
bxg/img/gsy-3.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 226 KiB

BIN
bxg/img/meishijrf.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 130 KiB

BIN
bxg/img/msj.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

BIN
bxg/img/msj1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

BIN
bxg/img/msj2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 339 KiB

BIN
bxg/img/msj3.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 109 KiB

BIN
bxg/img/msj4.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 176 KiB

BIN
bxg/img/msj5.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 277 KiB

BIN
bxg/img/msj6.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 379 KiB

BIN
bxg/img/msj7.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 152 KiB

BIN
bxg/img/msj8.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 80 KiB

BIN
bxg/img/msj9.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 35 KiB

35
crm/1.登录系统.md

@ -0,0 +1,35 @@
# CRM 系统登录与基础指南
::: tip 技术支持
如果您在使用过程中遇到任何问题或需要帮助,请在 **企业微信** 联系技术团队协助。
:::
## 1. 登录访问方式
### 1.1 网页端登录
- **访问地址**:[http://crm.lotus-wallet.com](http://crm.lotus-wallet.com)
- **登录方式**:输入您的账号密码,或使用企业微信扫码登录。
![登录界面](img/image-1.png)
![扫码登录](img/image-31.png)
### 1.2 企业微信工作台一键登录 (推荐)
在电脑端企业微信中,点击 `工作台` -> `回乡BPM` -> `回乡管理系统` 即可免密一键登录,极大地提升办公效率。
![企微一键登录](img/image-2.png)
---
## 2. 后台操作界面概览
系统采用响应式布局,左侧为功能菜单,顶部为辅助工具栏,右侧为核心业务操作区。
- **首页看板**:涵盖员工个人信息、实时概况、待办事项、任务看板、数据分析及遗忘提醒。
- **通知中心**:右上角第一个图标,展示最新的业务提醒。
- **个人中心**:可在右上角用户信息处进入,支持修改基础资料及重置登录密码。
::: warning 初始密码建议
系统初始密码较为简单,为了保障您的客户数据安全,请在首次登录后第一时间进入“个人中心”修改密码。
:::
![系统首页概览](img/image.png)
![个人中心修改密码](img/image-7.png)

67
crm/2.客户管理.md

@ -0,0 +1,67 @@
# 客户档案与生命周期管理
::: info 客户核心
CRM 系统的本质是维护深度的客户连接。通过对客户背景、跟进、带看及合作记录的全流程追踪,您可以建立起系统化的销售私域资产。
:::
## 1. 客户分类与来源
系统内的客户主要分为三类:
- **我的客户**:本人新增、上级分配或从公共池领取的客户。
- **下属客户**:作为部门负责人,可查看下属成员负责的客户流水。
- **公共客户**:已被原有负责人“放入公共”或已离职流失的客户,所有同事均可领。
---
## 2. 客户核心操作流程
### 2.1 新增/编辑客户档案
1. 点击“新增”按钮。
2. **必填项**:客户名称、负责人、客户分类、结识缘由。
3. **选填项**:手机号、单位名称、下次联系时间等(建议尽可能填补完整)。
![新增客户界面](img/image-10.png)
### 2.2 客户详情:360 度全貌
在“我的客户”列表点击“详情”进入。作为负责人,您可以深度管理以下模块:
- **联系人管理**:记录客户公司内的多个关键业务对接人及其职务。
- **团队协作**:新增“团队成员”,并设置只读或读写权限,实现跨部门服务客户。
- **动态汇总**:系统自动记录该客户的所有跟进、送礼、拜访及合作记录流向。
![客户详情界面](img/image-13.png)
---
## 3. 客户行为记录 (全生命周期追踪)
### 3.1 跟进、拜访与送礼
- **跟变记录**:选择电话/微信/见面沟通,录入详细结果。
- **拜访记录**:录入拜访地点、随同人员及客户满意度评分。
- **送礼记录**:建立客情关系,记录节日礼赠及客户反馈。
![跟进记录录入](img/image-21.png)
![拜访记录查询](img/image-23.png)
### 3.2 任务创建与提醒
您可以为客户创建特定的“任务”(如:周三回款、周五报价)。
- 设置责任人、参与人及时间轴。
- 系统将自动生成待办记录并推送至对应人员的看板。
![创建任务界面](img/image-14.png)
---
## 4. 客户资产流动与变更
### 4.1 更换负责人与放入公共
- **更换负责人**:离职交接或团队内转让。
- **放入公共**:若无法继续跟进,放回资源池供他人认领。
![放入公共池](img/image-17.png)
---
## 5. 公共池管理与领用
- **领用**:直接将公共客户移动至本人客户列表。
- **分配**:作为上级,可将公海资源定向分配给特定下属。
![公共池领用界面](img/image-26.png)

51
crm/3.任务管理.md

@ -0,0 +1,51 @@
# 任务管理与工作流自动化
::: info 任务核心
CRM 系统中的“任务”是达成业务目标的最小单位。它基于关联客户,实现全流程的“创建、指派、参与、转交与完成”闭环。
:::
## 1. 任务体系概览
- **入口**:`任务管理` -> `我的任务`
- **作用**:记录客户跟进工作流。
![任务列表界面](img/image-29.png)
---
## 2. 任务核心操作流程
### 2.1 新增/编辑任务
1. 点击“新增”按钮。
2. **必选配置**
- **关联客户**:必须选择您当前负责的客户。
- **责任人**:默认本人,可手动更改。
- **任务类型**:分为跟进、送礼、拜访、合作。
3. **协作配置**
- **参与人**:设置多个同事共同执行。
- **优先级**:标记无、高、中、低。
![新增任务界面](img/image-30.png)
### 2.2 任务详情与动态追踪
点击“详情”进入,查看任务实时信息:
- **任务状态**:进行中、已完成、延迟、取消。
- **动态记录**:参与人及其操作流水汇总。
![任务状态变更](img/image-37.png)
### 2.3 任务转交与指派
如遇岗变或业务调整:
1. 点击“转交任务”。
2. 输入转交原因。
3. 指定新的负责人,任务将自动移交至其列表并生成待办。
![转交任务界面](img/image-62.png)
---
## 3. 下属任务监管
针对管理岗:
- **操作路径**:`任务管理` -> `下属的任务`
- **作用**:实时穿透下属的工作饱和度、客户跟进进展及其任务完成率。
![下属任务情况](img/image-48.png)

41
crm/4.财务管理.md

@ -0,0 +1,41 @@
# 财务管理:发票申请与审核
::: info 发票原则
CRM 系统提供了发票申请的全流程监控。用户在完成合作后,可直接在后台发起申请,并由财务进行在线对账与审核。
:::
## 1. 发票申请管理概览
- **入口**:`财务管理` -> `发票申请`
- **作用**:记录申请时间、商户、申请人、发票类型(个人/单位)、订单及开票金额等核心资产数据。
![发票申请列表](img/image-41.png)
---
## 2. 发票审核与开项
### 2.1 审核全流程
1. 点击“审核”按钮。
2. **选择结果**
- **通过**:必须同步上传电子版发票(支持 PNG、JPG、PDF 格式)。
- **不通过**:必须填写驳回原因,用户可在个人中心查收原因并二次发起。
3. **确认提交**:审核通过后,发票状态变更为“已开票”。
![发票审核界面](img/image-43.png)
![上传电子发票](img/image-44.png)
---
## 3. 错票维护与清除
### 3.1 发票冲红
针对已开具但金额、抬头有误的发票:
1. 在已开票状态下点击“冲红”按钮。
2. 确认操作后,原发票即刻作废,不可再用(财务需按规定执行冲红记录)。
![发票冲红操作](img/image-46.png)
### 3.2 废票删除
针对“已作废”或“审核不通过”的记录,如有误录或重复申请,可点击“删除”。该记录将从财务列表中彻底移除。
![删除发票界面](img/image-47.png)

BIN
crm/img/image-1.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.5 MiB

BIN
crm/img/image-10.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

BIN
crm/img/image-11.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

BIN
crm/img/image-12.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.9 MiB

BIN
crm/img/image-13.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 476 KiB

BIN
crm/img/image-14.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-15.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 272 KiB

BIN
crm/img/image-16.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-17.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-18.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

BIN
crm/img/image-19.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

BIN
crm/img/image-2.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 478 KiB

BIN
crm/img/image-20.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-21.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

BIN
crm/img/image-22.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.8 MiB

BIN
crm/img/image-23.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.2 MiB

BIN
crm/img/image-24.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.4 MiB

BIN
crm/img/image-25.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 250 KiB

BIN
crm/img/image-26.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-27.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 901 KiB

BIN
crm/img/image-29.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-3.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

BIN
crm/img/image-30.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 MiB

BIN
crm/img/image-31.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 9.6 MiB

BIN
crm/img/image-32.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

BIN
crm/img/image-33.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.7 MiB

BIN
crm/img/image-34.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 MiB

BIN
crm/img/image-35.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 248 KiB

BIN
crm/img/image-36.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.8 MiB

BIN
crm/img/image-37.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.5 MiB

BIN
crm/img/image-4.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 42 KiB

BIN
crm/img/image-41.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.3 MiB

BIN
crm/img/image-42.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 MiB

BIN
crm/img/image-43.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 MiB

BIN
crm/img/image-44.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 201 KiB

BIN
crm/img/image-45.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 52 KiB

BIN
crm/img/image-46.png

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 MiB

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save