案件管理
「案件」是整套系統的核心。所有的進度、燈號預警、業主、前置資料、追加案，全都掛在案件底下。
這一頁帶你把案件列表的每一個按鈕、每一個欄位都搞懂：怎麼找案件（篩選、搜尋、排序、分頁）、怎麼新增案件（4 步精靈）、以及案件作廢與復原怎麼運作。進到單一案件之後的操作（節點、進度、追加案…）請看案件詳情；不懂分類、燈號、進度模式這些名詞，先看名詞觀念。
本頁畫面的「今天」
系統示範資料把「今天」固定在 2026-06-12，所以截圖裡的燈號、進度都是以這天計算的。你實際使用時會以真正的當天日期計算。
一、案件列表長什麼樣
最上面是標題「案件列表」，右邊有搜尋框和新增案件按鈕。中間那張卡片是篩選列（分類、狀態、燈號三排）。下面是案件表格，最底下是分頁。
我們一項一項看。
二、篩選列（三排，可同時套用）
篩選列上的每一個「圓角小標籤」都叫做 chip，點一下就會套用，再點一下相同的分類 chip 可取消。三排篩選會疊加：例如同時選「A1 設計監造 ＋ 進行中 ＋ 紅燈」，列表就只留下「分類是 A1、狀態進行中、而且亮紅燈」的案件。
1. 分類 chip（第一排）
依案件的六大分類（外加管理員自訂的分類）過濾。chip 依群組分段顯示：
| chip | 意義 |
|---|---|
| 全部 | 不限分類（預設）。 |
| 公共工程 ─ A1 設計監造 | 公共工程的設計監造案。 |
| 公共工程 ─ A2 鑑定 | 公共工程的鑑定案。 |
| 公共工程 ─ A3 巡查 | 公共工程的巡查案（年度四季巡查）。 |
| 私人案 ─ B1 建案 | 建商的結構設計案。 |
| 私人案 ─ B2 計算案 | 私人計算案，**唯一能掛追加案（母子案）**的分類。 |
| 私人案 ─ B3 鑑定案 | 私人鑑定案（現況／鄰損／安全／法院四種模板）。 |
每個分類預設的「進度模式」不一樣
分類不只是分類，它還決定這個案件怎麼算進度：A1／A2／A3 是節點式（系統自動加總）、B1／B2 是自填式（技師手填 %）、B3 是彈性混合式。詳細差別看名詞觀念。
如果管理員另外建了自訂分類（代碼像
S1、S2），會多出一段「其他」群組，chip 一樣可以點選過濾。
2. 狀態 chip（第二排左半）
| chip | 意義 |
|---|---|
| 進行中 | 正在執行的案件（預設只看這個）。 |
| 尚未開始 | 已建檔、但還沒到開始日的案件。 |
| 已結案 | 已完成結案的案件。 |
| 已作廢 | 被作廢封存的案件（見下方作廢與復原）。 |
| 全部 | 不分狀態，全部顯示。 |
為什麼有些案件「不見了」？
列表預設只顯示「進行中」。已結案、已作廢、尚未開始的案件預設是藏起來的。找不到某個案件時，先把狀態切到「全部」，幾乎都能找回來。
3. 燈號 chip（第二排右半）
燈號代表案件的時程緊張程度（依「業主工作日」算出的時程消耗 %）：
| chip | 燈號 | 時程消耗 |
|---|---|---|
| 全部 | — | 不限燈號（預設）。 |
| 🔴 紅 | 紅燈 | 時程消耗 ≥ 90%，最緊急。 |
| 🟠 橙 | 橙燈 | 75–89%。 |
| 🟡 黃 | 黃燈 | 50–74%。 |
| 🟢 綠 | 綠燈 | < 50%，相對寬裕。 |
從儀表板一鍵帶入
在儀表板點燈號卡（例如「紅燈案件」）進來，列表會自動幫你選好對應的燈號 chip，不用再手動篩。
已結案／已作廢／尚未開始的案件不參與燈號計算，所以用燈號 chip 篩選時看不到它們，這是正常的。
4. 搜尋框（右上角）
搜尋框的提示字是「搜尋案名 / 編號 / 業主」。輸入任一關鍵字，即時過濾：
- 案名：例如打「擋土牆」。
- 案件編號：例如打「RC-2026-005」或只打「005」。
- 業主名稱：例如打某建設公司的名字。
想跨頁面一起找？
搜尋框只在案件列表內過濾。想同時找案件＋業主＋人員，用畫面右上角的全系統快速搜尋（Ctrl／⌘ + K）更快。
三、案件表格的每一欄
表格由左到右，每欄意義如下：
| 欄位 | 說明 | 可排序？ |
|---|---|---|
| 🔵 燈號（最左小圓點） | 該案目前的紅／橙／黃／綠燈。 | 否 |
| 案件編號 | 格式 RC-YYYY-NNN（例 RC-2026-005），年度流水號，系統自動配發、不重複。 | 否 |
| 案件名稱 | 案件全名。名稱下方灰字會標出「進度模式」（節點式／自填式…）；自填式案件若超過 14 天沒更新，會多顯示「○ 天未更新」提醒。若是 B2 母案，名稱旁會有「＋N 追加案」小標。 | 否 |
| 分類 | 帶顏色的分類標籤（A1～B3／自訂；B3 會再標出鑑定子類型）。 | 否 |
| 業主 | 該案綁定的業主名稱。 | 否 |
| 負責 | 被指派的負責人員頭像（多人會疊著顯示）。 | 否 |
| 進度 | 進度條 ＋ 百分比。節點式由系統自動加總、自填式由技師手填。 | 是 |
| 截止日 | 合約截止日（畫面只顯示月-日）。亮紅燈時截止日會變紅加粗提醒。 | 是 |
排序
只有「進度」和「截止日」兩欄的欄頭可以點擊排序，點一下會有箭頭出現。三態循環：升冪 → 降冪 → 取消排序。一次只能對一欄排序。
點整列開案件
直接點表格中的某一列（不是點「編輯／作廢」按鈕），就會進入該案的案件詳情頁。
手機版會變成卡片
螢幕較窄時，表格會自動改成一張張「卡片」堆疊，每張卡顯示燈號、編號、分類、案名、進度與截止日，點卡片一樣進詳情頁。
四、每一列的操作鈕（編輯 / 作廢）
把游標移到表格某一列的最右邊，會看到操作按鈕（一般人員看不到這些鈕，見第七節）：
編輯
點「編輯」會跳出編輯視窗（不換頁），可改：
- 案件名稱（必填）。
- 合約截止日。
- 狀態（進行中／尚未開始／已結案）。
- 負責人員（至少要選一位；行政人員不會出現在可指派名單中）。
按「儲存變更」即生效。視窗底下會提醒「異動前後值將寫入稽核日誌」——代表這次改了什麼、改之前是什麼，系統都會留底。
作廢
點紅色的「作廢」會跳出作廢視窗：
- 必須填寫作廢原因（必填，例如「業主取消委託（未簽約）」），否則按鈕不會亮。
- 按「作廢此案」後，案件狀態變成「已作廢」並從預設列表隱藏。
作廢不是真的刪除，詳見下一節。
已作廢的案件那一列，不會再出現「編輯／作廢」鈕（改成在詳情頁「復原」）。
五、分頁與每頁筆數
表格底部是頁碼導覽：
- 顯示「共 N 筆」總數。
- 右邊可切換每頁筆數（10／20／50）。
- 用「上一頁／下一頁」或頁碼跳頁（例「第 1／2 頁」）。
換篩選或搜尋後，列表會重新計算，頁碼也會跟著更新。
六、新增案件（4 步精靈）
點右上角的「新增案件」，會開啟一個 4 步精靈，一步步把案件建好。系統會自動配發案號（標題列就會顯示這次要建立的案號，例 RC-2026-019），格式 RC-YYYY-NNN，年度流水。
頂端有 4 個步驟指示：1 選擇分類 → 2 基本資料 → 3 節點樣板 → 4 前置資料。每步右下角用「下一步／上一步」前後移動，最後一步是「建立案件」。
第 1 步｜選擇分類
從六大分類卡（外加自訂分類）點選一個。每張卡會標出代碼、名稱、群組與進度模式：
| 卡片 | 群組 | 預設進度模式 |
|---|---|---|
| A1 設計監造 | 公共工程 | 節點式（自動加總）— 預設 6 節點，合計 100% |
| A2 鑑定 | 公共工程 | 節點式（節點依委託書內容） |
| A3 巡查 | 公共工程 | 節點式（年度四季巡查各 25%） |
| B1 建案 | 私人案 | 自填式（技師填 %） |
| B2 計算案 | 私人案 | 自填式（技師填 %）— 建立後可加追加案 |
| B3 鑑定案 | 私人案 | 彈性混合式 |
選 B3 鑑定案要多一個動作
選 B3 時，下方會冒出「鑑定類型」四選一：(a) 現況鑑定 ／ (b) 鄰損鑑定 ／ (c) 安全鑑定 ／ (d) 法院評估。每個會帶不同的預設節點模板，但建立後節點還能自由增刪修改（這就是「彈性混合式」的意思）。
第 2 步｜基本資料
填這個案子的基本欄位：
- 案件名稱（必填）。
- 業主（必填，從既有業主建檔中搜尋選取）。選定後下方會顯示該業主的工作日曆（政府機關／一般建商／半導體廠），這會直接影響時程消耗與燈號的計算；若是 NDA 敏感業主，會標「NDA 敏感」。
- 負責人員（必填，至少一位；點頭像膠囊即指派，可多選。行政人員不會出現在名單裡）。
- 開始日 與 合約截止日（截止日必須晚於開始日，否則不能往下一步）。
找不到業主？要先建檔
業主一定要先在業主資料庫建檔，才能在這裡選到。沒有的話請先去建立業主，或請管理員／行政協助。
第 3 步｜節點樣板
這一步依分類不同而不同：
- 節點式／彈性混合式（A1/A2/A3/B3）：會「一鍵套用」對應的預設節點樣板，並把計畫起訖依權重均攤在你填的起訖日之間。畫面列出每個節點的名稱、交付物與權重 %。
- 只有管理員能改權重，且全部節點權重合計必須剛好 = 100%，否則「下一步」會擋住並提示「權重合計 ○%，需為 100%」。
- 非管理員在這步看到的是唯讀，會顯示「調整權重需管理員（目前唯讀）」。
- 自填式（B1/B2）：沒有固定節點，這步會顯示一段說明，告訴你這個案子之後要由技師手動填整案總進度 %、每次更新必填備註。B2 還會提醒：建立後可在案件頁新增追加案。直接按「下一步」即可。
第 4 步｜前置資料
登錄「開工前需要業主／上游交付」的資料（圖說、地質鑽探報告、同意書…）：
- 每一列填資料名稱，並切換「關鍵／一般」兩級（關鍵 = 沒到位就無法實質開工）。
- 可貼 NAS 連結（選填）。系統只貼連結、不上傳檔案。
- 用「新增一筆」加列、列尾的 ✕ 刪列；留白的列會被丟棄。
「關鍵」前置資料會連動燈號
標記「關鍵」的資料若未到位、又遇到時程消耗偏高（≥ 75%），儀表板會把這個案件標紅提醒。所以該標關鍵的別省。
最後一步底部有一段「建立摘要」，把案號、分類、案名、業主、起訖日、負責人列出來給你核對。確認無誤按「建立案件」即完成，並會跳出「案件 ○ 已建立 — 已寫入稽核日誌」提示，接著自動帶你進新案的詳情頁。
誰可以新增案件？
管理員與行政可以建檔（行政是「代建檔」，動作會寫入稽核日誌以區分本人與代操作）。一般人員（Staff）不能新增案件——他們的畫面上根本沒有「新增案件」鈕，取而代之會看到「建案需行政或管理員權限」的提示。
七、作廢與復原（軟刪除）
系統不會真的刪除案件。結構技師的簽證責任民事追訴期最長 10 年，所有紀錄都要保留供日後查證，因此案件採「作廢封存」的軟刪除。
怎麼作廢
兩個入口，動作相同：
- 案件列表某列的「作廢」鈕；或
- 進到案件詳情頁，從上方標題列作廢。
兩者都會要求必填作廢原因，送出後狀態變「已作廢」。
作廢後會怎樣
- 案件自預設列表隱藏——但可把狀態 chip 切到「已作廢」或「全部」查回，詳情頁也仍能打開。
- 稽核日誌與所有歷史紀錄永久保留。
怎麼復原
打開已作廢的案件詳情頁，頁面頂端會出現橫幅與「復原」鈕，點一下就回到正常狀態。
作廢可以救回來，放心用
作廢不是刪除，隨時能復原。作廢與復原都會寫入稽核日誌。權限為管理員＋行政（行政入日誌）；一般人員不可作廢或復原。
八、一般人員（Staff）看到的列表
一般人員（技師）的案件列表是受限版：
差別在於：
- 標題下方有一行提示：「一般人員僅顯示指派給你的案件」。
- 列表只會出現指派給你本人的案件——沒被指派的案件，他連看都看不到（這是伺服器端就過濾掉的，不是畫面藏起來而已）。
- 右上角沒有「新增案件」鈕，而是顯示「建案需行政或管理員權限」。
- 列上**沒有「編輯／作廢」**等操作鈕。
一般人員能做什麼？
一般技師在自己被指派的案件裡，仍可標記節點完成、填該案進度、維護前置資料——這些是在案件詳情頁進行的。列表頁本身對他們而言是「找到我的案子」的入口。