雲端 / NAS / Local 設定教學

一、Google Drive 設定
1) 到 Google Cloud Console 建立 OAuth 2.0 Client (Web)
2) 記下 Client ID / Client Secret
3) 設定 Redirect URI
   - {PUBLIC_BASE_URL}/api/admin/oauth/google/callback
   - 例：http://localhost:3000/api/admin/oauth/google/callback
4) 回到系統管理填入
   - Google Client ID
   - Google Client Secret
   - Google Folder ID (可空白=根目錄)
5) 按「連線 Google」完成授權

二、OneDrive 設定
1) 到 Azure Portal 建立 App Registration
   - 記下 Application (client) ID
   - 記下 Directory (tenant) ID (可用 common)
2) 建立 Client Secret
   - Certificates & secrets > New client secret
3) 設定 API 權限
   - Microsoft Graph > Delegated permissions
   - 勾選：offline_access, Files.ReadWrite
4) 設定 Redirect URI
   - {PUBLIC_BASE_URL}/api/admin/oauth/onedrive/callback
5) 回到系統管理填入
   - OneDrive Client ID
   - OneDrive Client Secret
   - OneDrive Tenant ID (可填 common)
   - OneDrive 資料夾路徑 (可空白，例：Shared/Contracts)
6) 按「連線 OneDrive」完成授權

三、NAS 設定
1) 準備可讀寫的 NAS 路徑
   - Windows 範例：\\NAS\share\contracts
   - Linux 範例：/mnt/nas/contracts
2) 在系統管理選擇「NAS」
3) 儲存位置填入 NAS 路徑
4) 按「儲存設定」

四、Local 設定
1) 選擇「Local」
2) 儲存位置填入本機資料夾
   - 本機儲存僅限直接從 localhost 登入時設定；正式 NAS 請使用已掛載的容器路徑
3) 按「儲存設定」

注意：
- PUBLIC_BASE_URL 需與瀏覽器實際可存取網址一致
- Redirect URI 必須在雲端平台設定且完全一致
- 連線完成後會顯示授權帳號與連線時間

五、模板資料夾規則
1) 人員經歷模板
   - staff 模板資料夾：templates/staff
2) 日報模板
   - report 模板資料夾：templates/report
3) 施工照片模板
   - photo 模板資料夾：templates/photo

六、模板同步規則
1) 只要進入對應頁面，系統會重新比對模板清單與實際資料夾/雲端資料夾
2) 若模板檔案被手動刪除
   - 下拉清單會自動移除
3) 若直接把模板檔案放進對應資料夾
   - 下拉清單會自動補進
4) Google / OneDrive / NAS / Local 都套用相同規則