# OnTime 智慧打卡系統 (OnTime Attendance & Workforce System)

> OnTime 是一款專為企業與團隊打造的高效雲端打卡與考勤管理系統，結合 NFC 近場感應、GPS 定位驗證、動態防偽與自動考勤統計報表。

## 系統核心特色 (System Highlights)
- **多重驗證打卡**：支援 NFC 實體卡片/貼紙感應打卡、GPS 圍欄與 WiFi IP 地理位置防偽驗證。
- **無縫 PWA 體驗**：支援 iOS / Android 手機桌面捷徑安裝、離線狀態快取與即時 Push 推播通知。
- **實時出勤統計**：提供主管與 HR 即時出勤看板、遲到/早退/加班統計、月度考勤 Excel/CSV 匯出。
- **彈性權限架構**：劃分系統管理者 (Admin)、部門主管 (Manager) 與一般員工 (Employee) 之三層安全存取控制。

## 文件導覽 (Documentation & Resources)
- [系統完整技術與產品規格書](https://ontime-tw-prod.web.app/llms-full.txt): 包含詳細資料庫 Schema、API 端點、防偽打卡演算邏輯與佈署說明。
- [產品網站 (Product Web)](https://ontime-tw-prod.web.app/): 智慧打卡系統線上說明與登入入口。

## 核心功能模組 (Core Modules)

### 1. 考勤打卡 (Punch System)
- **NFC 打卡**：手機感應 NFC 標籤即可秒級完成打卡。
- **GPS 定位**：自動比對公司辦公室/工作地點之座標距離，防止遠端假打卡。
- **打卡備註與相片**：支援外勤人員附帶地點照與工作說明。

### 2. 請假與加班申請 (Leave & Overtime Management)
- 支援線上請假（事假、病假、特休、公假等）與加班申請單。
- 主管線上審核機制與狀態變更推播通知。

### 3. 統計報表與匯出 (Analytics & Reports)
- 自動計算出勤時數、遲到分鐘數與加班累積時數。
- 支援一鍵導出月度考勤表，相容勞基法與企業薪資結算需求。

## 常見問題 (FAQ)
- **Q: 是否需要購買專用打卡機？**
  - A: 不需要，OnTime 支援一般智慧型手機（iOS/Android），配合一般 NFC 貼紙或手機 GPS 即可運作。
- **Q: 如何防止員工代打卡或虛報定位？**
  - A: 系統整合 GPS 範圍比對、裝置 ID 綁定與動態代碼驗證，有效防止防偽模擬定位與代打卡行為。