使用手冊 工程專案進度與監造管理系統 回到系統

工程專案進度與監造管理系統 使用手冊

表單編號 7016-GR-045 版別 1.7 | 手冊更新:2026-10-21(併入儀電組案件進度管理)

第一部 一般使用者

1. 角色與可使用的功能

每個帳號有一個角色,左側選單只會顯示您有權限使用的功能。角色由系統管理員指派;用 AD 登入不會改變角色。

角色主要工作可使用的選單
監造人員建立/維護自己負責的工程,每日填寫監造報表並送簽;報表核准後如需更正可建立修訂版監造總覽、工程管理、監造報表、工程統計、保險管理
工程師覆核(第一關)自己負責工程的監造報表,可退回監造總覽、工程管理、監造報表、待我簽核、工程統計、保險管理
主管(部門經理)核准(第二關)本部門監造的報表,可退回同工程師
工程管理員建立工程、維護工程保險、作廢報表監造總覽、工程管理、監造報表、工程統計、保險管理
查詢人員唯讀查詢、產生 PDF監造總覽、工程管理、監造報表、工程統計、保險管理
系統管理員所有功能,另含系統管理(見第二部)全部,另有系統管理
簽核對象由工程決定:第一關是該工程設定的「工程師」,第二關是該工程「監造部門」的部門經理,與帳號上的「直屬主管」無關。

2. 登入與登出

登入

  1. 開啟系統網址,輸入帳號與密碼,按 登入。帳號欄也可以輸入員工編號。
  2. 公司內網(登入頁顯示「目前連線為公司內網」):AD 帳號以公司網域密碼登入;忘記密碼請洽 IT(分機 365)。
  3. 內網以外(登入頁顯示「目前連線為內網以外」):一律以本機密碼登入。AD 帳號的本機密碼請先在內網登入後到「帳號設定」設定(見第 16 節),或請管理員設定,或用登入頁的「忘記本機密碼」寄送重設連結。本機帳號在內網與外網都用本機密碼。
  4. Google 登入(登入頁有「使用 Google 帳戶登入」按鈕時):只有已連結 Google 帳號的使用者可用。先以密碼登入後到「帳號設定」連結(見第 16 節),或請管理員在您的使用者資料登錄 Google Email,之後按鈕一點即登入,不必輸入本機密碼。未連結的 Google 帳號會顯示「尚未連結任何使用者」,不會自動建立帳號。公司內網 IP 站台沒有這個按鈕。
  5. 第一次用 AD 帳號登入時,系統會自動建立帳號,但需要系統管理員開通並指派角色後才能使用。此時畫面會顯示「您的帳號尚未開通或已停用,請聯絡系統管理員。」,管理員會同時收到通知,請稍候或直接聯絡管理員。

登入失敗與鎖定

  • 帳號或密碼錯誤一律顯示「帳號或密碼錯誤。」(不會告訴您是哪一個錯)。
  • 同一帳號 15 分鐘內失敗 5 次會被暫時鎖定,請等 15 分鐘後再試。帳號尚未開通時嘗試登入也會計入次數,請勿反覆嘗試。

什麼情況會被登出

  • 按右上角 登出。
  • 關閉瀏覽器。
  • 登入滿 12 小時(顯示「登入已逾時,請重新登入。」)。閒置不會被登出。
  • 帳號被停用,或密碼被重設、登入方式被變更。
系統不會因閒置而自動登出,離開座位時請按 Win + L 鎖定電腦。

3. 畫面說明與監造總覽

  • 上方列:系統名稱、 通知鈴鐺(紅色數字為未讀數)、您的姓名與角色、登出。
  • 左側選單:依角色顯示。手機或平板請按左上角 開啟「功能選單」。
  • 深色/淺色主題:右上角 按鈕。預設「自動」依時間切換(18:00~06:00 深色、其餘淺色);按一下依序切換為淺色 、深色 、自動 。手動選擇只記在您的瀏覽器。

監造總覽(首頁)

  • 我的待辦:今日待填寫的工程(您擔任監造人員、今天還沒建立報表的工程)、草稿待送簽、被退回、待我簽核;「今日尚未填報」清單可直接按 建立今日報表。
  • 工程統計:進行中/規劃中/暫停/已完工/結案的工程數。
  • 報表統計:本月報表、待簽核、已核准、已退回、草稿數。
  • 工程進度:每個進行中工程最新一份報表的預定與實際進度;差異為「實際 − 預定」,負值代表落後。
  • 保險到期提醒:即將到期與已到期的工程保險。

4. 工程管理

工程是監造報表的基礎:每份報表都屬於一個工程,簽核對象也由工程決定。

列表與查詢

  • 列表預設只顯示未完工的工程(規劃中、進行中、暫停);已完工與結案的工程不會出現。
  • 要查已完工/結案的工程:工程狀態選「全部(含已完工/結案)」或「已完工」後搜尋,或直接點列表上方的 包含已完工/結案。關鍵字搜尋同樣受工程狀態篩選限制,找不到舊案時請先切換為「全部」。
  • 即時篩選:關鍵字、案件狀態、類別、承辦人、工程狀態與「只看我承辦的」任一改變,列表就自動重新查詢(關鍵字停止輸入約半秒後),不必按搜尋。
  • 「承辦人」下拉只列出實際承辦過工程的人;勾「只看我承辦的」時以本人為準,承辦人下拉會自動清空。
  • 「清除」會回到預設(未完工)。

建立工程(監造人員、工程管理員)

  1. 左側選單 工程管理 → 建立工程。
  2. 填寫欄位(* 為必填):
    • 工程編號*(不可重複)、工程名稱*、工程狀態*(規劃中/進行中/暫停/已完工/結案)
    • 契約工期(日曆天)、開工日期、預定完工日期、實際完工日期(完工日期不可早於開工日期)
    • 原契約金額、變更後契約金額(未填時等於原契約金額)、主辦機關、承攬廠商、說明
    • 監造部門*:報表最後由此部門的經理核准
    • 監造人員(一)*:負責填寫報表的人;監造人員自己建立的工程固定為登入者本人(顯示您的姓名,不可修改)
    • 監造人員(二)(選填):每個工程最多可指派兩名監造人員,兩位權限相同——都能建立、填寫、送簽、抽回本工程的報表(可互相接手對方的草稿,例如一人請假時),也都能修改工程與維護保險。不可與監造人員(一)或工程師為同一人。
    • 工程師*:負責覆核報表的人,不可與任一位監造人員為同一人
    自動帶入:監造人員為您本人(監造人員建立時);工程師為監造人員的直屬主管;監造部門為監造人員所屬部門。選好部門後,下拉只列出該部門的人(直屬主管在其他部門也會列出);該部門只有一位時會自動帶入,沒有適合人選時會列出全部人員。帶入後仍可修改。
  3. 按 建立工程。

編輯、契約變更與刪除

  • 只有該工程的監造人員(兩位皆可)或系統管理員可以 編輯 工程與新增契約變更。
  • 契約變更:在工程頁「新增契約變更」填寫變更日期*、增減金額(可為負數)、展延天數、變更原因。系統會自動重算變更次數、展延天數、契約工期與變更後契約金額(之後這些欄位改由系統計算,不能手動修改)。預定完工日期不會自動調整,如需變更請編輯工程。契約變更建立後無法在畫面上修改或刪除,輸入前請確認。
  • 工程頁的「契約與工期」若出現「依開工日期與契約工期推算為…」提示,表示預定完工日期與工期不一致,請確認後自行修改。
  • 刪除工程僅限系統管理員,且已有監造報表或契約變更的工程不可刪除;工程結束請將狀態改為「結案」。

5. 填寫每日監造報表(監造人員)

建立報表

  1. 左側選單 監造報表 → 建立今日報表(或從監造總覽「今日尚未填報」直接建立)。
  2. 選擇工程*與填報日期*。只會列出您擔任監造人員、且狀態為規劃中/進行中/暫停的工程。
  3. 建立後會直接進入編輯頁,可分次填寫並 儲存草稿。
  • 同一工程每天只能有一份報表(已作廢的不算);填報日期不可是未來日期,也不可早於開工日期。
  • 表報編號自動產生:工程編號-R年月日(例:LNG-2026-001-R20261005)。
  • 工程與填報日期建立後不可變更;選錯請請工程管理員作廢後重建。
  • 已完工或結案的工程不能再建立報表。

各區填寫說明(依紙本 7016-GR-045 v1.7)

表單不得留白:送出簽核前,所有文字欄位(含本日天氣)都必須有內容;當日沒有該事項請填「無」。 各文字欄位下方的 填入「無」 按鈕可一鍵填入(欄位已有內容時不會覆蓋)。 草稿可以先留白,送簽時系統會列出所有空白的欄位,並直接切換到編輯頁:有問題的區段以紅框標示、區段標題下與欄位旁列出原因;頁首的「以下區段需補填」可直接點選跳到該區段。補填後按 儲存草稿,再回檢視頁送出簽核。PDF 上仍沒有資料的欄位(例如尚未完工的「實際完工日期」)一律印「無」;週報表當天沒有資料的格子,在格子正中央印「無」。
區段內容送簽時必填
第一區 基本資料本日天氣(上午/下午)、預定進度 %、實際進度 %(0–100);契約資料自動帶入天氣必填
第二區 一、工程進行情況當日施工概況必填
第三區 二、監督依照設計圖說及核定施工圖說施工文字說明;勾選「本日辦理項目」:施工抽查/檢驗停留點/其他,各項可填檢查內容、檢查結果、檢查日期(未填日期以填報日為準)文字必填
第四區 三、查核材料規格及品質文字說明;勾選:檢驗停留點/材料抽驗/其他(同上)文字必填
第五區 四、督導工地職業安全衛生事項(一)施工廠商施工前檢查事項辦理情形:完成/未完成;(二)其他工地安全衛生督導事項(一)必選、(二)必填
第六區 五、其他約定監造事項文字說明必填
第七區 各項保險期間是否在有效期限內選「是/否」,下方列出本工程保險供對照必選
第八區 簽核儲存後到報表檢視頁送出簽核—

報表狀態

狀態說明可否修改
草稿填寫中,尚未送出可(建立者)
待覆核已送出,等待該工程的工程師覆核不可;需先「抽回修改」
待核准工程師已覆核,等待監造部門經理核准不可;需先「抽回修改」
已退回被工程師或經理退回,請依退回意見修改可(建立者)
重新送簽退回後修改再送出,重新從工程師覆核開始不可;需先「抽回修改」
已核准部門經理已核准不可;需「建立修訂版」
已作廢已作廢,日期可重新建立報表不可

報表清單與搜尋

可依關鍵字、工程、狀態、日期區間搜尋。「只看我負責的工程」(我填報的,或我擔任監造人員、工程師、部門經理的工程)對監造人員、工程師、經理預設勾選,取消勾選可看全部。

  • 狀態預設為「未核准」:已核准的報表不會列出;要查已核准的報表,狀態選「全部狀態(含已核准)」或「已核准」,或點列表上方的 顯示全部(含已核准)。
  • 即時篩選:任一條件改變,列表就自動重新查詢(關鍵字停止輸入約半秒後),不必按搜尋。

6. 送簽與簽核流程

報表經過三關:監造人員送出 → 工程師覆核 → 部門經理核准。簽核按鈕在報表檢視頁的「簽核動作」區,只會顯示您目前可以執行的動作。

草稿監造人員填寫
待覆核工程師
待核准部門經理
已核准可產生正式 PDF

任何一關退回 → 「已退回」→ 監造人員修改後「重新送簽」→ 重新從工程師覆核開始。

按鈕誰可以按結果意見
送出簽核報表建立者(監造人員)草稿 → 待覆核,通知工程師—
重新送簽報表建立者已退回 → 重新送簽(待覆核),通知工程師—
覆核通過該工程的工程師待覆核 → 待核准,通知部門經理選填
核准監造部門的部門經理待核准 → 已核准,通知監造人員選填,會印在 PDF
退回目前這一關的簽核人→ 已退回,通知監造人員必填
抽回修改報表建立者(尚未核准時)→ 草稿,修改後須重新經兩關簽核選填
作廢工程管理員、系統管理員(草稿/待簽核/已退回)→ 已作廢必填
建立修訂版報表建立者(已核准時)→ 草稿(版次 +1),重新填寫送簽必填

送出前系統會檢查

  • 「一、工程進行情況」已填寫、第五區(一)與第七區已選擇。
  • 工程已指定工程師;工程的監造部門已設定部門經理。若出現「尚未指定工程師」或「尚未設定部門經理」,請洽工程的監造人員或系統管理員。
  • 工程狀態不是已完工或結案。
簽核意見最多 500 字。簽核歷程是稽核紀錄,建立後不可修改或刪除。若出現「報表狀態已被其他人變更」,代表別人剛處理過,請重新整理頁面。

7. 待我簽核(工程師、部門經理)

  1. 收到通知(鈴鐺及 Email),或點左側選單 待我簽核。工程師看到自己負責工程的「待覆核」報表;經理看到本部門監造工程的「待核准」報表。
  2. 點報表進入檢視頁,確認內容、附件與職安衛紀錄。
  3. 在「簽核動作」區填寫意見,按 覆核通過/核准,或填寫退回意見後按 退回。

待我簽核頁只列清單,簽核動作一律在報表頁執行。

8. 附件

  • 在報表檢視頁的「附件」卡片 上傳附件。
  • 可上傳 PDF、JPG、JPEG、PNG、DOCX、XLSX,每個檔案最大 10 MB。檔案內容必須與副檔名相符;含巨集的 Word/Excel 會被拒絕。
  • 只有報表在草稿或已退回時,建立者才能上傳或刪除附件;送出簽核後附件即鎖定。
  • 已核准版本的附件不可刪除(即使建立修訂版);如需更正請另行上傳新附件。
  • PDF 與圖片可直接開啟預覽,Word/Excel 會下載。

9. 產生 PDF 與版本

  • 報表頁按 產生 PDF,會在新分頁開啟,格式與紙本 7016-GR-045 v1.7 相同,檔名為 工程編號_監造報表_年月日.pdf。
  • 任何狀態都可以產生 PDF;尚未核准的報表會有「草稿」「待覆核」等淡色浮水印。
  • 已核准的報表依核准當下的內容產生,之後修改工程資料不會影響已核准的 PDF。
  • 「監造單位簽章」有三格章:監造人員(送出後)、工程師(覆核後)、經理(核准後)。章是系統依簽核紀錄產生(姓名+員工編號+民國時間),不是電子簽章。
  • 報表頁下方「版本快照」列出每次送出、覆核、核准、退回、抽回、作廢、修訂時的完整內容,可用 列印此版 產生當時的 PDF。

監造週報表(7016-GR-048 v2.1)

  • 週報表不用另外填寫:系統把該週(週一至週日)的監造日報彙整成橫式的「監造週報表」。到工程頁的 監造週報表 區塊選該週任一日期,或在報表頁按 本週週報表。檔名為 工程編號_監造週報表_週一-週日.pdf。
  • 七天逐日對應當天的日報,沒有日報的日子留白並標示「無監造日報」;已作廢的日報不列入。本週預定/實際進度取本週最後一日的日報;該週跨月時另填該月底的進度。
  • 「監造單位簽章」引用本週最後一日日報的簽核紀錄:該日報送出後有監造人員章、覆核後有工程師章、核准後有經理章;其他日子的日報已核准也不會蓋在週報表上。簽章處會註明引用哪一天的日報與本週納入的日報狀態。
  • 浮水印:引用的日報未核准時顯示其狀態;該日報已核准但本週其他日報未核准時顯示「含未核准日報」;全部核准才沒有浮水印。

10. 保險管理

  • 左側選單 保險管理 可查看所有工程保險,依工程、保險種類、狀態篩選;「剩餘」欄顯示剩幾天或已逾期幾天。
  • 狀態:有效 即將到期(30 天內)已到期 已作廢。狀態依保險迄日自動判定。
  • 新增保險(該案監造人員、系統管理員):到工程頁 新增保險,填寫保險種類*(雇主意外責任險及職業災害補償保險附加條款/雇主補償契約責任保險或團體意外傷害險/其他)、保單號碼、保險起日、保險迄日。種類為「其他」時,請在編輯頁的備註寫明保險名稱,PDF 報表「其他:」會印出備註。
  • 只有該案監造人員(及系統管理員)可以新增、修改、作廢該工程的保險與上傳/刪除保險附件;其他人只能查看。
  • 保險不能刪除;不再使用請在編輯頁勾選「標示為已作廢」。
  • 保險即將到期或已到期時,系統每天會通知工程管理員。

11. 工程統計

  • 工程進度趨勢:選擇工程後按 切換,顯示預定與實際進度曲線。
  • 每月監造報表數量與簽核情形:近 12 個月的報表數、核准數、退回數。
  • 報表狀態分布、工程狀態統計、保險到期統計。

12. 通知與 Email

通知誰會收到Email
您有一份監造報表待覆核該工程的工程師 會寄
您有一份監造報表待核准監造部門的部門經理 會寄
您的監造報表已退回/已核准報表建立者僅站內通知
工程保險將於 N 天內到期/已到期工程管理員、系統管理員僅站內通知
帳號待開通系統管理員 會寄
  • 點右上角 進入通知頁,可篩選未讀/已讀、類型;點通知會標示已讀並前往該報表或頁面。
  • 全部標示為已讀、清除已讀;單則可按 刪除。通知保留 3 個月。
  • Email 寄到您帳號上的信箱;收不到請請系統管理員確認您的 Email 是否正確。抽回、作廢、建立修訂版不會發通知。

13. 常見問題

建立報表時找不到我的工程?
只會列出您擔任監造人員、且狀態為規劃中/進行中/暫停的工程。請確認工程的監造人員是您,或洽工程管理員。
「此工程今天已有報表」?
同一工程每天只能有一份報表,請在監造報表清單找到它繼續編輯。
送出時出現「尚未指定工程師」或「尚未設定部門經理」?
工程缺少簽核人。工程師請由工程的監造人員在工程頁編輯;部門經理請洽系統管理員在部門管理設定。
已送出的報表發現錯字?
尚未核准:按 抽回修改,改完重新送出。已核准:按 建立修訂版,填寫修訂原因後修改並重新送簽。
填錯工程或日期?
工程與日期建立後不可變更,請工程管理員將報表作廢,再重新建立。
附件刪不掉?
報表送出後附件鎖定;已核准版本的附件永遠不可刪除,請上傳更正後的新附件。
被鎖定無法登入?
15 分鐘內失敗 5 次會暫停 15 分鐘。AD 密碼請洽 IT(分機 365),本機帳號密碼請洽系統管理員。

14. 案件進度(專案總覽、我的案件)

2026-10-21 起「儀電組專案進度管理系統」(ppts20)併入本系統:每一筆工程同時也是「案件」,欄位包含案件類別/性質/狀態、承辦人、預算年度與金額、決標資訊、採購時程、進度紀錄與多張保單。原 ppts20 的資料已全數匯入,承辦人沿用原帳號(員工編號)登入。

案件與工程的關係

  • 建立案件在 工程管理 → 建立工程(或專案總覽右上角「新增案件」)。「需要監造」勾選時才需要指派監造部門/監造人員/工程師,也才能填寫監造日報;只管進度的案件不必勾選。
  • 案件狀態(履約中、請購中、規劃中、已完工、終止、暫停…)由管理員維護,系統依狀態「類型」自動對應工程狀態(進行中、規劃中、已完工、暫停、結案)。
  • 工程編號可留空(規劃中、請購中案件尚無編號);填寫後才會出現在監造報表與 PDF。
  • 誰可以修改:該案承辦人本人、該案監造人員、具「維護全部案件」權限者、系統管理員。其他人只能檢視。

採購時程與日期

表單中的「採購時程」表格(請購、廠購審、部購審、採購處、公告、決標、開工、完工、驗收 × 預定/實際)是所有日期的唯一來源:「決標」實際日期即決標日期、「開工」實際日期即開工日期、「完工」預定/實際日期即預定/實際完工日期。不經過的階段兩格都留空,明細頁的甘特圖就不顯示該階段。日期請輸入西元年(例如 2026-03-30),民國年會被擋下。

進度紀錄

  1. 開啟案件明細頁,捲到「進度紀錄」區塊。
  2. 填回報日期、預計/實際進度(%)、本次進度內容,已完工時填實際完工日期,按 發布進度更新。
  3. 案件的整體進度永遠等於最新一筆有實際進度的紀錄;紀錄可編輯、刪除(只有可修改案件的人)。

專案總覽

側邊選單 案件進度 → 專案總覽:系統主動提醒(7 天內預計完工、超過 14 天未回報、進度落後超過 10 個百分點)、進行中案件的保險到期提醒(已到期/1 個月內/3 個月內)、年度與類別/狀態統計、個人案件統計。一般承辦人只看自己的案件,管理員看全部。監造總覽也會摘要顯示這些提醒。

我的案件(資料表)

案件進度 → 我的案件:以試算表方式列出本人承辦的案件,點儲存格即可修改(離開儲存格自動存檔,綠色閃示表示成功,紅色表示失敗並還原)。可全表搜尋、分組、選擇顯示欄位、匯出目前表格為 CSV。進度百分比與保險日期為唯讀,請分別由案件明細頁的進度回報與保險維護。

15. 案件報表與廠務會議報告

  • 全組報表(簡)/全組報表(詳):A4 直式,依案件類別分組;簡表列出名稱、性質、承辦人、開工/預計完工、保險起迄,詳表另含工期說明、採購時程甘特圖與全部進度紀錄。右上角可切換文字摘要版與圖表版(統計面板為圖表)。
  • 我的報表:只列本人承辦的案件(含決標總金額)。
  • 工具列:關鍵字即時篩選(空白分隔多個關鍵字、符合處以黃色標示、Esc 清除)、案件狀態勾選(已完工、暫停預設不勾,其餘勾選狀態記在瀏覽器)、只看列管、顯示進度、進度內容以段落顯示;點承辦人姓名可直接篩選該人案件;點案件列開啟案件頁。統計面板會依目前顯示的案件重新計算。
  • 列印:按 列印 / 儲存為 PDF,列印目的地選「另存為 PDF」。
  • 廠務會議報告:橫式 A4 簡報,章節為「一、專案列管工作追蹤」(勾選「專案列管」的案件,一案一頁含預定時程與甘特圖)、「二、例行工作與發包」(資本支出依預算年度分表、例行維修依狀態分組、長約案)、「三、各組協調事項」。可選部門、報告日期、已完工案件保留天數與八種風格(有底色的風格列印時請勾選「背景圖形」);「編輯文字」可直接在頁面上修改再列印(不會寫回資料庫);「播放」或 F5 進入全螢幕逐頁播放。
  • 匯出 CSV(專案總覽或工程管理右上角):全部案件含保單明細,Excel 可直接開啟。

16. 帳號設定與本機密碼

點右上角自己的姓名進入「帳號設定」。

  • AD 帳號:公司內網以 AD 密碼登入,本系統不保存 AD 密碼;這裡設定的本機密碼只用於內網以外的登入,兩組密碼互不影響。第一次設定不需輸入舊密碼(以已登入作為身分證明)。
  • 本機帳號:內網與外網都用本機密碼;變更時需輸入目前密碼。
  • 密碼規則:至少 12 字、須同時含英文與數字,強度須達「可以」以上,且不可與最近 5 次用過的密碼相同。輸入時下方會顯示強度,「弱」以下會被拒絕;建議用 3~4 個不相關的英文單字或一句好記的話。變更後其他裝置上的登入會自動失效,目前這台維持登入。
  • 忘記本機密碼:登入頁「忘記本機密碼」輸入帳號或 Email,系統寄送 1 小時內有效的重設連結(需管理員設定郵件主機);沒有收到信或沒有 Email 時請管理員在「使用者管理」重設。
  • Google 帳號(站台有啟用時):按「使用 Google 帳戶繼續」並在 Google 視窗選擇帳號即完成連結,之後登入頁可直接以 Google 登入。一個 Google 帳號只能連結一位使用者。「解除連結」後只能以密碼登入;尚未設定本機密碼時不能解除。

第二部 系統管理者

本部適用角色為「系統管理員」的人員。左側選單 系統管理 下有:使用者管理、部門管理、角色與權限、稽核紀錄。

1. 管理者的職責

  • 開通 AD 首次登入的帳號並指派角色、部門。
  • 維護部門與部門經理(報表第二關核准人)。
  • 停用離職或調職人員、重設本機帳號密碼。
  • 查詢稽核紀錄、確認每日備份正常。
  • 保留至少一個可登入的本機管理員帳號,作為 AD 故障時的緊急存取帳號(系統會強制保留)。
系統管理員可以執行所有簽核動作(覆核、核准、退回、作廢)。請僅在必要時使用,所有動作都會記錄在稽核紀錄中。

2. 使用者管理

清單

可依關鍵字(帳號/姓名/員工編號/Email)、狀態(啟用/待開通/停用)、登入方式、角色、部門篩選。有帳號等待開通時,頁面上方會顯示提醒與 查看待開通帳號。

新增使用者

  1. 新增使用者,選擇登入方式*:AD 帳號(建議,使用公司網域密碼)或本機帳號。
  2. 帳號*:英數字與 . _ -,建立後不可變更;AD 帳號必須與網域帳號相同(通常為員工編號),一律以小寫保存。
  3. 姓名*、Email(待簽核等通知會寄到這裡,請務必填寫公司信箱)、部門、角色*。員工編號不必另填,系統以帳號作為員工編號(簽章與登入皆以此為準)。
  4. 本機帳號需設定密碼:至少 12 字,須包含英文與數字,強度須達「可以」以上(輸入時下方會顯示)。
  5. Google Email(站台啟用 Google 登入時才有此欄):選填。填入後使用者第一次以該 Google 帳號登入即自動完成連結;使用者也可自行在「帳號設定」連結。更改或清空此欄會解除已有的連結。

編輯頁的其他功能

  • 停用帳號/重新啟用:停用後該使用者立即被登出。不可停用自己。
  • 重設密碼(本機帳號):重設後請以安全方式告知使用者。
  • 變更登入方式:本機 → AD 會清除密碼(帳號須為小寫英數字);AD → 本機需設定新密碼。
  • 查看稽核紀錄:列出與此帳號相關的操作。
  • 「直屬主管」:監造人員建立工程時,「工程師」會預設帶入其直屬主管,因此請為每位監造人員設定直屬主管為其工程師。報表實際的簽核人仍以工程上設定的工程師與監造部門經理為準。

刪除帳號

帳號原則上「停用」即可。只有在下列資料都沒有時才能刪除:工程(建立者/監造人員/工程師)、監造報表、報表檢查項目、簽核紀錄、版本快照、契約變更、附件、擔任他人直屬主管、擔任部門經理。不可刪除時,畫面會列出原因與筆數。

只有稽核紀錄(例如只登入過)的帳號可以刪除:稽核紀錄會保留,操作者改顯示「(未登入/已刪除帳號)」,原帳號資料記在該筆「刪除帳號」紀錄中。

系統必須保留至少一個啟用中、具使用者管理權限的本機帳號;對這個帳號的停用、刪除、降級或轉為 AD 會被拒絕。

3. AD 帳號開通流程

  1. 同仁用 AD 帳號第一次登入,系統自動建立帳號:狀態「待開通」、角色「查詢人員」,部門依 AD 部門代碼對照(對照不到時放在「未分類」)。
  2. 所有系統管理員會收到 站內通知與 Email「帳號待開通:姓名」。
  3. 點通知(或使用者管理 → 狀態「待開通」)進入該帳號編輯頁,確認姓名、部門,指派正確角色(監造人員/工程師/主管…)。
  4. 按 開通帳號。請同仁重新登入即可使用。
  • 每個帳號只在第一次登入時通知一次。之後每次 AD 登入會同步姓名、Email、部門、員工編號,但不會改變角色,也不會讓已停用的帳號恢復。
  • 同名的本機帳號不會被 AD 接管。
  • 同仁若在開通前反覆嘗試登入,可能被鎖定 15 分鐘。

4. 部門管理

  • 新增部門:部門代碼*(建立後不可變更,建議與 AD 部門代碼相同,AD 登入才能自動對應)、部門名稱*、部門經理。
  • 部門經理就是報表第二關的核准人。下拉選單只會列出啟用中、具核准權限的帳號(角色「主管」或系統管理員)。若現任經理已停用或改了角色,選單會顯示「現任經理無核准權限或已停用,請更換」,請改選其他人。清單出現「有工程使用此部門,但尚未設定經理」時請盡快設定。
  • 有成員(含已停用)、有工程使用、或有下層部門的部門不能刪除。

5. 角色與權限

  • 以矩陣勾選各角色的權限,調整後立即生效,使用者不需重新登入。
  • 可 新增角色(角色代碼為小寫英文、建立後不可變更)。角色不能刪除;仍有啟用中使用者的角色不能停用。
  • 「系統管理員」角色固定擁有全部權限,只能修改名稱與說明。
  • 主要權限:建立/編輯工程、建立/編輯/送出報表、覆核(工程師)、核准、退回、作廢、修訂、維護保險、匯出 PDF、使用者管理、系統管理。

6. 稽核紀錄

  • 記錄登入/登出、資料新增修改刪除、簽核、PDF 匯出、帳號管理等操作,不可修改或刪除。
  • 可依使用者、模組、動作、日期區間、關鍵字(異動內容/IP)查詢,每頁 50 筆;變更內容以「修改前 → 修改後」顯示。
  • 匯出 CSV:產生 稽核紀錄_年月日_時分秒.csv(Excel 可直接開啟),匯出動作本身也會被記錄。
  • 報表頁的「操作紀錄」、使用者頁的「查看稽核紀錄」會直接帶入該筆資料的篩選。

7. 上線前的基本設定

  1. 部門管理:建立各監造部門,代碼與 AD 部門代碼一致,並設定部門經理。
  2. 使用者:請工程師、主管、監造人員先用 AD 登入一次,再逐一開通並指派角色;確認每人都有公司 Email。
  3. 回到部門管理,把部門經理設為已開通的「主管」帳號。
  4. 工程:由監造人員或工程管理員建立工程,指定監造部門、監造人員、工程師。
  5. 試填一份報表,走完 送出 → 覆核 → 核准 → 產生 PDF,確認通知與 Email 都有收到。

8. 主機維運(備份、還原)

以下指令需 SSH 登入主機(QNAP)執行。PHP 位置為 /usr/local/apache/bin/php,專案目錄為 /share/CACHEDEV2_DATA/DV2/yalng/dwr。

cd /share/CACHEDEV2_DATA/DV2/yalng/dwr alias php=/usr/local/apache/bin/php
指令用途
$P bin/backup.php備份資料庫(storage/backups/backup_日期_時間.sqlite)與附件,自動刪除 30 天前的備份(--keep=60 可改天數)
$P bin/restore.php --list
$P bin/restore.php 檔名
列出備份/還原指定備份。需輸入 RESTORE 確認;還原前會先把目前資料庫另存為 pre_restore_*,並補回附件。還原前請先停止網站服務。
$P bin/create-admin.php建立本機系統管理員(緊急時使用,例如所有管理員都無法登入)
$P bin/ldap-check.php AD帳號逐步檢測 AD 連線、登入、屬性與部門對照,不寫入任何資料
$P bin/migrate.php系統更新後執行資料庫結構更新(status 可查看狀態)。執行前請先備份
$P bin/insurance-scan.php更新保險狀態並發出到期提醒(建議每日排程)
$P bin/purge-old-records.php清除 90 天前的登入嘗試與 3 個月前的通知(不會動到稽核、簽核、版本紀錄)
$P bin/check-deploy.php部署檢查清單(PASS/WARN/FAIL),不修改任何設定

建議排程(crontab)

0 1 * * * cd /share/CACHEDEV2_DATA/DV2/yalng/dwr && /usr/local/apache/bin/php bin/backup.php >> storage/logs/backup.log 2>&1 0 7 * * * cd /share/CACHEDEV2_DATA/DV2/yalng/dwr && /usr/local/apache/bin/php bin/insurance-scan.php >> storage/logs/insurance.log 2>&1 0 3 * * 0 cd /share/CACHEDEV2_DATA/DV2/yalng/dwr && /usr/local/apache/bin/php bin/purge-old-records.php >> storage/logs/purge.log 2>&1

QNAP 請寫入 /etc/config/crontab 後執行 crontab /etc/config/crontab,重新開機才不會遺失。備份與資料庫在同一台主機,建議以 Hybrid Backup Sync 將 storage/backups/ 定期複製到其他設備。

複製或搬移專案目錄

sessions/ 目錄存放使用者登入資料,只有網頁伺服器可以讀取。複製專案時請略過此目錄,例如:robocopy V:\yalng\dwr 目的地 /E /XD V:\yalng\dwr\sessions。搬移後系統會自動重建,使用者重新登入即可。

9. 系統參數與 .env

目前系統沒有「系統設定」畫面。下列參數存在資料庫 system_settings:

參數目前值說明
login_max_failures/login_lockout_minutes5/15登入失敗鎖定門檻與分鐘數
insurance_expiry_alert_days30距到期幾天內視為「即將到期」
upload_max_size_mb/upload_allowed_ext10/pdf,jpg,jpeg,png,docx,xlsx附件大小與格式
auth_default_typead未建檔帳號走 AD 驗證(首次登入自動建立待開通帳號)
company_name、report_title、form_no、form_version—PDF 表頭與表尾文字

主機設定在專案根目錄的 .env(修改後立即生效):

  • LDAP_*:AD 主機(Hqsdc5.cpc.com.tw,StartTLS 加密)、搜尋範圍、CA 憑證。
  • MAIL_HOST/MAIL_FROM:公司郵件主機與寄件者;留空即不寄 Email。
  • NOTIFY_CHANNELS/NOTIFY_EMAIL_TYPES:啟用 Email 通知的類型(目前為待簽核)。要讓退回、核准也寄信,加上 report_rejected,report_approved。
  • APP_URL:Email 內連結使用的網址。
  • GOOGLE_CLIENT_ID:Google 登入的 OAuth 用戶端 ID(Google Cloud Console → 憑證 → 網頁應用程式,「已授權的 JavaScript 來源」填本站 https 網址)。留空即停用;只適用有網域名稱的 HTTPS 站台,內網 IP 站台請留空。GOOGLE_ALLOWED_HD 可限制只接受某個 Google Workspace 網域。設定後執行 php bin/check-deploy.php 檢查。
  • APP_ENV:目前為 staging(網站尚未使用 HTTPS);改用 HTTPS 後請改為 production。

10. 故障排除

AD 帳號都無法登入,畫面顯示「目前無法連線 AD 驗證服務」
以本機管理員登入處理。主機執行 $P bin/ldap-check.php 某人的AD帳號 查看卡在哪一步;常見原因為 AD 主機憑證過期或網路中斷。
本機管理員全部無法登入
主機執行 $P bin/create-admin.php 建立新的本機管理員。
報表停在「待核准」沒人能核准
確認該工程監造部門的部門經理已設定,且角色為「主管」並已開通。
沒有收到 Email
確認收件人帳號的 Email 是公司信箱;再查看 storage/logs/app-日期.log 中的「通知傳送失敗」或「帳號待開通通知寄送失敗」訊息。
使用者反映登入後很快被登出
登入上限為 12 小時,且關閉瀏覽器即登出。若在更短時間內被登出,請檢查該帳號是否被停用或重設密碼,並查看稽核紀錄。
Windows 無法複製專案目錄
略過 sessions/ 目錄(見第 8 節)。
AD 帳號在外網登入顯示「帳號或密碼錯誤」
該帳號尚未設定本機密碼:請在「使用者管理 → 重設密碼」為其設定,或請使用者在內網登入後到「帳號設定」自行設定。
內網的使用者被判定為「內網以外」
檢查 .env 的 INTRANET_CIDRS 是否包含該網段;若經反向代理,TRUSTED_PROXIES 須列出代理 IP,否則不採信 X-Forwarded-For。

11. 案件設定與選單顯示

  • 系統管理 → 案件類別/案件性質/案件狀態:新增、改名、調整列印排序(報表分組順序)、刪除(仍有案件使用時不可刪除)。案件以編號參照,改名立即反映到所有案件。
  • 案件狀態另有:類型(一般、進行中、已完工、暫停、終止、未開工)決定保險到期提醒、完工判斷、新案件預設、標籤配色與對應的工程狀態;久未更新提醒(超過設定天數未回報進度時提醒);報表顯示(取消後不列入報表與會議報告)。
  • 系統管理 → 選單顯示:取消勾選即在左側選單隱藏該項目(全站生效),只影響顯示、不影響權限;監造總覽與系統管理不可隱藏。
  • 權限:case.view(檢視案件)、case.edit_own(維護本人案件)、case.edit_all(維護全部案件,取代 ppts20 的超級使用者)、case.report(全組報表、匯出)、case.meeting_report(廠務會議報告)、case.settings(本節的設定頁)。角色「承辦人」(case_officer)對應 ppts20 的一般承辦人。
  • 系統參數:case_idle_days(久未更新天數,預設 14)、case_behind_threshold(進度落後門檻,預設 10 個百分點)、nav_hidden(隱藏的選單項目)。

12. ppts20 資料匯入

ppts20 的 work_report.sqlite 以唯讀方式讀取,絕不寫回;匯入可重複執行(已匯入者更新,不會重複建立)。

$P bin/migrate.php
$P bin/import-ppts.php --source=database/import/work_report.sqlite --dry-run --department-code=7008
$P bin/import-ppts.php --source=database/import/work_report.sqlite --department-code=7008
  • --dry-run:在交易內執行後回滾,只輸出報表與衝突清單;正式匯入前會自動備份資料庫到 storage/backups/。
  • 報表與衝突清單同時寫入 storage/logs/import-ppts-日期.log:使用者合併結果、工程編號重複、孤兒進度紀錄、日期倒置等。
  • 使用者:帳號(員工編號)與 dwr 既有帳號相同者合併,保留 dwr 的角色與部門,並沿用 ppts20 密碼作為本機密碼;新建者為 AD 帳號、角色「承辦人」(ppts20 admin → 系統管理員)。
  • 案件:工程編號與 dwr 既有工程相同者合併(ppts20 欄位覆蓋案件欄位、dwr 監造欄位保留);新建者「需要監造」預設關閉。
  • 正式切換:重新複製最新的 dwr 資料庫與 ppts20 資料庫 → migrate → import;期間舊系統照常使用。