領域概念
這頁把瑞成 PMS 背後的規則講清楚——「為什麼系統這樣運作」。
看懂這幾條，操作時就不會困惑「為什麼這個案子不能刪」「為什麼我填不了進度 %」「為什麼燈號是紅的」。這些規則不是隨意設定的，而是對應瑞成事務所實際的辦案流程與結構技師的簽證責任。其他頁面若提到某個名詞，多半都連回這裡。
這頁沒有截圖，因為它講的是觀念
想看實際畫面，每段都會告訴你「去哪裡看」——例如案件列表在 /guide-zh/cases、單一案件細節在 /guide-zh/case-detail、整體燈號總覽在 /guide-zh/dashboard。
六大分類（A1–B3）
每個案子都屬於一種分類。分類決定兩件事：它是公共工程還是私人案，以及它用哪一種進度模式（進度 % 怎麼算，見下一段）。
| 代碼 | 全名 | 公或私 | 預設進度模式 | 用途 / 備註 |
|---|---|---|---|---|
| A1 | 設計監造 | 公共工程 | 節點式 | 預設 6 個節點：基本設計 15% → 細部設計 25% → 審查送件 10% → 審查通過／修正 10% → 請照 10% → 監造啟動 30%（合計 100%） |
| A2 | 鑑定 | 公共工程 | 節點式 | 節點依委託書內容設定 |
| A3 | 巡查 | 公共工程 | 節點式 | 年度週期：四季巡查各佔 25% |
| B1 | 建案 | 私人案 | 自填式 | 建商的結構設計案 |
| B2 | 計算案 | 私人案 | 自填式 | 唯一支援母子追加案的分類（見下方〈母子追加案〉） |
| B3 | 鑑定案 | 私人案 | 彈性混合式 | 四種模板起步：現況鑑定／鄰損鑑定／安全鑑定／法院評估 |
自訂分類：除了這六種，管理員可以新增自己的分類（代碼像 S1、S2…），未來接到新型案件不必聯絡開發方。規則：
- 只有管理員能新增／編輯／刪除自訂分類。
- 分類代碼建立後就不能改（改了會讓既有案件對不上），名稱與節點樣板則可以改。
- 改分類設定只影響之後新建的案件，不會動到舊案。
- 有案件正在用的自訂分類不可刪；內建的六大分類永遠不可刪，只能編輯它的節點樣板。
案號怎麼編
每個案子的案號格式是 RC-YYYY-NNN（年度＋流水號），例如 RC-2026-007。子案號則是主案號後面加 -1、-2。
在哪裡看：新增案件時選分類；分類與節點樣板的管理在 /guide-zh/settings。
三種進度模式
「進度 %」代表這個案子做到幾成。不同分類用不同方式算進度，這就是進度模式。
| 模式 | 進度怎麼算 | 誰能編輯進度 | 何時用 |
|---|---|---|---|
| 節點式 | 案子拆成幾個固定節點，每個節點帶一個權重（全部加起來 100%）。整案進度 = 已完成節點的權重加總，系統自動算，不用手填數字。節點不能在單一案件裡隨意增刪（要改得從樣板層級改）。 | 管理員、以及被指派的技師可以「標記節點完成」；行政不行（見下方核心界線） | A1／A2／A3 公共工程 |
| 自填式 | 沒有固定節點，由技師手動填整案的總進度 %。每次更新都必須填一句備註，這樣責任才可追溯。因為沒有節點時程，這類案子不畫甘特圖。 | 同上 | B1／B2 私人案 |
| 彈性混合式（僅 B3） | 從四個模板之一起步，但節點可以自由增、刪、改——因為鑑定案個案差異大、公會要求不一，模板只是起點。進度算法同節點式：已完成節點的權重加總。 | 同上 | B3 鑑定案 |
自填式案子超過 14 天沒更新會提醒
自填式進度全靠人手動填，所以如果一個自填式案子超過 14 天沒人更新進度，系統會發提醒，避免案子被遺忘。
進度落差是什麼
你會在儀表板看到「進度落差」這個詞，它的意思是：時程消耗 % 減掉 實際進度 %。數字大於 0 就代表「時間用掉的比進度還多」，也就是落後了。時程消耗 % 是什麼，看下一段。
在哪裡看：單一案件的進度與節點在 /guide-zh/case-detail。
時程燈號預警
每個進行中的案子，儀表板上都有一顆燈號（綠／黃／橙／紅），一眼就知道哪些案子時間快用完了。燈號是自動算的，不用人去設定。
燈號看的是「時程消耗 %」
| 燈號 | 時程消耗 % |
|---|---|
| 🟢 綠 | 低於 50% |
| 🟡 黃 | 50%–74% |
| 🟠 橙 | 75%–89% |
| 🔴 紅 | 90% 以上 |
時程消耗 % 怎麼算
時程消耗 % ＝（已過的業主工作日）÷（合約總業主工作日）
注意：算的是「業主工作日」，不是日曆天。同樣過了 30 天，政府機關案和半導體廠案消耗的工作日不一樣（為什麼，看下一段〈業主工作日與工作日曆〉）。
燈號每天凌晨 02:00 才重算
系統每天凌晨 02:00 自動掃描所有案件、重算一次燈號。所以白天看到的燈號，是當天凌晨的結果——這是正常的，不是當下即時計算。
哪些案子不算燈號
已結案、已作廢、還沒開始的案子不參與燈號計算（它們不會亮燈，也不會發提醒）。只有「進行中」的案子才算。
通知怎麼來
- 只用系統內的鈴鐺通知，畫面右上角的鈴鐺會跳數字。系統明確不寄 Email、不發 LINE。
- 會觸發通知的情況（限進行中案件）：亮紅燈（≥90%）、亮橙燈（75–89%）、節點已逾期、節點 7 天內到期、自填式超過 14 天沒更新。
- 加重情況：如果一個案子「關鍵前置資料還沒到 ＋ 時程又超標」，它會在儀表板的「需要注意的案件」裡標紅，提醒你優先處理。
在哪裡看：整體燈號與待辦在 /guide-zh/dashboard。
業主工作日與工作日曆
為什麼要算「業主工作日」而不是日曆天？因為不同業主的上班節奏差很多：政府機關春節整整放兩週，半導體廠卻是 24 小時不停工。用日曆天一視同仁會失真，所以每個業主都綁定一種工作日曆，時程消耗就照那本日曆算。
| 工作日曆 | 哪些天算工作日 | 典型業主 |
|---|---|---|
| 政府機關 | 週一至週五，國定假日休，春節 2 週不計入時程消耗 | 公部門、公共工程 |
| 一般建商 | 週一至週六，國定假日休（新案的預設） | 建商、私人企業 |
| 半導體廠 24/7 | 全年無休，照日曆天算 | 半導體廠、不停工的工地 |
- 每個業主只綁一種工作日曆，這本日曆直接影響該業主名下所有案子的時程消耗。
- 工作日曆的自訂與設定只有管理員能做。
在哪裡看：業主綁定的工作日曆在 /guide-zh/clients；日曆本身的設定在 /guide-zh/settings。
三層權限（管理員／行政／一般）
系統有三種角色：管理員（Admin）／行政（Operator）／一般（Staff）。權限設計的核心精神是——行為留痕、責任可溯：行政可以幫忙代操作大部分文書，但不能決定進度數字。
三條核心界線
- 行政可以代操作，但不能填進度 %。 進度 % 是結構技師的專業判斷與責任，這條界線不能模糊——這是整個系統最重要的一條權限規則。
- 一般人員（技師）只看得到自己被指派的案件，看不到別人的案子。
- 系統設定（分類與節點樣板、業主工作日自訂、稽核日誌查閱）對行政和一般人員都鎖死，只有管理員能進。
完整動作矩陣
| 動作 | 管理員 | 行政 | 一般 |
|---|---|---|---|
| 案件可見範圍 | 全部 | 全部 | 僅被指派 |
| 建立／編輯案件 | ✓ | ✓ 入日誌 | ✗ |
| 作廢／復原案件 | ✓ | ✓ 入日誌 | ✗ |
| 追加案（增改刪、切換狀態） | ✓ | ✓ 入日誌 | ✗ |
| 填進度 %／標記節點完成 | ✓ | ✗（核心界線） | 被指派案件 ✓ |
| 覆寫他人的進度 %（私人案） | ✓ | ✗ | ✗ |
| 前置資料 新增／編輯／標記已到 | ✓ | ✓ 入日誌 | 被指派案件 ✓ |
| 前置資料 刪除 | ✓ | ✓ 入日誌 | ✗ |
| 業主資料庫（含窗口管理） | 可編輯 | 可編輯・入日誌 | 唯讀 |
| 刪除業主（限無案件綁定） | ✓ | ✓ 入日誌 | ✗ |
| 帳號管理（停用／啟用） | ✓ | ✓ 入日誌 | ✗ |
| 分類與節點樣板 | ✓ | ✗ | ✗ |
| 業主工作日自訂 | ✓ | ✗ | ✗ |
| 稽核日誌 查閱／匯出 | ✓ | ✗ | ✗ |
「入日誌」是什麼意思
表格裡的「入日誌」代表：這個動作做得到，但每做一次都會被完整寫進稽核日誌（誰、什麼時間、改了什麼）。這樣行政的「代操作」就跟技師本人的操作清楚分得開——出事時能查得到是誰按的。
核心界線：行政不可填進度 %
行政可以代為建檔、改案、標記前置資料已到，但進度 % 永遠由技師自己負責。一般技師對「自己被指派的案件」可以填進度、標記節點完成；行政則對任何案子都不能動進度數字。
登入用的是工牌編號（格式
R00001）加密碼，不需要公司 Email，帳號由管理員建立。離職帳號會被「停用」而非刪除，停用後就不能登入。
在哪裡看：帳號與角色管理在 /guide-zh/settings。
母子追加案
業主在一個案子進行到一半時，常會臨時追加委託（例如「再幫我多算一道擋土牆」）。這種追加不另開新案，而是掛在主案下面，變成 -1、-2 的子案。
- 只有 B2 計算案支援母子追加案，其他分類不會出現這個區塊。
- 子案不另開案號、沿用主案的業主窗口。
- 子案只用「狀態」追蹤（尚未開始／進行中／已結案），不計進度 %——它不會有自己的進度條，也不影響主案進度。
- 主案結案不會強制子案跟著結案，兩者各自獨立。
- 操作（新增／編輯／刪除子案）權限：管理員、行政（行政入日誌）；一般人員不可。
在哪裡看：B2 案件的子案區塊在 /guide-zh/case-detail。
前置資料與 NAS
「前置資料」指的是開工前該到位的東西：圖說、載重清冊、同意書、卷證等等。系統把它們分成兩級：
- 關鍵前置資料：沒到位就無法實質開工。
- 一般前置資料：重要但不卡開工。
規則重點：
- 關鍵前置資料還沒到 ＋ 案子時程又超標 → 儀表板標紅，提醒你優先催件。
- NAS 只貼連結，不上傳檔案。 系統不做檔案上傳，只在前置資料上貼一個 NAS 連結（
nas://…，公司的 QNAP）。這樣做是為了避免同一份檔案在多處各存一版、版本對不上。 - 每筆前置資料可以「標記已到」，到位狀態會反映到燈號的加重判斷上。
- 權限：新增／編輯／標記已到 = 管理員、行政（入日誌）、被指派的技師；刪除 = 只有管理員與行政。
在哪裡看：案件的前置資料清單在 /guide-zh/case-detail。
業主資料庫
業主只要建檔一次，所有案件就能綁定它——請款、開發票、寄函時直接找到正確窗口，不用每個案子重打一次資料。
- 業主屬性分四類：政府機關／企業廠房／法人建築／家用建築（管委會）。
- 每個業主綁一種工作日曆（這會影響它名下案子的時程消耗計算，見上方〈業主工作日與工作日曆〉）。
- NDA 敏感業主會有標記（一個 amber 色小標籤），提醒處理時注意保密。
- 聯絡窗口離職要用「標記離職」而不是刪除：標記離職會留下離職年月（
YYYY-MM）並保留歷史紀錄，日後還能復職。直接刪掉會讓歷史斷掉。 - 一般人員對業主資料庫是唯讀的（只看得到，沒有任何操作按鈕）。
有案件綁定的業主不可刪
如果一個業主名下還有任何案件，系統不讓你刪除它——刪了會讓那些案子失去業主資訊。要先處理完所有綁定案件才談得上刪除。
在哪裡看：業主清單與窗口管理在 /guide-zh/clients。
稽核日誌
稽核日誌是系統的「黑盒子」——所有重要動作都被記下來，而且永遠刪不掉、改不掉。
為什麼要這麼嚴格？因為結構技師簽證的民事追訴期最長可達 10 年，萬一日後有爭議要打官司，這份日誌就是舉證依據。
每筆紀錄包含：
- 時間戳記（什麼時候）
- 操作者工牌編號 ＋ 角色（是誰、什麼身分）
- 動作 ＋ 對象（做了什麼、改的是哪一筆）
- 異動前後值（從什麼改成什麼）
規則：
- 涵蓋所有 CRUD：包含刪除、作廢、狀態切換、標記離職等等，全都留痕。
- 行政的「代操作」與技師本人的操作可以清楚區分。
- 永久保存、不可刪、不可改——系統在程式層面就沒有開「修改」或「刪除」日誌的路徑。
- 只有管理員能查閱，並可匯出 CSV（支援依人員／動作／日期區間篩選）。
在哪裡看：稽核日誌查閱與匯出在 /guide-zh/settings（僅管理員看得到）。
刪除與作廢政策
系統的核心原則是「能保留就不真刪」，避免破壞責任追溯。不同實體的刪除方式不一樣：
| 實體 | 刪除形式 | 限制 |
|---|---|---|
| 案件 | 作廢封存（軟刪除，可復原） | 必填原因、狀態變「已作廢」、可篩選查回 |
| 追加案 | 真刪除（先跳確認視窗） | — |
| 前置資料 | 真刪除（先跳確認視窗） | 刪除限管理員＋行政 |
| 業主 | 真刪除（先跳確認視窗） | 有任何案件綁定不可刪 |
| 業主窗口 | 真刪除（先跳確認視窗） | 離職應改用「標記離職」保留歷史 |
| 自訂分類 | 真刪除（連同節點樣板） | 有案件使用中不可刪 |
| 內建六大分類 | 不可刪 | 僅能編輯節點樣板 |
| 帳號 | 不刪，改用「停用」 | 不可停用自己；離職用停用保留歷史 |
| 稽核日誌 | 永久不可刪、不可改 | 民事舉證用 |
- 作廢 vs 真刪除：案件是最重要的紀錄，所以用「作廢」（軟刪除）——封存起來但能查回、能復原。其他次要資料（前置、追加案等）才是真刪除。
- 所有刪除動作都會先跳確認視窗，執行後寫進稽核日誌（連「刪除這件事」本身也永久留痕）。
- 刪除權限 = 管理員＋行政（行政入日誌）；一般人員一律不可刪。
在哪裡看：案件作廢與復原在 /guide-zh/cases。
刻意排除的功能
下面這幾項是故意不做的，不是漏掉、也不是還沒做。看到系統「沒有」這些功能，那是設計決定：
- 報價／發票管理——財務敏感，瑞成明確表示不要進系統。
- LINE 整合——不串 LINE。
- Email 通知——所有提醒都走系統內的鈴鐺通知，不寄 Email。
- 檔案上傳——系統不存檔案，NAS 一律只貼連結（
nas://…）。
請不要再把這些「加回來」
這四項是與瑞成確認過的範圍邊界。如果你覺得少了某個功能，先確認它是不是落在這份清單裡。
詞彙表
| 詞 | 意思 |
|---|---|
| 案號 | RC-YYYY-NNN，年度流水號，例如 RC-2026-007 |
| 子案號 | 主案號後面加 -1／-2 |
| 工牌編號 | R00001 格式，就是你的登入帳號 |
| 時程消耗 % | （已過業主工作日）÷（合約總業主工作日），每天 02:00 重算 |
| 進度落差 | 時程消耗 % 減 實際進度 %，大於 0 代表落後 |
| 關鍵前置資料 | 沒到位就無法實質開工的資料 |
| 作廢 | 案件的軟刪除：保留紀錄、預設隱藏、可復原 |
| 入日誌 | 動作做得到，但全程寫入稽核日誌 |