夜雨聆风
我用 AI 做了一个石油化工 EPC 项目管理系统 从需求到安装包的实操记录不是“一句话生成”,而是一次把工程管理经验沉淀成工具的尝试
摘要导语
• 这不是一篇 AI 炫技文章，而是一篇工程人员用 AI 辅助开发项目管理系统的真实记录。
• 我把石油化工 EPC 项目管理中的项目中心、WBS、采购、文控、工程资料、质量/HSE、费用、审批、工作流、AI 周报等模块，逐步做成了 PetroEPC V2.1 单机稳定版。
写在前面：项目管理最怕的不是没数据，而是数据串不起来
过去做 EPC 项目管理，很多时候并不是没有流程，而是流程太分散。项目基础信息在 Excel 里，WBS 进度在Project 里，采购台账在另一张表中，质量和 HSE 资料在文件夹里，问题整改在微信群里，最后汇报又要重新整理 PPT。
真正到了查进度、查责任、查资料、查风险的时候，问题就出来了：数据不是没有，而是找不到、找不全、对不上、串不起来。
因此我做了一个尝试：用 AI 辅助开发一个面向石油化工 EPC总承包项目的数字化执行与工作流管理系统。
这篇文章不讲“AI 一句话生成软件”的神话，只讲一个工程人员如何把自己的管理想法，一步一步做成 V2.1 单机稳定版，并最终生成 Windows 安装包和交付归档。
图 1PetroEPC V2.1 系统首页 / 工作台
01为什么要做这个系统：先解决流程断点
做石油化工 EPC 项目，最怕的不是某一张表没填好，而是设计、采购、施工、资料、质量、安全、费用、审批之间断开了。
■ 设计文件已经发出，但采购没有及时衔接。
■ 采购到货了，施工没有形成有效反馈。
■ 现场出现问题，质量或 HSE 没有形成闭环。
■ 当天计划没有完成，第二天没有自动滚动跟踪。
■ 资料上传过，但后面找不到最终版本。
如果这些工作只靠 Excel、微信群、文件夹和个人记忆，时间一长就会出现口径不一致、重复录入、责任不清、汇报靠临时拼凑等问题。
所以我一开始的目标不是做一个“高大上系统”，而是先做一个自己能用、能把项目数据串起来、能长期迭代的工程管理工具。
02 先做 MVP：不追求一步到位
这里先说一个关键概念：MVP，也就是 Minimum Viable Product，最小可行产品。
我没有一开始就要求 AI 做一个“大而全”的系统。工程项目管理系统如果第一步就想把所有功能做完，很容易越做越复杂，最后反而落不了地。
我给第一版定下的目标
• 项目能建起来，基础信息能保存。
• WBS 能录入、能保存、能反映进度状态。
• 设计、采购、施工之间能形成基本关联。
• 问题能闭环，数据重启后不丢。
• 系统能打包成安装包，先能用，再优化。
• 项目能建起来，基础信息能保存。
MVP 不是“简陋版”，而是先把最核心的业务链路跑通。对 EPC 项目来说，这条主链路就是：项目中心→WBS→设计→采购→施工→资料→问题闭环→报表。
03 V2.0：先把 EPC 主流程跑通
V2.0 是在 V1.0 MVP 基础上继续推进的版本。它的重点不是追求完美，而是验证系统主链路能不能走通。
这一阶段主要包括项目中心、WBS 与进度管理、设计管理、采购管理、施工管理、文控管理、工程资料管理、项目开销管理、审批流管理、统一工作流平台、看板与报表，以及 Windows 安装包交付。
V2.0 的价值在于，它把 EPC 项目管理从“分散台账”推进到了“系统化模块”。项目中心、WBS、采购、施工、资料之间开始形成数据链路。
图 2项目中心页面
如：项目中心建立项目，WBS 分解任务，设计资料绑定 WBS，采购条目绑定设计和 WBS，施工任务绑定采购和 WBS，施工进度再反向反馈 WBS。
这条链路跑通后，系统就不再只是一个个独立页面，而是具备了工程项目管理的基本骨架。
图 3WBS 与进度管理页面
04 V2.1：重点解决“数据不丢”和“文件不丢”
在 V2.0 跑通主流程以后，我发现了一个非常现实的问题：系统只是能演示还不够。如果数据保存不稳定、附件上传不可靠、重启后记录找不到，就不能真正用于项目管理。
所以 V2.1 的定位很清楚：单机自用稳定版。
这一版重点解决稳定性和实用性，主要增强包括数据持久化、首页工作台、我的项目稳定显示、WBS 保存后不丢、统一文件上传与附件中心、Project 计划导入、采购合同上传与信息抽取、质量/HSE 资料体系、看板图表化、AI 周报/月报 PPT 生成、交付目录整理和压缩归档。
对工程系统来说，最基础的信任只有三句
• 我今天录入的数据，明天还能看到。
• 我今天上传的文件，后面还能下载。
• 我今天建立的项目，重启系统后不会消失。
图 4统一附件管理中心
05我是怎么让 AI 不跑偏的
很多人以为用 AI 写软件，就是输入一句话：“帮我做一个 EPC 管理系统”。实际并不是这样。
AI 可以帮你写代码，但前提是你要按软件开发的基本方法管理它：拆需求、定边界、分步骤、做测试、验结果、封版本。
我的做法是把整个开发过程拆成一个个 Step，每一步只解决一个明确问题。
V2.1 的开发步骤
• Step1：单机数据持久化修复。
• Step2：统一文件上传与附件中心。
• Step3：Project 计划导入与自动拆解。
• Step4：采购合同上传与信息抽取。
• Step5：质量/HSE 资料体系扩展。
• Step6：看板图表化与首页驾驶舱。
• Step7：AI 周报/月报数据汇总。
• Step8：PPT 文件生成。
• Step9：AI 报告页面与下载入口。
• Step10：单机稳定版阶段收口。
• Step11：安装包打包。
• Step12：黑盒验证。
• Step13：最终交付归档。
每完成一步，我都会要求 AI 输出本阶段目标、本阶段不做什么、修改文件清单、测试结果、Git status，以及是否可以提交封点。
这种方法看起来慢，但可以有效避免 AI “越走越偏”。我的体会是：AI 负责帮你写代码，工程人员必须负责拆任务、定边界、验结果。
我常用的阶段指令模板
• 当前问题是什么。
• 本阶段目标是什么。
• 本阶段只实现什么，不允许扩展什么。
• 本阶段不实现什么。
• 需要补充哪些测试。
• 完成后输出修改文件清单、测试结果、Git status 和封点建议。
06 V2.1 已经跑通的几个核心功能
6.1 项目中心：先把项目主数据管住
项目中心是整个系统的基础。这里维护项目编号、项目名称、业主、地点、合同类型、项目阶段、项目状态、开工日期、计划完工日期、实际完工日期、项目经理等信息。
图 5项目中心功能页
6.2 WBS 与进度管理：项目执行的主轴
EPC 项目管理不能只看合同，也不能只看采购，更不能只看施工现场。真正贯穿项目执行全过程的主轴，是 WBS。
系统中可以维护任务名称、计划开始、计划完成、实际完成、进度百分比、任务状态、延期天数等字段，并按照规则自动判断任务状态：进度 100% 为已完成；当前日期超过计划完成且进度未完成为已延期；进度为 0 为未开始；0 到 100 之间为进行中。
这样项目经理能比较直观看到哪些任务正在推进，哪些任务已经延期。
图 6WBS 任务列表与进度状态
6.3 Project 计划导入：把外部计划转成系统数据
很多项目在策划阶段已经用 Microsoft Project 或 Excel 编制了计划。如果再让用户在系统里重新录入一遍，工作量太大，也不符合现场习惯。
所以 V2.1 增加了 Project 计划导入功能，支持从 CSV、Excel、Microsoft Project XML 中导入计划任务，并根据任务名称识别设计、采购、施工、文控、工程资料、管理任务、未知任务等类型。
导入后不是直接写入正式数据，而是先生成预览，允许人工调整，再确认导入。工程系统必须保留人工确认环节，不能把规则识别当成绝对准确。
图 7Project 计划导入：外部计划导入系统
6.4 采购合同上传与信息抽取
采购管理是 EPC 项目中的关键模块。V2.1 不只是做采购台账，还增加了采购合同上传与信息抽取。
用户上传合同文件后，系统可以根据规则抽取合同编号、合同名称、供应商、金额、日期、材料名称、规格型号、数量、单价、总价等信息。
图 8采购合同上传与信息抽取
6.5 质量与 HSE 资料体系
工程项目不能只管进度和采购，还必须管质量和安全。V2.1 对质量和 HSE 做了资料体系扩展。
质量侧包括质量体系文件、质量计划、检查记录、整改通知、整改回复、复查记录、验收记录、质量资料模板。
HSE 侧包括 HSE 体系文件、专项方案、检查记录、隐患整改、动火票、安全教育、受限空间作业票、高处作业票、吊装票、临时用电票、班前安全活动记录等内容。
这些资料都可以通过统一文件中心挂接附件，逐步形成可查询、可追溯的资料沉淀。
图 9质量管理界面
图10HSE 管理界面
6.6 工程资料管理：让资料从过程开始沉淀
工程资料往往是项目后期最头痛的事情。如果等到竣工时再整理，很多资料已经找不到，签字也很难补齐。
因此系统设计了工程资料管理模块，用于管理单位工程、分部工程、分项工程、检验批、工程资料文件、验收记录、缺失资料、竣工资料组卷和资料移交。
图11工程资料管理界面
6.7 看板与报表：从台账走向管理视图
前面所有模块都是数据来源，但项目经理真正需要的是管理视图。
V2.1 增加了看板与报表，将采购、文控、工程资料、项目开销、审批、问题闭环、每日计划等数据进行汇总。
实际使用中我也发现，有些图表区域一开始并没有真正显示成饼状图，而是把数据以普通文字堆叠出来。这也是开发系统过程中很真实的一点：不是每个功能第一次做出来就完美，必须通过实际点击和页面检查，发现问题后继续修复。
图12看板与报表界面
6.8 AI 周报/月报 PPT 生成
V2.1 还增加了 AI 周报/月报模块。这里的“AI”并不是直接接入外部大模型，而是先基于系统已有数据做规则化摘要，生成周报/月报结构化内容，再生成 PPT 文件供下载。
这个功能的价值在于减少项目汇报材料的重复整理工作。系统可以自动生成总体摘要、模块进展、风险提示、问题闭环情况、下周或下月计划，以及 PPT 汇报文件。
对项目经理、项目执行团队和内部汇报来说，这个功能有很直接的实用价值。
图13AI 周报/月报界面
07 开发过程中踩过的坑
这个过程并不是一路顺利。我遇到过很多很具体的问题。
■ 安装后打开的还是旧版本。
■ 旧端口被进程占用，导致新系统无法启动。
■ 页面菜单没有显示 V2.1 新入口。
■ 某些模块数据为空，原因是当前项目还没有 WBS。
■ 项目经理下拉框只能显示系统管理员，不能显示真实姓名。
■ 看板页面显示的是文字，不是图表。
■ 交付目录压缩失败，原因是目录还没有创建。
■ 某些步骤执行过程中卡住，需要安全恢复和复核。
这些问题反而让我更确定一件事：AI 开发不是一次性生成，而是不断验证、不断纠偏、不断封点。
每个阶段都必须有明确目标、明确边界、测试结果、测试记录、可退回版本、交付目录和安装包验证。否则系统越做越大以后，很容易失控。
08 封版、测试、打包和归档怎么做
这次实践里，我认为最有价值的经验之一，是把系统开发过程做成了可追溯的工程化流程。
V2.1 最终封装前，我做了几件事：运行全量测试，最终结果为 192 passed，2 warnings；生成 Windows 安装包；做黑盒验证；创建 Git 标签；整理交付目录；最后压缩归档。
黑盒验证很重要。也就是说，不在开发环境里运行，而是像普通用户一样安装系统、启动系统、登录系统、创建数据、上传文件、生成报告，再重启系统检查数据是否还在。
最终交付目录包括
• 安装包。
• 版本信息。
• 运行部署手册。
• 验收资料。
• Git 追溯文件。
• 发布说明。
• 已知限制与回滚说明。
• 演示资料。
• AI 报告说明。
最终形成 PetroEPC_V2.1_SINGLE_USER_STABLE_DELIVERY.zip。这样系统不只是“我电脑上能跑”，而是形成了一个可以备份、可以转移、可以交付、可以复盘的版本。
图14交付目录
图 15Windows 安装包
09 如果你也想做类似系统，建议这样开始
我的建议路径
• 第一步，先写清楚业务痛点：现在用什么表，哪些数据经常丢，哪些流程经常断，哪些资料经常找不到，哪些汇报最耗时间。
• 第二步，画出主流程。例如 EPC 项目可以先画：项目 → WBS → 设计 → 采购 → 施工 → 质量/HSE → 资料 → 费用 → 审批 → 报表。
• 第三步，先做 MVP。第一版只做最核心的 3 到 5 个模块。对工程项目来说，WBS往往是全系统最终都要采集和回溯的主轴。
• 第四步，把功能拆成 Step。每个 Step 都要明确做什么、不做什么、改哪些文件、测哪些内容、通过后是否提交。
• 第五步，坚持测试和封点。每完成一步就跑测试、提交 commit、记录版本，不要一口气改很多功能。
• 第六步，先做稳定，再做美观。工程系统第一优先级不是漂亮，而是数据不丢、文件不丢、流程不断、状态可查、问题可追溯。
• 第七步，最后再做打包和交付。只有生成安装包、完成黑盒验证、整理交付目录，才算形成一个真正可交付版本。
10 下一步我准备继续做
V2.1 不是终点，它只是一个可用、可测、可归档的单机稳定版。后续我准备继续优化几个方向。
■ 组织与用户管理：支持真实姓名、部门、岗位、角色和项目人员分工。
■ 主数据和字典管理：统一项目状态、合同类型、资料类别、费用类别、审批状态，减少手工输入错误。
■ 附件预览和版本管理：支持 PDF、图片、合同、资料文件在线预览，支持版本号、批量下载和归档。
■ 质量/HSE 专业表单深化：进一步细化质量检查、HSE 检查、整改通知、整改回复、复查关闭和作业票。
■ 看板图表优化：把现有指标数据转成更直观的饼图、柱状图、趋势图和风险色块。
■ PostgreSQL 和多人协同：如果只是单机个人使用，当前 SQLite 足够；如果要多人协同，就需要数据库升级、权限控制、备份恢复和服务器部署。
11 这次实践给我的最大感受
1、这次实践给我最大的感受是：AI 并不会自动替你做出一个真正可用的工程系统。
2、真正关键的，仍然是工程人员自己是否懂业务、懂流程、懂现场，是否知道项目执行中的真实痛点。
3、AI 的价值，是把这些业务经验更快地转化为系统原型、功能模块、测试用例和可交付的软件包。
4、对于工程人员来说，未来真正有价值的能力，可能不是单纯会不会写代码，而是能不能把自己的专业经验转化成可以运行、可以复用、可以迭代的数字化工具。
5、工程经验如果只停留在脑子里，就是个人经验；如果能沉淀成系统，就会变成组织能力。AI 不会替代真正懂工程的人，但会放大懂工程、懂流程、懂问题的人。
下一篇：（PetroEPC V2.1使用体验：项目中心、WBS、采购、资料和AI周报怎么用）