# 省钱兄文旅项目全套开源系统 **Repository Path**: witsbin/sqx-wenlv ## Basic Information - **Project Name**: 省钱兄文旅项目全套开源系统 - **Description**: 这是一套文旅业务系统,包含三个可以独立打开的部分。管理端和用户端都连接服务端,服务端负责接口、数据库,以及支付、地图等外部能力。 - **Primary Language**: Unknown - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 8 - **Created**: 2026-10-30 - **Last Updated**: 2026-10-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README
# **省钱兄JAVA文旅项目全套开源系统(JAVA+Uni-app+Vue3)** **服务端 · 管理端 · 用户端** [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE) [![JDK](https://img.shields.io/badge/JDK-1.8-orange.svg)](docs/服务端-运行教程.md) [![Spring Boot](https://img.shields.io/badge/Spring%20Boot-2.6.11-6DB33F.svg)](docs/服务端-运行教程.md) [![Vue](https://img.shields.io/badge/Vue-3-42b883.svg)](docs/管理端-运行教程.md) [![uni-app](https://img.shields.io/badge/uni--app-用户端-2b9939.svg)](docs/用户端-运行教程.md) 八年沉淀,分批次开源由 AI 辅助开发的系统源码。 开源为生态,服务才是根基。欢迎各位开发者一同交流。
--- ⭐ 如果觉得项目不错,请点击右上角 Star 收藏支持!您的 Star 是我们持续开源迭代的最大动力! ## **1. 项目简介** **省钱兄文旅项目全套开源系统**是一套文旅业务系统,采用前后端分离架构,服务端、管理端、用户端全套代码开源。 服务端基于 **Spring Boot 2.6.11**(**Java 8**)构建,负责接口、数据库,以及支付、短信、地图等外部能力。 管理端基于 **Vue 3** 开发,供运营人员在电脑浏览器中使用。 用户端基于 **uni-app** 开发,覆盖手机网页和微信小程序,游客与商户使用同一个应用。 本仓库为服务端、管理端、用户端全套源码。 - **官方网站开源计划**:[https://www.xiansqx.com](https://www.xiansqx.com) - **开源计划**:[https://opensource.xiansqx.cn](https://opensource.xiansqx.cn) - **官方文档**:[功能说明与运行教程](docs/服务端-运行教程.md) - **Gitee 仓库**:[https://gitee.com/maxiaodong1996/sqx-wenlv.git](https://gitee.com/maxiaodong1996/sqx-wenlv.git) - **GitHub 仓库**:[https://github.com/yuyang7816/sqx-wenlv.git](https://github.com/yuyang7816/sqx-wenlv.git) ## **2. 移动端界面预览**
| 首页 | 景区列表 | 景区详情 | 确认预定 | 个人中心 | | :---: | :---: | :---: | :---: | :---: | | 首页 | 景区列表 | 景区详情 | 确认预定 | 个人中心 |
## **3. 开源说明** > **【省钱兄科技|开源计划启动】** > > 八年沉淀,我们将分批次开源全套由 AI 辅助开发的系统源码。 > 本项目采用 **Apache 2.0** 许可协议,源码供学习、技术研究、商业使用、二次开发与参考使用。 > **开源为生态,服务才是根基;** 欢迎各位开发者一同交流。 ## **4. 快速开始** 建议顺序:**先服务端,再管理端,最后用户端。** 管理端和用户端都要等服务端已经启动,才能登录和加载数据。 ### **4.1 服务端** 安装 JDK 8、Maven、MySQL 8、Redis。新建数据库 `wenlv`,导入 [`lvyou-server/sql/wenlv.sql`](lvyou-server/sql/wenlv.sql),再启动服务端。 详细步骤见 [服务端运行教程](docs/服务端-运行教程.md)。 ### **4.2 管理端** 安装 Node.js 18 或更高版本,在 `lvyou-admin` 里执行安装并启动。 详细步骤见 [管理端运行教程](docs/管理端-运行教程.md)。 ### **4.3 用户端** 用 HBuilderX 打开 `lvyou-uniapp`,运行到浏览器。 详细步骤见 [用户端运行教程](docs/用户端-运行教程.md)。 后台演示账号:**admin** / **123456**。 地图、短信、微信、支付宝等密钥已从开源包中去掉,对应功能需要自行申请。申请入口和官网写在 [用户端功能说明](docs/用户端-功能说明.md) 末尾。 ## **5. 文档** | 想做的事 | 打开哪一份 | |---|---| | 把服务端跑起来 | [服务端运行教程](docs/服务端-运行教程.md) | | 看服务端能做什么 | [服务端功能说明](docs/服务端-功能说明.md) | | 把管理端跑起来 | [管理端运行教程](docs/管理端-运行教程.md) | | 看管理端能做什么 | [管理端功能说明](docs/管理端-功能说明.md) | | 把用户端跑起来 | [用户端运行教程](docs/用户端-运行教程.md) | | 看用户端能做什么 | [用户端功能说明](docs/用户端-功能说明.md) | ## **6. 目录结构** 仓库根目录只放三端代码、说明和协议。编译出来的 `target`、`dist`、`unpackage`、`node_modules` 是运行时生成的,不需要改。 ### **6.1 仓库根目录** | 路径 | 是什么 | |---|---| | `lvyou-server` | **服务端**。接口、数据库脚本、支付和短信等能力都在这里 | | `lvyou-admin` | **管理端**。运营人员在电脑浏览器里打开的后台 | | `lvyou-uniapp` | **用户端**。游客和商户用的手机应用,也能在电脑浏览器里看 | | `docs` | 三端的功能说明和运行教程 | | `LICENSE` | Apache License 2.0 全文 | ### **6.2 服务端 `lvyou-server`** | 路径 | 是什么 | |---|---| | `sqx-application` | 启动入口。主程序在 `SqxApplication.java`,数据库和 Redis 配置在 `src/main/resources` | | `sqx-modules/sqx-app` | 文旅业务代码。景区、酒店、线路、活动、非遗、订单、钱包、商户、客服、公交都在这里 | | `sqx-modules/sqx-generator` | 按数据表生成代码的工具,日常运行用不到 | | `sqx-common/sqx-common-web` | 网页请求、统一异常提示 | | `sqx-common/sqx-common-mybatis` | 访问 MySQL | | `sqx-common/sqx-common-redis` | 访问 Redis,记住登录和验证码 | | `sqx-common/sqx-common-shiro` | 管理端登录和权限 | | `sqx-common/sqx-common-pay` | 微信支付、支付宝 | | `sqx-common/sqx-common-sms` | 短信宝、阿里云短信、腾讯云短信 | | `sqx-common/sqx-common-mail` | 发邮件 | | `sqx-common/sqx-common-file` | 上传图片。可以存本机硬盘,也可以存阿里云 | | `sqx-common/sqx-common-doc` | 接口文档页面 | | `sqx-common/sqx-common-websocket` | 在线客服的实时消息 | | `sqx-common/sqx-common-core` | 三端都会用到的公共工具 | | `sql/wenlv.sql` | 要导入的完整数据库 | | `scripts` | 本机导入、同步配置用的脚本 | ### **6.3 管理端 `lvyou-admin`** | 路径 | 是什么 | |---|---| | `src/views/business` | 业务页面。景区、酒店、线路、订单、商户审核、平台配置、提现、客服都在这里 | | `src/views/system` | 系统页面。管理员、角色、菜单、字典、操作日志、系统配置 | | `src/views/user` | 用户列表、注销申请 | | `src/views/LoginView.vue` | 登录页,含验证码 | | `src/views/DashboardView.vue` | 登录后的数据统计 | | `src/api` | 每个页面调用服务端的接口 | | `src/router` | 页面地址和菜单对应关系 | | `src/stores` | 登录状态、主题、字典等临时数据 | | `src/layouts` | 左侧菜单和顶部栏 | | `src/components` | 上传图片、富文本、分页等共用组件 | | `src/styles` | 全局样式 | | `.env.development` | 开发时服务端地址 | | `.env.production` | 打包后服务端地址 | ### **6.4 用户端 `lvyou-uniapp`** | 路径 | 是什么 | |---|---| | `pages` | 底部三个主入口:首页、订单、我的,以及消息、城市选择 | | `mobile-design` | 游客页面。景区、酒店、线路、卤鹅、非遗、地图、停车、公交、活动、下单 | | `merchant-portal` | 商户入驻和商户中心 | | `merchant-hotel` | 酒店商户:房间、订单、装修 | | `merchant-restaurant` | 餐饮商户:菜品、订单、装修 | | `merchant-travel` | 旅游商户:线路、出行人、订单 | | `merchant-culture` | 文创商户:商品、订单、装修 | | `common` | 接口地址、登录、地图、上传图片等公共逻辑 | | `components` | 页面里重复使用的组件 | | `static` | 图标、默认图片 | | `uni_modules` | 界面组件库,其中 **uView Plus** 负责按钮、输入框、轮播 | | `pages.json` | 有哪些页面、底部导航怎么排 | | `manifest.json` | 应用名称、微信小程序 AppId、地图密钥 | ## **7. 核心特性与技术栈** ### **7.1 核心特性** · **一个用户端同时服务游客和商户** · **景区、酒店、线路、活动、美食、非遗一站浏览** · **地图导航、停车、公交出行** · **下单、优惠券、余额 / 微信 / 支付宝付款** · **钱包、邀请分销、在线客服与 AI 助手** · **酒店、餐饮、文创、旅游四类商户入驻和店铺管理** · **后台统计、审核、上下架和权限配置** · **服务端统一处理登录、订单和支付结果** 每项怎么用,见 [用户端功能说明](docs/用户端-功能说明.md)、[管理端功能说明](docs/管理端-功能说明.md)、[服务端功能说明](docs/服务端-功能说明.md)。 版本以仓库里的配置文件为准。没写死版本号的,按运行教程安装对应大版本即可。 ### **7.2 服务端** | 类别 | 技术 | 版本 | 用来做什么 | |---|---|---|---| | 语言 | **Java** | **1.8** | 整个服务端。不能换成 11 或 17 | | 框架 | **Spring Boot** | **2.6.11** | 提供网页接口,端口 `9186`,路径 `/sqx_fast` | | 构建 | **Maven** | 3.6 及以上 | 下载依赖、编译、启动 | | 数据库 | **MySQL** | 8.0 及以上 | 业务数据。库名 `wenlv`,脚本是 `sql/wenlv.sql` | | 数据库访问 | **MyBatis-Plus** | 3.5.3.2 | 读写表 | | 连接池 | **Druid** | 1.2.19 | 管理数据库连接 | | 缓存 | **Redis**、**Redisson** | Redis 5.0 及以上,Redisson 3.18.0 | 登录状态、验证码 | | 管理端登录 | **Apache Shiro** | 1.4.0 | 后台账号、角色、菜单权限 | | 用户端登录 | **JWT**(jjwt) | 0.9.1 | 游客和商户登录后的凭证 | | 接口文档 | **Knife4j** | 4.4.0 | 浏览器打开 `doc.html` 查看接口 | | JSON | **Fastjson2** | 2.0.41 | 接口数据格式 | | 工具库 | **Hutool** | 5.8.16 | 日期、字符串等常用处理 | | 登录验证码 | **Kaptcha** | 0.0.9 | 管理端登录页上的图片验证码 | | 对象存储 | **阿里云 OSS SDK** | 3.4.0 | 可选。不填密钥时图片存在本机硬盘 | | 支付 | 微信支付 SDK、支付宝 SDK | 随支付模块 | 下单、退款。密钥要自己申请 | ### **7.3 管理端** | 类别 | 技术 | 版本 | 用来做什么 | |---|---|---|---| | 运行环境 | **Node.js** | 18 及以上 | 安装依赖、启动开发网站 | | 页面框架 | **Vue** | 3.5 | 后台每一个页面 | | 构建 | **Vite** | 5.4 | 开发时热更新,默认端口 `5173` | | 界面组件 | **Element Plus** | 2.11 | 表格、表单、弹窗、菜单 | | 页面跳转 | **Vue Router** | 4.5 | 登录页、统计页和各业务页的地址 | | 状态 | **Pinia** | 3.0 | 记住是否已登录、当前主题 | | 请求 | **Axios** | 1.9 | 把操作发给服务端 | | 图表 | **ECharts** | 6.1 | 数据统计页上的图 | | 样式 | **Sass** | 1.89 | 后台样式 | ### **7.4 用户端** | 类别 | 技术 | 版本 | 用来做什么 | |---|---|---|---| | 框架 | **uni-app** | 用 HBuilderX 打开 | 同一套页面可运行到浏览器、微信小程序 | | 开发工具 | **HBuilderX** | 正式版 | 编译并运行到 Chrome 或微信开发者工具 | | 界面组件 | **uView Plus** | 随 `uni_modules` | 按钮、输入框、轮播、弹窗。不负责付款和地图 | | 省市区 | **element-china-area-data** | 6.1 | 收货地址里选择省、市、区 | | 浏览器预览 | H5 | 默认端口 `5588` | 电脑上看用户端 | | 微信小程序 | 微信开发者工具 | 可选 | 要自己的小程序 AppId 才能真机预览 | ## **8. 开源协议**
本仓库使用 **Apache License 2.0** 全文见 [LICENSE](LICENSE)
## **9. 社区与支持** 运行、二次开发或商务合作,可以扫码联系 **省钱兄科技**。 使用过程中如果接口起不来、页面打不开,先按本文 **4. 快速开始** 和 `docs` 里的运行教程排查。地图、短信、微信、支付宝等密钥需要自行申请,申请入口在 [用户端功能说明](docs/用户端-功能说明.md) 末尾。仍解决不了时,再扫下面的码说明你的环境和报错。 当前项目正在测试中,如遇到BUG,可自行修复或者留言反馈,我们将第一时间进行版本迭代。 欢迎一起交流学习。开源是把源码开放出来,具体落地、定制和长期维护仍由服务来承接。
省钱兄科技二维码 **省钱兄科技**