ycf1998

money-pos

<h1 align="center">💰 麦尼收银系统</h1> <p align="center"> <strong>Money POS - 基于 Spring Boot 3.5 & VueJS 3 的多店铺收银系统</strong> </p> <p align="center"> <a href="https://spring.io/projects/spring-boot" target="_blank"> <img src="https://img.shields.io/badge/Spring%20Boot-3.5.12-6DB33F?style=flat-square&logo=spring-boot" alt="Spring Boot"> </a> <a href="https://vuejs.org/" target="_blank"> <img src="https://img.shields.io/badge/Vue-3.x-4FC08D?style=flat-square&logo=vue.js" alt="Vue"> </a> <a href="https://element-plus.org/" target="_blank"> <img src="https://img.shields.io/badge/Element%20Plus-2.13.2-409EFF?style=flat-square" alt="Element Plus"> </a> <a href="https://baomidou.com/" target="_blank"> <img src="https://img.shields.io/badge/MyBatis--Plus-3.5.15-0078D4?style=flat-square" alt="MyBatis-Plus"> </a> <a href="https://www.oracle.com/java/" target="_blank"> <img src="https://img.shields.io/badge/JDK-17+-E76F02?style=flat-square&logo=openjdk" alt="JDK"> </a> <a href="https://opensource.org/licenses/MIT" target="_blank"> <img src="https://img.shields.io/badge/License-MIT-yellow?style=flat-square" alt="License"> </a> </p> <p align="center"> <a href="http://114.132.70.84/money-pos-demo?tenant=M">👉 在线体验</a> · <a href="#快速开始">🚀 快速开始</a> · <a href="#核心功能">✨ 核心功能</a> </p> ## 📖 项目简介 麦尼收银系统（Money POS）是一款基于自制快速后台开发框架 [QK-MONEY](https://github.com/ycf1998/qk-money) 开发的多店铺收银系统。系统支持**会员管理**、**商品管理**、**订单管理**等功能，并集成了**小票打印**等实用特性，适用于零售、餐饮等多种场景。 > 💡 **JDK 1.8 用户**：如需使用 **JDK 1.8 + Spring Boot 2.7** 版本，请切换到 [`jdk1.8`](https://github.com/ycf1998/qk-money/tree/jdk1.8) 分支。 ## ✨ 核心功能 <table> <tr> <th>模块</th> <th>功能描述</th> </tr> <tr> <td align="center">📊 <b>首页报表</b></td> <td>销售数据概览，营收、订单量等基础统计</td> </tr> <tr> <td align="center">🛒 <b>收银台</b></td> <td>快速收银流程、小票打印、节日主题皮肤</td> </tr> <tr> <td align="center">👥 <b>会员管理</b></td> <td>会员信息、会员等级、抵用券管理、消费记录追踪</td> </tr> <tr> <td align="center">🛍️ <b>商品管理</b></td> <td>商品分类、品牌管理、商品信息（条码、进价、售价、会员价、库存等）</td> </tr> <tr> <td align="center">📦 <b>订单管理</b></td> <td>订单查询与筛选、订单详情、订单统计、退单/退货处理、订单日志</td> </tr> <tr> <td align="center">⚙️ <b>系统管理</b></td> <td>用户管理、角色管理、权限管理、字典管理、租户管理</td> </tr> </table> ## 🛠️ 技术栈 ### 后端技术 <table> <tr> <th>技术</th> <th>版本</th> <th>说明</th> </tr> <tr> <td><b>Spring Boot</b></td> <td>3.5.12</td> <td>核心框架</td> </tr> <tr> <td><b>MyBatis-Plus</b></td> <td>3.5.15</td> <td>ORM 持久层框架</td> </tr> <tr> <td><b>Spring Security</b></td> <td>3.5.12</td> <td>安全认证</td> </tr> <tr> <td><b>Hutool</b></td> <td>5.8.43</td> <td>工具类库</td> </tr> <tr> <td><b>MySQL</b></td> <td>8.0+</td> <td>数据库</td> </tr> </table> ### 前端技术 <table> <tr> <th>技术</th> <th>说明</th> </tr> <tr> <td><b>Vue 3</b></td> <td>渐进式 JavaScript 框架</td> </tr> <tr> <td><b>Vue Router</b></td> <td>官方路由管理器</td> </tr> <tr> <td><b>Pinia</b></td> <td>轻量级状态管理库</td> </tr> <tr> <td><b>Element Plus</b></td> <td>基于 Vue 3 的 UI 组件库</td> </tr> <tr> <td><b>TailwindCSS</b></td> <td>实用优先的 CSS 框架</td> </tr> <tr> <td><b>Vite</b></td> <td>下一代前端构建工具</td> </tr> </table> ## 📋 环境要求 <table> <tr> <th>环境</th> <th>版本要求</th> </tr> <tr> <td><b>JDK</b></td> <td>17+</td> </tr> <tr> <td><b>MySQL</b></td> <td>8.0+</td> </tr> <tr> <td><b>Maven</b></td> <td>3.8+</td> </tr> <tr> <td><b>Node.js</b></td> <td>16+</td> </tr> </table> ## 🚀 快速开始 ### 1️⃣ 克隆项目 ```bash git clone https://github.com/ycf1998/money-pos.git cd money-pos ``` ### 2️⃣ 初始化数据库 执行 `money_pos.sql` 脚本创建数据库： ```bash mysql -u root -p < money_pos.sql ``` > ⚠️ **注意**：如果使用 MySQL 8 以下版本，请将脚本中的 `utf8mb4` 替换为 `utf8`，`utf8mb4_general_ci` 替换为 `utf8_general_ci`。 ### 3️⃣ 配置数据库连接 编辑 `qk-money-app/money-app-biz/src/main/resources/application-dev.yml`： ```yaml spring: datasource: url: jdbc:mysql://127.0.0.1:3306/money_pos?useUnicode=true&characterEncoding=utf-8&serverTimezone=GMT%2b8&allowPublicKeyRetrieval=true&useSSL=false username: root password: your_password ``` ### 4️⃣ 启动后端服务 运行 [ `QkMoneyApplication`](money-pos/qk-money-app/money-app-biz/src/main/java/com/money/QkMoneyApplication.java) 启动项目。 ### 5️⃣ 启动前端服务 ```bash cd money-pos-web npm install npm run dev ``` ### 6️⃣ 成功启动 访问：`http://localhost:1520/money-pos` ## 🖼️ 系统截图 <div align="center"> <h3>📊 首页仪表盘</h3> <img src="README.assets/image-20231022213735611.png" width="80%" alt="首页" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>🛒 收银台</h3> <img src="README.assets/image-20231022213834132.png" width="80%" alt="收银台" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>💳 收银结算</h3> <img src="README.assets/image-20231022213930361.png" width="80%" alt="收银" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>🧾 小票打印</h3> <img src="README.assets/image-20231022214227802.png" width="80%" alt="小票打印" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>👥 会员管理</h3> <img src="README.assets/image-20231022214014149.png" width="80%" alt="会员管理" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>🛍️ 商品管理</h3> <img src="README.assets/image-20231022214026761.png" width="80%" alt="商品管理" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>📦 订单管理</h3> <img src="README.assets/image-20231022214054581.png" width="80%" alt="订单管理" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> <h3>📋 订单详情</h3> <img src="README.assets/image-20231022214119628.png" width="80%" alt="订单详情" style="border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1);"> </div> --- <p align="center"> <strong>🎉 感谢使用麦尼收银系统！</strong> </p>