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