行政后勤综合管理系统产品系统Vibe Coding

一、立项原因
重庆世纪精信机械制造有限公司为典型的制造型企业，一线员工占比超70%，后勤管理覆盖 工装库存 、 宿舍 、 食堂 三大核心业务。当前管理完全依赖 Excel 手工台账和纸质单据流转，存在以下突出问题：

1. 效率低下、数据不准 ：工装入库出库、宿舍入住退宿、食堂采购消费均靠人工记录，数据滞后且差错率高。
2. 信息孤岛严重 ：人事、工装、宿舍、食堂数据割裂，员工入转调离无法驱动后勤业务自动联动（如入职自动匹配工装型号、分配床位、开通就餐权限）。
3. 成本控制缺失 ：食堂采购无计划无比价、食材浪费严重；宿舍水电费人工抄表分摊、纠纷频发；工装以旧换新无追溯、回收率低。
4. 审计合规困难 ：后勤全流程缺乏数字化记录，无法满足企业合规审计要求。
综上，亟需构建一套统一的 行政后勤综合管理平台 ，实现三大业务全生命周期数字化闭环。

二、行业场景
场景一：宿舍与工装管理

企业自建多栋员工宿舍楼（涵盖单人间至六人间），管理链条包含：宿舍楼/房间/床位信息维护 → 员工入住/退宿/调换 → 设施报修工单流转 → 水电费抄表分摊核算 → 住宿费用结算。工装方面，覆盖型号管理 → 库存入库 → 按人员花名册自动匹配发放 → 以旧换新 → 差缺统计 → 采购计划。两者均需与员工花名册实时联动，实现"入转调离"全流程后勤自动化。

场景二：食堂管理

食堂需覆盖早中晚三餐及夜宵供应，日均就餐数百人次。业务链条包含：食材采购计划 → 供应商比价下单 → 验收入库 → 菜谱制定与发布 → 刷卡/扫码就餐消费 → 餐补按出勤自动核算 → 食材消耗与成本分析。食堂模块与人事考勤、宿舍入住数据深度联动：新员工入职自动开通就餐权限，离职自动清算余额，宿舍入住状态决定餐补发放资格，形成"人-住-食"一体化管理闭环。

平台围绕制造型企业后勤管理需求，构建了"工装—宿舍—食堂"三大业务一体化管理系统，并配套统一的权限与基础数据管理能力。

宿舍管理 是当前最完善的核心模块。系统以宿舍楼、房间、床位三级架构为基础，实时呈现各房间入住状态与空余床位；员工入住登记、退宿办理、床位调换全程在线流转，自动生成完整的入住记录流水。每间宿舍的设施设备（家具、电器、卫浴等）独立建档，维修工单支持从申报、派工、处理到完工的闭环追踪，每次操作自动沉淀审计日志。水电费方面，系统支持抄表数据录入，可按居住天数比例、人头平摊或固定金额三种模式自动计算分摊明细，生成个人缴费账单，并输出月度台账与缴费率统计。同时提供看板大屏，直观展示入住率、维修趋势、房间状态分布等关键指标。

工装库存管理 覆盖从型号建档、采购入库、员工按花名册自动匹配发放，到以旧换新全程追溯的完整生命周期。系统根据实时库存与人员需求自动生成差缺报表，为采购决策提供数据支撑。

食堂管理 作为后续规划模块，将实现食材采购计划与供应商管理、每周菜谱在线发布、刷卡/扫码消费记录、结合考勤数据自动核算餐补以及食材消耗与成本分析等功能，与宿舍入住和人事考勤数据深度联动，实现"人—住—食"一体化管理闭环。系统管理为上述业务提供统一的用户、角色、菜单、部门、字典和日志管理能力，支撑多角色权限下的协同作业。

## 项目实现

**个人职责**：作为全栈开发独立完成从需求调研到生产部署的全流程。调研阶段赴客户现场梳理工装、宿舍、食堂三大业务域，完成12张表的数据库建模与接口设计。开发阶段一人承担后端11个功能模块和前端11个页面的全部编码，部署阶段编写Docker Compose编排文件完成上线。

**技术栈与架构**：基于RuoYi-Vue-Plus 5.5.0的Maven多模块单体架构，后端Spring Boot 3.5.6 + MyBatis-Plus + MySQL 8.0 + Redis + Redisson，运行于Java 21并启用虚拟线程，前端Vue3 + Element Plus + Vite，通过Docker Compose编排MySQL、Redis、Nginx、MinIO及业务服务。

**水电费分摊难点与算法优化**：

第一个难点是**退宿日期缺失**导致已退宿员工仍参与分摊。员工退宿记录可能与入住记录的dormId不一致（如房间删除重建），系统通过分摊前先在内存中按退宿记录回填入住记录的退宿日期，并跨宿舍查询员工全量记录补充回填，确保入住区间闭合。

第二个难点是**核算周期内换宿舍**导致重复计费。优化方案将批量分摊拆为三轮：第一轮逐账单在独立事务内计算分摊明细；第二轮按费用类型加年月聚合同一员工跨宿舍的分摊记录，采用区间并集算法去重计算实际居住天数，统一归集到最新入住宿舍；第三轮统一刷新账单金额与状态。

第三个难点是**多种计费模式混合计算**。系统支持按用量计费、按人头固定收费（宽带、住宿、特定房间水费）、按天数比例分摊。算法通过费用类型编码多维度识别，分摊循环中走独立分支，最后执行尾差调整——将舍入误差补偿到末位分摊者，确保总额与账单分毫不差。