# web_jobcheck · 360dHR 自動打卡

用 Node.js + Playwright 自動登入 [360dHR (femascloud)](https://femascloud.com/360dhr/) 並打卡。
提供一個本機網頁,上面有 **上班卡** / **下班卡** 兩顆按鈕,並可在打卡後發送通知。

## 功能
- 自動登入(帳密放在 `.env`,不寫死在程式)。
- 上班卡(`data-type=S`)/ 下班卡(`data-type=E`)一鍵完成。
- 打卡後截圖存證(`screenshots/`)、寫入 log(`logs/`)。
- 成功 / 失敗通知(Telegram 或 Email,可關閉)。

## 安裝
```bash
npm install          # 會一併下載 Playwright 的 Chromium
```

## 設定
1. 複製 `.env.example` 為 `.env`。
2. 填入你的打卡帳密:
   ```
   PUNCH_USER=你的登入帳號
   PUNCH_PASS=你的登入密碼
   ```
3. (選用)設定通知:
   - Telegram:`NOTIFY_CHANNEL=telegram`,填 `TELEGRAM_BOT_TOKEN`、`TELEGRAM_CHAT_ID`。
   - Email:`NOTIFY_CHANNEL=email`,填 SMTP 相關欄位。
   - 不需要通知:`NOTIFY_CHANNEL=none`。

> 第一次除錯建議把 `.env` 的 `HEADLESS=false`,可看到瀏覽器實際操作;確認沒問題後改回 `true`。

## 使用方式

### 方式 A:網頁按鈕(推薦)
```bash
npm start
```
瀏覽器開啟 <http://localhost:3000>,按「上班卡」或「下班卡」。

### 方式 B:命令列
```bash
npm run punch:in     # 上班打卡
npm run punch:out    # 下班打卡
```

## 專案結構
```
web_jobcheck/
├─ config/selectors.js   # 登入欄位與打卡按鈕的選擇器(改版只改這裡)
├─ deploy/
│   └─ nginx.jobcheck.conf.example  # nginx 反向代理範例
├─ Dockerfile
├─ docker-compose.yml
├─ src/
│   ├─ punch.js          # 核心:登入 + 點打卡按鈕
│   ├─ notify.js         # Telegram / Email 通知
│   ├─ logger.js         # 記錄
│   ├─ cli.js            # 命令列進入點
│   └─ server.js         # 本機網頁 + API
├─ public/index.html     # 兩顆按鈕頁面
├─ screenshots/          # 每次打卡截圖
└─ logs/                 # 每日 log
```

## Docker 部署 (VPS)

### 1. 上傳專案並設定 `.env`
```bash
cp .env.example .env
# 填入 PUNCH_USER、PUNCH_PASS，並設定 ACCESS_TOKEN（建議隨機長字串）
```

### 2. 確認 Docker network
```bash
docker network ls
docker inspect php-nginx-web -f '{{range $k,$v := .NetworkSettings.Networks}}{{$k}}{{end}}'
```
將查到的 network 名稱填入 `.env` 的 `DOCKER_NETWORK`。

### 3. 啟動容器
```bash
docker compose up -d --build
docker logs -f webapp-jobcheck
```

### 4. 接上現有 nginx
參考 `deploy/nginx.jobcheck.conf.example`，在 `php-nginx-web` 加入反向代理到 `webapp-jobcheck:3000`。

### 5. 開啟網頁
若設定了 `ACCESS_TOKEN`，首次請用：
```
https://jobcheck.你的網域.com/?token=你的ACCESS_TOKEN
```
之後同一瀏覽器會記住權杖。

### 6. (選用) 定時自動打卡
```bash
# crontab -e
0 9  * * 1-5 docker exec webapp-jobcheck npm run punch:in
0 18 * * 1-5 docker exec webapp-jobcheck npm run punch:out
```

## 注意事項
- 請勿把 `.env`(含帳密)提交到版本庫,已在 `.gitignore` 排除。
- 若打卡系統改版或加上驗證碼 / MFA,需調整 `config/selectors.js` 或流程。
- 是否使用自動打卡請自行評估是否符合公司規定。
- 部署到公網務必設定 `ACCESS_TOKEN` 或 nginx Basic Auth，避免他人代你打卡。
