java露营装备租赁小程序

1. 项目简介

露营装备租赁项目全套开源系统是一套面向同城/本地露营装备租赁业务的三端系统，采用前后端分离架构，服务端、管理端、用户端全套代码开源。

服务端基于 Spring Boot 2.6.11（Java 8）构建，负责接口、数据库，以及支付、短信、地图等外部能力。启动后控制台会打印「露营租赁项目启动成功」。 管理端基于 Vue 3 开发，供运营人员在电脑浏览器中维护分类、商品、订单、商户与营销配置。 用户端基于 uni-app 开发，覆盖 H5 与微信小程序。用户可浏览帐篷、天幕、桌椅等装备，按日租/小时租/过夜租下单；商户在同一应用内管理商品、库存、取货核销、归还验收与经营钱包。

2. 移动端界面预览

截图来自本项目线上 H5 演示站（与 luyingzulin_uniapp 构建产物一致），手机视口截取。

首页	分类	装备详情	租物车	我的

3. 开源说明

本项目采用 Apache 2.0 许可协议，源码供学习、技术研究、商业使用、二次开发与参考使用。
开源为生态，服务才是根基； 欢迎各位开发者一同交流。

4. 快速开始

建议顺序：先服务端，再管理端，最后用户端。 管理端和用户端都要等服务端已经启动，才能登录和加载数据。

说明： 仓库里不包含 node_modules（体积大、随系统生成）。克隆或下载后，在 luyingzulin_admin、luyingzulin_uniapp 各自目录下必须先执行一次 npm install，再启动开发命令。详细步骤见下方与 docs 中的运行教程。

4.1 服务端

安装 JDK 8、Maven、MySQL 8。新建数据库 luyingzulin，导入 luyingzulin_server/db/lyzl.sql。

本地开发时，将 luyingzulin_server/sqx-application/src/main/resources/application.yml 中的 spring.profiles.active 改为 dev，并按本机环境修改 application-dev.yml 里的数据库账号密码（默认连接 localhost:3306/luyingzulin）。

在 luyingzulin_server 目录执行 Maven 启动 sqx-application 模块。默认 端口 9188，上下文路径 /sqx_fast。接口文档：http://127.0.0.1:9188/sqx_fast/doc.html。

当前配置下 Redis 非必须（sqx.redis.open: false）；若开启 Shiro/Redis 相关能力，需本机 Redis 可用并在配置中打开开关。

更完整的模块划分与接口约定见 服务端功能说明；在线接口文档启动后访问 http://127.0.0.1:9188/sqx_fast/doc.html。

4.2 管理端

安装 Node.js 18 或更高版本。进入 luyingzulin_admin 目录，首次运行前安装依赖并启动：

cd luyingzulin_admin
npm install
npm run dev

npm install 会根据 package.json / package-lock.json 在本机生成 node_modules，只需在依赖变更或新克隆后执行。

开发站点默认端口 5173。API 地址在 .env.development 中配置，需指向已启动的服务端（如 http://127.0.0.1:9188/sqx_fast/）。

默认管理端账号可参考架构文档（常见为 admin / 123456，以导入后的数据库为准）。

4.3 用户端

命令行（联调本机服务端，推荐）： 进入 luyingzulin_uniapp，首次先 npm install，再 npm run dev:integration（H5 端口 5573，见 manifest.json）。

HBuilderX： 打开 luyingzulin_uniapp 目录运行到浏览器或微信开发者工具。若 uView 等组件样式异常，同样在该目录执行一次 npm install 后再运行。

开发时可通过 .env / vite.config.js 将接口代理到本地服务端；生产默认可对接线上 API。

地图、短信、微信、支付宝等密钥需自行申请，并在管理端「系统配置」中填写。

5. 文档

6. 目录结构

仓库根目录只放三端代码、说明和协议。编译出来的 target、dist、unpackage、node_modules 是运行时生成的，不需要改。

6.1 仓库根目录

6.2 服务端 luyingzulin_server

6.3 管理端 luyingzulin_admin

6.4 用户端 luyingzulin_uniapp

界面组件使用 uView Plus。

7. 核心特性与技术栈

7.1 核心特性

· 露营装备按分类浏览，支持日租 / 小时租 / 过夜租多种计费
· 租物车加购、确认订单、在线支付与押金管理
· 到店/自提点取货核销、使用中、归还申请与续租
· 商户入驻、商品发布、库存调整、订单处理与验收
· 优惠券、会员、钱包充值提现、邀请分销
· 平台客服与用户-商户 IM 咨询
· 管理端数据统计、审核、上下架与权限配置
· 服务端统一处理登录、订单状态与支付回调

业务细节与接口分组见 服务端功能说明 与 Swagger 文档 doc.html。

版本以仓库里的配置文件为准。没写死版本号的，按上文快速开始安装对应大版本即可。

7.2 服务端

7.3 管理端

7.4 用户端