築心相簿 使用者與管理員操作手冊

簡單、極速、手機友善的活動成果影像庫。採用 Google Photos 極簡設計哲學,結合全自動 WebP 雙軌高壓縮管線、相片/相簿跨層級安全移轉與訪客時間限制上傳機制。

📱 Mobile First 體驗 ⚡ 雙規格 WebP 管線 📁 資料夾拖曳智慧過濾 🔄 相簿/相片跨區安全移轉 🛡️ 防機器人驗證碼 📦 一鍵打包下載 ZIP (JPEG) 🌐 PWA 離線支援

PWA 行動裝置桌面安裝

築心相簿支援 PWA(Progressive Web App)標準,無需透過 App Store 或 Google Play 下載,即可將相簿捷徑安裝至手機主畫面,享有如同原生 App 的全螢幕體驗。

🍎

iPhone / iPad (iOS Safari)

1. 使用 Safari 開啟相簿首頁。
2. 點擊瀏覽器底部的「分享」圖示(帶向上箭頭的方框)。
3. 在選單中向下滑動,點擊「加入主畫面」。
4. 點擊右上角「新增」即完成安裝。

🤖

Android 手機 (Chrome / Edge)

1. 使用 Chrome 開啟相簿首頁。
2. 點擊右上角選單「⋮」。
3. 選擇「安裝應用程式」或「加到主螢幕」。
4. 系統將自動生成專屬圖示並置於主畫面。

專屬網域與 301 永久轉址說明

為提供組織標準化、簡潔好記且符合現代 SEO 規範之網址,築心相簿全面啟用獨立專屬頂級網域:

🌐
Canonical 正式網址: https://photos.chuhsin.org/
舊版歷史網址: https://portal.chuhsin.org/photos/
伺服器已設定 HTTP 301 永久重定向(Permanent Redirect)。若訪客或志工透過舊版書籤、歷史分享連結造訪,伺服器與前端將自動、無縫跳轉至最新專屬網域,完整保留所有分享參數與相簿定位。

相簿瀏覽、立體質感與全螢幕燈箱體驗

相簿首頁以質感微立體卡片風格呈現所有公開相簿,背景採低飽和度柔和配色,瀏覽舒適無負擔:

🖼️

智慧自適應相簿卡片 (2 ~ 6 欄響應式)

相簿封面卡片支援智慧寬度響應:手機 2 欄、平板 3~4 欄、電腦 4~5 欄、寬螢幕最大 6 欄,搭配立體微浮雕陰影與平滑上浮回饋,在任何裝置上均呈現最理想的排列比例。

📱

手機版 1200px Retina 高畫質封面

首頁封面全面採用 srcset 響應式雙軌載入,在手機與 Retina 視網膜螢幕上自動載入 1200px 高畫質封面快取,徹底杜絕模糊,兼顧載入速度與細膩畫質。

⚡

Google Photos 等高自適應行佈局與海報智慧防護

相簿採用等高自適應彈性行佈局(Justified Row Layout),相片 100% 完整呈現不裁切;遇到直式海報與 DM 宣傳圖卡時,系統自動啟動「直式海報智慧防護」,手機版鎖定每排 3 張(以 33% - gap 齊行排版,平板 4 張、電腦 5 張),確保版面勻稱美觀且細節清晰!

✨

經典通透色彩增強與 Lightbox 原圖對照

相簿預設套用智慧動態範圍與通透色彩增強濾鏡,提升戶外與室內相片通透感;在全螢幕 Lightbox 檢視器右上角設有「按住檢視原圖」按鈕,長按即可隨時切換還原原始色彩進行對照。

🔒

純粹乾淨的訪客瀏覽體驗

一般民眾與訪客瀏覽公開相簿時,介面自動隱藏封面星號標籤與任何管理字樣,呈現純淨無干擾的視覺美感。

手機觸控手勢與快捷操作

💡
支援手勢與快捷操作:
• 按住檢視原圖:在全螢幕大圖燈箱中,按住右上角「👁️ 按住檢視原圖」按鈕,可即時暫時關閉智慧色彩增強濾鏡,放開即恢復。
• 手機方向旋轉:支援手機直向或橫向旋轉,相片自動以滿版最佳比例自適應縮放呈現。
• 相片手動旋轉:點擊燈箱頂部「🔄 旋轉」按鈕(或鍵盤 R 鍵),可將相片以 90° 順時針旋轉並自動滿版縮放適配。
• 單擊切換沉浸式模式:輕觸相片任意處(或鍵盤 F 鍵),可隱藏/顯示上下工具列與控制按鈕,進入極致無干擾全螢幕檢視。
• 雙擊縮放與兩指捏合 (Pinch to Zoom):支援點兩下放大相片細節(以觸控位置為焦點),以及兩指縮放手勢;放大檢視時可單指平移拖曳查看細節,此時鎖定手勢上下張切換;再點兩下或縮小即可平滑回到預設大小,並自動恢復手勢切換上一張/下一張與下滑關閉。
• 手機下滑關閉:在全螢幕燈箱中(預設大小),單指往下滑動即可順暢退出檢視。
• 左右水平滑動:支援觸控左右撥動(預設大小),無縫切換上一張/下一張相片。
• 電腦鍵盤支援:支援方向鍵 ← → 切換,R 鍵旋轉,F 鍵全螢幕模式,滑鼠雙擊放大/還原,以及 ESC 鍵隨時關閉。

社群分享功能 (Web Share API)

在相簿上方點選「分享相簿」按鈕:

  • 手機環境:自動調用作業系統原生分享面板,可直接發送至 LINE 好友、LINE 社群、Facebook、Instagram 或 Messages。
  • 電腦環境:自動將完整的正規相簿網址複製到剪貼簿,並彈出提示通知,方便貼至各通訊軟體。
  • OpenGraph 標籤支援:分享至 LINE 或 Facebook 時,自動帶出相簿封面照片、相簿名稱與活動日期卡片預覽。

專屬投稿頁面、前置門檻與操作流程

為方便活動現場志工、家長與工作人員集中上傳花絮,本相簿設計「免登入獨立專屬投稿網頁(/upload/{token}/ 或 /upload/?token={token})」,具備雙重前置防護:

1

掃描專屬 QR Code 或開啟專用投稿連結

活動工作人員掃描由管理員提供的活動專屬 QR Code 或點擊投稿網址進入獨立投稿頁面,確認相簿名稱與開放狀態。

2

強制勾選【相片授權使用與無侵權聲明】

上傳者必須詳細閱讀並勾選聲明,同意無償授權活動成果紀錄使用,並保證絕無侵犯他人著作權、肖像權或隱私權爭議。

3

輸入 4 碼防機器人圖形驗證碼(即時核驗)

輸入右側 GD 生成之 4 位英數字驗證碼(輸入完成後系統即時在背景驗證並亮起綠色勾號 ✓ 驗證碼正確)。若字元不清晰可隨時點擊圖片更換。

4

解鎖上傳區域並選取照片

同時完成「授權勾選」與「驗證碼正確」後,照片選取區域自動解鎖;若未完成雙重條件,點擊選取區將被攔截並引導聚焦至未填寫欄位。

5

預覽縮圖與點擊外部獨立按鈕上傳

選取相片後可即時預覽縮圖、檢視單張大小、移除單張或一鍵清空;確認無誤後點擊卡片外部獨立的「上傳 X 張照片」按鈕開始上傳,傳輸過程請勿關閉頁面。

支援與禁止檔案格式規範

為維持伺服器長期穩定運作(10GB 主機環境)與最佳瀏覽體驗,本系統具備嚴格的相機攝影檔案類型白名單:

格式類別 副檔名與類型 系統狀態 轉碼處理方式
JPEG / JPG .jpg, .jpeg (相機 / Android) 允許上傳 讀取 EXIF 1~8 全規格轉向校正,轉碼為 Full / Thumb WebP,隨後銷毀原始暫存檔案。
HEIF / HEIC .heic, .heif (iPhone 預設相片) 允許上傳 透過 Imagick 解碼轉向並轉為 Full / Thumb WebP,隨後銷毀原始暫存檔案。
WebP .webp 允許上傳 標準化雙尺寸縮放(1200px / 400px),不放大原始檔案。
無損/非相機圖檔 .png, .gif, .bmp, .tiff, .svg 嚴格禁止 系統前後端雙重拒絕。PNG 等無損圖檔體積過大且非相機標準照片,禁止上傳以保護伺服器空間。
其他不相干格式 .mp4, .pdf, .doc, .zip 等 嚴格禁止 非相片檔案自動過濾與略過。

資料夾直接拖曳上傳與智慧過濾

📁
資料夾拖曳智慧過濾機制:
系統支援直接將電腦中的整份活動相片資料夾直接拖曳至上傳區域:
1. 遞迴解析目錄:瀏覽器透過 webkitGetAsEntry 遞迴走訪資料夾內所有子目錄。
2. 自動嚴格白名單過濾:自動排除 .png, .gif, .bmp, .tiff, .svg 等非相機圖檔、.mp4, .mov 等影片,以及 .DS_Store, Thumbs.db 等系統隱藏檔。
3. 清晰統計回饋:系統會自動統計有效相片張數並回報過濾結果,讓您直接挑選整個活動資料夾上傳,無須手動整理檔案!

單本相簿容量與張數配額

⚖️
全體適用配額規範(管理員與訪客投稿皆同,依相簿配額規範決定):
1. 單本相簿相片數量上限:最多 250 張 相片。
2. 單本相簿檔案總量上限:累計總容量不可超過 32 MB。
3. 單張照片大小限制:單檔上限為 15 MB。

上傳照片張數不設人為單次限制,管理員與訪客投稿規則一致,完全依上述配額規範決定。當相簿相片數達 250 張或總容量達 32MB 時(兩者先到者為準),前端與後端皆會自動封鎖上傳通道,確保單一相簿不會過度佔用主機磁碟。

打包下載整本相簿 (ZIP)

需要將整本相簿下載保存或用於成果報告時,可使用一鍵打包下載功能:

📦

整本相簿 ZIP 打包

點選相簿標題列的「下載整本 (ZIP)」按鈕,系統會在伺服器端將所有相片即時轉換為相容性最高、最通用的 JPEG 格式(Quality 90),並打包為 ZIP 檔案下載。

🔢

編號與中文檔名友善

ZIP 檔名自動採用「相簿名稱_日期.zip」,解壓縮後的相片自動加上序號編號(如 001_花絮.jpg),在任何電腦或行動裝置開啟皆能依序閱覽。

🔒

相簿下載與防盜圖版權保護

相簿預設允許下載與 ZIP 打包。若管理者手動設定為「不允許下載」,系統將自動對未登入訪客隱藏下載入口,並全面鎖定右鍵選單、複製/另存快捷鍵與圖片拖曳,防止未經授權盜圖(嘗試操作時彈出「版權所有,請勿盜圖」);已登入管理員則完全不受此限制,仍可自由下載與管理。

管理員登入與維護指引

管理員擁有分類建立、相簿管理、相片跨相簿移轉、封面更換、刪除以及伺服器儲存維護的完整管理權限:

1. 管理員登入

點擊網頁右上角「管理員登入」按鈕,輸入預設帳號 admin 與密碼 admin123。登入後頂部會顯示綠色管理員控制面板與專屬維護工具。

2. 分類管理與相簿跨分類移轉

系統支援二級階層架構(分類 → 相簿 → 相片),方便將歷年活動、專案或常規課程分門別類:

  • 建立與編輯分類:在分類標籤區點選「+ 新增分類」,可自訂分類名稱、Slug 代稱與簡介。
  • 分類拖曳排序:管理員可按住分類卡片拖曳調換前後順序,自動寫入資料庫。
  • 相簿跨分類移轉:點選相簿卡片之「移轉所屬分類」選單,即可一鍵將整本相簿移至目標分類,系統將自動維護目錄與資料庫關聯。

3. 相簿管理作業

  • 建立新相簿:設定相簿所屬分類、標題、日期、簡介,並選擇「公開/私人」權限。
  • 色彩與動態範圍智慧增強:預設啟用「經典通透色彩增強」濾鏡,使相片畫面通透亮麗;若是活動海報、文宣圖卡、簡報投影片或資訊圖表相簿,可取消勾選此項目,保持原始圖檔之設計原色與真實對比。
  • 自訂網址代稱 (Slug):相簿專屬靜態短網址代稱,嚴格限制僅能使用英文字母 (a-z, A-Z)、數字 (0-9) 及連字號 (-),例如 summer-camp-2026。若留空系統將自動生成合規代稱。
  • 訪客投稿專屬 Token 與 QR Code:
    • 專屬投稿網址:系統為每本相簿自動產生高強度的安全 Token 投稿連結(格式如 /upload/YbPyWYjaOLVP/),管理員可一鍵「複製投稿連結」。
    • 現場 QR Code 產出:點擊「查看 QR Code」即可彈出高解析度向量 QR Code,支援現場直接讓志工掃描或下載 PNG 圖片列印於活動海報。
    • 重新產生 Token:若活動結束或欲作廢舊連結,點擊「重新產生 Token」即可立即讓舊投稿連結失效。
  • 訪客上傳時限設定:
    • 開放至指定日期時間:填入例如 2026/12/20 22:00,時間一到系統自動關閉訪客上傳,但相簿仍持續開放公開瀏覽。
    • 無截止時間:留空則代表長期開放訪客上傳。
    • 關閉訪客上傳:取消勾選訪客上傳開關即可。
  • 相簿拖曳自訂排序 (Drag & Drop):登入管理員在相簿卡片上可看見專屬 ⠿ 拖曳 Handle,按住即可即時拖曳調整相簿排列順序。
  • 更換相簿封面:在相片卡片右上角點選「設為封面」圖示即可立即變更。

4. 相片跨相簿批次移轉(配額防護試算)

當相片需要重組或歸入不同活動相簿時,可使用強大的跨相簿批次移轉功能:

🔄
跨相簿移轉作業步驟:
1. 進入相簿內部,點選「選擇照片」進入選取模式,勾選欲移轉之相片(支援一鍵「全選」)。
2. 點選頂部浮動列的「📦 移轉至其他相簿」按鈕。
3. 即時配額試算:移轉彈窗會列出所有可選相簿,並即時計算「目前張數 + 移入張數 / 上限 250 張」。若超過上限將智慧警示並阻擋提交。
4. 點擊「確認移轉」,系統會以資料庫交易(Transaction)原子性搬移實體檔案、縮圖與資料庫外鍵,完全保留拍攝與排序資訊。

5. 永久刪除相簿防呆機制

🚨
相簿防誤刪機制:
若相簿內已有相片,點選「刪除相簿」時,系統會強制彈出確認視窗,要求管理員手動輸入完全一致的相簿名稱方可確認刪除,避免重要活動照片因誤觸而永久遺失。

6. 變更管理員密碼

為維護系統安全,建議於系統部署後立即變更預設密碼:

  1. 管理員登入後,點擊網頁頂部綠色管理控制列的「🔐 變更密碼」按鈕。
  2. 在彈出視窗中,依序填入目前舊密碼、新密碼(至少 6 位字元)與再次確認新密碼。
  3. 點擊「確認變更密碼」,系統將即時以強加密雜湊(Bcrypt Cost 12)更新資料庫,下次登入請使用新密碼。

7. 儲存空間與孤兒檔案清理

點擊頂部管理列的「🧹 清理孤兒檔案」:

  • 孤兒檔案掃描:自動比對實體磁碟目錄(uploads/full 與 uploads/thumbs)與資料庫紀錄,找出因非預期中斷而殘留未被記錄的無效圖檔。
  • 一鍵釋放與 VACUUM:管理員可一鍵徹底清除孤兒圖檔,系統會同步執行 SQLite VACUUM 壓縮資料庫,釋放伺服器空間。

常見問題與障礙排除 (FAQ)

Q1:為什麼 iPhone 上傳 HEIC 相片有時速度較慢?

答:HEIC 格式包含高密度的動態與色彩數據,伺服器在上傳時會運用 ImageMagick 與 GD 進行全自動解碼、轉向與雙尺寸 WebP 重新壓縮。單張照片處理約需 0.5 至 1.5 秒,請保持上傳進度條開啟直到全數處理完畢。

Q2:為什麼系統完全拒絕 PNG 和 GIF?

答:PNG 屬於無損壓縮,手機截圖或相機轉出的 PNG 檔案常高達 10MB~20MB,會迅速耗盡組織主機的 10GB 儲存空間;GIF 則色彩深度不足且檔案過大。請使用手機原生相機拍攝(JPEG 或 HEIF)後直接上傳。

Q3:相簿滿 250 張(或 32MB)後如何繼續記錄活動?

答:建議建立「活動名稱 (二)」或依不同活動子主題建立新相簿(例如「上午場」、「晚會活動」),保持每本相簿輕巧、載入流暢。

Q4:訪客下載 ZIP 解壓縮後是 WebP 還是 JPEG?

答:解壓縮後全部都是標準的 .jpg (JPEG) 檔案!本相簿在打包下載時已自動將高畫質 WebP 照片轉檔回 JPEG,讓大眾下載後可直接置入 Word、PowerPoint 報告或送交沖印,相容性 100%。