台球厅、棋牌室、自助娱乐门店的经营核心是台位计时与高频现金结算：收银机与手机端并行操作，台位计时起止容易记错；会员储值与优惠券叠加后金额难核对；日结靠人工翻单；换设备数据不互通，账目常对不上。
为此我做了这套门店收银系统，覆盖台位计时计费、商品零售、会员储值与积分、优惠券满减、多角色权限与报表统计。结算链路为台费加商品、会员折扣、满减、优惠券、手动减免，储值不足自动混合支付。系统为单文件应用，九大业务模块、四类角色权限，支持单机、局域网与云服务三种模式，多设备共用一份账。
前台开台、换台、结算一站完成，老板随时看经营看板，账务统一出单，减少人工对账差错；同时自建 Playwright 自动化测试体系，14 个脚本、131 条断言覆盖功能、权限、金额与同步链路。
系统面向台球厅等线下休闲门店，共九大功能模块：
1. 台位管理：台位建档、开台计时、暂停/恢复、换台无缝衔接、预定登记、维修停用；
2. 计费收银：按时计费与商品消费合并结算，会员等级折扣、满减、优惠券、手动减免四重优惠按序叠加，储值不足自动混合支付，结算即出单；
3. 会员管理：建档储值、消费积分、四级等级体系、会员营销与优惠券发放核销；
4. 商品进销存：入库/出库/盘点、库存预警、销量统计；
5. 订单与账单：多条件检索、订单详情、退款处理（自动回滚库存与优惠券状态）；
6. 统计报表：营收趋势、台位利用率、商品销量、支付方式分布等多维图表；
7. 员工权限：四类角色白名单授权，菜单裁剪与路由双重拦截；
8. 数据看板：今日营收、在台台数、近七日趋势等经营速览；
9. 系统设置：计费规则配置、数据备份/恢复/健康校验，支持多设备云端实时同步。
本人独立完成需求分析、功能开发、测试、部署上线全流程。
技术栈：原生 HTML/CSS/JavaScript 单文件应用 + Chart.js 图表；Node.js 原生 HTTP 零依赖后端（静态服务 + 数据接口）；WorkBuddy 云数据库（PostgreSQL，JSONB 全库快照 + revision 版本号）；Playwright + Edge headless 自动化测试。
架构与亮点：
① 三层数据通道：云数据库 → 同源后端 → 浏览器本地缓存，写操作防抖 300ms 推送，启动设同步闸门，防止初始化数据覆盖真实营业数据；
② 多设备一致性：推送前比对云端版本号的乐观锁，冲突时弹窗由用户选择"用云端最新/保留我的"，不静默覆盖；15 秒轮询 + 页面重新可见即拉取，其他设备改动免刷新可见；
③ 离线防护：从未成功拉取云端的设备禁止首次推送，演示数据一律不上传，防止污染营业库；
④ 数据可靠性：主数据 + 备份双槽 + 结构校验自动回退，三层防线防丢。
难点与解决：整库快照"后写覆盖先写"的丢单风险，用乐观锁 + 定时轮询收敛，并以双浏览器上下文实测通过；自动化测试中通过状态注入与断网模拟（route abort），把多端同步、离线恢复等难以人工验证的场景转为可断言用例，沉淀 14 个脚本、131+ 条断言。
评论