Skip to content

SUPPORT.md

Latest commit

 

History

History
337 lines (245 loc) · 10.3 KB

SUPPORT.md

File metadata and controls

337 lines (245 loc) · 10.3 KB

支援指南

歡迎來到環友科技的支援中心！我們致力於為使用者提供優質的技術支援和協助。

📞 聯絡方式

🏢 公司資訊

環友科技股份有限公司

📋 支援類型

支援類型 聯絡方式 回應時間 解決時間 可用時間
🐛 錯誤回報 GitHub Issues 1-2 工作天 5-10 工作天 工作時間
❓ 技術問題 GitHub Discussions 1-3 工作天 3-7 工作天 工作時間
💼 商業諮詢 sen@utk.com.tw 1 工作天 3-5 工作天 工作時間
🔒 安全問題 sen@utk.com.tw 24 小時內 72 小時內 24/7
🚨 緊急支援 sen@utk.com.tw 2-4 小時 8-24 小時 24/7
🏢 企業支援 sen@utk.com.tw 1 小時 依 SLA 協議 24/7
📞 電話支援 +886-XXX-XXXX 即時 依問題複雜度 工作時間

🎯 企業級支援服務

專業服務包

  • 🥉 基礎支援: 工作時間電子郵件支援
  • 🥈 專業支援: 優先回應 + 電話支援
  • 🥇 企業支援: 24/7 支援 + 專屬客戶經理
  • 💎 白金支援: 現場技術支援 + 定製 SLA

客戶成功管理

  • 專屬客戶經理: 企業級客戶專屬聯絡窗口
  • 定期健康檢查: 系統性能和安全性審查
  • 技術路線圖: 協助規劃技術發展方向
  • 培訓服務: 客製化技術培訓和研習

🔍 取得協助的步驟

1. 搜尋現有資源

在建立新的支援請求前，請先檢查：

2. 選擇適當的支援管道

🐛 錯誤回報

如果您遇到軟體錯誤：

  1. 前往相關專案的 Issues 頁面
  2. 使用 錯誤回報模板
  3. 提供詳細的重現步驟和環境資訊

❓ 技術問題

如果您有技術問題或需要指導：

  1. 前往 GitHub Discussions
  2. 搜尋相似的問題
  3. 建立新的討論主題

💡 功能建議

如果您有功能建議：

  1. 使用 功能請求模板
  2. 詳細描述用例和預期效果

3. 提供必要資訊

為了獲得最佳支援，請提供：

環境資訊

作業系統: Windows 11
.NET 版本: .NET 8.0
開發工具: Visual Studio 2022
瀏覽器: Chrome 120 (如適用)
專案版本: v1.2.3

錯誤資訊

  • 完整的錯誤訊息
  • 堆疊追蹤
  • 相關的記錄檔案
  • 螢幕截圖 (如適用)

重現步驟

  1. 詳細的操作步驟
  2. 預期結果
  3. 實際結果
  4. 發生頻率

📚 自助資源

📖 文件資源

.NET Core 開發

最佳實踐

🎓 學習資源

初學者

進階開發者

🛠️ 工具和資源

開發工具

測試工具

部署工具

❓ 常見問題

🔧 技術問題

Q: 如何設定開發環境？

A: 請參考我們的 貢獻指南 中的詳細步驟。

Q: 專案使用哪個 .NET 版本？

A: 我們主要使用 .NET 8.0 LTS。請確保您的開發環境安裝了相容的版本。

Q: 如何進行資料庫遷移？

A: 使用 Entity Framework Core 命令：

dotnet ef migrations add MigrationName
dotnet ef database update

Q: 部署到 Azure 需要什麼設定？

A: 請參考我們的 部署指南 了解 Azure 部署的詳細步驟。

🐛 疑難排解

開發環境問題

Q: 編譯錯誤怎麼辦？

A:

  1. 確認 .NET SDK 版本正確：dotnet --version
  2. 清理建置快取：dotnet clean && dotnet restore
  3. 檢查套件相依性：dotnet list package --outdated
  4. 查看詳細錯誤訊息：dotnet build --verbosity detailed
  5. 重新安裝 SDK 或切換到 LTS 版本

Q: 資料庫連線錯誤？

A:

  1. 驗證連線字串格式和參數
  2. 測試資料庫連線：dotnet ef dbcontext info
  3. 檢查防火牆和網路規則
  4. 確認資料庫服務狀態和使用者權限
  5. 查看詳細錯誤日誌以獲取具體錯誤訊息

部署與運維問題

Q: 部署後網站無法存取？

A:

  1. 檢查 IIS 應用程式集區狀態
  2. 驗證網站綁定和端口設定
  3. 查看 Windows 事件檢視器和 IIS 日誌
  4. 確認 .NET Core Hosting Bundle 已安裝
  5. 檢查應用程式權限和目錄存取權

Q: API 回應緩慢或超時？

A:

  1. 檢查資料庫查詢效能
  2. 分析應用程式記憶體使用
  3. 查看網路延遲和頻寬
  4. 檢查第三方服務依賴
  5. 啟用 Application Insights 進行詳細分析

安全性問題

Q: 遇到認證或授權錯誤？

A:

  1. 驗證 JWT Token 格式和有效期
  2. 檢查 Claims 和角色設定
  3. 確認 API 端點的授權需求
  4. 查看認證中介軟體配置
  5. 檢查 HTTPS 重定向設定

Q: 發現潛在的安全漏洞？

A:

  1. 立即停止使用受影響功能
  2. 記錄詳細的問題描述和重現步驟
  3. 透過 sen@utk.com.tw 回報（請勿公開）
  4. 等待安全團隊回應和修復指導
  5. 按照安全修復指南進行修復

📦 套件和版本

Q: 如何更新套件版本？

A: 使用 NuGet Package Manager 或命令列：

dotnet add package PackageName --version x.x.x
dotnet restore

Q: 套件版本衝突怎麼解決？

A:

  1. 檢查 .csproj 檔案中的套件參考
  2. 使用 dotnet list package --outdated 查看過期套件
  3. 統一相依套件的版本
  4. 必要時使用 PackageReference 明確指定版本

📊 支援品質保證

📈 服務等級協議 (SLA)

標準 SLA 條款

優先級 描述 影響範圍 回應時間 解決時間 可用性要求
P1 - 緊急 生產環境完全停機 全部用戶 2 小時 8 小時 99.9%
P2 - 高 功能嚴重受損 多數用戶 8 小時 2 工作天 99.5%
P3 - 中 一般功能問題 部分用戶 1 工作天 5 工作天 99.0%
P4 - 低 文件或改善建議 無直接影響 3 工作天 10 工作天 N/A

企業級 SLA 承諾

📞 回應時間保證

  • P1 問題：2 小時內專家回應
  • P2 問題：4 小時內技術人員聯絡
  • P3 問題：1 工作天內初步回應
  • 所有問題：定期狀態更新 (每 4-8 小時)

🔧 解決時間承諾

  • 90% 的 P1 問題在 8 小時內解決
  • 85% 的 P2 問題在 2 工作天內解決
  • 80% 的 P3 問題在 5 工作天內解決

📊 服務品質保證

  • 99.9% 系統可用性 (月度)
  • 95% 客戶滿意度評分
  • 平均首次解決率 > 80%

SLA 補償機制

如未達 SLA 承諾，將提供：

  • 專業諮詢: 免費的技術諮詢服務
  • 優先支援: 後續問題優先處理權

📝 支援流程

  1. 問題接收: 自動分配追蹤編號
  2. 初步評估: 分類優先級和類型
  3. 指派處理: 分配給相關技術專家
  4. 問題解決: 提供解決方案和測試
  5. 結案確認: 確認問題已解決
  6. 滿意度調查: 收集回饋改善服務

🌐 社群支援

💬 社群管道

  • GitHub Discussions: 技術討論和問答
  • Stack Overflow: 使用 utk-tw 標籤提問
  • 技術部落格: https://blog.utk.com.tw

🤝 貢獻社群

  • 回答其他使用者的問題
  • 分享使用經驗和最佳實踐
  • 回報錯誤和建議改進
  • 參與程式碼審查

📅 支援時間

🕐 一般支援

  • 時間: 週一至週五 09:00-18:00 (台灣時間)
  • 回應: 1-3 工作天
  • 管道: GitHub Issues, Email

🚨 緊急支援

  • 時間: 24/7 (僅限 P1 緊急問題)
  • 回應: 2-4 小時
  • 管道: sen@utk.com.tw

🎄 假期安排

  • 國定假日期間回應時間可能延長
  • 緊急支援服務維持正常運作
  • 重要公告會提前通知

📋 意見回饋

我們重視您的意見，請透過以下方式提供回饋：

📧 意見回饋

⭐ 滿意度調查

我們會定期發送滿意度調查，您的回饋有助於我們改善服務品質。

感謝您選擇環友科技！

我們致力於提供最優質的技術支援，讓您的開發工作更加順利。如有任何問題，請隨時聯絡我們。

最後更新: 2025年8月18日