本项目立项源于智慧养老平台旗下线下门店（助餐点、生活服务站等，含自营与加盟）的收银痛点：门店长期依赖手工记账加个人收款码，账目靠Excel人工核对，储值余额易记错，退款无据可查，店长无法实时掌握经营状况，平台方也缺乏对众多门店统一开通与监管的手段；而市面通用收银系统价格高、行业定制化强，不支持多商户多门店多角色的分级管理。本项目旨在为小微门店提供一套开通即用、收款快、账目清、管理省的轻量收银SaaS。业务背景上，店员日常为老年顾客开单收款、办理储值消费，店长管理本店成员与对账，平台运营统一开通商户并监督经营；方案预留多行业扩展能力，可平移至中式快餐等全行业门店，并顺应数字人民币推广趋势，作为其线下落地场景。
项目围绕“商户（租户）—门店—成员”三级组织，具体功能模块包括：1、组织权限模块：平台运营控制台（商户/门店/成员统一管理、代开通、启停用），店长端（本店成员管理、客户档案维护），店员端（收银开单），三角色权限严格隔离；2、收银开单模块：商品快速开单、多支付方式组合收款（现金/银行转账/储值卡，枚举可扩展）、账单明细与分页查询；3、退款审批模块：整单与单品退款申请、店长审批、驳回重提，四态状态机全程留痕可追溯；4、会员储值模块：客户建档支持手动录入、Excel批量导入（预览确认防误灌）、平台数据一键同步三种来源，储值卡开户、充值含赠送、消费扣款，并有防透支控制；5、报表对账模块：门店经营看板、日结与月结对账、平台跨店汇总，支持Excel导出；6、安全管控：成员密码重置、停用即强制下线。主要功能是为小微门店提供从收款开单、退款审批、会员储值到报表对账的收银全流程线上化，平台侧可统一开通与监管多商户多门店。
本人在项目中独立负责全部工作：产品方案与数据库建模、后端全部接口开发、前端页面开发、服务器部署上线以及测试验收。技术栈与架构：后端采用Spring Boot 3.5 + Java 17 + JPA + Flyway + MySQL + Redis（JWT会话与登出黑名单），前端采用Vue 3 + Vite，本地用docker-compose一键启动中间件，服务器以systemd守护加nginx反代部署；整体为多租户SaaS架构，业务表统一携带tenant_id，数据访问层强制附带租户过滤谓词，唯一键含租户字段，从底层防止跨租户数据越权。实现亮点与难点：1、行级多租户数据隔离，通过基准查询约束加自动过滤器保证任何查询必带租户条件；2、退款四态状态机与储值卡防透支设计，状态流转全程留痕，账户并发扣减安全；3、基于Redis令牌版本号实现成员停用或重置密码后的即时强制下线；4、合规设计：平台不碰资金池、不做二清，日志中手机号三段脱敏；5、配套200余个JUnit5单元测试及接口全链路冒烟测试，保障核心链路质量。
评论