> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alforse.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 稽核日誌

> 記錄誰建立、變更或刪除了公司中的重要業務記錄，依單筆記錄或整家公司檢視該歷程，並下載超過 30 天的封存檔。

稽核日誌是每家公司對 Alforse 主要業務記錄的建立、更新與刪除所保存的歷程，包含每項變更的操作者及其動到的欄位。由管理員開啟；之後任何有權檢視設定的人，不必到處詢問就能回答「這是誰在何時改的？」。

## 稽核日誌如何運作

記錄**預設為關閉**，且每家公司各自保存。一旦開啟，Alforse 會記錄受稽核實體之後的每一項變更。在你啟用之前、或關閉期間所做的變更，永遠不會被記錄。

項目是依人們所處理的業務實體分組，而不是依發生變更的資料庫列。例如，編輯品項的成本會產生一筆**品項**項目，而不是底層 `itemCost` 列的項目。

### 一筆項目包含什麼

| 部分 | 內容 |
| - | - |
| 操作 | `INSERT`、`UPDATE` 或 `DELETE`，在應用程式中顯示為已建立、已更新或已刪除 |
| 操作者 | 做出變更的使用者；由系統或服務角色所做的變更顯示為*系統* |
| 變更 | 新舊值的逐欄位差異 |
| 中繼資料 | 請求的 IP 位址、使用者代理程式（user agent）與來源 |
| 時間戳記 | 變更發生的時間 |

差異會省略 `updatedAt`、`updatedBy` 與內部嵌入向量等簿記欄位，所以項目只顯示人們會在意的變更。

## 受稽核的實體

只有以下實體會受稽核。對其他任何東西的變更都不會被記錄，無論記錄是否開啟。

| 銷售與客戶 | 採購與供應商 | 生產與庫存 | 財務與管理 |
| - | - | - | - |
| 客戶 | 供應商 | 品項 | 會計期間 |
| 報價單 | 供應商報價 | 品項保存期限 | 日記帳分錄 |
| 銷售訂單 | 採購單 | 工單 | 付款 |
| 銷售發票 | 採購發票 | 工作中心 | 備忘單 |
| 出貨 | 收貨 | 庫存盤點 | 報銷 |
| 定價規則 | | 揀料清單 | 固定資產 |
| 價格覆寫 | | 倉庫調撥 | 折舊執行 |
| 價格覆寫級距 | | 庫存調撥 | 收入認列執行 |
| 租賃合約 | | 保養排程 | 員工 |
| | | 保養派工 | 邀請 |
| | | 不合格品 | ITAR 認證 |
| | | 變更通知 | |
| | | 量規 | |

## 開啟與關閉記錄

**設定 → 稽核記錄**下的**稽核記錄**卡片只有一個切換開關。

### 開啟設定頁面

前往**設定 → 稽核記錄**。

### 打開切換開關

在**稽核記錄**卡片上，打開切換開關。Alforse 會建立公司的日誌儲存空間、設定 `auditLogEnabled`，並讓受稽核的資料表訂閱其變更管線。

### 確認狀態

卡片會顯示 *"Audit logging is enabled — All changes to auditable entities are being recorded."*（稽核記錄已啟用——所有對可稽核實體的變更都正在被記錄。）記錄關閉時則顯示 *"Audit logging is disabled — Enable to start tracking changes to your data."*（稽核記錄已停用——啟用後即開始追蹤對您資料的變更。）

關閉切換開關會停止新的項目，但保留既有歷程。重新開啟會從那一刻起恢復記錄；關閉期間的空檔會維持空白。

## 檢閱變更

同樣的資料可在兩種範圍檢視。

### 單筆記錄的歷程

在多數詳細資料頁面上，例如客戶、銷售訂單、工單或出貨，**歷程**動作會開啟一個側邊面板，顯示該記錄的時間軸。每項變更顯示操作、操作者、時間，以及可展開的已變更欄位清單。

如果記錄為關閉，面板會顯示 *"Audit logging is not enabled"*（稽核記錄未啟用）。可以更新設定的使用者會得到啟用它的捷徑；其他人則會被告知聯絡管理員。

### 全公司日誌

在**設定 → 稽核記錄**上，選取**檢視全部**以開啟全螢幕的**所有稽核日誌**表格。它可搜尋且有分頁，欄位有**實體**、操作、**變更者**、**變更**與**時間**。

| 篩選 | 將表格縮小為 |
| - | - |
| **實體** | 一種實體類型，例如銷售訂單或品項 |
| 操作 | 已建立、已更新或已刪除 |
| **變更者** | 一位使用者（操作者） |

操作會顯示為彩色徽章：已建立為綠色，已更新為藍色，已刪除為紅色。展開一列可查看其欄位層級的差異，選取**實體**的值可開啟它所指的記錄。

## 保留與封存

即時日誌保留 **30 天**的項目。每晚有一項工作會把較舊的項目移入壓縮封存檔，記錄封存檔的日期範圍、列數與大小，並從即時資料表中刪除這些項目。

封存檔列在設定頁面的**已封存記錄**之下。**下載**會建立指向壓縮匯出檔的短效簽署連結，所以請每次都重新要求新連結，而不要儲存舊的。在第一份封存檔出現之前，卡片會說明超過 30 天的日誌將封存在這裡。

## 權限與方案

| 動作 | 需求 |
| - | - |
| 開啟或關閉記錄 | **更新設定**權限 |
| 檢視日誌與記錄歷程 | **檢視設定**權限 |
| 使用此功能 | Business 方案 |

關於設定模組如何對應到員工類型，請見[權限與存取](https://docs.alforse.com/zh-Hant/docs/reference/permissions.md)。

## 疑難排解

### "Upgrade to Business to enable audit logging"（升級至 Business 以啟用稽核記錄）

**原因：**公司不是 Business 方案，所以**設定 → 稽核記錄**中的切換開關被擋住。
**解決方法：**升級方案，然後開啟記錄。

### "Upgrade to unlock audit history"（升級以解鎖稽核歷程）

**原因：**同一個方案限制，顯示在記錄的**歷程**面板中。
**解決方法：**升級到 Business 方案；此限制同時涵蓋設定切換開關與面板。

### "Audit logging is not enabled"（稽核記錄未啟用）

**原因：****歷程**面板已開啟，但公司的記錄是關閉的。
**解決方法：**具有更新設定權限的使用者在**設定 → 稽核記錄**中開啟它。如果你沒有該權限，請詢問管理員。

### "Failed to enable audit logging" 或 "Failed to disable audit logging"（無法啟用／停用稽核記錄）

**原因：**建立或移除公司的日誌儲存與變更訂閱時發生伺服器錯誤。
**解決方法：**再試一次。如果持續失敗，日誌資料表或其訂閱可能不同步；再切換一次即可重新同步。

### "Failed to generate download URL"（無法產生下載 URL）

**原因：**Alforse 無法建立簽署連結，原因可能是封存檔儲存的檔案遺失，或簽署請求失敗。
**解決方法：**再試一次。連結很快就會過期，所以舊連結無法使用。

### 記錄沒有顯示歷程

請檢查三件事。變更發生時記錄必須是開啟的，因為 Alforse 絕不回填。該記錄的實體必須出現在[受稽核的實體](#audited-entities)中。而且只動到簿記欄位（`updatedAt`、`updatedBy`、嵌入向量）的變更不會顯示欄位層級的差異。

### 表格中缺少較舊的變更

即時日誌只保留最近 30 天。較舊的變更請到**已封存記錄**下的可下載匯出檔中尋找。

## 相關內容

**公司設定**

公司記錄及其功能開關，包括稽核記錄。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/company-settings.md)

**權限與存取**

設定權限如何決定誰可以檢視與管理日誌。

[Open](https://docs.alforse.com/zh-Hant/docs/reference/permissions.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.