本项目面向中小型棋牌室、麻将馆、桌游室等休闲娱乐门店。传统经营通常依赖纸质记录和口头结算,容易出现包间状态不清、会员余额难追踪、人员与商品归属混乱、逃单损失难核算以及营业数据统计滞后等问题。
系统围绕门店日常经营闭环,提供包间开台、客户与会员管理、人员上桌、商品消费、订单结算、支出登记和营业报表等功能,并通过响应式界面同时适配电脑和手机,适合前台、店长和经营者日常使用。
点击空白处退出提示
本项目面向中小型棋牌室、麻将馆、桌游室等休闲娱乐门店。传统经营通常依赖纸质记录和口头结算,容易出现包间状态不清、会员余额难追踪、人员与商品归属混乱、逃单损失难核算以及营业数据统计滞后等问题。
系统围绕门店日常经营闭环,提供包间开台、客户与会员管理、人员上桌、商品消费、订单结算、支出登记和营业报表等功能,并通过响应式界面同时适配电脑和手机,适合前台、店长和经营者日常使用。
包间经营看板:实时展示空闲、进行中和已结账状态,快速进入开台或查看订单。
开台管理:支持台费档位选择,以及最多四名客户预先上桌。
客户管理:保存客户姓名、电话、备注和到访次数,支持搜索、编辑和删除。
自动客户建档:订单中输入新客户姓名后自动加入客户列表,下次开台可直接复用。
会员管理:支持普通会员、超级会员、会员余额、充值和台费抵扣。
订单与商品管理:人员、会员和商品统一关联到订单,支持商品归属人员。
结账与逃单处理:支持多人逃单、台费分摊核减、逃单商品剔除和自动生成订单备注。
报表管理:统计订单实收、会员费、支出、净收入和订单明细。
权限与安全:管理员登录、CSRF 防护、登录失败限制、安全响应头和会话管理。
响应式界面:适配电脑、平板和手机,方便前台移动操作。
项目采用 Flask 单体 Web 应用架构,使用 Jinja2 服务端渲染页面,SQLAlchemy 负责数据建模和数据库访问,Flask-Migrate 管理数据库结构变更。系统默认使用 SQLite,也可通过 DATABASE_URL 接入其他兼容 SQLAlchemy 的关系型数据库。
后端按包间、订单、人员、客户、会员、商品、收入和支出等业务对象进行数据建模,通过路由层完成业务校验、状态流转和事务提交。订单模块关联普通客户、会员、商品和逃单记录,支持开台、人员上桌、商品消费和结账闭台的完整流程。
客户模块建立了独立客户档案,并将订单人员与客户记录关联。新增人员时自动创建或更新客户档案,开台时可选择已有客户;系统同时校验重复上桌、跨包间占用和每桌人数上限,保证订单人员状态与客户档案一致。
结算逻辑根据台费档位、计费人数、普通会员数量和超级会员数量计算会员抵扣及现场应收。发生逃单时,系统核减台费分摊、剔除逃单人员名下商品,并保留逃单人员及订单备注。
页面采用移动端优先的响应式 CSS,实现经营看板和后台管理界面;认证与安全层包含密码哈希、管理员会话、CSRF 校验、登录失败限制及安全响应头。项目提供 Dockerfile、Docker Compose 和 Gunicorn 部署配置,并编写自动化测试覆盖客户复用、订单结算、会员扣费、逃单处理和权限校验等核心流程。




评论