筑信工程管理系统 — 产品文档

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

目录

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

1. 软件简介

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

核心亮点：

• 🔒 纯本地运行：所有数据存储在本机，不上传任何服务器，隐私安全有保障
• 📦 免安装部署：绿色版双击即用，无需配置服务器和数据库
• 🖥 桌面软件体验：三栏布局 + 多标签页，操作流畅，支持快捷键
• 📊 数据驱动决策：8 张核心报表 + 仪表盘，经营状况一屏掌握
• 🛡 工程安全专项：加油站动火作业审批、安全隐患闭环管理

2. 版权与版本信息

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

3. 系统要求

说明：本软件为纯本地应用，安装后无需联网即可使用全部功能。

4. 功能特性总览

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

5. 安装教程

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

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

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

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

方式二：绿色免安装版

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

卸载方法

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

6. 快速入门

6.1 首次登录

首次登录流程：

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

6.2 主界面说明

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

6.3 管理员常用操作

• 新增用户：系统管理 → 用户管理 → 「＋ 新增用户」（默认密码 admin123）
• 用户改密/禁用：系统管理 → 用户管理 → 对应行的操作按钮
• 备份数据：系统管理 → 备份管理 → 「立即备份」
• 查看日志：系统管理 → 操作日志

7. 模块使用教程

7.1 项目管理

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

7.2 物资采购（闭环流程）

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

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

7.3 成本管理

1. 点击「💰 成本财务」→ 顶部选择项目
2. 「编制预算」：输入预算金额（按材料/人工/机械/分包分类）
3. 「登记支出」：记录实际支出（类型/金额/收款方）
4. 顶部实时显示：预算 vs 支出 vs 结余，超支自动标红预警

7.4 安全隐患闭环

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

7.5 维修工单

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

7.6 报表与导出

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

7.7 数据导入

系统管理 → 数据字典 → 支持 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 导出提示失败？
A：Excel/PDF 导出依赖 Python 环境，请确认本机已安装 Python 3.10+ 及 openpyxl、reportlab 库（安装包环境已内置）。

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

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

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

10. 测试报告

10.1 测试结论

10.2 测试覆盖范围

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

• 认证模块（登录/密码哈希/改密）：5 项
• 项目管理（编号/查重/状态机/工期）：10 项
• 合同管理（编号/必填/筛选）：5 项
• 材料管理（编码/精度/搜索）：6 项
• 采购+库存（闭环/库存不足/预警）：7 项
• 供应商+收付款（黑名单/超期预警）：6 项
• 成本模块（预算/支出/超支偏差）：6 项
• 人员劳务（考勤/日薪计件双制）：8 项
• 安全隐患（闭环/超期）：7 项
• 设备+作业票（动火审批）：6 项
• 维修工单（状态机全流转）：6 项
• 报表（8张/CSV导出）：5 项
• 消息中心（聚合提醒）：3 项
• 备份恢复（闭环）：4 项
• 加密模块（加解密闭环）：3 项
• Excel 导入（BOM/重复处理）：3 项

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

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

10.3 已知说明

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

11. 用户协议

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

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

一、软件许可

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/ 联系作者。

12. 隐私协议

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

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

一、信息收集范围

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

二、信息存储方式

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

三、信息使用目的

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

四、信息安全保护

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

五、信息共享与披露

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

六、您的权利

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

七、未成年人保护

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

八、协议变更

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

九、联系我们

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

13. 版权声明

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

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

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

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

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

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

14. 联系我们

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