本项目为 PrintBiz 桌面业务管理系统,面向中小商家/工作室日常经营场景,提供“基础资料—业务单据—成本用料—统计分析”的闭环能力。桌面端支持材料与商品档案维护、订单创建/编辑/查询、按订单录入用料与成本、关键指标统计与报表展示等功能;通过配置 API 地址与 API-Key 连接后端服务,实现数据统一存储与多端一致性。主要功能路径:先维护材料/商品等基础数据,再创建订单并录入用料/成本,提交后由后端落库,最终在统计模块按时间/商品/订单维度汇总展示,为经营决策与成本核算提供依据。
项目采用前后端分离架构:桌面端使用 Electron + React + Vite 实现跨平台客户端与业务界面,调用后端 Spring Boot 提供的 REST API 完成数据读写;后端对材料、商品、订单、用料、统计等业务域进行接口拆分与服务封装,使用 MySQL 持久化,支持基于 API-Key 的接口鉴权(生产开启,开发可按需关闭),并提供健康检查接口用于连接检测。开发协作上按“桌面端/服务端”两个子工程独立构建与启动:后端使用 Maven profile 启动开发环境,桌面端通过 npm 脚本一键启动 Vite 与 Electron 联调;难点主要在 Electron 开发环境的依赖安装与启动编排(等待前端服务就绪后再拉起 Electron)以及鉴权与配置管理(API 地址、Key 在设置页可配置并联通测试)。