ZhuaTech CONSTRUCTION · 知华工程项目协同平台

面向项目进度、现场安全、材料与质量的前后端分离社区源码项目

版权所有 © 2026 上海如静知华信息科技有限公司。项目仅限个人非商业学习、研究与技术交流；商用、企业内部生产使用、SaaS、交付或二次开发服务均须取得书面授权。

一眼了解项目

ZhuaTech CONSTRUCTION 是知华科技推出的工程项目协同系统社区源码版。首版以“运营态势—协同事项—移动执行—风险评估”为主线，把管理者的全局视角和一线人员的移动工作台放在同一套业务模型中。项目采用 Java 21、Spring Boot、Vue 3 与 MySQL，可作为前后端分离、权限控制、运营看板和移动适配的学习样例。

CONSTRUCTION 管理端运营总览

管理端：进度、安全、材料和质量事项的统一运营视图

CONSTRUCTION 移动工作台

用户端：面向运营人员与项目部与现场作业团队的移动工作台

功能地图

使用角色	已实现能力	典型价值
运营管理者	核心指标、流程进度、重点事项、健康度评估	快速发现资源与时效风险
工程协同人员	待办列表、优先级、责任团队、快捷工作入口	减少跨团队沟通遗漏
系统管理员	管理/操作员权限隔离、接口鉴权、数据初始化	提供可继续扩展的安全基线
移动用户	响应式 H5 工作台、事项查看、异常上报入口	支持施工现场移动作业场景

后端还提供运营风险评估接口，结合积压、延期、关键事项、容量利用率与数据完整度给出分级结果和行动建议。该结果仅用于软件学习演示，不替代企业正式风控与业务决策。

新增：工程进度款支付门禁

进度款评估结合合同金额、申报金额、已计量产值、已批准变更、保留金比例、资料完整度和安全停付状态，计算本期可支付金额及差异，并输出 APPROVE / REVIEW / BLOCK 决策与可解释原因，帮助工程与成本团队在付款前完成一致性检查。

接口：POST /api/admin/progress-payment。

技术结构

zhuatech-construction/
├── backend/       Spring Boot 4 / Java 21 / Spring Security / JPA
├── frontend/      Vue 3 / Vite / 响应式管理端与 H5
├── docs/          架构、接口与项目截图
├── compose.yaml   MySQL、后端、前端一键编排
└── LICENSE        知华科技个人非商业社区源码许可

快速启动

环境建议：JDK 21、Maven 3.9+、Node.js 22+、MySQL 8.4+；也可直接使用 Docker Compose。

cp .env.example .env
docker compose up --build

启动后访问 http://localhost:8090。本地演示管理账号为 admin / admin123，操作员账号为 operator / operator123。这些仅是开发默认值，任何联网或生产环境都必须通过环境变量替换，并增加企业级身份认证、审计与数据脱敏。

单独启动开发环境：

cd backend && mvn spring-boot:run
cd frontend && npm install && npm run dev

接口示例：

curl -u admin:admin123 http://localhost:8080/api/admin/dashboard
curl -u admin:admin123 -H 'Content-Type: application/json' \
  -d '{"backlog":18,"delayedItems":3,"criticalItems":1,"capacityUtilization":91,"dataCompleteness":86}' \
  http://localhost:8080/api/admin/risk-assessment

更多信息见接口说明与架构说明。

使用许可

本项目采用 ZhuaTech Community Source License 1.0（个人非商业版），不是 OSI 认可的开源许可证。

可以：个人学习、研究、技术交流、非商业修改。
不可以：企业内部生产使用、商业部署、SaaS、收费下载、外包交付、售卖、投标、品牌替换或任何直接/间接获利行为。
需要商业使用、生产部署或深度开发定制时，必须先取得上海如静知华信息科技有限公司书面授权。

详情以 LICENSE 为准。

定制咨询

知华科技（上海如静知华信息科技有限公司）提供企业数字化、软件项目外包、系统集成、私有化部署和深度定制服务。

官方网站：https://www.zhuatech.cn/
商业授权与深度定制：可通过官网联系，也可扫描下方任一微信二维码咨询。

知华科技微信咨询二维码一知华科技微信咨询二维码二

安全与贡献

本仓库不包含真实业务数据、真实生产接口凭据或生产配置。请勿提交个人隐私与业务敏感信息、访问令牌、私钥或真实业务数据。安全问题请按 SECURITY.md 私下报告；参与开发前请阅读 CONTRIBUTING.md。

关键词：知华科技 CONSTRUCTION、工程项目系统、施工运营管理、工程协同平台、Java 工程系统、Spring Boot CONSTRUCTION、Vue 企业管理系统、上海软件定制开发。