# 勞工與宿舍管理系統 - 使用者操作手冊

---

## 目錄

1. [系統簡介](#系統簡介)
2. [登入系統](#登入系統)
3. [儀表板](#儀表板)
4. [工人檔案管理](#工人檔案管理)
5. [宿舍管理](#宿舍管理)
6. [智能宿位分配](#智能宿位分配)
7. [會計管理](#會計管理)
8. [問題追蹤板](#問題追蹤板)
9. [公司與店鋪管理](#公司與店鋪管理)
10. [勞工主任管理](#勞工主任管理)
11. [簡介會地點管理](#簡介會地點管理)
12. [Excel 匯入功能](#excel-匯入功能)
13. [帳號管理](#帳號管理)
14. [個人設定](#個人設定)

---

## 系統簡介

本系統專為勞工與宿舍管理而設計，提供完整的工人資料管理、宿舍分配、會計記錄等功能，協助您更有效率地管理外勞相關事務。

### 主要功能

- **工人檔案管理**：完整記錄工人基本資料、申請進度、合約資訊
- **宿舍管理**：管理宿舍資訊與床位分配
- **智能宿位分配**：自動計算距離，建議最佳宿舍分配
- **會計管理**：記錄租金收入與支出，產生報表
- **問題追蹤板**：問題管理與追蹤，支援樹狀回覆結構
- **公司與店鋪管理**：管理公司與店鋪資訊
- **Excel 匯入**：批次匯入工人資料

---

## 登入系統

### 步驟

1. 開啟瀏覽器，進入系統網址
2. 輸入您的帳號與密碼
3. 點擊「登入」按鈕

### 忘記密碼

如忘記密碼，請聯繫系統管理員協助重設。

---

## 儀表板

登入後，您將看到儀表板，這裡顯示系統的重要資訊概覽。

### 儀表板功能

- **工人統計**：顯示工人總數、性別比例等資訊
- **合約到期提醒**：列出即將到期的合約
- **宿舍使用狀況**：顯示各宿舍的入住率
- **最新動態**：顯示最近的系統活動

---

## 工人檔案管理

### 功能概述

工人檔案模組讓您可以完整管理所有工人的資料，包括基本資訊、申請進度、合約追蹤等。

### 查看工人列表

1. 點擊左側選單的「工人檔案」
2. 系統會顯示所有工人的列表，每頁顯示 15 筆資料
3. 列表會顯示以下資訊：
   - 勞工處編號
   - 中文姓名
   - 性別
   - 身份證號碼
   - 所屬公司 / 店鋪
   - 宿舍地址

### 搜尋工人

1. 在工人列表頁面上方的搜尋框中輸入關鍵字
2. 可以搜尋：
   - 姓名（中文或英文）
   - 身份證號碼
   - 勞工處編號
3. 點擊「搜尋」按鈕或按 Enter 鍵執行搜尋
4. 點擊「清除」可清空搜尋條件，顯示所有工人

### 排序功能

- 點擊「勞工處編號」欄位標題可進行排序
- 第一次點擊：升序排列（小到大）
- 第二次點擊：降序排列（大到小）

### 新增工人

#### 方法一：手動新增

1. 在工人列表頁面，點擊右上角的「新增工人」按鈕
2. 填寫工人資料表單：
   - **基本資料**（必填：中文姓名、身份證號碼）
     - 中文姓名
     - 英文姓名
     - 身份證號碼
     - 性別
     - 出生日期
     - 電話號碼
     - 職位
     - 勞工處編號
   
   - **分配資訊**
     - 分配店鋪
     - 分配宿舍
     - 月租（收入）
     - 指派勞工主任
   
   - **申請進度與合約追蹤**（選填）
     - 政府編號（入境處檔案編碼、配額序號、合約編號）
     - 申請流程日期（申請日期、刊登報紙、交勞工處等）
     - 證件與合約效期（抵港日期、合約到期日期等）
     - 簡介會與身分證申請資訊

3. 點擊「新增工人」按鈕完成新增
4. 系統會顯示成功訊息，並自動返回工人列表

#### 方法二：Excel 匯入

請參考 [Excel 匯入功能](#excel-匯入功能) 章節。

### 查看工人詳情

1. 在工人列表中，點擊工人姓名旁的「查看」圖示（眼睛圖示）
2. 系統會顯示該工人的詳細資料頁面
3. 詳情頁面包含：
   - 完整的個人資料
   - 申請進度追蹤
   - 合約資訊
   - 宿舍分配狀態

### 編輯工人資料

1. 在工人列表中，點擊工人姓名旁的「編輯」圖示（鉛筆圖示）
2. 或在工人詳情頁面點擊「編輯」按鈕
3. 修改需要更新的欄位
4. 點擊「儲存所有修改」按鈕完成更新

### 刪除工人資料

> ⚠️ **注意**：刪除操作無法復原，請謹慎執行

1. 在工人列表中，點擊工人姓名旁的「刪除」圖示（垃圾桶圖示）
2. 系統會顯示確認對話框：「確定要刪除這位工人嗎？此動作無法復原！」
3. 點擊「確定」執行刪除
4. 系統會顯示成功刪除的訊息

> **權限說明**：刪除功能僅限管理員使用

### 匯出 Word 合約

1. 進入工人詳情頁面
2. 點擊「匯出 Word 合約」按鈕
3. 系統會自動下載該工人的僱傭合約文件（.docx 格式）

---

## 宿舍管理

### 功能概述

宿舍管理模組讓您可以維護所有宿舍的資訊，包括地址、性別限制、床位數量等。

### 查看宿舍列表

1. 點擊左側選單的「宿舍管理」
2. 系統會顯示所有宿舍的列表
3. 每個宿舍會顯示：
   - 地址
   - 性別限制（男 / 女 / 混合）
   - 床位總數
   - 已入住人數
   - 剩餘床位

### 新增宿舍

1. 在宿舍列表頁面，點擊「新增宿舍」按鈕
2. 填寫宿舍資料：
   - 地址
   - 性別限制
   - 床位數量
   - 月租金額
3. 點擊「儲存」完成新增

### 編輯宿舍

1. 在宿舍列表中，點擊「編輯」按鈕
2. 修改需要的欄位
3. 點擊「儲存」完成更新

### 刪除宿舍

1. 在宿舍列表中，點擊「刪除」按鈕
2. 確認刪除操作

> ⚠️ **注意**：如果宿舍內已有工人入住，可能無法刪除

---

## 智能宿位分配

### 功能概述

智能宿位分配功能會根據工人工作的店鋪位置，自動計算距離最近的宿舍，建議最佳的床位分配方案。

### 使用步驟

1. 點擊左側選單的「智能宿位分配」
2. 系統會顯示尚未分配宿舍的工人列表
3. 每位工人會顯示：
   - 工人姓名
   - 工作店鋪
   - 性別
   - 推薦宿舍（按距離排序）
   - 預計距離（公里）

### 分配宿舍

1. 查看系統推薦的宿舍選項
2. 選擇合適的宿舍
3. 點擊「分配」按鈕
4. 系統會自動更新工人的宿舍資訊

### 重新整理

- 點擊「重新整理」按鈕，系統會重新計算距離並更新推薦

---

## 會計管理

### 功能概述

會計模組讓您可以管理宿舍租金收入、工人租金收入及其他收支項目。

### 查看會計總覽

1. 點擊左側選單的「會計」
2. 選擇要查看的月份
3. 系統會顯示該月份的收支明細

### 宿舍租金收入

- 顯示每間宿舍的租金收入
- 可編輯每月實際收取的金額
- 可新增或刪除租金記錄

### 工人租金收入

- 顯示每位工人的租金繳交記錄
- 可編輯每月實際收取的金額
- 可新增或刪除租金記錄

### 其他收支

- 記錄非租金的收支項目
- 可選擇收支類別
- 可新增、編輯或刪除記錄

### 會計類別管理

1. 點擊「會計類別」
2. 可新增、編輯或刪除收支類別

### 匯出報表

- **宿舍報表**：匯出宿舍租金收入明細（Excel 格式）
- **月報表**：匯出單月收支明細（Excel 格式）
- **年報表**：匯出年度收支明細（Excel 格式）

---

## 問題追蹤板

### 功能概述

問題追蹤板是一個問題管理系統，讓您可以建立、追蹤和管理各類問題，支援樹狀回覆結構，方便團隊協作解決問題。

### 問題分類

系統提供五種問題分類：
- **工人問題**：與工人相關的問題
- **宿舍問題**：與宿舍相關的問題
- **公司問題**：與公司相關的問題
- **店鋪問題**：與店鋪相關的問題
- **其他問題**：其他類型的問題

### 查看問題列表

1. 點擊左側選單的「問題追蹤板」
2. 系統會顯示所有問題的列表
3. 每個問題會顯示：
   - 問題標題
   - 分類與狀態
   - 優先級
   - 處理期限（如有設定）
   - 建立者與跟進人
   - 回覆數量

### 搜尋與篩選

#### 篩選問題

1. 在問題列表頁面上方的篩選器中選擇條件：
   - **分類**：選擇問題分類
   - **狀態**：開啟 / 處理中 / 已完結
   - **優先級**：低 / 中 / 高 / 緊急
2. 系統會即時更新列表

#### 搜尋問題

1. 在搜尋框中輸入關鍵字
2. 可搜尋問題標題與內容
3. 點擊搜尋按鈕或按 Enter 執行搜尋

### 新增問題

1. 點擊右上角的「新增問題」按鈕
2. 填寫問題資訊：
   - **問題分類**（必填）：選擇適當的分類
   - **問題簡介**（必填）：簡短描述問題主題
   - **問題內容**（必填）：詳細描述問題
   - **優先級**（必填）：低 / 中 / 高 / 緊急
   - **處理期限**（選填）：設定希望完成的時間
   - **指派跟進人**（選填）：指定負責的用戶
3. 點擊「建立問題」完成新增

### 查看問題詳情

1. 在問題列表中，點擊問題標題或「查看」按鈕
2. 系統會顯示問題的詳細資訊：
   - 問題標題與內容
   - 分類、狀態、優先級
   - 建立者與建立時間
   - 處理期限（如有設定）
   - 跟進人（如有指派）
   - 所有回覆（樹狀結構顯示）

### 回覆問題

#### 新增回覆

1. 在問題詳情頁底部的回覆表單中輸入內容
2. 點擊「送出回覆」按鈕
3. 回覆會即時顯示在頁面上

#### 回覆其他人的回覆

1. 找到要回覆的回覆
2. 點擊該回覆右下角的「回覆」按鈕
3. 輸入回覆內容
4. 點擊「送出回覆」
5. 子回覆會以縮排方式顯示在父回覆下方

### 編輯回覆

> **權限說明**：只能編輯自己的回覆

1. 找到自己的回覆
2. 點擊「編輯」按鈕
3. 修改回覆內容
4. 點擊「儲存修改」完成更新

> **注意**：回覆無法刪除，只能編輯，以保留完整的討論記錄

### 編輯問題

> **權限說明**：只有問題建立者和管理員可以編輯問題

1. 在問題詳情頁點擊「編輯」按鈕
2. 修改需要的欄位
3. 可更改：
   - 問題分類
   - 問題標題與內容
   - 優先級
   - 狀態（開啟 / 處理中 / 已完結）
   - 處理期限
   - 跟進人
4. 點擊「儲存修改」完成更新

### 完結問題

1. 在問題詳情頁點擊「完結問題」按鈕
2. 問題狀態會變更為「已完結」
3. 已完結的問題會：
   - 標題與內容顯示刪除線
   - 整體以灰色顯示
   - 仍可查看與回覆

### 重新開啟問題

> **權限說明**：只有管理員和問題建立者可以重新開啟已完結的問題

1. 在已完結的問題詳情頁點擊「重新開啟」按鈕
2. 問題狀態會變更回「開啟」
3. 刪除線會消失，恢復正常顯示

### 刪除問題

> **權限說明**：
> - 管理員可以刪除任何問題
> - 問題建立者只能刪除自己建立的問題

1. 在問題詳情頁點擊「刪除」按鈕
2. 系統會顯示確認對話框
3. 點擊「確定」執行刪除
4. 問題與所有回覆都會被移除

> ⚠️ **注意**：刪除操作無法復原

### 問題狀態

- **開啟**：問題已建立，等待處理
- **處理中**：問題正在處理中
- **已完結**：問題已解決

### 優先級說明

- **低**：一般問題，不急迫（灰色）
- **中**：正常優先級（藍色）
- **高**：較為重要（橙色）
- **緊急**：需要立即處理（紅色）

### 逾期警示

- 當問題的處理期限已過，且問題尚未完結時，系統會以紅色標示
- 問題列表中的逾期問題會顯示「已逾期」標籤
- 儀表板的小鈴鐺會顯示逾期問題數量

### 通知系統

儀表板右上角的小鈴鐺會顯示以下通知：

- **逾期問題**：超過處理期限但尚未完結的問題
- **指派給我的問題**：被指派給您的問題
- **待處理問題**：所有狀態為「開啟」的問題

點擊通知項目會直接跳轉到對應的問題列表。

### 最佳實踐

1. **建立問題時**：
   - 選擇正確的分類
   - 填寫清楚的標題與詳細內容
   - 設定合理的處理期限
   - 指派適當的跟進人

2. **回覆問題時**：
   - 提供具體的資訊
   - 使用樹狀回覆功能回覆特定人的回覆
   - 保持討論焦點

3. **管理問題時**：
   - 定期檢查指派給自己的問題
   - 及時更新問題狀態
   - 問題解決後記得完結

---

## 公司與店鋪管理

### 功能概述

管理系統中的公司與店鋪資訊，建立公司與店鋪的從屬關係。

### 查看公司列表

1. 點擊左側選單的「公司與店鋪」
2. 系統會顯示所有公司
3. 展開公司可查看其下的所有店鋪

### 新增公司

1. 點擊「新增公司」按鈕
2. 輸入公司名稱
3. 點擊「儲存」完成新增

### 新增店鋪

1. 在公司列表中，找到要新增店鋪的公司
2. 點擊「新增店鋪」按鈕
3. 輸入店鋪名稱與地址
4. 點擊「儲存」完成新增

### 編輯公司 / 店鋪

1. 點擊「編輯」按鈕
2. 修改需要的欄位
3. 點擊「儲存」完成更新

### 刪除公司 / 店鋪

1. 點擊「刪除」按鈕
2. 確認刪除操作

> ⚠️ **注意**：如果公司或店鋪下已有工人，可能無法刪除

---

## 勞工主任管理

### 功能概述

管理勞工主任的資訊，可將工人指派給特定的勞工主任負責。

### 查看勞工主任列表

1. 點擊左側選單的「勞工主任」
2. 系統會顯示所有勞工主任的列表

### 新增勞工主任

1. 點擊「新增勞工主任」按鈕
2. 填寫資料：
   - 姓名
   - 電話
   - 電子郵件
3. 點擊「儲存」完成新增

### 編輯 / 刪除勞工主任

操作方式與其他模組相同。

---

## 簡介會地點管理

### 功能概述

管理簡介會的舉辦地點，方便在工人資料中選擇。

### 查看地點列表

1. 點擊左側選單的「簡介會地點」
2. 系統會顯示所有地點的列表

### 新增地點

1. 點擊「新增地點」按鈕
2. 填寫資料：
   - 地點名稱
   - 詳細地址
3. 點擊「儲存」完成新增

### 編輯 / 刪除地點

操作方式與其他模組相同。

---

## Excel 匯入功能

### 功能概述

批次匯入工人資料，節省手動輸入的時間。

### 使用步驟

1. 點擊左側選單的「Excel 匯入」
2. 下載 Excel 範本（點擊「下載範本」按鈕）
3. 在 Excel 檔案中填寫工人資料
4. 回到匯入頁面，選擇填寫好的 Excel 檔案
5. 點擊「匯入」按鈕
6. 系統會顯示匯入結果（成功筆數、失敗筆數）

### Excel 欄位說明

請確保 Excel 檔案包含以下欄位（欄位名稱需完全相符）：

- 中文姓名
- 英文姓名
- 身份證號碼
- 性別
- 出生日期
- 電話號碼
- 職位
- 勞工處編號
- 其他相關欄位...

> ⚠️ **注意**：詳細的欄位對照表請參考系統提供的範本

---

## 帳號管理

> **權限說明**：此功能僅限管理員使用

### 功能概述

管理系統使用者帳號，新增、編輯或刪除使用者。

### 查看使用者列表

1. 點擊左側選單的「帳號管理」
2. 系統會顯示所有使用者帳號

### 新增使用者

1. 點擊「新增使用者」按鈕
2. 填寫資料：
   - 姓名
   - 電子郵件（作為登入帳號）
   - 密碼
   - 角色（管理員 / 一般使用者）
3. 點擊「儲存」完成新增

### 編輯使用者

1. 點擊「編輯」按鈕
2. 修改需要的欄位
3. 點擊「儲存」完成更新

### 刪除使用者

1. 點擊「刪除」按鈕
2. 確認刪除操作

---

## 個人設定

### 功能概述

管理您個人的帳號設定，包括修改密碼。

### 修改密碼

1. 點擊右上角的使用者名稱
2. 選擇「個人設定」
3. 輸入：
   - 目前密碼
   - 新密碼
   - 確認新密碼
4. 點擊「更新密碼」按鈕

### 登出系統

1. 點擊右上角的使用者名稱
2. 選擇「登出」

---

## 常見問題

### Q1: 忘記密碼怎麼辦？

請聯繫系統管理員協助重設密碼。

### Q2: 為什麼無法刪除某些資料？

如果該筆資料與其他資料有關聯（例如：公司下有工人），系統會保護這些資料不被刪除。請先移除相關聯的資料後再執行刪除。

### Q3: Excel 匯入失敗怎麼辦？

請檢查：
1. Excel 檔案格式是否正確（.xlsx）
2. 欄位名稱是否與範本完全相符
3. 資料格式是否正確（例如：日期格式）
4. 必填欄位是否都有填寫

如仍有問題，請聯繫系統管理員。

### Q4: 如何列印工人資料？

可以在工人詳情頁面使用瀏覽器的列印功能（Ctrl + P）進行列印。

### Q5: 問題追蹤板中，為什麼無法刪除回覆？

系統設計上不允許刪除回覆，只能編輯自己的回覆。這是為了保留完整的討論記錄，確保問題處理過程的透明度與可追溯性。如需修正錯誤，請使用編輯功能。

### Q6: 問題逾期了怎麼辦？

逾期問題會在問題列表中以紅色標示，並顯示在儀表板的通知鈴鐺中。請盡快處理逾期問題，並在完成後將問題狀態設為「已完結」。如需更多時間，可以編輯問題並調整處理期限。

### Q7: 如何查看指派給我的問題？

點擊儀表板右上角的小鈴鐺，會顯示「指派給我的問題」數量。點擊該項目會跳轉到問題列表，您也可以在問題列表中查看「跟進人」欄位確認。

---

## 技術支援

如有任何問題或建議，請聯繫系統管理員。

---

**文件版本**：1.1  
**最後更新**：2026 年 8 月 27 日