Project Management Information System for AI-Powered Construction Supervision
協助監造單位於公共工程執行各階段的資訊化支援平台。系統整合施工各作業流程所需的功能模組,提供一套完整且具延展性的數位管理工具,涵蓋公共工程全生命週期,以提升工程執行效率、履約管控力與管理透明度。
本專案功能設計參考行政院公共工程委員會 PMIS 推廣版操作規範,並以「PM 管控」視角重新歸納為 8 大功能模組(PMIS-01 ~ PMIS-08),再疊加 AI 流程優化能力(詳見 AI 流程優化設計)。
| 編號 | 功能 | 契約要求整理 | PM 管控提醒 |
|---|---|---|---|
| PMIS-01 | 行事曆提醒及預警 | 提醒履約期限、會議、送審、查核、改善期限 | Dashboard 與通知機制 |
| PMIS-02 | 待辦事項追蹤 | 追蹤各單位待辦事項與改善辦理情形 | 需可即時紀錄、查詢、統計 |
| PMIS-03 | 契約履約管理 | 契約文件、履約事項、變更、罰則與付款節點 | 需與履約期限連動 |
| PMIS-04 | 時程進度管理 | 工程進度、預定/實際、落後預警 | 需可供行動裝置查詢進度 |
| PMIS-05 | 環安衛管理 | 環境、職安衛、交通維持督導與稽核資料 | 需建置稽核紀錄 |
| PMIS-06 | 送審文件材料管理 | 設計、施工、材料設備、試驗報告送審資料 | 需可追蹤審查狀態與退件修正 |
| PMIS-07 | 品質稽核管理 | 施工品質抽查、材料設備抽驗、缺失改善 | 需可統計與追蹤改善成果 |
| PMIS-08 | 文件/照片/影片資料庫 | 工程監造紀錄、工程照片、影片、文件 | 需雲端查詢及持續更新 |
以行事曆與儀表板為核心,集中呈現各項具時效性的履約與監造事件,並在期限前主動預警。
- 履約期限、工期里程碑、工期展延核准日期之到期提醒。
- 材料/文件送審預定日期、施工查驗檢驗停留點、缺失改善完成期限之倒數與逾期示警。
- 上級/主管機關查核、會議、首件檢驗等排程提醒。
- 儀表板彙整當日/當月應辦事項數量,支援以年月切換檢視。
追蹤跨單位(監造、施工廠商、二級品管)之待辦與改善辦理情形,確保事事有著落、件件可查。
- 缺失改善(施工品質、安衛、材料不合格)之待辦清單與辦理狀態。
- 送審退件修正、查驗待簽核等流程節點之待處理項目。
- 可即時登錄、依單位/狀態/期限查詢與統計,逾期項目可升級提醒。
建立標案全生命週期的履約起始資料,作為後續材料管控、施工查驗與報表作業的資料基礎(對應官方「標別管理」)。
- 標案基本資料:契約金額、開工日期、承包商、監造單位等。
- 契約變更資料:變更次數、變更內容與項目、變更後金額、變更天數。
- 工期里程碑:關鍵階段性成果與完工日期(可由開工日 + 契約工期自動計算)。
- 工期展延紀錄:展延名稱、核准日期、核准文號與說明。
- 罰則與付款節點與履約期限連動,供逾期扣款與計價管控。
以預定/實際進度對比呈現工程時程,落後即預警,並支援行動裝置隨時查詢。
- 分項工程進度百分比、預定 vs 實際、S 曲線。
- 里程碑達成度與關鍵路徑影響追蹤。
- 落後預警與行動裝置(手機/平板)進度查詢。
記錄環境、職業安全衛生與交通維持之督導與稽核資料,符合法令及契約規定(對應官方查驗紀錄之「安衛/環保檢查」)。
- 定期與不定期安衛/環保巡檢:高風險作業防護、機具設備安全、防墜與臨邊防護、作業環境衛生、廢棄物與污水、粉塵與噪音等。
- 現場施工抽查先查驗安衛項目、再查驗施工品質。
- 稽核紀錄含檢查日期、地點、抽查項目、缺失情形、改善期限與追蹤結果,並可附現場照片與 GPS 座標。
- 重大缺失可即時管制或暫停作業。
管控設計、施工、材料設備與試驗報告之送審流程,嚴格追蹤送審狀態與退件修正(對應官方「材料管控」)。
- 材料檢試:抽驗管理標準表、送審管制總表(表 5-1)、檢(試)驗管制總表(表 5-2)。
- 支援 Excel/範本批次匯入建置材料資料庫,減少逐筆建檔。
- 送審文件建立:勾選施工廠商資料、型錄、試驗報告、樣品,記錄預定/實際送審日期、審查日期與結果。
- 材料取樣:與材料檢試模組串聯,現場抽驗/取樣、監造簽名、取樣照片上傳。
- 材試不合格追蹤:不合格自動列管於「不合格追蹤管制表」,通知廠商退料與矯正預防。
標準化施工查驗流程,管控施工品質抽查、材料設備抽驗與缺失改善成果(對應官方「施工查驗」與「查驗統計」)。
- 查驗申請:施工廠商依構造物分類提出檢查申請,上傳施工抽查表與核定圖面;支援申請單 Excel/JSON/XML 匯入匯出(相容工程會 CMIS 格式)。
- 查驗填報:狀態分為未查驗、查驗中、待簽核、已簽核;現場抽查填報結果並記錄 GPS 定位。
- 不合格追蹤:上傳缺失改善前/中/後照片與文字說明,設定缺失類型與預定改善日期,複查合格後由監造工程師與監造主管數位簽章簽核。
- 主管簽核後鎖定為唯讀並自動產生歸檔紀錄,可匯出 PDF/WORD/ODT 查驗表單。
- 查驗統計:依年月統計查驗與缺失數量(安衛缺失、環保缺失、材料會同檢驗成果)。
集中保存工程監造全程之數位紀錄,支援雲端查詢與持續更新,落實無紙化與資料治理。
- 施工紀錄、材料取樣試驗、安衛環保、業主指示、上級/主管機關稽查、首件檢驗導讀等紀錄。
- 工程照片、影片、圖檔、掃描文件與試驗報告之上傳、預覽與歸檔編號管理。
- 監造報表:每日填報按圖施工概況、材料管理、人機管理、取樣試驗與重要事項,可由當日查驗紀錄自動匯入。
- 建物歷程檢索(依構造物分類彙整抽查資料)、空間使用量統計,作為數位轉型量化佐證。
| 官方章節 | 內容 | 對應本系統模組 |
|---|---|---|
| 第二章 基本設定 | 標別管理、查驗範本管理、資料設定 | PMIS-03、PMIS-07 |
| 第三章 材料管控 | 材料檢試、材料取樣、材試不合格追蹤 | PMIS-06 |
| 第四章 施工查驗 | 查驗申請、查驗填報、不合格追蹤、簽核主管 | PMIS-07、PMIS-05 |
| 第五章 查驗紀錄 | 查驗紀錄、查驗報表、查驗統計 | PMIS-08、PMIS-02 |
| 第六章 監造報表 | 監造報表、報表檔案 | PMIS-08 |
| 第七章 後台管理 | 帳號管理、群組管理、功能權限設定 | 系統管理(RBAC) |
| 全域 | 行事曆、期限提醒、待辦追蹤 | PMIS-01、PMIS-02 |
八大模組皆已實作為獨立頁面,並由儀表板彙整:
| 路由 | 模組 | 說明 |
|---|---|---|
/ |
儀表板 | 統計、預警與模組導覽 |
/calendar |
PMIS-01 | 行事曆提醒及預警 |
/todos |
PMIS-02 | 待辦事項追蹤 |
/projects、/projects/[id] |
PMIS-03 | 契約履約(含變更、里程碑、付款節點) |
/schedule |
PMIS-04 | 時程進度(進度條與落後預警) |
/ehs |
PMIS-05 | 環安衛稽核 |
/submittals |
PMIS-06 | 送審文件材料 |
/quality |
PMIS-07 | 品質稽核(查驗 + 缺失) |
/documents |
PMIS-08 | 文件/照片/影片資料庫 + 監造報表 |
資料模型依 8 大模組設計,以 Project 為核心串聯:
- PMIS-03 契約履約:
Project、ContractChange(契約變更)、Milestone(里程碑/展延)、PaymentNode(付款節點) - PMIS-04 時程進度:
WorkItem(分項工程,預定/實際/進度) - PMIS-07 品質稽核:
Inspection(查驗)、Defect(缺失) - PMIS-01 行事曆:
ReminderEvent(提醒/預警) - PMIS-02 待辦:
TodoItem(跨單位待辦) - PMIS-05 環安衛:
EhsAudit(安衛/環保/交通稽核) - PMIS-06 送審:
Submittal(送審與退件) - PMIS-08 資料庫:
MediaAsset(照片/影片/文件)、SupervisionReport(監造報表)
Schema 定義於 prisma/schema.prisma,資料庫連線設定於 prisma.config.ts。
- Next.js 16.2.10(App Router、Turbopack、React 19)
- Prisma 7.8.0(
prisma-clientgenerator、@prisma/adapter-better-sqlite3) - TypeScript 5、Tailwind CSS v4、shadcn/ui 風格元件
npm install # 安裝套件
npm run db:migrate # 建立資料庫與資料表
npm run db:seed # 匯入範例資料
npm run dev # 啟動開發伺服器開啟 http://localhost:3000 即可看到儀表板。
| 指令 | 說明 |
|---|---|
npm run dev |
開發伺服器(Turbopack) |
npm run build |
生產環境建置 |
npm run db:migrate |
建立/套用 migration |
npm run db:generate |
產生 Prisma Client |
npm run db:seed |
匯入範例資料 |
npm run db:studio |
開啟 Prisma Studio |
npm run db:reset |
重置資料庫並重新 seed |
- AI 流程優化設計 — 各模組 AI 應用、整體架構、導入藍圖與風險控管。
專案採單向分層,禁止跨層存取:
頁面 / 元件 / server actions
↓ 只能呼叫
service(商業邏輯)
↓ 只能呼叫
repository(唯一能操作 DB)
↓
Prisma / SQLite
| 目錄 | 職責 | 規則 |
|---|---|---|
src/constant |
常數(列舉標籤/樣式、行事曆設定等) | 無副作用 |
src/lib |
通用函式庫(cn、日期/金額格式化) |
與領域無關 |
src/repository |
所有 DB 操作邏輯 | 只有 repository 可操作 DB;Prisma client 僅於 repository/client.ts 實例化 |
src/service |
服務商業邏輯(驗證、彙整、組合) | 只有 service 可呼叫 repository;不得直接碰 DB |
src/app、src/components |
畫面與互動 | 只呼叫 service,不得引用 repository 或 Prisma |
畫面最右側的 AI 對話面板串接 Google Gemini API。於 .env 填入金鑰即可啟用:
AI_KEY="你的 Gemini API 金鑰"
AI_MODEL="gemini-2.5-flash" # 可選,預設 gemini-2.5-flash
流程為 AiPanel(前端) → /api/chat(route handler) → service/ai.service.ts → Gemini。金鑰僅在伺服器端讀取,不會外洩到瀏覽器。未設定 AI_KEY 時,面板會回覆提示訊息。
預設使用本機 SQLite(.env 中 DATABASE_URL="file:./prisma/dev.db")。改用 PostgreSQL/MySQL 時,調整 prisma/schema.prisma 的 datasource provider、更換對應 driver adapter 並更新 .env。