基于SSM框架的麻将馆经营管理系统 - 源码深度解析

JavaJavaScriptMavenHTMLCSSSSM框架MySQL
2026-03-114 浏览

文章摘要

本项目是一款基于SSM（Spring+SpringMVC+MyBatis）框架开发的麻将馆经营管理系统，旨在解决传统麻将馆在运营过程中普遍存在的手工记录效率低、账目易出错、会员信息管理混乱等核心痛点。系统通过数字化的管理手段，帮助经营者清晰掌握场馆运营状况，降低人力成本，提升管理效率与服务质量。 ...

在传统娱乐服务行业中，麻将馆、棋牌室等场所的运营长期依赖于手工记录和人工记忆。这种模式在台位状态更新、会员消费记账、营收统计等环节效率低下，且容易因人为疏忽导致账目错误或客户纠纷。为了应对这些挑战，我们设计并实现了一套基于SSM（Spring + SpringMVC + MyBatis）框架的数字化运营管理平台，旨在通过技术手段提升管理精度与运营效率。

该系统采用典型的三层架构设计，实现了业务逻辑、数据持久化与用户界面的清晰分离。Spring框架作为核心容器，负责管理服务层组件的依赖注入与事务控制；SpringMVC处理前端请求的路由与响应渲染；MyBatis则通过灵活的SQL映射机制实现对MySQL数据库的高效操作。下文将从技术选型、数据模型、核心功能及未来扩展性等方面展开详细分析。

技术架构与选型依据

SSM框架组合在Java Web开发领域具有广泛应用，其成熟度与稳定性为系统可靠性提供了坚实基础。Spring的核心特性——控制反转（IoC）与面向切面编程（AOP）——在本系统中得到充分体现。通过注解配置（如@Service, @Autowired）管理业务对象生命周期，减少了硬编码依赖；同时利用@Transactional注解实现声明式事务管理，确保会员充值、消费扣款等操作的数据一致性。

SpringMVC采用前端控制器模式，通过@Controller和@RequestMapping注解将HTTP请求映射到具体的业务处理方法。系统前后端采用JSON格式进行数据交互，后端返回统一的响应对象（如Result封装类），便于前端解析与状态提示。以下代码展示了会员查询功能的控制器实现：

@Controller
@RequestMapping("/member")
public class MemberController {
    
    @Autowired
    private MemberService memberService;
    
    @RequestMapping(value = "/list", method = RequestMethod.GET)
    @ResponseBody
    public Result getMemberList(@RequestParam Map<String, Object> params) {
        try {
            List<Member> members = memberService.getMemberList(params);
            return Result.success(members);
        } catch (Exception e) {
            return Result.error("查询会员列表失败");
        }
    }
}

MyBatis作为持久层框架，通过XML映射文件将Java方法调用与SQL语句动态绑定。其优势在于可编写灵活的动态SQL，适应多条件查询场景。例如，会员信息查询支持按姓名、电话、会员状态等字段组合筛选：

<!-- MemberMapper.xml -->
<select id="getMemberList" parameterType="map" resultType="Member">
    SELECT id, name, phone, balance, status, create_time 
    FROM member 
    WHERE 1=1
    <if test="name != null and name != ''">
        AND name LIKE CONCAT('%', #{name}, '%')
    </if>
    <if test="phone != null and phone != ''">
        AND phone LIKE CONCAT('%', #{phone}, '%')
    </if>
    <if test="status != null">
        AND status = #{status}
    </if>
    ORDER BY create_time DESC
</select>

数据库模型设计解析

系统数据库共设计5张核心表，涵盖会员管理、台位状态、消费订单等业务实体。以下重点分析member（会员表）与poker_table（麻将台表）的结构设计。

会员表（member） 是系统的核心数据载体，其结构设计直接影响到会员管理的精度与效率：

CREATE TABLE `member` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(50) NOT NULL COMMENT '会员姓名',
  `phone` varchar(20) NOT NULL COMMENT '手机号',
  `balance` decimal(10,2) DEFAULT '0.00' COMMENT '账户余额',
  `status` tinyint(1) DEFAULT '1' COMMENT '状态：1-正常 0-禁用',
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_phone` (`phone`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='会员信息表';

该表设计的亮点在于：1）phone字段设置唯一索引，避免重复注册且可作为登录凭证；2）balance采用DECIMAL(10,2)类型，确保金额计算精度；3）status状态位实现软删除逻辑，保留历史数据便于审计。

麻将台表（poker_table） 实时记录每个台位的状态与使用情况：

CREATE TABLE `poker_table` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `table_number` varchar(10) NOT NULL COMMENT '台位编号',
  `status` tinyint(1) DEFAULT '0' COMMENT '状态：0-空闲 1-使用中',
  `current_order_id` int(11) DEFAULT NULL COMMENT '当前订单ID',
  `last_update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_table_number` (`table_number`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='麻将台位表';

该表通过status与current_order_id字段联动实现台位状态机：当顾客入座时，系统生成订单并更新台位状态；结账后状态重置为空闲。last_update_time字段自动记录最后状态变更时间，便于监控台位周转率。

核心功能模块实现

1. 会员管理与充值消费

会员管理模块实现会员信息的增删改查、账户充值、消费扣款等功能。前端界面采用表格展示会员列表，支持按条件筛选与分页显示。

会员管理界面

后端服务层通过MemberService封装会员相关业务逻辑，确保账户操作的原子性。以下代码展示会员充值方法的实现：

@Service
public class MemberServiceImpl implements MemberService {
    
    @Autowired
    private MemberMapper memberMapper;
    
    @Transactional
    @Override
    public Result recharge(Integer memberId, BigDecimal amount) {
        Member member = memberMapper.selectById(memberId);
        if (member == null) {
            return Result.error("会员不存在");
        }
        if (amount.compareTo(BigDecimal.ZERO) <= 0) {
            return Result.error("充值金额必须大于0");
        }
        
        BigDecimal newBalance = member.getBalance().add(amount);
        member.setBalance(newBalance);
        int rows = memberMapper.updateBalance(member);
        
        if (rows > 0) {
            // 记录充值流水
            recordTransaction(memberId, amount, "充值");
            return Result.success("充值成功");
        } else {
            throw new RuntimeException("充值失败，数据更新异常");
        }
    }
}

2. 台位状态管理与订单生成

台位管理模块实时显示每个麻将台的使用状态（空闲/使用中），管理员可快速安排顾客入座。当台位状态变更为"使用中"时，系统自动创建消费订单并开始计时。

台位管理界面

订单生成涉及台位状态更新与订单记录创建的原子操作，通过Spring事务管理确保数据一致性：

@Service
public class OrderServiceImpl implements OrderService {
    
    @Autowired
    private PokerTableMapper pokerTableMapper;
    
    @Autowired
    private OrderMapper orderMapper;
    
    @Transactional
    @Override
    public Result createOrder(Order order) {
        // 检查台位是否可用
        PokerTable table = pokerTableMapper.selectByTableNumber(order.getTableNumber());
        if (table == null) {
            return Result.error("台位不存在");
        }
        if (table.getStatus() == 1) {
            return Result.error("该台位正在使用中");
        }
        
        // 创建订单
        order.setStartTime(new Date());
        order.setStatus(1); // 进行中
        orderMapper.insert(order);
        
        // 更新台位状态
        table.setStatus(1);
        table.setCurrentOrderId(order.getId());
        pokerTableMapper.updateStatus(table);
        
        return Result.success("订单创建成功");
    }
}

3. 消费结算与营收统计

订单管理模块提供消费结算功能，系统根据使用时长与收费标准自动计算金额，支持会员账户扣款或现金支付。结算后台位状态自动重置，并生成消费记录。

订单管理界面

结算过程的业务逻辑涉及费用计算、支付方式判断、账户余额更新等多个步骤：

@Transactional
@Override
public Result settleOrder(Integer orderId, Integer payType) {
    Order order = orderMapper.selectById(orderId);
    if (order == null || order.getStatus() != 1) {
        return Result.error("订单不存在或已结算");
    }
    
    // 计算消费金额（根据时长和费率）
    BigDecimal amount = calculateAmount(order);
    order.setAmount(amount);
    order.setEndTime(new Date());
    
    if (payType == 1) { // 会员支付
        Member member = memberMapper.selectById(order.getMemberId());
        if (member.getBalance().compareTo(amount) < 0) {
            return Result.error("会员余额不足");
        }
        // 扣减会员余额
        member.setBalance(member.getBalance().subtract(amount));
        memberMapper.updateBalance(member);
    }
    
    // 更新订单状态
    order.setPayType(payType);
    order.setStatus(2); // 已结算
    orderMapper.update(order);
    
    // 释放台位
    PokerTable table = pokerTableMapper.selectByTableNumber(order.getTableNumber());
    table.setStatus(0);
    table.setCurrentOrderId(null);
    pokerTableMapper.updateStatus(table);
    
    return Result.success("结算成功");
}

系统还提供按日、周、月等多维度营收统计功能，通过MyBatis动态SQL聚合消费数据：

<select id="getRevenueReport" parameterType="map" resultType="RevenueVO">
    SELECT 
        DATE(create_time) as date,
        COUNT(*) as order_count,
        SUM(amount) as total_amount,
        SUM(CASE WHEN pay_type=1 THEN amount ELSE 0 END) as member_amount,
        SUM(CASE WHEN pay_type=2 THEN amount ELSE 0 END) as cash_amount
    FROM `order` 
    WHERE status=2 
    <if test="startDate != null">
        AND create_time >= #{startDate}
    </if>
    <if test="endDate != null">
        AND create_time <![CDATA[ <= ]]> #{endDate}
    </if>
    GROUP BY DATE(create_time)
    ORDER BY date DESC
</select>

系统安全与稳定性考量

系统采用基于会话的身份认证机制，管理员需通过登录验证才能访问管理功能。登录控制器对用户凭证进行校验，并设置会话超时时间：

@Controller
@RequestMapping("/admin")
public class AdminController {
    
    @RequestMapping(value = "/login", method = RequestMethod.POST)
    @ResponseBody
    public Result login(@RequestParam String username, 
                       @RequestParam String password, 
                       HttpSession session) {
        Admin admin = adminService.validateAdmin(username, password);
        if (admin != null) {
            session.setAttribute("admin", admin);
            return Result.success("登录成功");
        } else {
            return Result.error("用户名或密码错误");
        }
    }
}

管理员登录界面

为防止未授权访问，系统通过拦截器对管理接口进行权限验证：

public class AuthInterceptor implements HandlerInterceptor {
    
    @Override
    public boolean preHandle(HttpServletRequest request, 
                           HttpServletResponse response, 
                           Object handler) throws Exception {
        HttpSession session = request.getSession();
        Admin admin = (Admin) session.getAttribute("admin");
        if (admin == null) {
            response.sendRedirect(request.getContextPath() + "/admin/login.html");
            return false;
        }
        return true;
    }
}

未来功能扩展方向

  1. 微信小程序集成：开发顾客端小程序，实现线上预约台位、查看消费记录、接收促销信息等功能。技术实现可通过Spring Boot构建RESTful API，小程序端调用接口完成业务交互。

  2. 智能排台算法：根据历史客流数据预测高峰时段，为管理员提供台位分配建议。可通过机器学习库（如Weka）分析时段、星期、节假日等因素与客流量的关联性。

  3. 会员等级体系：引入积分与等级制度，不同等级会员享受差异化折扣。需新增会员等级表、积分流水表，并在结算时自动计算优惠金额。

  4. 库存管理模块：扩展饮料、零食等商品管理功能，实现商品入库、销售、库存预警一体化管理。需新增商品表、库存表、销售明细表等数据模型。

  5. 数据可视化大屏：使用ECharts等前端图表库构建实时数据看板，动态展示当日营收、台位利用率、会员增长等关键指标，辅助经营决策。

该系统通过SSM框架的有机结合，构建了一个稳定可靠、易于扩展的麻将馆数字化管理平台。清晰的分层架构与模块化设计为后续功能迭代奠定了良好基础，而针对行业特点的业务逻辑实现则切实解决了传统管理模式的痛点。随着技术演进与业务需求变化，系统可通过引入微服务架构、容器化部署等现代化技术手段进一步提升可维护性与 scalability。

本文关键词
SSM框架麻将馆管理系统源码解析会员管理数据库设计

上下篇

上一篇
没有更多文章
下一篇
没有更多文章