本项目面向美发、养发、头疗、美容等单店及小型连锁，旨在解决门店日常经营中工具割裂带来的问题：传统门店依赖纸质登记、Excel 和通用收银软件，存在预约与到店开单脱节、收银后不自动扣减库存导致账实不符、疗程次卡管理混乱、头疗师业绩与提成靠手工统计易出错、收支与利润算不清、客户资料分散流失等痛点；而市面主流 SaaS 多按年订阅、数据存于云端，断网或内网环境无法使用，个性化流程也难以调整。基于此，立项自研一套可在门店自有电脑或服务器本地/内网部署、数据自持、无需联网、可一次性买断的一体化门店经营管理系统，覆盖从前台预约接待、到店收银开单、客户与会员管理、员工排班提成、商品库存、服务套餐、次卡销售核销，到门店业绩统计与财务利润核算的完整闭环，帮助单店及十人以内小团队实现数字化、规范化经营。
系统为全栈 Web 应用，主要包含以下功能模块：
1、首页工作台：集中展示今日预约数、订单数、营业额、新增客户，营业额支持按月/季/年切换统计并展示趋势图，提供快捷入口。
2、预约管理：预约登记、日历与列表双视图、到店/服务中/完成/取消等状态流转；选定开始时间后结束时间自动顺延一小时，列表默认按开始时间倒序。
3、快速收银开单：服务、商品、套餐、次卡核销四类消费可一单合并结算，自动计算优惠与应付，支持多种支付方式；结账自动扣减库存、自动登记头疗师服务次数与业绩，退款自动冲减营业额并回补库存，防止重复提交。
4、客户管理：客户档案、历史订单、累计消费、最近到店、名下次卡及剩余次数，支持搜索、编辑与详情。
5、员工与排班：员工档案、岗位与提成规则、离职/复职，以及可视化排班日历。
6、库存管理：卡片/列表双视图，支持入库、出库、盘点、库存预警、流水台账，并可导出 Excel。
7、服务项目与套餐：维护可售服务与组合套餐、上下架，开单选套餐自动带出明细。
8、次卡管理：卡种维护、售卡时指定卖卡头疗师并将卡面金额计入其业绩、核销自动扣减次数、售卡与核销流水可查。
9、门店业绩：按时间段统计客流量、订单总金额、每位头疗师服务次数与业绩排行，个人业绩=服务业绩+售卡业绩，支持导出。
10、财务管理：收入/支出录入（默认已收/已付），按“收入-支出”计算利润，提成单列、基本工资不自动扣除（可作支出录入），支持月度汇总筛选。
11、系统与权限：店铺名与系统名、浏览器标题、首页全局联动；主密码登录加二级密码二次验证，业绩、次卡、排班三个敏感模块受保护，离开满一分钟再进入需重新验证。技术栈为 React+NestJS+PostgreSQL+TypeScript，支持本地内网部署、数据自持。
本人独立负责该系统从需求梳理、架构设计、数据库建模到前后端开发、联调测试与本地部署的全流程。
技术栈与架构：前端 React 19 + TypeScript + Vite，结合 Tailwind CSS 与 shadcn/ui（Radix UI）搭建组件，用 React Router、Redux Toolkit/React Query 管理路由与状态、ECharts 做经营图表、xlsx 导出台账；后端 NestJS（Express）+ TypeScript 模块化分层，Drizzle ORM 操作 PostgreSQL，class-validator 校验入参；前后端同仓共享类型，生产由 Nest 单进程同时提供 /api 与前端静态资源（SPA 回退），支持内网离线部署、数据自持。
难点与亮点：
1、收银开单事务一致性：服务、商品、套餐、次卡四类消费一单结算，在单个数据库事务内原子完成扣库存、次卡核销、头疗师服务次数与业绩累加、订单及财务流水生成；退款反向补偿并回补库存业绩，用幂等控制防止重复点击重复扣库存。
2、业绩与利润口径：售卡即计入指定“卖卡头疗师”业绩，个人业绩=服务业绩+售卡业绩并区分预收；财务按“收入-支出”算利润、提成单列、基本工资不自动扣除。
3、安全机制：主密码加二级密码双重校验，业绩、次卡、排班三个敏感模块二次验证，前端管理离开满一分钟自动失效的会话。
4、平台解耦：通过适配层剥离原低代码平台 SDK，使其可脱离云端在内网独立运行；并实现店铺名全局联动、库存双视图、Excel 导出、经营数据按月/季/年聚合。
评论