歷史異動日誌(Audit Trail)

CallIT 對每張需求單的所有狀態變更與重要備註自動寫日誌,提供 IT 角色用 Timeline 形式查詢,做事後追溯。

寫入時機

每次以下動作後端自動寫一筆

  • 被 IT 接單(APPLYING → PROCESSING
  • 退回(任何狀態 → REJECTED
  • 分派處理人員
  • 結案(PROCESSING → COMPLETED
  • 單號刪除
  • 重要備註修改

寫入動作在 五層式架構service/ 層做 — service.transition_state() 內部呼叫 repository.write_audit_log(),不能繞過。

紀錄欄位

欄位內容
timestamp異動時間
operator操作者(從 cookie 解析)
action異動動作(接單 / 退回 / 結案 / 刪除…)
before_state異動前狀態
after_state異動後狀態
reason操作者填的原因(必填於退回時)
request_id對應的需求單號

查詢頁面

只有 IT 角色可進入「歷史異動日誌」查詢頁。

Timeline 呈現

需求單詳細頁 / 進度查詢頁可選兩種呈現:

  1. 清單:時間倒序的表格
  2. 時間軸(Timeline):圖形化的時序圖,方便看完整生命週期一眼

進度查詢權限分級

「歷史異動日誌」之外,「進度查詢頁面」也分權限:

角色可查範圍
User自己的單
行政 / 主官管部門的單
IT全部(含已刪除)

為什麼重要

  • 事後追溯:客訴、爭議、稽核時可看完整流轉歷程
  • 行為歸責:每筆都有 operator,無法匿名修改
  • 管理盲點偵測:若發現「同一單反覆 RE/退回」可能是流程設計問題

相關概念

強連結(原文明確提及)

深入閱讀

← 回到 wiki