筑信工程管理系统 — 更新文档
文档日期：2026-08-15
适用范围：v1.0.0 → v1.0.3
一、版本历史总览
| 版本 | 类型 | 构建号 | 日期 | 说明 |
|---|---|---|---|---|
| v1.0.0 | 测试版 | 20260814.01 | 2026-08-14 | 首个完整功能版本 |
| v1.0.1 | 测试版（修复版） | 20260814.02 | 2026-08-14 | 修复 2 个缺陷 + 文档完善 |
| v1.0.2 | 测试版（增强版） | 20260814.03 | 2026-08-14 | 全局搜索可用 + 项目经理变更 + 数据清理 |
| v1.0.3 | 测试版（功能扩展版） | 20260815.01 | 2026-08-15 | 加油站专项 + 证照管理 + 甘特图 |
二、v1.0.3 更新内容
✨ 新功能（3 项）
1. 加油站专项信息
- 项目可维护加油站专业信息：加油机（数量/型号/油枪数）、油罐（数量/单罐容量/油品类型）、油气回收（是否安装/类型）、消防（等级/灭火器配置）、防雷检测（检测日期/到期日期）。
- 入口灵活：项目详情页「⛽ 专项信息」按钮，所有项目类型均可填写（不需要的字段可留空）。
- 新增 gas_station_info 表（与项目 1:1），自动增量迁移老库。
2. 项目证照管理 + 到期提醒
- 一个项目可挂多条证照记录（危化品经营许可/消防验收/防雷检测等，名称自由填写）。
- 到期提醒：消息中心聚合提醒 + 项目详情页顶部黄色横幅，双通道。
- 提醒天数可配置（系统配置 cert.remind.days，默认 60 天）。
- 新增 project_cert 表（与项目 1:N）。
3. 甘特图可视化
- 自绘 Canvas 实现（无第三方依赖，完全可控）。
- 展示：项目详情页「📈 甘特图」按钮打开独立窗口。
- 交互：拖拽任务条调整工期（自动回写 WBS）、按周/月缩放切换、显示负责人开关。
- 着色：按任务类型（施工绿/安装蓝/验收紫）+ 进度（已完成深色覆盖）+ 今天虚线。
- 左侧任务名缩进展示层级。
🧩 架构增强
- DbInitializer 增加增量迁移机制（老库自动补建新表，无需手动升级）。
- 配置新增证照提醒天数项。
📦 版本与质量
- 版本号升级至 v1.0.3（构建 20260815.01），安装包/免安装版同步更新。
- 测试用例 120 项全部通过（新增加油站专项+证照 5 项、甘特图界面 1 项）。
三、v1.0.2 更新内容（回顾）
✨ 新功能（2 项）
1. 全局搜索正式可用
- 之前：顶栏搜索框仅为占位，输入无响应。
- 现在：回车即可跨模块搜索，覆盖 6 类数据：项目、维修工单、材料、合同、供应商、工人。
- 搜索结果弹窗展示（类型/名称/说明三列），各模块独立查询，单模块异常不影响整体。
- 实现：新增
SearchService，顶栏绑定回车事件。
2. 新增项目经理变更
- 项目详情页「项目经理」旁新增「变更」按钮。
- 弹窗列出可用项目经理（限项目经理/系统管理员角色），选择后一键变更。
- 变更自动记录操作日志，便于追溯。
- 适用场景：项目中途调整负责人、人员离职交接。
🧹 数据清理（1 项）
删除测试数据"永立欣燃气公司油气站改造"
- 清理内容：测试项目 1 条 + 关联安全隐患 1 条 + 操作日志 1 条。
- 该数据为用户测试期间录入的演示数据，已从正式数据库清除。
📦 文档与版本
- 版本号升级至 v1.0.2（构建 20260814.03），安装包/免安装版同步更新。
- 开发文档、发布文档、测试报告同步更新。
- 测试用例新增至 115 项（新增全局搜索 4 项测试），全部通过。
四、v1.0.1 更新内容（回顾）
🔧 缺陷修复（2 项）
1. 修复：项目详情页打开报错（ClassCastException）
- 现象：项目管理 → 项目列表 → 点击「详情」按钮，WBS 任务表格渲染时报错：
class java.lang.Integer cannot be cast to class java.lang.String - 原因：WBS 表格的「状态」列（Integer 类型）和「计划时间」列（LocalDate 类型）在代码中声明为 String 泛型，导致数据绑定渲染时类型强转失败。
- 修复：将相关列泛型修正为 Object，并自定义单元格渲染逻辑，各类型数据均能正确显示。
- 影响范围：项目详情页 WBS 任务表格。
2. 修复：施工进度上报会篡改项目状态
- 现象：在项目详情页上报 WBS 任务进度后，项目自身状态被自动改为「施工中」——即使项目尚未开工（应保持「立项」），或项目已完工（会被错误改回「施工中」）。
- 原因：详情页数据刷新逻辑中错误地调用了
setStatus(施工中)。 - 修复：移除该逻辑。现在刷新只更新项目总进度，项目状态完全由「状态」按钮按状态机流转控制（立项→施工中→已完工→已验收→已归档）。
- 影响范围：项目管理状态流转的准确性。
✨ 功能优化（1 项）
登录后默认打开仪表盘
- 登录成功进入主界面后，自动打开「📊 仪表盘」标签页，方便第一时间掌握经营概况，无需手动点击。
📦 文档完善
- 桌面新增《筑信工程管理系统-发布文档.md》，包含：软件简介、版权与版本信息、系统要求、功能总览、安装教程、快速入门、模块使用教程、备份恢复、FAQ、测试报告、用户协议、隐私协议、版权声明、联系方式。
- 桌面测试报告更新至 v1.0.1。
五、v1.0.0 初始版本功能清单（回顾）
13 大功能模块
| 模块 | 功能 |
|---|---|
| 📊 仪表盘 | 4 大指标卡 + 状态分布饼图 + 项目进度柱状图 |
| 📁 项目管理 | 立项、WBS 任务分解、进度自动汇总、里程碑、状态流转 |
| 📦 物资管理 | 材料档案、采购单（审批→到货→入库）、供应商黑名单、库存预警 |
| 🛡 质量安全 | 隐患闭环（上报→整改→复查→销号）、特种作业票审批 |
| 💰 成本财务 | 预算编制、支出登记、超支偏差分析 |
| 🔧 维修工单 | 报修→派单→维修→验收→回访全闭环 |
| 📄 合同客户 | 合同统一管理、收付款节点、超期预警 |
| 🛠 设备管理 | 加油机/施工机具/车辆/检测仪器台账 |
| 👷 人员劳务 | 工人库、考勤、工资结算（日薪+计件双制） |
| 📊 报表中心 | 8 张报表 + CSV/Excel/PDF 导出 |
| 🔔 消息中心 | 隐患/低库存/收付款超期聚合提醒 |
| 📝 协同办公 | 施工日志、公告 |
| ⚙️ 系统管理 | 用户/角色、操作日志、备份恢复、数据字典、Excel 导入 |
其他特性
- 首次登录强制修改初始密码
- 修改密码（顶栏按钮 + 首次登录引导）
- 全中文「关于」对话框（作者/支持链接/用户协议/隐私协议）
- 登录页品牌图 + Logo 展示
- 软件窗口图标
- 逻辑删除（可恢复）、操作日志全量审计
- 备份/恢复（自动清理旧备份）
六、质量保障
| 项目 | v1.0.0 | v1.0.1 | v1.0.2 | v1.0.3 |
|---|---|---|---|---|
| 单元测试 | 90/90 通过 | 90/90 通过 | 94/94 通过 | 99/99 通过 |
| 集成测试 | 21/21 通过 | 21/21 通过 | 21/21 通过 | 21/21 通过 |
| UI 验收测试 | 通过 | 通过（含详情页 Bug 回归验证） | 通过 | 通过（含甘特图） |
| 搜索测试 | — | — | 4/4 通过 | 4/4 通过 |
| 专项/证照测试 | — | — | — | 5/5 通过 |
| 甘特图测试 | — | — | — | 1/1 通过 |
| 合计 | 111/111 | 111/111 | 115/115 | 120/120 |
七、更新方式
方式一：全新安装
- 下载最新安装包：
筑信工程管理系统-安装包-v1.0.3.exe - 运行安装向导，覆盖安装或全新安装均可。
方式二：已安装旧版本用户（v1.0.0 / v1.0.1 / v1.0.2）
- 直接运行 v1.0.3 安装包，选择原安装目录覆盖安装即可（业务数据保留，数据存储于程序目录 data 文件夹，安装不会清除）。
- 或删除旧版后重新安装（建议先备份 data 目录）。
⚠️ 提示：升级前建议先执行「系统管理 → 备份管理 → 立即备份」，确保数据安全。
筑信工程管理系统 v1.0.3 | © 2026 吴钧泽*
滇ICP备2025053877号 
滇公网安备53018102000274号 
评论（0）