# 門禁比對程式使用教學

## 1. 開啟程式

請進入：

`程式執行檔\門禁比對程式\門禁比對程式.exe`

第一次開啟後，程式會在本機建立自己的資料庫，不需要安裝 SQL Server，也不需要連網。

## 2. 這套程式可以做什麼

- 手動新增列管人員
- 匯入列管名單 Excel
- 匯入門禁 Excel
- 自動比對指定日期區間內是否有進出
- 支援多個 Excel、連續多天 Excel、舊版 `.xls`
- 支援部分髒資料自動略過
- 資料完全保存在本機 SQLite，不連外部 API

## 3. 最簡單操作流程

1. 先按 `匯入列管檔案`
2. 選擇列管名單 Excel
3. 再按 `匯入門禁檔案` 或 `匯入門禁資料夾`
4. 設定開始日期與區間
5. 按 `套用時間並執行比對`
6. 看 `比對結果`
7. 需要交付報表時按 `匯出比對結果`

## 4. 程式畫面重點

- 預設會先遮罩個資
- 右上角 `👁 顯示個資` 可以切換完整姓名與電話
- `無進出` 會用紅色醒目顯示
- 結果表格如果欄位太長，可以左右拖曳
- 雙擊某一列，可以看完整內容

## 5. 列管名單格式建議

建議欄位：

- 戶別
- 姓名
- 聯絡電話
- 緊急聯絡人
- 緊急聯絡電話
- 卡號1
- 卡號2

注意：

- 同一人可有 2 張卡
- 如果第二張卡放在下一列，且那一列姓名空白，程式會自動併回上一人
- 如果姓名欄大量是數字，代表可能選錯欄位

## 6. 門禁資料支援範圍

目前支援：

- `.xlsx`
- `.xls`
- `.xlsm`
- `.csv`

可處理情況：

- 一個 Excel 內含多天資料
- 多個 Excel 一次匯入
- 整個資料夾批次匯入
- 日期欄與時間欄分開
- 只有時間欄，但檔名內有日期

## 7. 智慧辨識說明

這套程式不連外部 AI，但有本地智慧辨識功能：

- 自動猜測卡號欄
- 自動猜測日期時間欄
- 自動記住已確認過的格式
- 發現低信心格式時才要求人工確認
- 遇到髒資料時會跳出智慧提醒

## 8. 資料保存位置

打包版執行後，資料會存到：

`%APPDATA%\TaipeiUrbanRenewalAccessCompare\app_data`

其中包含：

- `app.db`
- SQLite 備份
- 舊設定遷移資料

## 9. 常見狀況

### 匯入後沒有結果

請確認：

- 列管名單有卡號
- 門禁資料真的有對應卡號
- 日期區間有包含刷卡時間

### 比對人數怪怪的

請先檢查：

- 姓名欄是不是其實選成序號欄
- 卡號欄是不是有空白或錯欄
- 是否重複匯入同一份資料

### 程式打不開

請確認：

- Windows 沒擋掉 `.exe`
- 整個 `門禁比對程式` 資料夾都有一起帶走
- 不要只單獨複製 `.exe`

## 10. 給測試者的建議

第一次測試時，請先用 `測試資料` 裡的檔案跑一遍，再換自己的資料。
