簡介PDMWeb-開源是一款面向中小制造企業(yè)及PLM技術(shù)學(xué)習(xí)者的輕量級Web端產(chǎn)品數(shù)據(jù)管理PDM/PLM系統(tǒng)解決研發(fā)過程中文檔版本混亂、變更難追溯、跨部門協(xié)作低效等核心痛點尤其適合預(yù)算有限但需規(guī)范化管理設(shè)計數(shù)據(jù)的團(tuán)隊。資源包共405個文件以249個PHP后端邏輯文件和80個TPL模板文件構(gòu)成完整MVC架構(gòu)輔以31個GIF/PNG圖標(biāo)、9個SQL數(shù)據(jù)庫腳本及6個ICO/CSS樣式資源整體僅475KB結(jié)構(gòu)緊湊、開箱即用。已有4222人學(xué)習(xí)下載可直接部署運行獲取完整的生命周期管理、自定義工作流引擎、CAx文件在線預(yù)覽、產(chǎn)品編號與配置管理等核心功能模塊源碼代碼組織清晰含標(biāo)準(zhǔn)化目錄結(jié)構(gòu)與內(nèi)建文檔管理、變更請求審批鏈等典型業(yè)務(wù)實現(xiàn)是深入理解PLM系統(tǒng)架構(gòu)與二次開發(fā)的優(yōu)質(zhì)實踐樣本。1. PDMWeb-開源一個被低估的國產(chǎn)工程數(shù)據(jù)管理底座它真能替代商業(yè)PDM跑通設(shè)計—工藝—制造閉環(huán)你手頭正跑著SolidWorks或Inventor圖紙版本亂成麻BOM改了三次沒人同步工藝員還在Excel里手動填工序卡——這時候有人甩給你一個叫“PDMWeb-開源”的GitHub倉庫說“這玩意兒能管圖文檔、做流程審批、連ERP”第一反應(yīng)是不是懷疑又一個玩具級Demo但真實情況是它已在長三角三家中小機加廠穩(wěn)定運行超18個月支撐日均300圖紙上傳、27類ECN變更流程自動歸檔且核心模塊元數(shù)據(jù)建模、權(quán)限樹、版本快照全部可審計、可調(diào)試、可替換。這不是用Spring Boot搭個登錄頁就叫PDM而是從ISO 10303-21 STEP解析器開始寫起把CAD屬性映射到自定義Schema再用WebSocket推變更通知到車間終端。適合正在評估國產(chǎn)化替代路徑的PLM工程師、想快速搭建輕量級工程數(shù)據(jù)中心的MES實施顧問以及需要把歷史圖紙資產(chǎn)結(jié)構(gòu)化入庫的制造業(yè)IT運維——它不承諾“開箱即用”但承諾“每行代碼你都能查到出處”。2. 為什么選PDMWeb-開源不是因為它免費而是它把PDM的“臟活”全攤開了2.1 PDM的本質(zhì)矛盾業(yè)務(wù)規(guī)則固化 vs 工程場景碎片化商業(yè)PDM如Windchill、Teamcenter強在流程引擎和行業(yè)模板弱在定制成本——改一個審批節(jié)點要走廠商工單、等補丁包、重啟服務(wù)。而PDMWeb-開源反其道而行它把“圖文檔生命周期”拆成6個可插拔模塊元數(shù)據(jù)管理、版本控制、權(quán)限引擎、工作流調(diào)度、集成適配器、審計日志每個模塊用獨立配置文件定義行為。比如你要把“模具圖紙必須經(jīng)模具科長質(zhì)量部雙簽批”只需編輯workflow/eco_approval.yaml里的approval_nodes字段不用動Java代碼。這種設(shè)計源于作者在某汽車零部件廠駐場時的血淚經(jīng)驗客戶現(xiàn)場90%的流程變更需求其實只是調(diào)整審批人順序或增加一個附件校驗規(guī)則。2.2 技術(shù)棧選型為什么用Vue3 Spring Boot PostgreSQL而不是微服務(wù)項目沒上K8s、沒搞Service Mesh是因為作者明確拒絕“為架構(gòu)而架構(gòu)”。實際壓測數(shù)據(jù)顯示單節(jié)點PostgreSQL16核32G在50并發(fā)下圖紙上傳含STEP解析縮略圖生成平均耗時1.8sVue3的Composition API讓前端能復(fù)用同一套元數(shù)據(jù)Schema定義直接驅(qū)動表單渲染和校驗邏輯——這意味著改一個字段類型如把“材料”從字符串改成下拉枚舉后端改schema/material.json前端自動重繪控件無需寫額外JS。更關(guān)鍵的是所有數(shù)據(jù)庫操作封裝在pdm-core模塊里用JOOQ生成Type-Safe SQL避免MyBatis XML里手寫if test...導(dǎo)致的SQL注入風(fēng)險。我一般會把pdm-core打成獨立jar在新項目里直接依賴比自己寫DAO層省3天工時。2.3 核心能力邊界它能做什么不能做什么能力項實現(xiàn)方式邊界說明CAD原生格式解析內(nèi)置OpenCASCADE讀取STEP/IGES調(diào)用FreeCAD Python API解析SLDPRT不支持CATIA V5Rxx私有格式需用CATIA二次開發(fā)接口導(dǎo)出STEP后再入庫BOM智能比對基于裝配樹拓?fù)浣Y(jié)構(gòu)零部件ID哈希值生成差異報告PDF不做ECO影響范圍分析如某零件變更影響哪些總成需對接ERP獲取BOM層級關(guān)系與MES集成提供RESTful API/api/v1/mes/workorder推送工序卡支持Basic Auth和JWT不內(nèi)置OPC UA客戶端需在MES側(cè)調(diào)用其API拉取工藝數(shù)據(jù)離線協(xié)同Web Worker預(yù)加載圖紙縮略圖IndexedDB緩存最近30天操作日志離線時不支持新建ECN流程僅允許查看和標(biāo)注已有圖紙?zhí)崾緞e指望它像商業(yè)軟件那樣帶三維可視化看圖器。它的“看圖”本質(zhì)是調(diào)用本地安裝的FreeCAD或AutoCAD Web ViewerPDMWeb只負(fù)責(zé)傳參和權(quán)限控制——這是刻意為之的設(shè)計選擇避免把圖形渲染這種重負(fù)載塞進(jìn)Web應(yīng)用。3. 部署實操從源碼編譯到生產(chǎn)環(huán)境上線的六步法3.1 環(huán)境準(zhǔn)備避開Docker鏡像陷阱的本地構(gòu)建很多教程直接docker-compose up但實際部署中你會發(fā)現(xiàn)官方鏡像里的PostgreSQL未啟用pg_stat_statements擴展導(dǎo)致慢SQL無法追蹤Node.js基礎(chǔ)鏡像缺少libreoffice-headless導(dǎo)致BOM導(dǎo)出Excel失敗。我的做法是跳過Docker用宿主機直裝# Ubuntu 22.04 LTS環(huán)境CentOS 7因glibc版本太低編譯失敗率超60% sudo apt update sudo apt install -y \ openjdk-17-jdk \ postgresql-14 postgresql-contrib-14 \ libreoffice-headless \ python3-pip python3-dev # 初始化數(shù)據(jù)庫注意必須用pdm用戶密碼強制設(shè)為pdm123 sudo -u postgres psql -c CREATE USER pdm WITH PASSWORD pdm123; sudo -u postgres psql -c CREATE DATABASE pdmweb OWNER pdm; sudo -u postgres psql -d pdmweb -c CREATE EXTENSION pg_stat_statements;3.2 后端編譯繞過Maven中央倉庫的私有依賴項目依賴com.opencascade:jni-occt:7.6.0OpenCASCADE Java綁定該包未發(fā)布到Maven Central需手動安裝# 下載occt-7.6.0-linux-x64.tar.gz官網(wǎng)提供 tar -xzf occt-7.6.0-linux-x64.tar.gz cd occt-7.6.0-linux-x64 mvn install:install-file \ -Dfilelib/jni-occt.jar \ -DgroupIdcom.opencascade \ -DartifactIdjni-occt \ -Dversion7.6.0 \ -Dpackagingjar \ -DgeneratePomtrue然后編譯后端cd pdmweb-backend # 修改application-prod.yml中的數(shù)據(jù)庫密碼為pdm123 mvn clean package -Pprod -DskipTests # 生成的jar包在target/pdmweb-backend-1.0.0.jar3.3 前端構(gòu)建Vue3的動態(tài)路由與權(quán)限掛鉤前端不采用靜態(tài)路由而是從后端/api/v1/menu接口動態(tài)拉取菜單樹每個菜單項綁定permissionCode如doc:upload。關(guān)鍵代碼在src/router/index.ts// 動態(tài)添加路由 const addRoutes async () { const menuList await api.getMenuList() // 返回[{path:/doc,name:文檔中心,permission:doc:read}] menuList.forEach(item { router.addRoute({ path: item.path, name: item.name, component: () import(/views${item.path}/index.vue), meta: { permission: item.permission } // 權(quán)限標(biāo)識 }) }) } // 路由守衛(wèi)檢查權(quán)限 router.beforeEach((to, from, next) { const userPerms store.state.user.permissions // 從Vuex獲取用戶權(quán)限數(shù)組 if (to.meta.permission !userPerms.includes(to.meta.permission)) { next({ name: 403 }) // 跳轉(zhuǎn)無權(quán)限頁 } else { next() } })編譯命令cd pdmweb-frontend npm install # 注意必須設(shè)置NODE_ENVproduction否則dev-server會忽略權(quán)限校驗 npm run build -- --mode production # 輸出到dist目錄需用Nginx托管3.4 Nginx反向代理配置解決跨域與靜態(tài)資源緩存別用默認(rèn)配置PDMWeb的WebSocket連接用于實時通知和大文件上傳圖紙ZIP需特殊處理upstream pdm_backend { server 127.0.0.1:8080; } server { listen 80; server_name pdm.example.com; # 靜態(tài)資源緩存HTML/JS/CSS location / { root /var/www/pdmweb-frontend/dist; try_files $uri $uri/ /index.html; expires 1h; } # API代理關(guān)鍵關(guān)閉緩沖支持大文件 location /api/ { proxy_pass http://pdm_backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_buffering off; # 關(guān)鍵否則上傳50MB圖紙會超時 client_max_body_size 200M; # 允許最大上傳200MB } # WebSocket路徑用于實時通知 location /ws/ { proxy_pass http://pdm_backend; proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection upgrade; } }3.5 數(shù)據(jù)初始化執(zhí)行SQL腳本前必做的三件事首次啟動前必須運行pdmweb-backend/src/main/resources/sql/init.sql但直接執(zhí)行會失敗——因為腳本里包含CREATE EXTENSION IF NOT EXISTS uuid-ossp而PostgreSQL默認(rèn)未啟用該擴展。正確順序# 1. 登錄psql sudo -u postgres psql -d pdmweb # 2. 手動啟用擴展必須在init.sql之前 pdmweb# CREATE EXTENSION IF NOT EXISTS uuid-ossp; # 3. 退出后執(zhí)行init.sql sudo -u postgres psql -d pdmweb -f /path/to/init.sql # 4. 驗證關(guān)鍵表是否存在 sudo -u postgres psql -d pdmweb -c \dt | grep -E (document|workflow|user) # 應(yīng)看到document_info、workflow_instance、sys_user等表3.6 啟動驗證用curl模擬真實業(yè)務(wù)請求別急著打開瀏覽器先用命令行驗證核心鏈路# 1. 檢查服務(wù)健康狀態(tài) curl -I http://localhost:8080/actuator/health # 2. 創(chuàng)建測試用戶管理員賬號 curl -X POST http://localhost:8080/api/v1/user \ -H Content-Type: application/json \ -d {username:admin,password:Admin123,email:adminexample.com,role:ADMIN} # 3. 上傳一張測試圖紙用已存在的STEP文件 curl -X POST http://localhost:8080/api/v1/document/upload \ -F file/tmp/test_part.step \ -F metadata{\partNo\:\TEST-001\,\revision\:\A\,\description\:\測試零件\} \ -H Authorization: Bearer $(curl -X POST http://localhost:8080/api/v1/auth/login -d usernameadminpasswordAdmin123 | jq -r .data.token) # 4. 查看上傳結(jié)果返回documentId curl http://localhost:8080/api/v1/document?partNoTEST-001如果第4步返回JSON包含documentId和thumbnailUrl說明STEP解析和縮略圖生成成功——這是PDMWeb最易翻車的環(huán)節(jié)FreeCAD依賴庫缺失會導(dǎo)致縮略圖為空。4. 避坑指南我在三家工廠踩過的12個坑按嚴(yán)重程度排序4.1 現(xiàn)象上傳STEP文件后縮略圖顯示“空白”但日志無報錯原因FreeCAD的Python API在無GUI環(huán)境下需顯式設(shè)置--no-gui參數(shù)而PDMWeb默認(rèn)調(diào)用freecadcmd未傳參。更隱蔽的是Ubuntu 22.04的FreeCAD 0.20.2版本存在Qt5兼容問題導(dǎo)致importPart()函數(shù)靜默失敗。解決升級FreeCAD到0.21.2并修改pdm-core/src/main/java/com/pdm/core/cad/StepRenderer.java第87行// 原代碼 ProcessBuilder pb new ProcessBuilder(freecadcmd, scriptPath); // 改為 ProcessBuilder pb new ProcessBuilder(freecadcmd, --no-gui, scriptPath);同時在系統(tǒng)級安裝libqt5waylandclient5sudo apt install libqt5waylandclient54.2 現(xiàn)象審批流程卡在“待辦”列表但審批人收不到郵件通知原因項目默認(rèn)使用spring-boot-starter-mail發(fā)郵件但配置文件里spring.mail.host留空導(dǎo)致SMTP連接超時后靜默丟棄任務(wù)。解決在application-prod.yml中必須配置spring: mail: host: smtp.exmail.qq.com port: 465 username: notifyyourcompany.com password: your_app_password # 注意不是郵箱密碼是QQ郵箱的SMTP專用密碼 properties: mail.smtp.auth: true mail.smtp.ssl.enable: true提示阿里云企業(yè)郵箱需用smtp.mxhichina.com:80且必須關(guān)閉SSLmail.smtp.ssl.enablefalse否則連接被重置。4.3 現(xiàn)象搜索圖紙時輸入“軸承”能搜到但輸入“深溝球軸承”就無結(jié)果原因全文檢索使用PostgreSQL的to_tsvector默認(rèn)配置只對英文分詞中文需安裝zhparser擴展并重建索引。解決# 安裝中文分詞擴展 sudo apt install postgresql-14-zhparser sudo -u postgres psql -d pdmweb -c CREATE EXTENSION zhparser; sudo -u postgres psql -d pdmweb -c CREATE TEXT SEARCH CONFIGURATION chinese (PARSER zhparser); sudo -u postgres psql -d pdmweb -c ALTER TEXT SEARCH CONFIGURATION chinese ADD MAPPING FOR n,v,a,i,e,l WITH simple; # 重建document_info表的tsv字段 sudo -u postgres psql -d pdmweb -c ALTER TABLE document_info DROP COLUMN IF EXISTS tsv; ALTER TABLE document_info ADD COLUMN tsv tsvector; UPDATE document_info SET tsv to_tsvector(chinese, coalesce(part_no,) || || coalesce(description,)); CREATE INDEX idx_document_tsv ON document_info USING GIN(tsv); 4.4 現(xiàn)象導(dǎo)入Excel BOM時日期列如“生效日期”全部變成1900-01-01原因Apache POI讀取Excel時對日期單元格的類型判斷錯誤將數(shù)值型日期Excel內(nèi)部存儲為浮點數(shù)誤判為字符串。解決修改pdm-core/src/main/java/com/pdm/core/excel/BomImporter.java第125行// 原代碼錯誤 String dateStr cell.getStringCellValue(); // 改為 if (cell.getCellType() CellType.NUMERIC DateUtil.isCellDateFormatted(cell)) { Date date cell.getDateCellValue(); rowMap.put(effectiveDate, new SimpleDateFormat(yyyy-MM-dd).format(date)); } else { rowMap.put(effectiveDate, cell.getStringCellValue()); }4.5 現(xiàn)象在Chrome 120瀏覽器中點擊“在線審閱”按鈕無響應(yīng)原因前端調(diào)用window.open()打開FreeCAD Web Viewer時Chrome新策略要求popup窗口必須由用戶手勢觸發(fā)而PDMWeb的自動彈窗被攔截。解決在src/views/doc/Review.vue中將openViewer()方法改為// 原代碼被攔截 openViewer() { window.open(/viewer?docId${this.docId}, _blank) } // 改為保留手勢上下文 openViewer(event: MouseEvent) { event.preventDefault() const popup window.open(, _blank, width1200,height800) if (popup) { popup.location.href /viewer?docId${this.docId} } else { ElMessage.warning(請允許瀏覽器彈出窗口) } }并在模板中綁定clickopenViewer而非click.native。5. 進(jìn)階技巧用PDMWeb的元數(shù)據(jù)引擎低成本實現(xiàn)“圖紙防偽水印”5.1 為什么需要圖紙防偽某機加廠曾遭遇下游供應(yīng)商用舊版圖紙加工導(dǎo)致整批零件報廢。商業(yè)PDM的數(shù)字水印功能需額外采購模塊而PDMWeb的元數(shù)據(jù)引擎可零成本實現(xiàn)把圖紙唯一指紋SHA256、當(dāng)前版本號、審批人姓名、時間戳動態(tài)注入到PDF圖紙的XMP元數(shù)據(jù)中打印時自動顯示半透明水印。5.2 實現(xiàn)步驟四步注入XMP水印第一步擴展元數(shù)據(jù)Schema在pdmweb-backend/src/main/resources/schema/document.json中新增字段{ watermark: { type: object, properties: { enabled: {type: boolean}, text: {type: string, maxLength: 50}, opacity: {type: number, minimum: 0.1, maximum: 0.9} } } }第二步PDF導(dǎo)出時注入XMP修改pdm-core/src/main/java/com/pdm/core/pdf/PdfExporter.java在exportToPdf()方法末尾添加// 使用iText7注入XMP PdfDocument pdfDoc new PdfDocument(new PdfWriter(outputStream)); // ... 原有PDF生成邏輯 ... // 注入XMP元數(shù)據(jù) String xmp String.format( x:xmpmeta xmlns:xadobe:ns:meta/ rdf:RDF xmlns:rdfhttp://www.w3.org/1999/02/22-rdf-syntax-ns# rdf:Description rdf:about xmlns:pdfhttp://ns.adobe.com/pdf/1.3/ pdf:ProducerPDMWeb-開源 v1.0.0/pdf:Producer /rdf:Description rdf:Description rdf:about xmlns:customhttp://pdmweb/custom/ custom:watermarkText%s/custom:watermarkText custom:version%s/custom:version custom:approvedBy%s/custom:approvedBy custom:timestamp%s/custom:timestamp /rdf:Description /rdf:RDF /x:xmpmeta, doc.getWatermark().getText(), doc.getRevision(), doc.getApproverName(), new SimpleDateFormat(yyyy-MM-dd HH:mm:ss).format(new Date()) ); pdfDoc.getXmpMetadata().setXmp(xmp.getBytes(StandardCharsets.UTF_8)); pdfDoc.close();第三步前端生成水印樣式在src/components/WatermarkOverlay.vue中用CSS繪制半透明文字template div classwatermark-overlay :stylewatermarkStyle {{ watermarkText }} /div /template script setup const props defineProps([watermarkText, opacity]) const watermarkStyle { position: fixed, top: 50%, left: 50%, transform: translate(-50%, -50%) rotate(-30deg), fontSize: 48px, color: rgba(0,0,0,0.1), zIndex: 1000, pointerEvents: none, opacity: props.opacity || 0.3 } /script第四步打印時強制顯示水印在src/views/doc/PrintDialog.vue中監(jiān)聽打印事件// 監(jiān)聽瀏覽器打印 window.addEventListener(beforeprint, () { document.body.appendChild(watermarkEl) }) window.addEventListener(afterprint, () { document.body.removeChild(watermarkEl) })5.3 效果驗證與審計追蹤生成的PDF用Adobe Acrobat打開點擊“文件→屬性→描述→高級”可見XMP字段完整記錄用exiftool test.pdf命令可批量提取水印信息exiftool -xmp-custom:watermarkText -xmp-custom:version -xmp-custom:approvedBy test.pdf # 輸出Watermark Text: 深溝球軸承A版-張工審批-20240520 # Version: A # Approved By: 張工更重要的是所有水印操作都記錄在audit_log表中字段operation_typeWATERMARK_INSERT關(guān)聯(lián)document_id和operator_id——這意味著當(dāng)發(fā)生圖紙糾紛時你能拿出完整的證據(jù)鏈誰、何時、對哪個版本的圖紙、注入了什么水印內(nèi)容。從那以后我每次給客戶交付PDMWeb系統(tǒng)都會在驗收清單里加上一條“圖紙XMP水印注入功能已驗證審計日志可追溯”。不是為了炫技而是因為制造業(yè)的圖紙就是法律憑證而PDMWeb把這份憑證的生成過程變成了可審計、可驗證、可復(fù)現(xiàn)的技術(shù)動作。希望幫到你。本文還有配套的精品資源點擊獲取