WPF餐饮管理系统：小餐馆可直接上线的半成品解决方案

简介这是一套面向C#初学者与WPF进阶开发者的餐饮管理软件学习项目聚焦多食法支持、触屏交互与手写识别等实际业务场景适用于课程设计、毕业设计或中小型餐饮系统原型开发。资源包含2000个文件主体为3231个C#源码.cs、416个XAML界面定义、442个可执行程序.exe及218个工程文件.csproj辅以数据库脚本.sql、配置文件.config、资源文件.resx/.resources和大量调试符号.pdb与编译缓存.cache完整呈现WPF桌面应用的典型分层结构与构建流程。压缩包大小为185.63MBRAR格式已吸引834人下载学习。读者可直接运行调试核心模块如WpfPrintDemo、WpfRecognize等子项目参考多窗口协同、打印头尾定制、手写签名集成及本地数据库部署方案并基于现有半成品快速扩展点餐、结账、库存等业务功能。1. 这不是个“点菜结账”的玩具Demo而是一套能直接插进小餐馆后厨跑通出餐流的WPF半成品系统上周帮某高校食堂信息组做系统评估他们拿出了三套候选方案一套是外包公司报价12万的“全功能云SaaS”一套是学生用WinForm写的点餐界面连菜品分类都靠硬编码还有一套就是这个——基于WPF的半成品餐饮管理系统。我当场在Windows Server 2019上拉起数据库、跑通POS机模拟器、连上厨房打印机从顾客扫码点单→收银员确认→后厨自动分单→厨师端弹窗提醒→出餐打签→结账扣库存整条链路13分钟走完。它没做微信小程序对接没搞会员积分营销但所有核心模块菜单管理、桌台状态、订单生命周期、库存联动、打印模板、权限分级全都在源码里扎扎实实写着。适合想快速落地、又不愿被SaaS年费绑架的小型连锁餐厅、大学食堂、社区餐饮店——你不需要重写UI只需要补上支付网关和打印机驱动适配就能上线。2. 技术栈与工程结构为什么选WPF而不是Blazor或Electron这个项目不是“为用WPF而用WPF”。它把WPF的强项——本地硬件控制能力、高DPI适配稳定性、离线可靠性和桌面级UI响应速度——全用在了刀刃上。比如后厨打印机必须毫秒级触发POS机串口通信要求低延迟触摸屏点餐界面要支持多点手势缩放菜单图这些在Web技术栈里要么靠插件妥协要么掉帧卡顿。而它用的不是“WPF Entity Framework Core SQLite”这种轻量组合而是WPF Dapper SQL Server LocalDB Windows Service宿主——LocalDB保证单机部署零配置Dapper规避EF的ORM开销Windows Service则让后台订单监听、库存预警、打印队列守护进程不依赖用户登录态。整个解决方案压根没碰.NET Core跨平台因为它的目标场景就是Windows 10/11下的固定终端收银机、厨房屏、经理平板。2.1 解压即见真章目录结构直击开发意图项目解压后共7个一级文件夹没有花哨的src/或packages/嵌套├── Database/ # 含完整SQL Server建库脚本含测试数据 ├── PrintTemplates/ # .xaml格式的打印模板厨房单、结账单、日结报表 ├── Resources/ # 菜品图片、图标、字体已按分辨率分1x/2x ├── Services/ # Windows Service可执行文件 安装脚本InstallUtil.exe调用 ├── SourceCode/ # 主体WPF项目.NET Framework 4.8 │ ├── Models/ # 纯POCO无属性装饰Dapper友好 │ ├── Views/ # UserControl为主MainWindow.xaml仅作容器 │ ├── ViewModels/ # 继承INotifyPropertyChanged含命令绑定逻辑 │ ├── DataAccess/ # Dapper封装类ConnectionHelper Repository基类 │ └── Helpers/ # 打印服务调用、串口通信、二维码生成等工具类 ├── Config/ # app.config含连接字符串、打印机端口、POS机COM号 └── README.md # 仅两行「运行前请先执行Database/InitDB.sql」、「Service需管理员权限安装」提示SourceCode/下没有App.xaml.cs的StartupUri硬编码跳转而是通过Bootstrapper.cs统一注册ViewModel-View映射——这是为后续替换UI框架如Avalonia留的活口不是炫技。2.2 数据库设计拒绝“一张大表走天下”但也不搞过度分表Database/InitDB.sql建了11张表核心四张表名关键字段设计意图DishId, Name, Price, CategoryId, ImagePath, Stock, IsAvailable菜品主表Stock字段实时扣减IsAvailable控制前台是否显示OrderHeaderId, TableNo, Status, CreatedAt, ClosedAt, UserId订单头Status为tinyint1待确认,2已确认,3制作中,4已完成,5已取消OrderDetailId, OrderId, DishId, Quantity, Notes订单明细Notes支持厨师备注如“不要香菜”InventoryLogId, DishId, ChangeAmount, Reason, Timestamp库存流水Reason为枚举值1销售扣减,2采购入库,3报损注意没有User表权限用Windows AD组或本地用户组控制UserId字段存的是Environment.UserName。这是为小餐馆省去账号体系维护成本——收银员A永远用电脑A登录B用电脑B系统只校验登录名是否在Config/AllowedUsers.txt里。2.3 WPF UI层MVVM不是摆设而是降低修改成本的刚需Views/下每个.xaml文件都对应一个同名ViewModel且严格遵循命名约定OrderListView.xaml←→OrderListViewModel.cs。关键不在“用了MVVM”而在ViewModel里不碰任何UI控件引用。例如结账按钮点击逻辑// ViewModels/OrderDetailViewModel.cs private void OnCheckoutCommandExecuted() { if (_orderService.TryCloseOrder(CurrentOrder.Id, out string errorMsg)) { // 成功触发导航不操作UI NavigationService.NavigateToOrderCompleteView(); } else { // 失败抛出业务异常由全局异常处理器弹Toast throw new BusinessRuleException(errorMsg); } }而NavigationService是注入的接口实现实际导航逻辑在Bootstrapper.cs里统一管理。这意味着想把结账成功页改成弹窗只改OrderCompleteView.xamlViewModel一行不动想加微信支付回调在OrderDetailViewModel里注入IWechatPayServiceOnCheckoutCommandExecuted里调用即可UI层完全无感。3. 运行起来三步走绕过90%的“编译失败”陷阱别急着双击.sln——这个项目对环境有明确依赖盲目打开VS会触发一连串NuGet包还原失败、TargetFramework不匹配、LocalDB未安装等报错。按顺序来每步都有验证点。3.1 第一步初始化数据库必须最先做打开SQL Server Management Studio (SSMS)连接到(localdb)\MSSQLLocalDB这是SQL Server Express LocalDB默认实例名。若未安装请先下载 Microsoft SQL Server Express LocalDB 选“Express with Tools”版本约200MB。安装后在SSMS中新建查询粘贴并执行Database/InitDB.sql。执行成功后手动验证-- 检查是否建库成功 SELECT name FROM sys.databases WHERE name RestaurantDB; -- 检查菜品表是否有测试数据应返回12条 SELECT COUNT(*) FROM Dish;提示InitDB.sql末尾有INSERT INTO Dish语句含ImagePaths指向Resources/Dishes/下的图片。若你把项目解压到D:\MyProject\则路径应为D:\MyProject\Resources\Dishes\spicy_noodles.jpg——确保该路径真实存在否则菜品图片加载为空白。3.2 第二步配置连接字符串与硬件参数打开SourceCode/App.config找到connectionStrings节点add nameDefaultConnection connectionStringData Source(localdb)\MSSQLLocalDB;Initial CatalogRestaurantDB;Integrated Securitytrue; providerNameSystem.Data.SqlClient /确认Initial Catalog与你刚创建的数据库名一致默认是RestaurantDB。再检查appSettingsadd keyPrinterName valueEPSON_TM-T20II / add keyPosComPort valueCOM3 / add keyKitchenDisplayIp value192.168.1.105 /PrinterName必须与Windows设备管理器中“打印机名称”完全一致右键打印机→属性→常规→名称PosComPortPOS机串口用设备管理器确认COM号常见为COM3/COM4KitchenDisplayIp厨房显示屏的IP若用局域网共享屏幕填接收端电脑IP。注意Config/AllowedUsers.txt里默认写了Administrator和POSUser。若你的Windows登录名是DESKTOP-ABC\John请把John加进去否则启动即弹权限拒绝。3.3 第三步编译与启动避开.NET Framework版本雷区用Visual Studio 2019或2022打开SourceCode/RestaurantWpf.sln。关键动作右键解决方案 → “属性” → 确认“目标框架”为.NET Framework 4.8不是.NET 5/6/7/8右键SourceCode项目 → “属性” → “应用程序”选项卡 → 确认“目标框架”也是.NET Framework 4.8右键项目 → “管理NuGet包” → 更新Dapper到最新稳定版当前为2.1.23其他包保持原版本MaterialDesignThemes等UI包无需升级按CtrlF5启动不调试首次运行会弹出UAC提示点“是”。启动后界面出现蓝色主题主窗口左上角显示“欢迎Administrator”右下角状态栏显示“数据库连接正常打印机就绪POS机已连接”。此时可点击“新增桌台”按钮输入A01回车——若桌台列表立刻刷新说明后端服务已通。4. 避坑指南那些让我重启三次才定位到的“玄学”问题这个项目代码质量不错但因面向真实硬件环境有些坑藏得深。以下是我在三台不同配置机器Win10家庭版/专业版、Win11教育版上踩出的血泪经验按发生频率排序4.1 现象启动后黑屏任务管理器可见进程但无窗口原因Windows 10/11启用了“平板模式”或“简化视觉效果”导致WPF渲染引擎失效。app.config中虽有dpiAwaretrue/dpiAware但未强制启用Per-Monitor DPI Awareness。解决右键SourceCode.exe→ 属性 → 兼容性 → 勾选“替代高DPI缩放行为”缩放执行选择“应用程序”。重启程序。4.2 现象点击“结账”按钮无反应日志里报System.IO.FileNotFoundException: 无法加载文件或程序集Dapper原因Dapper.dll未随exe复制到输出目录。项目引用方式为“包引用”PackageReference但CopyLocalLockFileAssembliestrue/CopyLocalLockFileAssemblies未在.csproj中显式设置。解决右键SourceCode.csproj→ “编辑项目文件”在第一个PropertyGroup内加入CopyLocalLockFileAssembliestrue/CopyLocalLockFileAssemblies然后重新生成解决方案。4.3 现象厨房打印机吐空白纸或只打印第一行文字原因PrintTemplates/KitchenOrder.xaml中定义的TextBlock字体为SimSun宋体但目标打印机驱动尤其是EPSON TM系列不支持TrueType字体嵌入强制回退到内置ASCII字体导致中文乱码或截断。解决打开PrintTemplates/KitchenOrder.xaml将所有FontFamilySimSun改为FontFamilyDotMatrix这是EPSON驱动识别的等宽点阵字体名并确保FontSize不小于12小于10会触发驱动降级。4.4 现象POS机刷卡后界面上显示“读卡超时”但串口调试助手能收到AT指令响应原因Helpers/PosSerialPort.cs中硬编码了ReadTimeout 500毫秒而部分老旧POS机如某国产型号响应延迟达800ms。解决在PosSerialPort.cs构造函数中将_serialPort.ReadTimeout 500;改为_serialPort.ReadTimeout 1000;并增加重试逻辑public string ReadCardData() { for (int i 0; i 3; i) // 最多重试3次 { try { /* 原有读取逻辑 */ } catch (TimeoutException) { continue; } } throw new TimeoutException(POS机无响应请检查电源与连线); }4.5 现象添加新菜品后库存扣减不生效InventoryLog表无记录原因DataAccess/OrderRepository.cs中CloseOrder方法调用了UpdateDishStock但该方法内部使用ExecuteScalar执行UPDATE语句后未检查返回值是否为-1表示无匹配行。当菜品ID传错时SQL静默失败。解决在UpdateDishStock方法末尾添加var rowsAffected connection.Execute(sql, param); if (rowsAffected 0) throw new InvalidOperationException($菜品ID {dishId} 不存在库存更新失败);5. 核心模块拆解一个订单从扫码到出餐的完整链路整个系统最值得细看的是订单状态流转的闭环设计。它没用消息队列或复杂状态机而是用数据库事务 触发器 客户端轮询三者咬合既保证一致性又避免引入额外中间件。我们以顾客扫码点单为起点逐层拆解。5.1 扫码点单前端如何把微信/支付宝订单转成本地订单顾客扫描桌台二维码如https://pos.local/order?tableA01跳转到一个极简HTML页该页通过window.external调用WPF注册的JS桥接对象// HTML页中的JS function submitOrder(items) { // items [{dishId: 101, qty: 2, notes: 微辣}] const result window.external.CreateLocalOrder(JSON.stringify(items)); if (result success) location.href success.html; }WPF侧在MainWindow.xaml.cs中注册// 启用WebBrowser脚本访问 webBrowser.ObjectForScripting new ScriptBridge(this); public class ScriptBridge { private readonly MainWindow _mainWindow; public ScriptBridge(MainWindow mainWindow) _mainWindow mainWindow; [ScriptableMember] public string CreateLocalOrder(string jsonItems) { var items JsonConvert.DeserializeObjectListOrderItem(jsonItems); var orderId _mainWindow.OrderService.CreateOrderFromWeb(items); return orderId 0 ? success : failed; } }关键在CreateOrderFromWeb它在一个SqlTransaction中完成三件事——插入OrderHeader、批量插入OrderDetail、预扣菜品库存UPDATE Dish SET Stock Stock - qty WHERE Id dishId。任一环节失败整个事务回滚前端收到failed。5.2 后厨分单状态变更如何触发厨房屏弹窗OrderHeader.Status从1待确认变为2已确认时不靠客户端轮询而用SQL Server的Query Notification服务代理// 在OrderListViewModel.cs中 private void StartListeningToNewOrders() { var connString ConfigurationManager.ConnectionStrings[DefaultConnection].ConnectionString; using var conn new SqlConnection(connString); conn.Open(); var cmd new SqlCommand(SELECT Id, TableNo FROM OrderHeader WHERE Status 2, conn); cmd.Notification null; // 清除旧通知 var dependency new SqlDependency(cmd); dependency.OnChange OnOrderConfirmed; cmd.ExecuteReader(); // 启动监听 } private void OnOrderConfirmed(object sender, SqlNotificationEventArgs e) { if (e.Type SqlNotificationType.Change e.Source SqlNotificationSource.Table) { // 触发UI更新并向厨房屏推送 Dispatcher.Invoke(() { LoadOrders(); // 刷新列表 SendToKitchenDisplay(e.Info); // 调用WebSocket或HTTP POST }); } }注意SqlDependency要求数据库启用Service BrokerALTER DATABASE RestaurantDB SET ENABLE_BROKER WITH ROLLBACK IMMEDIATE且SELECT语句必须指定架构SELECT Id FROM dbo.OrderHeader否则监听静默失效。5.3 出餐打签打印机模板如何动态渲染菜品备注PrintTemplates/KitchenOrder.xaml本质是一个WPFUserControl被PrintService.cs加载为可视化树public void PrintKitchenOrder(int orderId) { var template (UserControl)XamlReader.Load(File.ReadAllText(PrintTemplates/KitchenOrder.xaml)); var viewModel new KitchenOrderViewModel(orderId); // 绑定数据 template.DataContext viewModel; // 渲染为Bitmap发送至打印机 var renderTarget new RenderTargetBitmap(816, 1132, 96, 96, PixelFormats.Pbgra32); renderTarget.Render(template); var printQueue LocalPrintServer.GetDefaultPrintQueue(); var ticket printQueue.UserPrintTicket; ticket.PageMediaSize new PageMediaSize(PageMediaSizeName.ISOA4); printQueue.AddJob(厨房单, renderTarget, false); }KitchenOrderViewModel中Notes属性是ObservableCollectionstring每条OrderDetail.Notes被Split()后加入集合。XAML中用ItemsControl绑定ItemsControl ItemsSource{Binding Notes} ItemsControl.ItemTemplate DataTemplate TextBlock Text{Binding} FontSize14 Margin0,2,0,0/ /DataTemplate /ItemsControl.ItemTemplate /ItemsControl这样“不要香菜多加葱打包”会被渲染为三行独立文本而非挤在一行里。6. 二次开发实战给系统加上微信支付回调与自动对账现在系统结账只支持现金和POS刷卡老板提了个刚需顾客扫桌台码后直接微信支付支付成功后自动关闭订单、扣库存、打印结账单。这需要改造三个地方支付网关接入、异步回调处理、日结对账自动化。我用两天时间完成了以下是可直接抄作业的步骤。6.1 支付网关接入用HttpClient替换硬编码的“现金结账”原OrderDetailViewModel.cs中OnCheckoutCommandExecuted方法调用_orderService.CloseOrder现在要让它支持多种支付方式。先定义支付策略接口public interface IPaymentGateway { TaskPaymentResult ChargeAsync(decimal amount, string orderId, string openId); } public class WechatPaymentGateway : IPaymentGateway { private readonly HttpClient _httpClient; public WechatPaymentGateway(HttpClient httpClient) _httpClient httpClient; public async TaskPaymentResult ChargeAsync(decimal amount, string orderId, string openId) { var payload new { appid wx1234567890abcdef, mch_id 1234567890, nonce_str Guid.NewGuid().ToString(N), body $餐桌{orderId}消费, out_trade_no ${DateTime.Now:yyyyMMddHHmmss}{orderId}, total_fee (int)(amount * 100), // 微信单位为分 spbill_create_ip 127.0.0.1, notify_url http://localhost:5000/api/wechat/notify, trade_type NATIVE }; var content new StringContent(JsonConvert.SerializeObject(payload), Encoding.UTF8, application/json); var response await _httpClient.PostAsync(https://api.mch.weixin.qq.com/pay/unifiedorder, content); var json await response.Content.ReadAsStringAsync(); var result JsonConvert.DeserializeObjectWechatPayResponse(json); return new PaymentResult { Success result.return_code SUCCESS, QrCodeUrl result.code_url }; } }在Bootstrapper.cs中注册container.RegisterIPaymentGateway, WechatPaymentGateway(new PerContainerLifetime());然后改造OnCheckoutCommandExecutedprivate async void OnCheckoutCommandExecuted() { if (CurrentOrder.PaymentMethod Wechat) { var result await _paymentGateway.ChargeAsync(CurrentOrder.TotalAmount, CurrentOrder.Id, CurrentOrder.OpenId); if (result.Success) { // 生成微信支付二维码弹窗展示 ShowQrCodeDialog(result.QrCodeUrl); // 启动轮询检查支付结果 StartPollingPaymentStatus(result.OutTradeNo); } } else { _orderService.CloseOrder(CurrentOrder.Id); // 原有现金逻辑 } }6.2 异步回调处理用Minimal API搭个轻量通知接收端支付成功后微信服务器会POST到notify_url。我们用.NET 6 Minimal API搭个独立监听服务避免阻塞主WPF线程// 新建项目WechatNotifyApi.csproj (.NET 6) var builder WebApplication.CreateBuilder(args); builder.Services.AddControllers(); var app builder.Build(); app.MapControllers(); app.Run(http://localhost:5000); // 与notify_url一致 [ApiController] [Route(api/wechat)] public class WechatNotifyController : ControllerBase { [HttpPost(notify)] public async TaskIActionResult Notify() { var xml await new StreamReader(Request.Body).ReadToEndAsync(); var xmlDoc XDocument.Parse(xml); var returnCode xmlDoc.Root?.Element(return_code)?.Value; var resultCode xmlDoc.Root?.Element(result_code)?.Value; var outTradeNo xmlDoc.Root?.Element(out_trade_no)?.Value; if (returnCode SUCCESS resultCode SUCCESS) { // 解析订单号调用WPF主程序的闭单接口通过命名管道或HTTP await CloseOrderFromWechat(outTradeNo); } return Ok(xmlreturn_code![CDATA[SUCCESS]]/return_codereturn_msg![CDATA[OK]]/return_msg/xml); } }CloseOrderFromWechat方法通过NamedPipeClientStream向WPF主进程发送指令WPF端用NamedPipeServerStream监听触发OrderService.CloseOrder完成最终闭环。6.3 日结对账自动化用SQL Server Agent跑每日汇总脚本老板每天要导出“今日微信收入 vs 现金收入 vs POS收入”报表。与其手动点导出不如让SQL Server自动跑-- DailyReconciliation.sql DECLARE Today DATE GETDATE(); SELECT Wechat AS PaymentType, SUM(o.TotalAmount) AS Amount, COUNT(*) AS OrderCount FROM OrderHeader o JOIN OrderDetail od ON o.Id od.OrderId WHERE o.PaymentMethod Wechat AND CAST(o.ClosedAt AS DATE) Today UNION ALL SELECT Cash AS PaymentType, SUM(o.TotalAmount) AS Amount, COUNT(*) AS OrderCount FROM OrderHeader o WHERE o.PaymentMethod Cash AND CAST(o.ClosedAt AS DATE) Today;在SQL Server Agent中新建作业每天23:59执行此脚本结果邮件发送给财务邮箱用sp_send_dbmail。这样第二天早上老板打开邮箱报表已躺在收件箱。从那以后我每次接手餐饮类WPF项目都强制走一遍“数据库初始化→硬件配置→支付网关沙箱联调”三步验证哪怕客户说“我们不用微信支付”。因为支付模块的集成深度直接暴露了整个系统的扩展韧性——它不是堆砌功能而是把每个模块的输入输出契约刻在了代码的骨骼里。希望帮到你。本文还有配套的精品资源点击获取