📋 鑫慧元工程施工管理系统

1 系统概述

鑫慧元工程施工管理系统是一套专为中小型施工企业打造的数字化管理工具，覆盖了工程项目从开工准备 → 采购物料 → 仓库管理 → 领用出库 → 施工进度 → 劳务结算 → 财务收支的全流程。

2 登录与首页

🔐 登录系统

第一次使用，请使用管理员账号登录系统（账号由系统管理员统一开通和分配）。

📊 仪表板首页

登录后第一眼看到的就是仪表板，它把所有重要信息集中展示在一页上：

仪表板主要分为以下几个区域：

• 顶部核心指标 — 项目总数、合同总额、采购单数、库存预警数量等
• 左侧区域 — 最近项目列表、待办事项提醒
• 右侧区域 — 快捷操作按钮、施工进度图表
• 左侧边栏 — 所有功能模块的导航菜单

🧭 侧边栏导航

屏幕左侧的竖条就是导航菜单，点击即可进入各个功能模块：

3 基础资料管理

基础资料是系统的"地基"，所有业务操作都依赖于这里的数据。一定要先建好基础资料！

📦 物料管理

管理所有施工用到的物料信息，包括物料分类。

🏪 供应商管理

管理为你供货的商家信息。

• 记录供应商名称、联系人、电话、地址
• 可设置结算方式（月结/现结/账期）和供应商评级（A/B/C）
• 支持填写信用代码和银行账户信息

👥 班组 & 人员管理

管理施工队（班组）和每个队里面的人员。

• 班组：先添加班组（如"张师傅水电班组"），设置班组负责人和电话
• 人员管理：在班组下面添加人员，记录姓名、身份证号（自动校验18位）、电话号码、工种和日工资

🏭 仓库管理

管理你的仓库信息，可以添加多个仓库。

• 设置仓库名称、地址和管理员
• 物料入库时必须选择存入哪个仓库

4 采购管理

📋 采购订单

采购流程：创建采购单 → 质检 → 收货入库

🔬 质检管理

质检是保证材料质量的关键环节。采购到货后，先检验再入库。

• 记录检验人和检验日期
• 可以上传检测报告和现场照片
• 检验结果分为"合格"和"不合格"
• 不合格的物料无法收货入库

🚚 批量收货分配

对于批量采购，支持更灵活的收货方式：

• 入仓：物料直接存入仓库
• 直送：物料直接送到工地项目上，系统自动生成领用单

5 库存管理

库存管理是系统的核心模块，涵盖入库、领用、盘点、退库、计划申报等完整功能。

📊 库存查询

查看所有仓库中每种物料的实时库存数量。可以通过关键字和仓库进行筛选。

📥 入库管理

查看所有入库记录，入库单关联采购订单。

📤 领用管理

各项目班组从仓库领取物料：

• 选择项目、班组、仓库，添加需要领用的物料和数量
• 领用后系统自动扣减库存（库存不足的物料会自动跳过）
• 领用单有"待确认"和"已确认"两种状态

📋 领用计划申报

施工班组提前申报领用计划，仓库按计划备料：

• 创建计划时填写物料和计划数量
• 实际领用时关联计划，系统自动计算"已领数量"和"未领数量"
• 方便管理层掌握即将使用的物料量

🔍 盘点管理

定期对仓库实物进行盘点：

• 新建盘点单，选择一个仓库
• 系统自动加载该仓库所有物料的账面库存数量
• 填写实际盘点数量，系统自动计算盘盈/盘亏
• 确认盘点后，库存自动按实际数量调整
• 支持从CSV文件批量导入盘点数据

↩️ 退库管理

施工结束后，未用完的物料退回仓库：

• 选择对应的项目和班组，关联原领用单
• 填写退库物料和数量，系统自动增加库存
• 退库后原领用单的领用数量不变，但库存恢复

6 项目管理

🏗️ 项目列表

管理所有工程项目的档案：

• 项目名称、地址、客户信息、联系方式
• 合同金额、合同编号
• 开工/竣工日期
• 项目状态：待开工/进行中/已完工/已取消
• 支持母子项目（如一个小区项目下面分一期、二期）

📄 项目详情页

点击项目名称，进入项目详情页面，集中查看该项目所有相关信息：

项目详情页聚合了该项目的：

• 采购订单 — 与该项目的所有采购记录
• 领用记录 — 该项目下的领用出库情况
• 劳务合同与进度 — 该项目的劳务合同、日进度、结算信息
• 成本利润 — 自动计算材料成本 + 人工成本，对比合同金额得出利润

📊 项目进度跟踪

项目详情页内置了进度跟踪模块，自动汇总每个节点的完成进度和项目总进度：

• 总进度条 — 顶部显示项目整体进度百分比，颜色随进度变化（灰→黄→蓝→绿）
• 节点进度列表 — 每个节点独立显示完成量/计划量 + 进度百分比 + 进度条
• 状态标识 — ✓已完成（绿色）/ ⟳进行中（蓝色）/ ⏳未开始（灰色）
• 数据来源 — 自动从日进度录入的完成量汇总，无需额外操作

📐 节点计划配置

每个项目可以单独设置各节点的计划量和单位，不同项目的同一节点互不影响：

• 在项目详情页展开"节点计划配置"面板
• 为每个节点设置本项目的计划量和单位（留空=使用全局默认值）
• 设置额定材料消耗（BOM） — 每完成一单位需要消耗多少材料
• 设置损耗预警阈值 — 损耗率超过此百分比时系统标红提醒
• 每个材料可单独设置预警阈值

📉 材料损耗分析

系统自动对比额定材料用量与实际领用量，计算损耗率：

• 额定用量 = 节点完成量 × 单位消耗（来自BOM配置）
• 实际领用 = 从领用单汇总该材料的领用数量
• 损耗率 = (实际领用 - 额定用量) / 额定用量 × 100%
• 预警机制 — 损耗率超过阈值时整行红色高亮显示
• 正常范围 — 绿色表示损耗可控，黄色表示偏高需关注，红色表示异常需核查

7 劳务管理

劳务管理是对施工队（班组）的合同、施工进度、结算进行全面管理。

📄 劳务合同

与班组签订施工合同：

• 关联项目和班组，约定单价（如每平米多少钱）和合同总金额
• 设置质保金比例（通常在5%-10%）
• 结算周期：按月结算

📅 施工日进度

每天记录班组完成的工程量：

• 选择项目、班组、日期，填写完成数量
• 可选填写材料使用量和人员人数
• 已结算的月份不可再编辑日进度

📊 月度汇总

按月汇总每个班组的总完成量：

• 系统根据日进度自动计算汇总数据
• 也可以手动保存汇总记录

💰 劳务结算

按月给班组结算工钱：

• 选择合同和结算月份，系统自动计算完成量
• 自动扣留质保金，计算实付金额
• 结算后记录到财务系统，用于后续付款
• 质保金管理：到期后可释放质保金

8 财务管理

💸 付款管理

记录给供应商和班组的付款：

• 支持两种收款方：供应商（付材料款）和班组（付人工费）
• 关联未付款的采购单或劳务结算单
• 付款后自动生成资金流水记录

💵 收款管理

记录从甲方（项目业主）收到的工程款：

• 填写收款金额、日期、关联项目
• 自动生成资金流水

🧾 发票管理

管理所有与项目相关的发票：

• 采购发票：供应商开给我们的发票（需要收回）
• 销售发票：我们开给甲方的发票（需开具）
• 在仪表板上会预警"未收回的发票"和"未开具的发票"

💱 资金流水

查看所有资金的收入和支出流水，可按日期范围筛选，自动统计收支汇总和分类统计。

9 经营费用报销

管理日常经营中的费用报销，支持完整的审核流程：

10 成本分析

成本分析页面按项目展示详细的成本数据：

• 合同金额：与甲方签订的总金额
• 材料成本：该项目所有采购订单的累计金额
• 人工成本：该项目所有劳务结算的累计金额
• 利润与利润率：自动计算（合同金额 - 材料成本 - 人工成本）

11 工程报审

工程报审功能支持施工过程中的节点报审和项目完工后的竣工报审，覆盖施工方报审→监理审批的完整流程。

📋 节点报审

施工过程中每个关键节点完成后，由施工方报请监理验收：

• 预置节点：地基验槽、钢筋工程、混凝土工程、支架安装、组件安装、电气安装、防水工程、管道试压、系统调试等
• 自定义节点：可选择"其他"手动输入自定义节点名称
• 资料清单：每个节点预置了对应的资料清单，可设置每项为必填/非必填/不填

🏁 竣工报审

项目全部完工后的最终验收报审：

• 提交竣工资料（竣工图、施工总结、质量验收资料等）
• 监理初验、整改、正式验收全流程

📄 资料清单管理

每份报审都带有资料清单，审批时可逐项标记：

• 必填 — 必须提供的资料
• 非必填 — 有则提供，无则跳过
• 不填 — 该资料不适用于本次报审（行变淡隐藏）

⏰ 审批时限与超时预警

新建报审时可设置审批时限（天），系统自动计算截止时间：

• 超时后自动红色标记 ⚠
• 到期前24小时黄色预警预警 ⏰
• 仪表板实时显示待审批数、已超时数、即将超时数

👪 母子项目支持

• 子项目：可以单独提交报审
• 母项目：统一查看所有子项目的报审情况
• 项目详情页：底部直接展示该项目所有报审记录

12 系统管理

系统管理功能只有管理员可用，用于维护系统运行。

👤 用户管理

管理系统的登录用户：

• 新增用户：设置用户名、密码、姓名、电话
• 设置角色：管理员（全部权限）或普通用户
• 细粒度权限：普通用户可以精细控制每个模块的查看/编辑/删除权限
• 可启用/禁用用户账号

📋 操作日志

系统自动记录所有用户的操作行为，如"新增物料"、"创建采购单"等，方便追溯。

📦 数据导入导出

管理员可以：

• 导出数据：将所有业务数据导出为ZIP文件，用于备份
• 导出模板：获取CSV模板，按要求填写后批量导入
• 导入数据：上传填好的ZIP压缩包，批量导入数据

📷 数据快照

在重要节点手动保存当前所有数据的"快照"，之后可以：

• 查看快照详情
• 对比两个快照之间的差异（新增/删除/修改了哪些数据）

🖨️ 打印模板

系统支持8种单据的打印（采购单、领用单、劳务结算、盘点单、日进度、付款单、收款单、发票等），你可以自定义打印模板的格式和内容。

🎨 主页布局

管理员可以自定义仪表板的布局：

• 显示/隐藏各个模块（核心指标、快捷操作、施工进度等）
• 修改侧边栏的导航标签文字
• 切换主题颜色（6种预设主题）

📎 附件上传配置

管理员可以自定义每个模块的附件上传提示文字：

• 标题文字 — 如"项目附件"、"图纸文件"、"资质文件"等
• 提示文字 — 小字提示用户应该上传什么类型的文件（如"合同文档、现场照片"）
• 文件格式 — 限制可上传的文件类型（如 .pdf,.jpg,.dwg）
• 共支持18个模块的附件区域单独配置，修改后全局立即生效

13 常见问题

14 项目结算与质保金

项目结算功能支持项目完工后的最终结算管理，以及质保金的全生命周期跟踪。

💰 项目结算

• 创建结算：从项目详情页或项目结算管理模块创建结算单，填写结算金额、结算日期等信息
• 审核流程：结算单创建后可在审核中心进行审批
• 自动关联：工程报审通过后自动生成结算草稿

🔒 质保金管理

• 质保金设置：在项目管理中可设置每个项目的质保金比例（默认5%）、金额和到期日期
• 质保金提醒：系统自动计算质保金到期日，质保金模块按 已到期（红色）、即将到期（黄色，30天内）、正常（绿色） 三级预警
• 质保金返还：到期后操作质保金返还，记录返还金额和日期

15 项目甘特图

项目甘特图以可视化方式展示每个项目的工程节点时间计划，直观查看各节点的起始日期和完成进度。

📊 功能特点

• 节点时间轴：每个节点以横条形式展示计划开始→结束时间
• 进度展示：节点横条根据完成进度填充颜色（0%灰色 → 100%蓝色）
• 今日标记线：甘特图中自动显示一条红色"今日"竖线
• 多项目切换：通过下拉选择器查看不同项目的甘特图

📝 节点管理

在"系统管理 > 工程节点"中设置节点的计划开始日期、计划结束日期和进度百分比，甘特图自动刷新。

16 审核中心

审核中心是系统中所有待审核项的统一看板，方便集中处理各类审批请求。

支持以下类型的审核：

• 采购申请 — 采购申请单的审批
• 采购订单 — 采购订单的审批
• 劳务结算 — 班组结算的审批
• 项目结算 — 项目最终结算的审批
• 费用报销 — 费用报销单的审批
• 库存调拨 — 库存调拨申请的审批
• 维护记录 — 维护维修记录的审批

审核中心上方显示各类待审核项的汇总卡片，点击即跳转到对应模块的待审列表进行审批操作。

17 图纸与联系人管理

📐 图纸管理

图纸管理用于集中存储和管理项目的各类工程图纸：

• 多文件上传：支持一次选择多个文件同时上传，支持 PDF、DWG、DXF、图片（JPG/PNG等）、ZIP 等格式
• 附件管理：上传的图纸文件以附件形式存储，可在线查看/下载、随时追加新文件
• 图纸信息：记录图纸名称、图纸编号、类别（施工图/竣工图/平面图等）、版本号、所属项目等信息
• 编辑维护：编辑图纸时可以追加新文件，也可以删除已有文件，每个文件独立管理
• 列表展示：图纸列表中"附件"列直接显示文件链接，多个文件分别可点击查看

📞 工程联系人

记录项目中各参与方（甲方、监理、设计院、施工方等）的联系信息：

• 联系人姓名、电话、所属单位、职务
• 关联到具体项目，方便快速查找

18 维护管理

维护管理用于记录项目交付后的维护维修记录，支持与质保期关联。

🛠️ 功能说明

• 创建维护单：记录维护编号、维护内容、维护类型（日常/紧急/保修）、维护费用等
• 关联质保：维护记录可关联到项目的质保期
• 审核流程：维护记录创建后可在审核中心进行审批
• 项目详情：项目详情页底部直接展示该项目的维护记录

19 版本更新记录

V2.61（当前版本）

• 新增：材料损耗分析 — BOM配置 + 额定用量 vs 实际领用对比 + 可设阈值预警
• 新增：项目进度跟踪 — 节点进度条 + 项目总进度条，自动从日进度汇总
• 新增：项目节点计划可独立设置 — 每个项目单独配置各节点的计划量和单位
• 新增：附件上传文字配置 — 管理员后台可自由设置每个模块的附件提示文字
• 新增：项目编辑弹窗增加附件上传
• 优化：工程节点单位改为自由输入（支持datalist建议）
• 优化：图纸管理支持多文件上传（复用通用附件系统）
• 修复：审核中心SQL双引号与异常保护深度修复

V2.58

• 修复：审计中心网络错误（排序None值+SQL双引号问题）
• 修复：项目结算管理列表加载失败（缺少路由装饰器）
• 优化：图纸管理改为多文件附件上传，支持PDF/DWG/图片等
• 优化：月度汇总与日进度节点保持一致，按工程节点分组汇总
• 优化：库存管理列表显示最低储量及库存预警标识

V2.57

• 新增：审核中心 — 7种待审核项统一看板
• 新增：采购申请管理 — 采购申请→采购订单转换
• 新增：库存调拨管理 — 跨仓库调拨自动更新库存
• 新增：工程联系人管理
• 新增：维护管理 — 维护维修记录
• 修复：多项安全加固（权限检查、错误信息隐藏）

V2.56

• 新增：项目结算管理 — 结算单创建、编辑、审核
• 新增：质保金管理 — 质保金设置、到期提醒、返还记录
• 新增：项目甘特图 — 工程节点时间轴可视化