工程人員使用指南

奇享工程助手

出工 · 拍照 · 完工回報 全流程自動化
▶ 開始使用 Bot · @jxwork_bot
STEP BY STEP

出工一次的標準流程

1
到 form.enjoy2new.com 填施工申請單
出工前的前置作業。沒先填單,Bot 的 /work 會找不到案件。
2
到現場打 /work
Bot 會列出你今天未完工的工單,選一張 → Bot 自動建 Drive 資料夾,回傳連結。
3
拍「施工前」照片 → 傳給 Bot
預設 before 模式,自動存進 before/。
⚠️ 請用「檔案」模式傳,不然被 Telegram 壓縮。
4
施工中 / 完成拍後,打 /after
切到 after 模式,接下來照片存 after/。
5
客戶簽完單,打 /signed 後拍簽單
簽收單照片會存案場根目錄,檔名會標 _signed_。
6
收尾:/done [備註]
例如: /done 客戶驗收 OK,設備正常
Bot 會一次完成三件事:
✓ 更新施工申請單完工時間
✓ 寫一筆到施工日報（績效計算用）
✓ Email 通知謝依珊核對紙本簽收單
CRITICAL

📸 照片一定要用「檔案」模式傳!

⚠️ 相簿模式 = Telegram 會把照片壓縮到 100KB 左右

案場文件是重要證據,一定要保留原圖。Bot 回覆訊息會告訴你這張是壓縮還是原圖,請確認。

❌ 錯誤

相簿模式 (預設)

從 Telegram 的「相簿」按鈕挑照片 → 被強制壓縮

檔案大小:100-400 KB
Bot 回覆:「（壓縮）」
✅ 正確

檔案模式

用「檔案」介面選照片 → 原圖完整上傳

檔案大小:2-8 MB
Bot 回覆:「（原圖）」
📱 iPhone (iOS)
  1. 在 @jxwork_bot 聊天視窗
  2. 點左下 📎 迴紋針
  3. 選 「檔案」(不是「圖片」或「相簿」!)
  4. 點「瀏覽」→ 找「照片」或 DCIM 資料夾
  5. 選照片 → 送出
🤖 Android
  1. 聊天裡點 📎 迴紋針
  2. 選 「檔案」(不是「圖片/相片」)
  3. 找到 Camera 或相簿資料夾 → 選照片 → 送出
💡 驗證成功:Bot 回「📸 已存 before/(第 N 張) （原圖） 大小:3200 KB」
CHEAT SHEET

指令速查

⚙ 開工流程
/work
開工(從今日未完工工單挑一張)
/after
切到 after/ 模式
/signed
切到 signed 模式(簽收單用)
/done [備註]
完工,自動雙寫 Sheets + email 謝依珊
🛠 輔助工具
/today
查今日「奇享行程安排」行程（廖/劉 看自己、Sonic 看全部）
/status
看目前進度(模式 / 照片累積)
/cancel
取消目前 work state(資料夾不刪,可重新開始)
/history [天數]
查自己最近 N 天工單清單(預設 30 天,可輸 /history 7 或 /history 90,上限 90)
/whoami
查自己的 Telegram ID 與角色
/help
完整指令清單
📅 自動推送（不用打指令）
每日 07:30
Bot 自動推送你今天的行程（依「奇享行程安排」Calendar）
事件前 1 小時
Calendar 原生 email/push 提醒（backup）
FAQ

常見問題

Q：傳錯照片模式了(傳成壓縮版)怎麼辦?

如果是不重要的照片無所謂。重要紀錄就用「檔案」模式重傳一次原圖,Bot 會再存一份(舊的壓縮版不會自動刪,但你知道哪張是原圖)。

Q：/work 說我今天沒工單?

你還沒到 form.enjoy2new.com 填施工申請單。制度要求先填單才能開工,填完回來 /work 就會看到案件列表。

Q：/work 時不小心選錯案件了?

打 /cancel 清掉 state,再打 /work 重新選。Drive 裡建的資料夾保留不影響(重新 /work 會複用同一個)。

Q：/done 完了但忘記拍簽收單?

建議 /done 前先 /signed 把簽收單拍完再 /done。如果已經 /done 了,就到 Drive 的對應資料夾手動拖拉簽收單照片進去。

Q：Bot 沒回應?

稍等 5-10 秒;超過 30 秒還沒反應就告訴 Sonic,他看 log 查問題。

Q：要查過去的工單或照片?

打 /history → 看自己最近 30 天所有工單清單（完工 ✅ / 未完工 ⏳）+ 附照片總資料夾連結。要看更久用 /history 90（上限 90 天），只看最近一週用 /history 7。
清單中**不直接顯示每筆案件的照片資料夾**，要看具體案件照片，點訊息最下方的照片總資料夾連結，再依 客戶/日期_類型/ 找進去。

Q：可以同時開多張工單嗎?

目前一人一次只能一張 active 工單(同時開會混淆歸檔)。做完一張 /done 再開下一張,或 /cancel 換張。

Q：每天早上 07:30 自動收到的行程訊息是哪來的?

Bot 會每日 07:30 自動讀「奇享行程安排」Calendar，把你今天有份的事件推給你。預設所有事件都會推給廖+劉，除非 Sonic 在 Calendar 事件 title 前面加 [私] / [Sonic] 前綴（代表私人、不推）。若 Sonic 標 [廖] 代表只指派給你、標 [劉] 代表只指派給對方。

Q：想主動看今天行程怎麼辦?

隨時打 /today，Bot 會當場讀 Calendar 回你今日行程（會過濾只顯示跟你有關的）。