筑信工程管理系统

版本：v1.0.7 测试版（Beta）
状态：功能完整，已通过全部自动化测试，欢迎试用反馈
文档日期：2026-08-18

目录

1. 软件简介
2. 版权与版本信息
3. 系统要求
4. 功能特性总览
5. 安装教程
6. 快速入门
7. 模块使用教程
8. 数据备份与恢复
9. 常见问题（FAQ）
10. 测试报告
11. 版本更新记录
12. 用户协议
13. 隐私协议
14. 版权声明
15. 联系我们

1. 软件简介

筑信工程管理系统是一款面向中小型施工企业的纯本地桌面管理软件，覆盖加油站建设、装修工程、维修工程等业务场景，提供从客户跟进、商机管理、合同签订、项目施工、物资采购、成本核算、质量安全监督到售后档案的全流程数字化管理。

核心亮点：

• 🔒 纯本地运行：所有数据存储在本机，不上传任何服务器，隐私安全有保障
• 📦 免安装部署：绿色版双击即用，无需配置服务器和数据库
• 🖥 桌面软件体验：三栏布局 + 多标签页，操作流畅，支持快捷键
• 📊 数据驱动决策：8 张核心报表 + 仪表盘 + 客户统计 + 成本图表，经营状况一屏掌握
• 🛡 工程安全专项：加油站动火作业审批、安全隐患闭环管理、证照/检测到期自动提醒
• 🎯 客户经营闭环：客户档案 → 跟进 → 商机漏斗 → 回款台账 → 转介绍，客户不漏单

2. 版权与版本信息

版本说明： 本版本为功能完整的测试版，全部核心功能已实现并通过自动化测试（168/168 通过）。测试版可能存在未知问题，欢迎反馈，正式版将根据反馈持续优化。

3. 系统要求

说明：本软件为纯本地应用，安装后无需联网即可使用全部功能；仅「报表中心 Excel/PDF 导出」依赖本机 Python 环境（系统会自动探测可用的 Python）。

4. 功能特性总览

本系统包含 16 大功能模块：

5. 安装教程

方式一：安装包安装（推荐）

1. 双击运行 筑信工程管理系统-安装包-v1.0.7.exe

2. 跟随全中文安装向导：

   • 点击「下一步」→ 阅读协议 → 同意
   • 选择安装位置（默认：D:\筑信工程管理系统，可自由选择其他路径）
   • 选择附加任务（桌面快捷方式等）
   • 点击「安装」→ 等待完成 → 点击「完成」
3. 安装完成后自动启动，或双击桌面快捷方式

💡 提示：覆盖升级请选择原安装目录（数据保留）；装到新目录为全新安装。

方式二：绿色免安装版

1. 解压 筑信工程管理系统-免安装版.zip
2. 双击文件夹内的 ZhuXinApp.exe
3. 即可直接使用（数据保存在程序目录 data 文件夹）

卸载方法

• 开始菜单 → 「卸载筑信工程管理系统」，或
• 控制面板 → 程序和功能 → 找到筑信工程管理系统 → 卸载

6. 快速入门

6.1 首次登录

首次登录流程：

1. 打开软件，输入账号 admin、密码 admin123
2. 系统检测到初始密码，自动弹出「修改密码」对话框
3. 设置您自己的新密码（至少 6 位）并确认
4. 修改成功后自动进入系统主界面，默认打开「仪表盘」

6.2 主界面说明

┌──────────────────────────────────────────────────────┐
│ 顶栏：系统名 | 全局搜索 | 改密🔑 | 关于ℹ | 退出        │
├──────────┬───────────────────────────────────────────┤
│ 左侧导航  │  内容区（多标签页，可同时打开多个模块）      │
│ 16个模块  │                                           │
├──────────┴───────────────────────────────────────────┤
│ 状态栏：当前用户 | 角色 | 数据库状态 | 日期             │
└──────────────────────────────────────────────────────┘

6.3 管理员常用操作

• 新增用户：系统管理 → 用户管理 → 「＋ 新增用户」（默认密码 admin123）
• 用户改密/禁用：系统管理 → 用户管理 → 对应行的操作按钮
• 备份数据：系统管理 → 备份管理 → 「立即备份」（强烈建议每周一次）
• 配置公司抬头：系统管理 → 公司信息 → 填写名称/地址/电话/银行/税号（打印单据自动带出）
• 查看日志：系统管理 → 操作日志

7. 模块使用教程

7.1 客户管理（v1.0.7）

1. 左侧「📇 客户管理」→「客户档案」Tab →「＋ 新增客户」
2. 填写：客户名称（必填）、类型（新建/装修/维修/潜在）、联系人/电话/微信、区域、价值分级（A/B/C）、信用评级、合作年限、生日/开业纪念日
3. 「跟进记录」Tab：选客户 →「＋ 新增跟进」（电话/上门/微信，填沟通内容+下一步计划+下次跟进日期）；下次跟进日期逾期自动标红
4. 「商机漏斗」Tab：新增商机（名称/阶段/金额），点「推进 ▶」逐步流转：潜在需求→已报价→已中标→施工中→已完工→已回款
5. 「回款台账」Tab：选客户查看其名下合同收款节点，逾期自动标红"逾期!"
6. 「转介绍」Tab：登记老客户介绍的新客户，成交/未成状态 + 介绍费
7. 「客户统计」Tab：客户总数/潜在数/A级数/应收未收总额 + 区域分布图

7.2 加油站档案库（v1.0.7）

1. 左侧「⛽ 加油站档案」→「＋ 新增站点」（站名/公司/老板/区域/油品/油罐/加油机）

2. 选中站点后右侧 4 个 Tab：

   • 生命周期：登记建站/装修/维修/改造/翻新事件（日期/内容/金额），形成完整时间线
   • 设备台账：登记油罐/加油机/管线/油气回收/消防/防爆设备（品牌/型号/安装日期/年限）
   • 到期提醒（核心）：登记检查项，系统自动算下次日期——油罐强检 8 年、清洗 2 年、消防/防爆年检 1 年；逾期标红、30天内临期标橙
   • 巡查记录：登记现场检查，发现问题可「标记整改」
3. 到期提醒就是"自动销售员"：油罐快到期提前联系客户安排检测/清洗，单子自己送上门

7.3 项目管理

1. 点击左侧「📁 项目管理」→「＋ 新建项目」
2. 填写：项目名称（必填）、类型、甲方、合同金额、预算金额（开工前必填）、工期
3. 项目编号可自动生成（GC-年份-流水），也可手动输入（自动查重）
4. 保存后点击「详情」进入项目详情页
5. 在详情页添加 WBS 任务（输入任务名 + 权重%），点「＋ 一级任务」或「＋ 子任务」
6. 施工员上报叶子任务进度（选中任务 →「上报进度」）
7. 父级任务和项目总进度自动汇总，无需手动计算
8. 项目状态流转：立项 → 开始施工 → 标记完工（需进度100%）→ 验收 → 归档
9. 详情页另有：⛽ 专项信息 / 📜 证照 / 📈 甘特图 / 🖨 验收单打印

7.4 物资采购（闭环流程）

材料计划 → 创建采购单（选项目/供应商/添加材料明细）
→ 提交审批 → 批准/驳回 → 到货入库 → 库存自动增加

1. 物资管理 → 材料档案：先维护材料库（编码/名称/规格/单位/参考价/安全库存/常用品牌）
2. 供应商：维护供应商（可拉黑，黑名单不可选）
3. 新建采购单：选择项目、供应商，逐条添加材料（数量+单价），合计自动计算
4. 提交后状态为「待审批」，点击「批准」通过
5. 批准后点击「到货入库」，库存自动增加
6. 出库领料：在库存管理中操作（强关联项目+任务，成本可追溯）

7.5 价格库比价与库存预警（v1.0.7）

1. 「物资管理」→「价格库比价」Tab：选材料 →「＋ 新增报价」（多家供应商报价）；报价自动按价格升序，最低价高亮
2. 「库存预警」Tab：低于安全库存的材料自动列出（建议补货）；同材料连续涨价超 10% 自动预警（建议提前囤货）

7.6 成本管理

1. 点击「💰 成本财务」→ 顶部选择项目
2. 「编制预算」：输入预算金额（按材料/人工/机械/分包分类）
3. 「登记支出」：记录实际支出（类型/金额/收款方），支持编辑/删除
4. 「登记收入」：记录工程款/结算款/材料回收/其他收入
5. 顶部实时显示：收入 vs 预算 vs 支出 vs 利润，超支/亏损自动标红
6. 图表区：分项对比柱状图（预算vs实际）+ 月度支出趋势折线图
7. 「收入管理」Tab：收入流水台账（增删改查）

7.7 做工统计（v1.0.6）

1. 「👷 人员劳务」→「做工统计」Tab →「打卡记录」
2. 选工人 → 「⬆ 上班打卡」记录上班时间；下班时点「⬇ 下班打卡」
3. 工时自动计算（支持跨天夜班），超 8 小时自动记为加班
4. 可补卡：修改日期/时间后打卡
5. 「统计汇总」Tab：选月份 + 项目 →「统计」，查看每人出勤天数/总工时/总加班

7.8 打印单据（v1.0.4）

1. 先配置抬头：系统管理 → 公司信息 → 填写公司名称/地址/电话/银行/税号

2. 打印入口：

   • 采购单列表 →「打印」→ 采购单
   • 合同列表 →「封面」→ 合同封面
   • 质量安全隐患列表 →「打印」→ 隐患整改单
   • 工资结算 →「打印」→ 工资条
   • 项目详情 →「🖨 验收单」→ 验收单
3. 预览窗口：所见即所得，可「🖨 打印」或「📄 导出 PDF」
4. 所有单据金额小写 + 中文大写双显示

7.9 安全隐患闭环

1. 「🛡 质量安全」→「＋ 上报隐患」（选项目/描述/等级/责任人/整改期限）
2. 隐患状态「未整改」→ 点「整改」填写整改说明 →「已整改」
3. 安全员「复查通过」→ 销号；「复查不通过」→ 退回整改
4. 超期未整改自动标红，并进入消息中心提醒

7.10 维修工单

1. 「🔧 维修工单」→「＋ 新建工单」（客户/故障/优先级）
2. 「派单」（自动推荐空闲维修工）→ 维修工「接单维修」→「完成维修」（填结果+费用）
3. 客户「验收」（评分 1-5）→「完成回访」
4. 全程状态可视化：待派单→已派单→维修中→待验收→已完成→已回访

7.11 报表与导出

1. 「📊 报表中心」→ 选择 8 张报表之一（进度/成本/收支/工单/库存/工资/隐患/回款）
2. 点击「导出 CSV / Excel / PDF」选择保存位置
3. Excel/PDF 导出由 Python 服务生成（系统自动探测可用的 Python 解释器），格式专业

7.12 数据导入

系统管理 → 数据字典 → 支持 CSV 批量导入（工人/材料/供应商）：

• 工人：姓名,身份证号,工种,电话,体检(0/1)
• 材料：编码,名称,规格,单位,分类,参考价
• 供应商：名称,联系人,电话,地址,资质证号

使用 Excel 编辑后「另存为 CSV（UTF-8）」，再用系统导入即可。

8. 数据备份与恢复

备份（强烈建议每周执行）：

1. 系统管理 → 备份管理 → 「立即备份」
2. 备份文件自动保存到 backups 目录（zip 格式，含数据库+附件）
3. 系统自动保留最近 10 份备份，旧备份自动清理

恢复：

1. 系统管理 → 备份管理 → 选择备份文件 → 「恢复」
2. 确认后数据恢复至备份时状态

⚠️ 重要提醒：本软件为纯本地存储，硬盘损坏或误删将导致数据丢失，请务必定期备份！

9. 常见问题（FAQ）

Q1：忘记密码怎么办？
A：请联系系统管理员，在「系统管理 → 用户管理」中对您的账号点击「重置密码」，密码将重置为 admin123。

Q2：账号被禁用了怎么办？
A：管理员在用户管理中点击「启用」即可恢复。

Q3：登录提示"用户名或密码错误"？
A：检查账号是否启用、密码是否正确。初始密码 admin123，首次登录后已修改的请使用新密码。

Q4：Excel/PDF 导出提示失败？
A：导出依赖 Python 环境，系统会自动探测（py launcher → python → 常见安装路径）。请确认本机已安装 Python 3.10+ 及 openpyxl、reportlab 库（本机已内置指引；软件会自动选择带依赖的 Python）。

Q5：数据存在哪里？
A：数据库文件在程序目录 data/eng_mgmt.db，附件在 attachments 目录。请勿手动修改数据库文件。

Q6：可以多人同时使用吗？
A：当前版本为单机版。多人协作请在同一台电脑上轮换使用，或关注后续局域网版。

Q7：会联网上传我的数据吗？
A：不会。本软件纯本地运行，除"功能外跳转支持链接"外不发起任何网络请求，您的数据完全留在本机。

Q8：升级新版本会不会丢数据？
A：不会。覆盖安装保留原目录 data 文件夹；系统也自带备份功能。升级前建议先「立即备份」。

10. 测试报告

10.1 测试结论

10.2 测试覆盖范围

单元测试（21 个测试类）：

• 认证模块（登录/密码哈希/改密）：5 项
• 项目管理（编号/查重/状态机/工期）：10 项
• 合同管理（编号/必填/筛选）：5 项
• 材料管理（编码/精度/搜索/安全库存/品牌）：6 项
• 采购+库存（闭环/库存不足/预警）：7 项
• 供应商+收付款（黑名单/超期预警）：6 项
• 成本模块（预算/支出/超支偏差/编辑/删除/月度趋势）：11 项
• 收入登记（增删改/利润计算/校验）：5 项
• 做工统计（打卡/工时加班计算/按月统计）：5 项
• 人员劳务（考勤/日薪计件双制）：8 项
• 安全隐患（闭环/超期）：7 项
• 设备+作业票（动火审批）：6 项
• 维修工单（状态机全流转）：6 项
• 报表（8张/CSV导出）：5 项
• 消息中心（聚合提醒）：3 项
• 备份恢复（闭环）：4 项
• 加密模块（加解密闭环）：3 项
• Excel 导入（BOM/重复处理）：3 项
• 金额大写（元角分/负数/万级）：6 项
• 打印模板（7模板/无CSS泄漏/抬头逻辑）：9 项
• Python 导出（Excel/报表PDF/文档PDF）：3 项
• 加油站档案库（站点/生命周期/设备/到期状态/巡查）：5 项
• CRM（客户/跟进/商机/转介绍/统计）：5 项
• 材料价格库（比价/涨价预警/低库存/校验）：5 项

集成测试（21 项）： 登录→项目→WBS→合同→收付款→材料→供应商→采购→库存→成本→工人→工资→隐患→设备→作业票→工单→日志→施工日志→报表→消息→导入，全链路一条龙验证。

界面验收： 登录页（品牌图/Logo/表单）、主框架（顶栏/导航/标签页/状态栏）、16 个模块界面加载无异常。

10.3 已知说明

• 本版本为测试版，可能存在未覆盖的边界情况，欢迎反馈
• C 加密模块在本机受安全软件拦截时自动降级为 Java 实现（功能一致）
• 报表/单据 PDF 导出依赖 Python reportlab 库（系统自动探测可用解释器）

11. 版本更新记录

完整版本历史与各版本更新详情见《筑信工程管理系统-更新文档.md》，此处为摘要。

v1.0.7 核心更新：

1. 加油站网点档案库：站点档案/生命周期时间线/设备台账/到期提醒（油罐强检8年、清洗2年、消防年检，自动算下次日期，逾期标红）/巡查记录
2. 客户关系管理（CRM）：客户档案（微信/企业性质/区域/价值/信用/生日）/跟进记录+逾期提醒/商机漏斗六阶段/回款台账逾期标红/转介绍/客户统计
3. 材料供应商增强：价格库比价（最低价高亮）/涨价预警（超10%提醒囤货）/安全库存预警/材料品牌字段

v1.0.6 核心更新： 收入登记（分类收入流水+利润显示）、做工统计（上下班打卡自动算工时加班、按月按人统计）

v1.0.5 核心更新： 成本分项对比柱状图、支出编辑/删除、月度支出趋势折线图

v1.0.4 核心更新： 7 种单据打印模板（采购/领料/工资条/结算/验收/整改/合同封面）、公司信息抬头设置、金额中文大写自动转换、HTML 预览+PDF 导出双通道

12. 用户协议

欢迎使用「筑信工程管理系统」（以下简称"本软件"）。在使用本软件前，请您仔细阅读并充分理解本协议全部内容。

您安装、登录或使用本软件，即视为您已阅读并同意接受本协议全部条款的约束。

一、软件许可

1. 本软件为本地化工程管理工具，授权您在其自有设备上安装、使用。
2. 本软件按「现状」提供，作者不承诺软件永久可用或适配所有硬件环境。
3. 未经作者书面许可，不得对本软件进行反向工程、反编译、破解或用于商业再分发。

二、账号与安全

1. 系统账号由管理员统一创建，初始密码为系统默认密码，首次登录后应尽快修改。
2. 用户应妥善保管账号密码，不得将账号出借或转让给他人使用。
3. 因密码泄露、保管不当导致的数据损失或业务风险，由用户自行承担。
4. 管理员可对账号进行禁用、重置密码等管理操作。

三、数据管理

1. 本软件所有业务数据（项目、合同、人员、成本、质量安全等）存储于本地数据库。
2. 用户应定期使用系统内置的备份功能备份数据，防止数据丢失。
3. 删除数据将不可恢复（系统采用逻辑删除策略，可通过恢复备份找回）。
4. 建议对数据库文件及备份文件进行妥善保管和加密保护。

四、使用规范

1. 用户应合法使用本软件，不得利用本软件从事任何违法活动或侵犯第三方合法权益。
2. 用户应如实录入业务数据，因录入虚假、错误信息造成的后果由用户自行承担。
3. 不得干扰、破坏本软件的正常运行，不得植入恶意代码。

五、免责声明

1. 本软件仅供业务管理参考，不构成任何法律、财务、工程安全等方面的专业意见。
2. 因不可抗力、设备故障、数据丢失等原因造成的损失，作者在法律允许范围内不承担赔偿责任。
3. 软件依赖第三方组件（如 Java 运行时、SQLite、Python 环境），相关风险由对应提供方承担。

六、知识产权

1. 本软件的名称、界面、代码、文档等知识产权归作者（吴钧泽）所有。
2. 用户在使用过程中录入的业务数据，其所有权归用户或用户所在单位所有。

七、协议变更与终止

1. 作者有权根据需要修订本协议，修订后将在软件内更新展示。
2. 用户违反本协议时，作者有权终止其使用权限。

八、联系我们

如对本协议有任何疑问，可通过支持链接 https://lxqgf.cn/ 联系作者。

13. 隐私协议

我们深知个人信息对您的重要性，并会尽全力保护您的个人信息安全。本协议旨在向您说明本软件如何收集、使用、存储和保护您的信息。

您使用本软件即视为您已同意本协议的全部内容。

一、信息收集范围

1. 账号信息：登录名、姓名、手机号、邮箱、角色等（由管理员录入或您自行填写）。
2. 业务信息：您在系统中录入的项目、合同、人员、材料、成本、质量安全、客户等业务数据。
3. 系统日志：操作记录（谁在何时执行了什么操作），用于审计追溯。

二、信息存储方式

1. 本软件为纯本地应用，所有数据存储于您本机设备的 SQLite 数据库中。
2. 数据不经过任何外部服务器，不上传至云端，不发送至任何第三方。
3. 附件（图纸、合同扫描件、站点照片等）存储于您本机的附件目录。

三、信息使用目的

1. 仅用于工程业务管理：项目跟踪、进度管理、成本核算、质量安全监督、客户经营等。
2. 系统日志仅用于操作审计和数据追溯。

四、信息安全保护

1. 密码采用加盐哈希（SHA-256）存储，不保存明文密码。
2. 系统提供备份与恢复功能，备份文件由您自行选择存放位置并妥善保管。
3. 建议您对存放数据库和备份文件的磁盘进行加密或访问控制。

五、信息共享与披露

1. 本软件不会向任何第三方出售、出租或共享您的个人信息和业务数据。
2. 除非法律法规要求或您主动授权，否则不会对外披露。

六、您的权利

1. 您有权查看、修改您在系统中录入的个人信息。
2. 您有权导出、备份您的业务数据。
3. 您有权删除本地数据库及备份文件（删除前请确认已妥善备份）。

七、未成年人保护

本软件面向工程管理场景，不建议未成年人独立使用；若未成年人使用，应在监护人指导下进行。

八、协议变更

本协议可能随软件功能更新而修订，修订后将在软件内展示，继续使用即视为接受修订后的协议。

九、联系我们

如您对本隐私协议有任何疑问或建议，可通过 https://lxqgf.cn/ 联系作者（吴钧泽）。

14. 版权声明

© 2026 吴钧泽 版权所有。保留所有权利。

本软件（包括但不限于软件名称、程序代码、界面设计、文档、图标等）受《中华人民共和国著作权法》及相关国际公约保护。

未经版权所有者书面许可，任何单位和个人不得：

• 复制、传播、出租、出借本软件或其任何部分
• 对本软件进行反向工程、反编译或试图提取源代码
• 修改、篡改、删除软件中的版权标识
• 将本软件用于商业再分发或捆绑销售

用户在使用过程中产生的业务数据归用户所有，但数据的组织方式、软件功能设计及相关技术方案归版权所有者所有。

免责声明： 本软件按「现状」提供，作者不承担因使用本软件产生的任何直接或间接损失的责任。使用本软件即表示您已理解并同意上述条款。

15. 联系我们

期待您的反馈，帮助我们做得更好！

文档结束 | 筑信工程管理系统 v1.0.7 测试版 | © 2026 吴钧泽