朵咔掌柜是美助科技面向美容、美发、养发、美甲美睫纹绣、院线护肤等美业连锁门店打造的一体化经营管理系统(SaaS 模式,按门店开通)。
一、立项背景与目标
美业门店长期被"人、货、客"三本账困扰:通用收银软件不懂计次卡、套餐、技师提成和会员晋级,旧版 POS 系统技术陈旧。朵咔掌柜的目标是打造专为美业设计的"经营大脑",把开单收银、会员充值、员工提成、进销存、经营报表集成到一个系统;支持安卓/iOS/鸿蒙平板与 H5 多端协同,让老板不在店也能实时看见、管住门店。
二、核心功能模块
1. 收银开单:快速开单、点单轮单分配技师、套餐计次抵扣、混合支付、多单联合结账。
2. 会员管理:建档、等级折扣、储值/折扣/计次/代金券、消费留痕、晋级与生日关怀。
3. 商品库存:分类与会员价、采购到销售全单据进销存、多仓库与供应商管理。
4. 员工考勤:排班、扫码打卡、请假、业绩提成自动核算。
5. 报表中心:营业、业绩、产品、考勤等 16+ 张可视化报表,管理后台的报表更加丰富。
6. 多端与安全:三端平板+H5 横屏,权限分级、操作可追。
三、业务流程
主线为"开单—会员—报表":选会员→加项目→指技师→混合支付结账出小票;会员建档后自动分级折扣、消费留痕并晋级;库存采购到销售全单据流转;员工排班打卡后自动算提成;经营数据实时生成报表,老板随时查阅。
一句话:朵咔掌柜是美业门店的"经营驾驶舱",让门店经营看得见、管得住
朵咔掌柜项目实现
一、整体架构与技术栈
朵咔掌柜由美助科技将原有 ASP.NET 美业 POS 增量迁移到现代前端,前后端分离。后端采用 C# .NET 4.8 + SQLServer,统一 ResultMsg 响应包,157 个接口覆盖 13 大模块,数据库遵循 T_/F_ 命名规范。前端采用 Vue3(Options API)+ uni-app,经 HBuilderX 编译到 Android、iOS、鸿蒙、H5 四端;用 app.config.globalProperties 替代 Vue.prototype 挂全局属性,自定义 uni.$showModal 统一弹窗,utils/router.js 单例路由负责跳转与登录拦截。设计上按"一次一个功能"增量重写老页面,便于逐轮回归。
二、我负责的模块与结果
我主导前端 Vue2→Vue3 迁移与功能开发:完成 sale-list、bill-detail、save-suit-first、UnionOutNote(联合结账)等十余个核心组件及十余处组件映射;落地升级模块 Android、iOS、鸿蒙三平台适配;以 ActSuitInfo.vue 为模板为全项目保存按钮统一防重复点击机制;修复 note-list 等运行时缺陷。每个功能在真机/模拟器按控制台报错回归 2–3 轮。
三、难点、坑与解决方案
1. Vue3 入口契约:main.js 不能自挂载,须 export function createApp() 交给框架挂载,否则白屏。
2. 根目录缺 index.html:HBuilderX 的 Vue3 模板强制要求,从兄弟项目复制补齐。
3. 组件内 CommonJS 崩溃:module.exports/require 在 vite 报错,统一改 export default + import,动态组件用 defineAsyncComponent。
4. 空选择器崩溃:CSS 空选择器致 stylePluginScoped 报错,扫描所有 style/.css 修复。
5. 自定义 Router 漏注册:未调 beforeEach 致非 tabBar 跳转失效,在 createApp 内注册守卫。
6. 后端 ResultMsg 包结构:返回 res.data 即整体 body,业务数据在 Data. 且须 await,漏写会致列表/保存为空。