龙阿龙的编程日记
作品软件定制二次开发RSS联系我
返回作品

茶楼管理系统

创建于 2026 年 2 月 4 日

标签
  • Java
  • Spring Boot
  • Spring Security
  • MyBatis
  • MySQL
  • Redis
  • JWT
  • Vue 2
  • Element UI
  • ECharts
  • Apache POI

项目介绍

这是一套面向中小茶楼门店的经营管理后台，基于若依 RuoYi-Vue v3.8.9 前后端分离框架二次开发而来。项目把茶楼日常经营里”看得见摸得着”的对象全部数据化：能按时计费出租的茶室、摆在货架上的茶叶茶具零食、进店的茶客、排班的员工、每天开的订单，以及散落在前台的评价和活动。系统用 12 张 tea_ 前缀业务表把这些对象串成一个可操作的闭环——茶室可以预订，商品有库存可卖，订单带着明细收钱，订单可以评价，老板每天看统计。

业务数据与若依自带的系统管理（用户、角色、菜单、字典、日志、定时任务等）完全隔离在独立模块中，既不污染框架代码，又能直接复用若依的权限、日志、字典、Excel 导入导出等基础设施。从建表到接口再到页面，整体走的是”设计表结构 → 若依代码生成器一键生成 → 手工定制业务细节”的工程路线，项目里 gen_table / gen_table_column 中完整保留了 12 张表的生成配置，包括 tea_room 关联 tea_room_booking 的主子表（sub）模式。

项目架构

后端沿用若依经典多模块结构（ruoyi-admin / ruoyi-framework / ruoyi-common / ruoyi-system / ruoyi-quartz / ruoyi-generator），业务代码全部落在新增的 ruoyi-tea 模块：11 个 Controller、12 个 Domain、12 个 Mapper（含 XML）、12 组 Service 接口与实现，统一挂在 /tea/* 路由前缀下。接口沿用若依规范，@PreAuthorize("@ss.hasPermi('tea:xxx:list')") 做按钮级权限控制，@Log 记录操作日志，列表走 startPage() + PageHelper 分页，Excel 导出复用 ExcelUtil 注解驱动。

前端 ruoyi-ui 在 src/views/tea/ 下对应生成 11 个页面：商品管理、库存管理、茶室管理、茶室预订、订单管理、订单明细、茶客管理、活动管理、订单统计、订单评论管理、员工管理。技术栈为 Vue 2.6.12 + Element UI 2.15.14 + Axios，字典下拉（pay_status、booking_status、room_status、position 等）通过若依字典模块动态配置。数据库脚本为 MySQL 8 的 sql/ry-vue1.sql，其中除了若依框架表，还完整携带了 12 张业务表的结构、种子数据与全部 tea:* 菜单、字典授权记录，拿到脚本即可一键还原整个系统。

核心功能

  • 茶室管理与预订：茶室档案包含编号、类型（小包间/大包间/VIP）、容纳人数、小时收费标准与押金，状态分空闲/占用/维护，备注记录配套设施（配茶桌、空调、WiFi、投影仪等）。预订单号按 BOOK + 日期 + 序号 生成，记录预订日期、起止时间、时长、金额、押金，支付状态与预订状态（待使用/已使用/已取消/超时未用）双维流转，前端表单支持”根据开始时间和预订时长自动计算结束时间”。种子数据里的清风阁 88 元/时、观云轩 168 元/时、VIP 尊享厅 298 元/时相当写实。
  • 商品与库存管理：商品档案含编码、名称、类型（茶叶/茶具/零食）、规格、单位（克/包/件）、售价、成本价与图片路径；库存表按商品维度维护库存数量、预警数量，库存状态自动分正常/预警/缺货三档，并记录仓库位置与最后盘点时间，为后续”下单扣库存”留好了数据位。
  • 订单与评论闭环：订单主表 + 明细表的主从结构，明细记录商品数量、单价与小计；订单金额、支付状态（未支付/已支付/已退款）、支付时间、完成时间齐全。订单完成后可发起 1-5 星评分与评论，商家可回复，前台可见性由”显示/隐藏”状态控制，构成从消费到反馈的完整回路。
  • 茶客与员工管理：茶客档案记录姓名、电话、性别与会员积分，为会员运营打底；员工档案有编号、职位（茶艺师/收银员/店长/保洁）、入职时间、月薪、居住地址与在职/离职/休假状态，覆盖排班与薪酬管理的基本盘。
  • 日统计与活动管理：订单统计表按日聚合订单总数、已支付订单数、订单总金额、已支付金额，并区分茶室订单数与商品订单数，直接回答”今天包间赚了多少、货架卖了多少”；活动管理维护促销活动的起止时间与状态（未开始/进行中/已结束/暂停），配合后续接营销场景。

功能截图

暂无运行截图。

快速上手

环境要求：JDK 1.8+（ruoyi-tea 模块以 Java 17 编译，需保证 Maven 编译可用）、Maven 3、MySQL 8、Redis。先执行 sql/ry-vue1.sql 初始化数据库（框架表 + 12 张业务表 + 菜单字典一并就绪），再修改 ruoyi-admin/src/main/resources/application-druid.yml 中的数据库连接与 Redis 配置，然后启动 RuoYiApplication，默认账号 admin / admin123。

前端进入 ruoyi-ui 目录执行 npm install 与 npm run dev（或 npm run build:prod 打包），浏览器打开即可在左侧菜单看到商品、库存、茶室、预订、订单、茶客、员工、活动、统计等完整菜单树。项目根目录的 ry.sh / ry.bat 提供了前后端一键启动脚本，doc/ 下还附有若依环境使用手册。

总结

这个项目的价值在于”框架与业务解耦”的示范：若依的系统管理能力原封不动，茶楼业务全部收敛进一个 ruoyi-tea 模块和 12 张表里，模块边界清晰，从建表、生成到定制有完整的工程链路可循。业务设计上也覆盖了茶楼经营的三个核心场景——包间按时计费预订、商品销售与库存、订单与评价的售后闭环，再辅以员工、茶客、活动与日统计，已经具备一家小茶楼日常运营所需的管理面。

后续可扩展的方向不少：下单自动扣减库存并联动库存预警、预订与茶室状态（占用/空闲）的自动联动、统计页接入 ECharts 做经营趋势图、茶客积分累计与会员等级、对接扫码点单与移动端小程序，让门店的”收银台”和”老板台”真正跑起来。