本项目服务于棋牌室、茶楼等以台桌和场次为核心的线下休闲娱乐门店。此类门店经营高度依赖现场员工经验，客流、台桌、顾客、欠款和营业收入往往分散在纸笔、聊天记录或多个表格中，导致经营信息难沉淀、交接成本高、财务核对慢。项目立项的核心，是把门店日常接待和结算过程标准化、在线化，让经营者能及时掌握门店状态，让员工按统一流程完成操作。
• 立项原因：解决传统门店“看不清台桌状态、记不准顾客账目、算不清经营收入、交接容易出错”的共性问题。
• 业务背景：门店需要同时处理顾客建档、组局开桌、座位变更、筹码/账目记录、场次结算、欠款催收和员工协作。
• 目标用户：门店老板、店长、收银/店员，以及通过微信小程序访问门店信息的顾客。
• 业务价值：形成从顾客到店、组局开桌、过程记账、换人留痕到结算入账的闭环，提升现场服务效率和经营数据透明度。
项目采用“后台管理端 + 门店端小程序 + 用户端小程序”的分端设计，按角色提供最短操作路径。功能以门店实际运营为中心，覆盖基础资料、现场台桌、顾客关系和财务流水等模块。
• 门店与账号管理：后台支持门店新增、编辑、删除、列表查询和下拉选择；支持用户列表、详情、启停用、导出等管理能力。
• 微信小程序用户中心：支持微信授权登录、老用户识别、个人信息维护、用户身份查询及门店列表展示。
• 门店台桌管理：支持台桌大盘、台桌新增/编辑/删除、详情查看，并以“空闲、组局中、进行中”等状态呈现现场资源。
• 组局与场次管理：支持暂存组局计划、确认开桌、记录场次玩法和台费，维护场次从组局到进行中再到已结算的状态流转。
• 顾客与牌局账目：支持顾客建档、常玩档位、顾客状态、历史欠款、避战关系管理；支持保存本局账目、座位换人及换人记录。
• 结算与财务：支持本局结算、收入统计、全局流水、快捷记账、欠款客户列表和顾客欠款明细，便于店长日常对账和催收。
• 员工与内容运营：支持门店员工列表及新增编辑；后台支持轮播图配置、上下架和删除，满足小程序基础内容运营。
项目采用 Java 8 + Spring Boot 体系，基于若依基础平台进行后端服务建设，使用分层架构承载后台端、门店端和用户端接口。数据模型按门店、顾客、台桌、场次、参与人、变更日志和账本流水拆分，既满足当前业务落地，也为后续统计分析和多门店扩展保留空间。
• 技术栈与架构：Spring Boot、若依基础组件、MyBatis-Plus、PageHelper、MySQL、Druid、Redis、Lombok、MapStruct、Knife4j；采用 Controller-Service-Mapper-PO/DTO/VO 分层。
• 安全与认证：接入微信授权登录和门店账号登录，使用 JWT/Token 机制区分访问身份；Redis 用于登录态、门店令牌及缓存控制，支持账号停用后的会话失效。
• 接口与工程规范：后台、用户端、门店端按包路径和 URL 分组，统一使用响应包装和 Swagger/Knife4j 文档，分页查询采用 PageHelper，数据库启用逻辑删除。
• 实现亮点：以台桌状态和场次状态驱动现场流程；通过场次参与人、换人日志和账本流水保存关键业务轨迹，降低人工核账和责任追溯成本。
• 实现难点：需要保证开桌、换人、记账、结算之间的数据一致性；同时处理顾客欠款与本局账目的关联、门店员工权限边界，以及高频现场操作下的状态并发问题。
• 扩展基础：已预留微信支付、腾讯云 COS 等组件接入能力，可在后续版本扩展在线支付、票据/图片存储、经营报表和连锁门店统一管理。
评论