全屋定制计件管家系统产品系统

本项目是为一家全屋定制家具制造厂量身定制的生产管理系统。该企业采用“前端门店接单、后端工厂生产”的运营模式，每张订单会被拆解为数十乃至上百块板材，进入工厂流水线。在长期的生产管理中，企业积累了三大实际痛点：一是计件工资不透明，工人薪资依赖班长人工统计，按块数或面积估算，漏记、错记及人情账频发，工人与老板之间缺乏可信的核算依据；二是工序责任难以追溯，板材需依次经过开料、封边、侧孔、质检、打包五道工序，一旦出现缺件、尺寸错误或划伤等问题，无法准确定位是哪个工位、哪位工人或哪一批次造成的；三是生产瓶颈难以发现，生产依赖纸质流转单和口头沟通，管理层无从得知哪个工位积压、哪位工人效率高低、订单能否按期交付，排产只能凭经验。为解决上述问题，本项目以“一板一码、扫码流转、按件计酬”为核心理念，将传统作坊式生产升级为数字化、可量化、可追溯的透明化管理。

系统按该企业车间的实际流程定制开发，业务背景是其特有的“多工位串并行流水线”。板件以“客户+颜色+批次”为维度进行组织，一个批次对应一张订单的多块板材；生产流程固定为待开料、开料、封边、侧孔、质检、打包、完成七个环节，五个主要工位可由不同工人并行承接。每道工序产生独立的计件记录（完成块数乘以工序单价），最终汇总为工人的日、周、月计件工资。质检环节支持不合格品回退到前序工序，确保质量闭环。上游则衔接企业使用的海迅等拆单软件，通过导入其导出的板材清单（Excel格式）批量录入数据，大幅减少重复录入工作。

在功能构建上，系统划分为八大核心模块。底层支撑包含用户认证与权限管理模块，采用JWT登录及Refresh Token自动续期机制，并基于RBAC模型实现了用户、角色、菜单及部门的精细化权限管控，配套完整的系统管理功能以维护基础数据。在业务操作层面，设有物料管理模块，负责板材主数据的维护，支持按客户、颜色及批次进行组织，并可衔接上游拆单软件实现Excel批量导入；面向车间一线，则部署了开料、封边、侧孔、质检、打包五个独立的工人工作站界面，支持扫码领料与工序上报。在数据汇总与决策层面，系统提供统一工作台仪表盘，按角色展示待办任务与生产概览；工时与计件记录模块自动归集每块板材的工序完成详情；报表中心可生成日报、周报及月报，涵盖产量、工资、合格率与工位积压情况；此外，公告管理模块用于发布生产通知与制度文件。

在核心业务流程上，系统通过工序状态机实现严谨的流转控制。板材状态严格遵循“待开料→开料→封边→侧孔→质检→打包→完成”的路径演进，各工位仅能操作自己负责的状态节点，完成即自动流转至下一工位，从机制上杜绝了跳序与越权操作。在计件工资核算方面，每完成一块板材便自动生成一条包含工人、工序、件数及单价的计件记录，系统可按日、周、月自动汇总工资，并支持按工位、工人、批次及时间等多维度查询统计。针对上游数据衔接，系统支持从Excel直接导入板材清单，与海迅等拆单软件的导出格式无缝对接，大幅降低了手工录入成本与差错率。在质量管控上，质检环节构建了完整闭环——检验不合格时可标记并回退至对应工序，形成“检验—退修—复检”的可追溯流程，退修记录有据可查。最终，通过透明化报表中心，老板与班组长可实时掌握各工位产量、工资及积压状况，为科学排产与绩效考核提供了坚实的数据依据。

我负责的核心任务

前端：五大工人工作站（扫码领料、开工/完工上报）、主布局、路由及权限菜单；

业务逻辑：工序状态机（5套操作Hook，控制流转与回退）；

数据链路：完成上报→计件记录→工资汇总；

功能模块：Excel批量导入（前端流程+后端解析）；

认证体系：Token存储、自动刷新、重试、幂等键及权限API封装；

质量保障：Vitest单元测试 + Playwright E2E测试框架搭建及关键用例编写。

技术栈

前端：React 18 + TS + Vite 5 + Ant Design 5（管理端）+ Tailwind（工人端）+ Zustand

后端：Spring Boot 3.2 + Java 21 + JPA + Flyway

数据库：MySQL 8.0（开发H2）

安全：JWT + Refresh Token

测试：Vitest + Playwright

部署：Docker Compose，前端内嵌后端JAR单包部署

架构亮点（简）

双UI适配（管理端AntD，工人端大按钮触屏）；

单JAR交付，适合内网；

API层自动重试+幂等键，应对弱网；

Flyway管理35个迁移脚本，13张表版本演进。

难点与对策（简）

状态机并发与回退：按状态节点锁权限+严格校验；

计件工资多口径：落库时固化单价和时间；

双用户兼容：兼容层平滑过渡；

弱网一致性：幂等键+重试防重复/丢失。