# Face Recognition System GUI 操作指南

系統名稱: Face Recognition Syste
版本：v1.0.0
發佈日期: 2025/09/02
GitHub：
- [FaceRecoSystem](https://github.com/JiangXiu11200/FaceRecoSystem) ⭠ 前後端系統
- [FaceRecognition](https://github.com/JiangXiu11200/FaceRecognition) ⭠ 人臉辨識服務

## 前言

本文件為 [FaceRecoSystem](https://github.com/JiangXiu11200/FaceRecoSystem) 的 圖形化介面 (GUI) 操作手冊，主要說明各個功能頁面的用途、操作方式與基礎教學。若需更深入的系統架構、安裝與技術細節，請參考 GitHub 專案的 README 文件。

本系統為個人開發的 Side Project，旨在探索前後端整合、工具運用與系統設計實踐。內容僅作為研究與學習用途，若有興趣或建議，歡迎交流與討論！

## 頁面說明

頁面配置說明

系統介面設計簡潔一致，使用者登入後即進入首頁。所有頁面皆採相同配置，主要區域如下：
- **Sidebar（側邊欄）**：提供頁面切換與功能入口，例如人臉辨識、日誌、帳號管理與系統設定。
- **功能區域（Main Content）**：各頁面主要操作與顯示內容的核心區域。
- **頁面導航（Breadcrumb / Header）**：顯示目前所在位置，並協助快速返回上層或其他頁面。
- **用戶操作區（User Menu）**：位於介面右上角，包含使用者資訊與登出功能。

___

## - Login

登入頁面

模式比較

**模式說明：**

系統提供兩種操作模式，使用者登入後會依權限自動進入對應模式：
- **Standard 模式**：
- 功能範圍：僅開啟**人臉辨識頁面**。
- 適用情境：作為門禁系統日常運作時使用，提供穩定且單純的辨識功能。
- **Advanced 模式**：
- 功能範圍：除人臉辨識外，**依照使用者權限可進入 系統設定、帳號管理、日誌查閱 等進階功能**。
- 適用情境：管理員或具備特定權限的使用者進行 參數調整、事件追蹤、系統維運。

___

## - Face Recognition

Face Recognition

**辨識頁面功能說明：**

- **Connect**：點擊後，Web Server 會與 Face Recognition Service 建立 WebSocket 連線，準備接收即時辨識資訊。
- **Start Stream**：點擊後，系統開始串流，將攝影機的即時影像傳送至網頁，並同步進行人臉辨識。
- **Clear Logs**：點擊後，會清除右側的辨識日誌內容，方便進行新一輪的觀測。
- **辨識日誌區域**：顯示系統運行資訊與人臉辨識結果，包括事件時間、狀態與識別內容。
- **串流影像視窗**：用於呈現 Face Recognition Service 傳回的即時影像，並搭配辨識框顯示識別結果。

---

## - User Registration

User Registration

**註冊新用戶頁面功能說明：**

- **子頁面選單**：
- **Register**：用於註冊用戶人臉，並將人臉傳送至 Face Recognition Service，產生人臉特徵。
- **Group**：建立與管理用戶群組，用於區分與分類使用者，方便辨識與權限控管。
- **User**：檢視已註冊之用戶清單與相關資料。
- **串流影像視窗**：顯示即時串流影像，僅用於輔助註冊時的影像擷取。
- **用戶名稱**：輸入待註冊使用者的名稱。
- **選擇用戶群組**：從既有群組中選擇使用者所屬分類。
- **影像截圖**：擷取當前畫面的人臉影像，作為註冊依據。
- **清除資料**：清空當前頁面輸入與影像，適用於擷取影像不理想時重新操作。
- **Start Stream**：啟動攝影機串流，將即時影像傳送至網頁。
- **Connect**：與 Face Recognition Service 建立 WebSocket 連線，準備接收影像串流。

---

## - User Registration: Group

User Registration: Group

**用戶群組頁面功能說明：**

- **群組搜尋**：可輸入群組名稱進行快速查詢，方便定位目標群組。
- **建立群組**：輸入新群組名稱後建立，適用於新增部門、角色或權限分類。
- **已建立之群組清單**：顯示所有已建立的群組清單，並提供檢視、管理或刪除的操作入口。

---

## - User Registration: User

User Registration: User

**已註冊用戶頁面功能說明：**

- **透過名稱與群組搜尋用戶**可輸入使用者名稱或所屬群組進行快速查詢，方便查找特定使用者。
- **已建立之用戶清單**：顯示所有已註冊的使用者清單，包含使用者名稱、群組、註冊時間等資訊，並方便管理員做細節修改，包括啟用/關閉用戶、修改所屬群組、刪除用戶等。

---

## - Alarm Logs

Alarm Logs

**告警日誌頁面功能說明：**

- **告警日誌搜尋**：可依照告警類型、處理狀態、時間區間等條件進行篩選，快速找到目標紀錄。
- **告緊日誌清單**：顯示所有符合條件的告警事件，內容包含事件類型、時間、處理狀態、人臉照片 ROI 顯示等，方便快速檢視。

---

## - Activity Logs: Facial Recognition

Activity Logs: Facial Recognition

**辨識活動日誌頁面功能說明：**

- **辨識活動日誌搜尋**：可依照用戶名稱與群組，快速找到用戶辨識紀錄。
- **辨識活動日清單**：顯示所有符合條件的辨識日誌，內容包含用戶名稱、所屬群組、辨識結果、時間戳與辨識當下之人臉 ROI 照片。

---

## - Activity Logs: System

Activity Logs: System

**系統活動日誌頁面功能說明：**

- **系統活動日誌搜尋**：可依照用系統用戶名稱過濾日誌。
- **系統活動日清單**：顯示系統活動日誌，包含用戶名稱、用戶操作、操作細節、操作狀態結果、時間戳。
- **系統活動日誌保存天數設定**：可設定日誌保存期限，系統將自動刪除超過天數的舊紀錄，以確保資料量可控。

---

## - Settings: Accounts

Settings: Accounts

**系統用戶設定頁面功能說明：**

- **用戶搜尋**：可依照用系統用戶名稱過濾已建立的系統用戶。
- **建立用戶**：建立系統用戶，並可依照系統用戶群組設定用戶應用程式存取權限。
- **系統用戶清單**：顯示當前已建立的系統用戶，包括名稱、Email、啟用狀態、所屬群組等資訊。

---

## - Settings: Accounts - Account Groups

Settings: Accounts - Account Groups

**系統用戶群組頁面功能說明：**

- **群組搜尋**：可依照用系統用戶名稱過濾已建立的系統群組用戶。
- **建立群組**：建立系統群組，並可設定該群組可存取之應用程式權限。
- **系統用戶群組清單**：顯示當前已建立的系統群組，包括名稱、可用應用程式、啟用狀態、更新時間、建立時間等資訊。

---

## Settings: Face Recognition

Settings: Face Recognition

**人臉辨識參數頁面功能說明：**

- **攝影機參數**：設置 Face Recognition Service 接入之攝影機 RTSP、Web Camera路徑、影像 Resize 寬/高、檢測 ROI 座標。
- **Debug 參數**：開啟或關閉 Debug 模式。若開啟，則會顯示人臉追蹤框與人眼睛追蹤框。
- **辨識參數**：設定 Face Recognition Service 人臉辨識算法之參數，詳細說明請查看 [Face Recognition Service](https://github.com/JiangXiu11200/FaceRecognition)

---

## 系統操作教學

## - 建立系統群組

1. 進入系統群組頁面(Settings > Accounts > Account Groups)，點擊`Create`按鈕。
2. 對應欄位填入所需項目，最後點擊`Create`按鈕。
3. 完成。

---

## - 建立系統用戶

1. 進入系統群組頁面(Settings > Accounts)，點擊`Create`按鈕。
2. 對應欄位填入所需項目，最後點擊`Save`按鈕。
3. 創建完成，可透過新的帳號登入。

---

## - 開始新的人臉註冊

### 人臉辨識用戶群組

1. 進入人臉群組頁面(User Registration > Group)，點擊`Add Group`按鈕。
2. 填入群組名稱，並將其設為開啟。
4. 創建完成。

### 人臉用戶註冊

1. 進入人臉註冊頁面(User Registration)，點擊`Connect`按鈕，與 Face Recognition Service 建立連線。
2. 點擊`Stream`按鈕，開始影像串流。
3. 輸入用戶名稱，並選擇所屬群組後，點擊`Screenshot`按鈕進行截圖，最後點擊`Register`按鈕註冊。此時，系統會呼叫 Face Recognition Service 進行人臉特徵擷取，可能需要一點點時間。
4. 註冊完成。

### 查看已註冊用戶與群組

1. 進入人臉群組頁面(User Registration > Group)，可看到用戶群組使用者為`1`。
2. 進入人臉註冊用戶頁面(User Registration > User)，可看到剛才註冊的用戶`Jonas`。
3. 點擊編輯符號，可編輯該用戶資訊。

---

## - 開始人臉辨識

### 已註冊之使用者

1. 進入首頁(Face Recognition)，點擊`Connect` -> `Start Stream` 開啟主功能。
2. 當人臉進入 ROI 範圍時，系統會開始進行辨識。
，若人臉已註冊，則顯示辨識成功與當前使用者。
3. 進入辨識日誌頁面(Activity Logs > Facial Recognition)，可看到剛才辨識成功的歷史紀錄。

### 未註冊之使用者

1. 我們將剛才註冊的人臉用戶刪除後，回到辨識頁面，系統若偵測到該用戶未註冊，則顯示辨識結果為`false`。
2. 並將失敗時間戳、人臉 ROI 影像與相關資訊，記錄到 Alarm logs 中。
3. 點擊檢視符號，可以查看每一筆告警資訊細節。

---

## 其他

### Token 到期自動登出

系統預設登入有效時間為 1 天。當登入時間超過此期限時，系統將顯示以下訊息：`Your session has expired, please login again.` 並會自動登出使用者，需重新登入才能繼續使用系統。