Skip to content

系統設定

系統設定是整套系統「規則」與「人員」的集中管理處——案件分類怎麼分、進度怎麼算、誰能做什麼、有哪些帳號、業主的工作日怎麼算,以及所有動作的稽核留痕,全都在這一頁。

這一頁是管理員/行政專屬

系統設定僅限「管理員」與「行政」使用。一般人員(Staff)的左側選單根本看不到「系統設定」;就算直接輸入網址硬闖,系統也會把他導回儀表板——這是路由層級的鎖,不只是把按鈕變灰。

進到這一頁後還有分頁級的細鎖

分頁管理員行政一般人員
分類與節點樣板✅ 可編輯👁 唯讀(鎖)⛔ 進不來
權限對照表✅ 可看✅ 可看⛔ 進不來
帳號管理✅ 可編輯✅ 可編輯(入日誌)⛔ 進不來
業主工作日✅ 可編輯✅ 可編輯(入日誌)⛔ 進不來
稽核日誌✅ 可查閱/匯出🔒 鎖(只看到提示卡)⛔ 進不來

被鎖的分頁標籤會變成鎖頭圖示、灰字、不可點,滑過去顯示「需要管理員權限」。被鎖住的功能不會憑空消失——只是換成提示,讓你知道「這要更高權限」。

頁面頂端標題下方一行小字:「分類樣板可自訂 — 未來接到新型案件不需聯絡開發方」。共五個分頁,預設停在第一個「分類與節點樣板」。

延伸閱讀:領域概念(分類、燈號、權限的全貌)、案件管理業主資料庫


分頁 1:分類與節點樣板

分類與節點樣板

誰能編輯

只有管理員可以新增/編輯/刪除分類與節點樣板manageTemplates 旗標)。行政與一般人員看到的是唯讀版本:右上沒有「新增自訂分類」按鈕,每張卡片底部顯示「編輯需管理員」的鎖提示。

這個分頁管理的是**「案件怎麼分類、每類案子的進度怎麼算」。每一種分類一張卡片,卡片頂邊的顏色就是該分類的代表色。最上方那行說明寫著:「案件分類 × 預設節點樣板(建案時一鍵套用)・內建六大分類不可刪除」**。

「節點樣板」的意思是:建一個新案件選了某個分類後,系統會自動把這個分類的預設工作節點(每個節點帶一個權重 %)套進去,省去每次手動建節點。這也是為什麼樣板要事先設定好。

六大內建分類(A1–B3)

每張卡上方有分類代碼徽章、群組(公共工程/私人案)、進度模式標籤;私人案沒有「自動加總」字樣,公共工程才有。逐一說明:

代碼名稱群組進度模式卡片內容
A1設計監造公共工程節點式(自動加總)6 個權重節點:基本設計 15%、細部設計 25%、審查送件 10%、審查通過/修正 10%、請照 10%、監造啟動 30%(合計 100%)
A2鑑定公共工程節點式(自動加總)權重節點:圖面測繪查勘 20%、核心機構試設計 20%、評估分析 40%、審查與定稿 20%
A3巡查公共工程節點式(自動加總)年度四季:第一季巡查 25%、第二季巡查 25%、第三季巡查 25%、第四季彙整+年度建議 25%
B1建案私人案自填式(技師填 %)無固定節點。技師自訂工作項目、手動填整案總進度 %,每次更新必填備註
B2計算案私人案自填式(技師填 %)同 B1,外加一行紫字「+ 母子追加案:主案下掛 -1 / -2 子案」——B2 是唯一支援母子追加案的分類
B3鑑定案私人案彈性混合式四個子樣板可逐一編輯(見下)

三種進度模式有什麼差別

  • 節點式(step):固定節點各帶權重,整案進度=已完成節點權重加總,系統自動算。用於 A1/A2/A3。
  • 自填式(self):沒有固定節點,技師手動填整案總進度 %,每次更新必填備註(責任可溯)。用於 B1/B2。
  • 彈性混合式(hybrid):套模板起步,但節點可自由增刪修改——因為鑑定個案差異大。僅 B3。

B3 鑑定案的四個子樣板

B3 卡片內列出四個鑑定類型,每一列右側有一個鉛筆 ✎ 圖示,點它就能單獨編輯那個子樣板的節點:

  • (a) 現況鑑定 → 現況勘查 → 報告出具
  • (b) 鄰損鑑定 → 施工前後況勘查 → 施工中監測 → 損害分析
  • (c) 安全鑑定 → 外觀勘查 → 核心構件分析 → 安全性評估
  • (d) 法院評估 → 收件 → 現場勘查 → 鑑定書出具

卡片底部小字提醒:「模板僅是起點 — 節點可自由增刪修改」。B3 卡的編輯入口是「點各模板右側 ✎ 編輯」,不是整張卡一次編輯。

怎麼編輯內建分類的節點樣板

A1/A2/A3 這類節點式分類,卡片底部有「編輯樣板」按鈕。點開後是一個節點清單編輯視窗:

  • 每一列:節點名稱(必填)+ 權重 %交付物(選填)。
  • 可「新增節點」、可移除(至少保留 1 個)。
  • 底部即時顯示「權重合計 N%」——必須剛好等於 100% 才能按「儲存樣板」,否則按鈕鎖住並標紅「(需 = 100%)」。
  • 視窗頂端提醒:「修改僅影響之後新建的案件;既有案件節點不變。」

B1/B2 是自填式,沒有固定節點,卡片底部直接寫「自填式無固定節點」,不需編輯樣板。

分類的兩條紅線

  1. 內建六大分類永遠不可刪——只能改它的節點樣板,不能整類刪掉。
  2. 修改樣板只影響之後新建的案件,不會動到既有案件已經建好的節點。所以調整樣板不會搞亂正在進行的案子。

新增/編輯/刪除自訂分類

如果未來接到新型態的案子(內建六類都不合),管理員可在右上點「+ 新增自訂分類」自己建一類,不必聯絡開發方。編輯視窗欄位:

欄位說明
代碼自動帶入下一個 S1S2…(系統決定,灰底唯讀)。代碼一旦建立就不可修改——避免既有案件失效。編輯既有自訂分類時這格鎖住,滑過顯示「代碼建立後不可改」。
分類名稱 *必填,例如「地下捷運段橋墩補強」。
群組公共工程/私人案 下拉。
進度模式三選一卡片:步驟式(固定節點,系統自動加總 %)/自填式(技師手動填整案 %,必填備註)/彈性混合式(套模板起步,節點可增刪)。
顯示顏色一排色塊,決定卡片頂邊與徽章的顏色。
進度節點只有非自填式才出現。每列=名稱 + 權重 % + 交付物(選填)。同樣合計需 = 100%

儲存後會跳提示:「已建立自訂分類『S1 ○○』— 建案流程可直接選用」。之後建新案就能在分類下拉看到它。

自訂分類什麼時候不能刪

自訂分類卡片底部有「編輯分類」按鈕。刪除按鈕只有在「沒有任何案件正在使用這個分類」時才出現;只要有案件在用,刪除位置會改成「有案件使用中,不可刪」的鎖提示。刪除會連同節點樣板一併移除、不可復原,但稽核日誌會永久保留刪除紀錄。


分頁 2:權限對照表

權限對照表

誰能看

管理員與行政都看得到這張表(一般人員進不了系統設定)。這是唯讀的對照表,沒有任何可改的設定——它只是把「誰能做什麼」一次攤開講清楚。

表頭橫向三欄是三種角色:管理員(Admin)/行政人員(Operator)/一般人員(Staff),你目前登入的角色那一欄會高亮,並標上「目前身份」。左側是一條條動作,依「案件 / 進度 / 資料庫與設定」三組分段。

表格上方藍底寫著核心設計原則:

設計原則:行為留痕、責任可溯 — 行政可代操作但不能決定進度數字,避免責任界線模糊。

怎麼看每一格

符號意思
✓(綠勾)可以做
✓ 入日誌(藥丸標籤)可以做,但每個動作都會寫進稽核日誌
✕(灰叉)不可以做
被指派僅被指派唯讀全部(藥丸)範圍限制,例如一般人員只能動「被指派的案件」

對照表完整內容

案件

動作管理員行政一般人員
查看案件範圍全部全部僅被指派
建立案件(代建檔)✓ 入日誌
編輯案件基本資料✓ 入日誌
作廢/復原案件(軟刪除)✓ 入日誌
新增追加案(-1 / -2)✓ 入日誌
追加案編輯/狀態/刪除✓ 入日誌

進度

動作管理員行政一般人員
更新節點(標記完成)被指派案件
填寫自填式進度 %被指派案件
覆寫他人進度 %(私人案)
前置資料新增/編輯/標記已到✓ 入日誌被指派案件
前置資料刪除✓ 入日誌
增刪節點(彈性混合式)

資料庫與設定

動作管理員行政一般人員
業主資料庫編輯編輯・入日誌唯讀
業主窗口編輯/離職/刪除✓ 入日誌
刪除業主(限無綁定案件)✓ 入日誌
帳號新增/編輯✓ 入日誌
帳號停用/啟用(保留紀錄)✓ 入日誌
分類與節點樣板(含自訂分類增修刪)
業主工作日曆 新增/編輯/刪除✓ 入日誌
稽核日誌查閱 / 匯出

表格最下方一行提醒:「『入日誌』=可操作,但每個動作都寫入稽核日誌(含時間戳記與異動前後值)」

核心界線:行政可代操作,但不能決定進度數字

整張表的靈魂在「進度」那一段。行政(Operator)可以代替技師處理一切文書類動作(建案、改基本資料、前置資料、帳號、日曆…),這些都會入日誌、可追溯。但**「填進度 %/標記節點完成/覆寫他人進度」這幾項,行政一律是 ✕——因為進度 % 是結構技師的專業判斷與簽證責任**,不能由行政代填。一般人員則只能動自己「被指派」的案件。完整說明見 領域概念 → 三層權限


分頁 3:帳號管理

帳號管理

誰能編輯

管理員與行政都能管理帳號manageUsers 旗標);行政的所有帳號異動都會入日誌。一般人員進不來這一頁。

標題列寫「帳號管理(工牌編號登入)」,右上是「+ 新增帳號」按鈕(沒權限時改顯示「需管理員或行政」)。下方是固定欄位的人員清單(不分頁、不排序,因為上限 30 人):

欄位內容
頭像自動由姓名/工牌產生
工牌編號R00001 格式(登入帳號就是這串)
姓名 / 職稱姓名(粗體)+ 職稱(灰字)。已停用者後面接紅色「已停用・離職 YYYY-MM-DD」標籤
角色管理員/行政人員/一般人員 徽章
進行中案件在職者顯示進行中件數(如「5 件」);已停用者改顯示灰字「曾參與 N 件」(保留歷史)
操作在職者顯示「編輯」;已停用者顯示「啟用

清單底部一行政策提醒:「合約上限 30 人・行政人員的帳號異動全數寫入稽核日誌・人員離職改用『停用』(不刪除),保留曾參與專案與登入歷史供歷史稽核,可隨時啟用」

新增帳號

點「+ 新增帳號」開視窗,標題會直接帶出將分配的工牌號(如「新增帳號 R00016」):

欄位說明
工牌編號自動產生下一個 R+5 位(灰底唯讀,伺服器最終決定)。這就是同仁登入用的帳號,不需要公司 Email
姓名 *必填,例如「王小明」。
職稱預設帶「工程師」,可改。
角色(權限)三選一:管理員(Admin)/行政人員(Operator)/一般人員(Staff)。選好後下方灰框會即時顯示該角色能做什麼。

三種角色的能力摘要(視窗內提示文字):

  • 管理員:所有案件建立/編輯、進度覆寫、樣板與帳號管理、稽核日誌。
  • 行政人員:代建檔、前置資料、人員名單(所有動作入日誌);不可填進度 %
  • 一般人員:查看被指派案件、標記前置資料、更新節點。

視窗底部會顯示「合約上限 30 人(目前 N 人)」。按「建立帳號」後跳「帳號 R000xx 已建立 — 已寫入稽核日誌」。

編輯/停用(離職)/重新啟用

點任一在職列的「編輯」可改姓名、職稱、角色。編輯視窗底部多一塊帳號狀態區:

  • 在職帳號:顯示「帳號狀態:使用中」,右側有紅色「停用(離職)」按鈕。若該人還有進行中案件,會提醒「停用後無法登入(仍有 N 件進行中案件,建議先改派)」。
  • 已停用帳號:清單上的操作鈕變「啟用」;編輯視窗顯示「已停用(離職 YYYY-MM-DD)」與「無法登入;保留 N 件專案參與與稽核歷史供查證,可隨時重新啟用」,右側按鈕變「重新啟用」。

人員離職用「停用」,絕不刪除

帳號採停用(軟刪除、可復原)永遠不真的刪掉。原因是:結構技師簽證有民事舉證需求,追訴期最長 10 年,離職人員的歷史專案參與與稽核紀錄都必須留著。停用後:

  • 該帳號無法登入(會看到清楚的提示訊息)。
  • 該人被排除於新案指派,但清單仍顯示「曾參與 N 件」的歷史數。
  • 不能停用自己——若那一列是你本人,停用按鈕不會出現,提示「不可停用自己的帳號」。

停用與啟用都會寫入稽核日誌。


分頁 4:業主工作日

業主工作日

誰能編輯

管理員與行政都能新增/編輯/刪除工作日曆(編輯=createCase、刪除=deleteData;行政動作入日誌)。沒權限時各按鈕改成鎖提示。一般人員進不來這一頁。

註:本系統的領域規則文件(SSOT §3)將「業主工作日自訂」列為僅管理員;實際介面把編輯權給了管理員+行政(與案件建立同一旗標)。若您的事務所要嚴格限制成只有管理員能改日曆,請依內部規範執行。

為什麼工作日曆很重要

案件的**「時程消耗 %」是依「業主工作日」計算,不是日曆天**。也就是:合約給的天數要扣掉週末、國定假日這些業主不上班的日子。不同業主上班型態不同,所以要分日曆。每個業主在業主資料庫綁定一種工作日曆,案件的燈號(綠/黃/橙/紅)就靠這個算。分頁底部說明:「時程消耗 % 依業主工作日計算,非日曆天 — 政府機關春節 2 週不計入流失;半導體廠 24/7 照算。自訂日曆的新增/編輯/刪除均寫入稽核日誌。」

三種預設日曆

每張卡有日曆名稱、右上「預設」徽章、說明、「套用業主:N 家」、以及底部的「編輯」鈕。預設日曆可改規則但不可刪(刪除位置顯示「預設不可刪」)。

日曆規則對時程消耗的影響
一般建商週一至週六,固定假日休新案的預設日曆,週日不算工作日
半導體廠 24/7全年無休,照日曆天計算等於照日曆天算,最嚴格
政府機關週一至週五,固定假日休(春節不計入時程消耗週末與國定假日不算,且春節 2 週完全不計入流失

新增/編輯自訂工作日曆

卡片格最後一張是虛線「+ 自訂工作日曆」卡(沒權限改顯示「自訂需管理員或行政」)。新增或編輯時的欄位:

欄位說明
日曆名稱 *必填,例如「醫療院所(週日休)」。
每週工作日 *一排日(日~六)按鈕,點選哪幾天上班,至少選 1 天
國定假日二選一:「休(不計入時程消耗)」或「照常(照算)」。
說明備註留空時自動依工作日/假日規則帶入一句說明。

視窗底部提醒「工作日影響時程消耗 % 計算(非日曆天)」。儲存後跳「工作日曆『○○』已新增/已更新 — 已寫入稽核日誌」。編輯預設日曆時,頂端會多一條藍底提示「預設日曆:可調整工作日規則,但不可刪除。」

自訂日曆什麼時候不能刪

自訂日曆只有在「沒有任何業主套用它」時才可刪。只要「套用業主」大於 0,刪除位置會改成「有業主套用,不可刪」。刪除前會跳確認視窗,刪除後稽核日誌保留紀錄。要先在業主資料庫把那些業主改綁別的日曆,才能刪。


分頁 5:稽核日誌

稽核日誌

僅管理員可查閱

稽核日誌只有管理員看得到viewAudit 旗標)。行政進到這個分頁只會看到一張「稽核日誌僅管理員可查閱」的鎖提示卡,看不到任何內容。一般人員連系統設定都進不來。

稽核日誌是整套系統的法律證據鏈。標題下方寫明用途:「永久保存・不可刪除・民事舉證用(追訴期最長 10 年)。僅管理員可查閱/匯出。」 上方還有一條琥珀色 banner:「本日誌為法律證據,僅供新增、永久保存,系統不提供任何編輯或刪除途徑。」

記錄了什麼

系統所有的 CRUD 動作——包含建立、編輯、刪除、作廢、狀態切換、標記離職、進度覆寫——全部自動留痕。每一筆紀錄的欄位:

欄位內容
時間戳記動作發生的精確日期時間
操作者操作人的姓名+工牌編號(沒有登入者的系統動作標「系統」)
動作動作代碼,如 user.createduser.role_changed覆寫類動作(核心責任界線)以琥珀色強調,一眼分辨技師本人操作 vs 行政代操作
對象被異動的對象(人類可讀標籤,或型別:ID)
異動內容異動前後值的摘要(改了什麼、從什麼變成什麼)

行政「代操作」可辨識

行政代技師做的每個動作都在日誌標示「入日誌」並可辨識,與技師本人操作清楚區分。這正是權限對照表「✓ 入日誌」的落地——責任永遠可回溯到人。

篩選與匯出

篩選列在表格上方,可組合使用:

  • 人員下拉(「全部人員」或選特定操作者,含「系統」)。
  • 動作下拉(「全部動作」或選特定動作代碼)。
  • 日期區間:起始日 yyyy/mm/dd ~ 結束日 yyyy/mm/dd
  • 有套用任何篩選時,右側出現「清除篩選」;右上角顯示「符合 N 筆」。
  • 表格支援分頁(每頁筆數可調、上下頁切換)。

右上角「匯出 CSV」可把目前資料匯出成檔(按下後顯示「匯出中…」)。

永久不可刪、不可改

稽核日誌只能新增,永久保存,系統在程式層就沒有任何「修改」或「刪除」的途徑——沒有編輯 UI、沒有刪除按鈕、沒有後門。這是刻意的:結構技師簽證的民事追訴期最長 10 年,這份日誌就是事務所的舉證依據,必須完整、不可竄改。

Released under the MIT License.