3.4 KiB
3.4 KiB
心願星河 - 佈署指南
🚀 正式環境佈署準備
1. 資料清理
在佈署前，請確保已清空所有測試資料：
```javascript // 在瀏覽器控制台執行以下代碼清空測試資料 localStorage.clear() ```
或者執行專用的清理腳本：
scripts/clear-all-data.js- 清空所有測試資料scripts/reset-to-production.js- 重置到正式環境狀態
2. 環境檢查清單
✅ 功能檢查
- 首頁載入正常，許願瓶動畫運作
- 分享困擾頁面表單功能正常
- 聆聽心聲頁面顯示空狀態
- 問題洞察頁面顯示無資料狀態
- 感謝頁面跳轉正常
- 音效系統可正常開關
- 背景音樂控制正常
- 響應式設計在各裝置正常
✅ 資料狀態檢查
- localStorage 中無測試資料
- 所有統計數字顯示為 0
- 分類統計圖表顯示無資料狀態
- 搜尋和篩選功能正常
✅ 隱私功能檢查
- 公開/私密選項正常運作
- 隱私說明文字正確顯示
- 私密案例不會出現在聆聽心聲頁面
- 分析頁面正確統計公開和私密案例
3. 佈署步驟
使用 Vercel 佈署
- 確保所有測試資料已清空
- 提交最新代碼到 Git 倉庫
- 連接 Vercel 到你的 Git 倉庫
- 設定環境變數（如需要）
- 執行佈署
使用其他平台
- 執行
npm run build建構專案 - 將
out或dist資料夾上傳到伺服器 - 確保伺服器支援 SPA 路由
- 設定適當的 HTTP 標頭
4. 佈署後驗證
🔍 功能驗證
- 訪問所有頁面確認載入正常
- 提交一個測試困擾確認流程完整
- 檢查響應式設計在不同裝置
- 測試音效和背景音樂功能
- 驗證隱私設定功能
📊 效能檢查
- 頁面載入速度合理
- 動畫效果流暢
- 音效載入不影響頁面效能
- 圖片和資源正確載入
5. 使用者指南
🎯 管理者功能
- 問題洞察頁面: 查看完整的問題分析，包含公開和私密案例
- 分類統計: 了解團隊面臨的主要挑戰領域
- 趨勢分析: 追蹤問題提交的趨勢變化
👥 使用者功能
- 分享困擾: 可選擇公開或私密分享工作困擾
- 聆聽心聲: 查看其他人公開分享的經歷
- AI 建議: 獲得針對困擾的智能解決方案建議
- 共鳴支持: 對相似困擾表達支持
6. 維護建議
📈 資料監控
- 定期檢查案例提交數量
- 關注公開/私密案例比例
- 監控熱門問題分類變化
🔧 技術維護
- 定期更新依賴套件
- 監控頁面載入效能
- 檢查音效資源載入狀況
🎨 使用者體驗
- 收集使用者回饋
- 根據使用情況調整功能
- 持續優化響應式設計
7. 故障排除
常見問題
- 音效無法播放: 檢查瀏覽器音頻政策，需要使用者互動後才能播放
- 動畫不流暢: 檢查 CSS 動畫是否被瀏覽器支援
- 資料不同步: 確認 localStorage 功能正常
- 響應式問題: 檢查 Tailwind CSS 是否正確載入
聯絡支援
如遇到技術問題，請提供：
- 瀏覽器版本和類型
- 錯誤訊息截圖
- 重現步驟描述
- 裝置和螢幕尺寸資訊
🎉 佈署完成
恭喜！心願星河已準備好為你的團隊提供職場困擾收集和分析服務。
記住：每一個真實的困擾分享都是改善工作環境的重要起點！