非功能性需求設計規格範本(NFR Design Specification Template)

非功能性需求設計規格範本(NFR Design Specification Template) 適用標準:ISO/IEC 25010:2023(SQuaRE - 系統與軟體品質模型)、ISO/IEC/IEEE 29148:2018 適用階段:系統設計階段(Design Phase) 負責角色:系統架構師(SA)、效能工程師、SRE 範本版本:v2.0(2026-10-06)|對應《軟體開發標準程序教學手冊》v2.0 第 3.2、4.5、10.2、12.2 節 📑 章節目錄 文件資訊 品質屬性總覽 效能設計(Performance) 可用性設計(Availability) 延展性設計(Scalability) 可靠性設計(Reliability) 可維護性設計(Maintainability) 可觀測性設計(Observability) 安全性設計(Security) 相容性設計(Compatibility) 驗證與測試策略 審查與驗證 📝 範本 1. 文件資訊 項目 內容 文件名稱 [系統名稱] 非功能性需求設計規格 文件編號 [專案代碼]-NFR-[版本號] 版本 v[X.Y] 建立日期 [YYYY-MM-DD] 撰寫者 [SA 姓名] 審核者 [技術主管] 2. 品質屬性總覽 依 ISO/IEC 25010:2023 品質模型分類 品質屬性 子特性 目標等級 優先級 驗證方式 效能效率 時間行為、資源利用、容量 [目標] [High/Med/Low] [效能測試] 可用性 成熟度、容錯性、可恢復性 [目標] [High/Med/Low] [HA 測試] 延展性 水平/垂直擴展能力 [目標] [High/Med/Low] [負載測試] 可靠性 容錯、一致性 [目標] [High/Med/Low] [Chaos 測試] 可維護性 模組化、可測試性、可修改性 [目標] [High/Med/Low] [Code Review] 安全性 機密性、完整性、可用性 [目標] [High/Med/Low] [安全測試] 相容性 瀏覽器、裝置、整合 [目標] [High/Med/Low] [相容測試] 3. 效能設計(Performance) 3.1 效能目標 指標 日常目標 尖峰目標 測量方式 回應時間(P50) < [N]ms < [N]ms APM / Load test 回應時間(P95) < [N]ms < [N]ms APM / Load test 回應時間(P99) < [N]ms < [N]ms APM / Load test 吞吐量(TPS) ≥ [N] ≥ [N] Load test 並發用戶 [N] [N] Load test 錯誤率 < [N]% < [N]% Monitoring 3.2 效能設計策略 策略 適用場景 設計方案 快取 [高頻讀取、低頻更新] [快取層級/策略/TTL] 非同步處理 [非即時、耗時任務] [Message Queue + Worker] 連接池 [DB/HTTP 連線] [Pool size + timeout 設定] 分頁查詢 [大量資料列表] [Cursor-based / Offset pagination] 批次處理 [大量寫入] [Batch size + 排程策略] CDN [靜態資源] [CDN provider + cache policy] 3.3 效能預算(Performance Budget) 資源 預算 目前值 狀態 首頁載入(FCP) < [N]s [N]s [✅/⚠️/❌] 最大內容繪製(LCP) < [N]s [N]s [✅/⚠️/❌] 累計版面偏移(CLS) < [N] [N] [✅/⚠️/❌] 互動至下一次繪製(INP) < [N]ms [N]ms [✅/⚠️/❌] JS Bundle Size < [N]KB [N]KB [✅/⚠️/❌] API Response Size < [N]KB (avg) [N]KB [✅/⚠️/❌] 4. 可用性設計(Availability) 4.1 SLA 定義 服務 SLA 目標 允許停機/月 計算方式 [核心服務] [99.9%] [~43.8 min] Uptime / Total time [次要服務] [99.5%] [~3.6 hr] [背景服務] [99.0%] [~7.3 hr] 4.2 高可用設計 元件 HA 模式 Failover 時間 健康檢查 [元件] [Active-Active / Active-Passive / N+1] [N]s [HTTP/TCP/Custom] 4.3 停機策略 停機類型 通知時間 持續時間 影響範圍 核准 計畫性維護 [N 天前] [N hr] [描述] [PM/業務] 緊急修復 [即時] [N hr] [描述] [Tech Lead] 5. 延展性設計(Scalability) 5.1 擴展策略 維度 策略 設計 水平擴展(Scale-Out) [無狀態 + Load Balancer] [Auto-scaling rules] 垂直擴展(Scale-Up) [資料庫 / 特殊運算] [上限與遷移計畫] 資料擴展 [分區 / Sharding] [分區策略] 5.2 容量規劃 時間軸 預估用戶 預估資料量 預估 TPS 對應架構 上線 [N] [N] GB [N] [架構描述] 6 個月 [N] [N] GB [N] [是否需擴展] 1 年 [N] [N] GB [N] [擴展方案] 3 年 [N] [N] GB [N] [重大架構變更?] 6. 可靠性設計(Reliability) 6.1 容錯設計 故障場景 影響 容錯機制 降級方案 [單節點故障] [描述] [自動 failover] [N/A] [DB 連線失敗] [描述] [Circuit Breaker] [顯示快取資料] [外部 API 超時] [描述] [Retry + Timeout] [預設值/離線模式] [整個 AZ 故障] [描述] [Multi-AZ 部署] [部分功能降級] 6.2 Circuit Breaker 設計 服務 Open 條件 Half-Open 條件 Close 條件 Fallback [服務] [N 次失敗 in M 秒] [N 秒後] [N 次成功] [降級方案] 6.3 Retry 策略 場景 最大重試 退避策略 可重試條件 [HTTP call] [N] 次 [Exponential backoff + jitter] [5xx, timeout, network error] [DB operation] [N] 次 [Fixed interval] [Deadlock, connection lost] 7. 可維護性設計(Maintainability) 品質指標 目標 度量方式 程式碼覆蓋率 ≥ [N]% [CI/CD report] 技術債指標 [SQALE ≤ N days] [SonarQube] 模組耦合度 [低耦合] [Architecture fitness test] 部署頻率 [≥ N 次/週] [CI/CD metrics;DORA] 變更前置時間 [< N 天] [Git commit → 正式部署;DORA] 失敗部署復原時間 [< N hr] [事件系統;DORA] 變更失敗率/部署重工率 [< N%] [部署紀錄 + 事件系統;DORA 五項指標](只看趨勢,不作為考核目標) 8. 可觀測性設計(Observability) 8.1 三大支柱 支柱 工具 設計 Metrics [Prometheus / CloudWatch] [RED + USE metrics] Logging [ELK / Loki] [Structured JSON, correlation ID] Tracing [Jaeger / Zipkin / OTEL] [Distributed tracing, 100% sampling for errors] 8.2 SLI/SLO 定義 SLI(指標) SLO(目標) 計算方式 告警閾值 Availability [99.9%] successful requests / total requests < 99.8% → Warning Latency (P95) [< 200ms] histogram_quantile(0.95) > 300ms → Warning Error Rate [< 0.1%] 5xx / total requests > 1% → Critical Throughput [≥ N TPS] rate(requests_total[5m]) < N*0.7 → Warning 9. 安全性設計(Security) 詳見安全設計文件(SecurityDesign_Template.md),此處僅摘要 NFR 指標 ...

May 18, 2026 · 5 min · 966 words · Eric Cheng

軟體開發標準程序(Software Development Standard Process)教學手冊

軟體開發標準程序(Software Development Standard Process)教學手冊 項目 內容 版本 v2.1 最後更新 2026-10-06(v2.1:文件範本同步更新,見附錄 D.3;各標準版本查證日:2026-10-06,見附錄 E) 適用對象 軟體開發團隊全體成員:PM、BA/SA、架構師、開發、QA、DevOps/SRE、資安、稽核 文件性質 企業內部技術規範(白皮書等級)與教育訓練教材 閱讀方式 第一次閱讀請先看 1.4 如何使用本手冊;要驗證 AI 依本手冊產出的成果,請看各章最後一節「審查與驗證」與附錄 A.5 📋 目錄 第一章:前言與目的 1.1 為什麼需要軟體開發標準程序 1.2 對組織與工程師的價值 1.3 本手冊適用範圍 1.4 如何使用本手冊 1.5 AI 輔助開發的人機責任 1.6 參考標準與版本基準 第二章:軟體開發生命週期(SDLC)總覽 2.1 SDLC 各階段說明 2.2 與實務專案的關係 2.3 敏捷與瀑布的選擇 2.4 階段閘門(Stage Gate)與 DoR/DoD 2.5 專案裁剪(Tailoring) 2.6 AI 輔助 SDLC 的產出與審查點 2.7 審查與驗證 第三章:需求管理(Requirements Engineering) 3.1 需求來源與分類 3.2 功能性與非功能性需求 3.3 需求文件標準 3.4 PRD、SDD、TSD、程式規格書 四大文件體系 3.5 需求異動管理流程 3.6 需求品質檢核 3.7 需求追溯矩陣(RTM) 3.8 審查與驗證 第四章:系統分析與設計 4.1 系統架構設計原則 4.2 邏輯架構與實體架構 4.3 API 設計規範 4.4 資料庫設計與資料治理 4.5 非功能性設計 4.6 架構決策紀錄(ADR) 4.7 C4 Model 架構圖 4.8 審查與驗證 第五章:開發實作規範 5.1 程式碼風格與命名規範 5.2 架構分層原則 5.3 重用性與模組化 5.4 Secure Coding 基本原則 5.5 AI 生成程式碼審查 5.6 審查與驗證 第六章:測試策略與品質保證 6.1 測試類型與層級 6.2 測試責任分工 6.3 測試資料管理 6.4 缺陷(Bug)管理流程 6.5 測試進入與退出準則 6.6 效能測試 6.7 審查與驗證 第七章:版本控制與組態管理 7.1 Git 分支策略 7.2 版號管理原則 7.3 設定檔與環境管理 7.4 機密資訊(Secrets)防護 7.5 審查與驗證 第八章:CI/CD 與部署流程 8.1 自動化建置流程 8.2 部署策略 8.3 回滾與風險控管 8.4 Feature Flag 與漸進式交付 8.5 審查與驗證 第九章:資安與 SSDLC 9.1 安全需求納入時機 9.2 程式碼掃描與弱點管理 9.3 權限、稽核與日誌 9.4 軟體供應鏈安全 9.5 AI/LLM 應用安全 9.6 法規遵循重點(台灣) 9.7 審查與驗證 第十章:上線、維運與監控 10.1 上線檢核清單 10.2 監控與告警 10.3 問題處理與 RCA 10.4 審查與驗證 第十一章:文件化與知識交接 11.1 必備文件清單 11.2 文件維護責任 11.3 審查與驗證 第十二章:持續改善與流程治理 12.1 專案回顧(Post-mortem) 12.2 指標與成熟度模型 12.3 流程優化建議 12.4 審查與驗證 附錄 A:檢查清單(Checklist) A.1 開發階段檢查清單 A.2 部署階段檢查清單 A.3 Code Review 檢查清單 A.4 安全性檢查清單 A.5 AI 產出審查檢查清單 附錄 B:文件範本索引 需求分析階段(Requirements Phase) 系統設計階段(Design Phase) 測試驗證階段(Testing Phase) 部署上線階段(Deployment Phase) 維運監控階段(Operations Phase) 專案管理(Project Management) 附錄 C:術語對照表 附錄 D:修正紀錄 D.1 錯誤修正 D.2 新增內容 D.3 v2.1 文件範本更新 附錄 E:查證紀錄 E.1 待確認與後續更新事項 E.2 標準、法規與工具版本查證 E.3 範例實測紀錄 E.4 如何重做驗證 文件資訊 版本歷程 第一章:前言與目的 1.1 為什麼需要軟體開發標準程序 在企業軟體開發環境中,缺乏標準化流程將導致以下問題: ...

February 5, 2026 · 82 min · 17402 words · Eric Cheng

12-Factor App 說明與對應解決方案

Codebase(單一程式碼庫,多個部署環境) 原則:一個應用程式應有單一程式碼庫,透過不同的部署(deploy)對應不同環境(dev/test/prod)。 解決方案: 使用 GitLab repository 管理專案。 每個環境使用不同 branch 或 tag(如 develop, release, main)。 CI/CD pipeline 進行自動化部署,避免分散程式碼庫。 Dependencies(明確宣告與隔離依賴) 原則:應用程式必須明確管理相依性,避免依賴系統環境。 解決方案: 後端:使用 Maven pom.xml 宣告所有 dependencies,不依賴本地安裝的 jar。 前端:使用 package.json 鎖定依賴版本。 建議使用 Docker 建立一致的 build/runtime 環境。 Config(將設定與程式碼分離) 原則:設定(如 DB 密碼、API key)不應寫死在程式碼中。 解決方案: Spring Boot 使用 application.yml + 外部設定檔 或 環境變數。 GitLab CI/CD 提供 Environment Variables 管理不同環境的設定。 建議搭配 Vault / AWS Secrets Manager / Kubernetes Secrets。 Backing Services(後端服務當作附加資源) 原則:資料庫、快取、MQ、外部 API 都應視為「可替換的資源」。 解決方案: DB(MySQL/DB2/PostgreSQL)、Redis、RabbitMQ 等連線資訊放在設定檔,不耦合程式。 測試環境可用輕量替代(如 testcontainers 啟動 DB/Redis)。 Build, Release, Run(明確分離建置、發佈、執行) 原則:建置(build)、發佈(release)、執行(run)必須分開,避免環境污染。 解決方案: ...

October 31, 2025 · 2 min · 292 words · Eric Cheng

API設計範本

API 設計範本 Prompt 目標 指導 AI 進行RESTful API設計,產生完整的API規格文檔和設計指南。 角色設定 你是一位資深API架構師,具備豐富的API設計經驗,熟悉RESTful設計原則、OpenAPI規範和API最佳實務。 任務描述 請協助我完成 {專案名稱} 的API設計工作。 API 背景資訊 專案名稱: {填入專案名稱} API 類型: {填入API類型,如:RESTful、GraphQL、gRPC} 主要功能領域: {填入主要業務領域} 預期使用者: {填入API使用者類型,如:前端應用、第三方系統、移動應用} 安全等級: {填入安全要求等級} API 設計要求 請按照以下結構進行API設計: 1. API 概覽設計 API 目標和範圍定義 資源模型設計 URL 結構規劃 HTTP 方法對應 2. 資料模型設計 實體關係模型 JSON Schema 定義 資料驗證規則 錯誤回應格式 3. 端點詳細設計 CRUD 操作設計 查詢和篩選設計 分頁機制設計 排序機制設計 4. 安全性設計 身份驗證機制 授權控制設計 API 金鑰管理 速率限制設計 5. 版本控制策略 版本控制方法 向後相容性規劃 廢棄策略設計 遷移指南規劃 6. 文檔和測試 OpenAPI 規格撰寫 使用範例提供 測試案例設計 錯誤處理指南 輸出格式 # {專案名稱} API 設計規格 ## 1. API 概覽 ### 1.1 API 目標 **主要目標:** [API 的主要用途和目標] **次要目標:** [輔助功能和延伸應用] **成功標準:** [API 品質和使用量指標] ### 1.2 API 設計原則 - **RESTful 設計**: 遵循 REST 架構風格 - **一致性**: 統一的命名和回應格式 - **可預測性**: 直觀的 URL 結構和行為 - **可擴展性**: 支援未來功能擴展 - **安全性**: 內建安全機制 ### 1.3 基礎 URL 結構 **Base URL:** `https://api.{domain}.com/v1` **URL 模式:** `/{resource}/{id}/{sub-resource}` ### 1.4 HTTP 方法對應 | HTTP 方法 | 用途 | 冪等性 | 安全性 | |-----------|------|--------|--------| | GET | 查詢資源 | 是 | 是 | | POST | 建立資源 | 否 | 否 | | PUT | 更新/替換資源 | 是 | 否 | | PATCH | 部分更新資源 | 否 | 否 | | DELETE | 刪除資源 | 是 | 否 | ## 2. 資料模型設計 ### 2.1 核心實體模型 #### 實體: User (使用者) ```json { "id": "string (UUID)", "username": "string (3-50字元)", "email": "string (email格式)", "firstName": "string (1-50字元)", "lastName": "string (1-50字元)", "role": "string (enum: admin, user, guest)", "status": "string (enum: active, inactive, suspended)", "createdAt": "string (ISO 8601 datetime)", "updatedAt": "string (ISO 8601 datetime)" } 實體: Product (產品) { "id": "string (UUID)", "name": "string (1-200字元)", "description": "string (可選,最多1000字元)", "price": "number (正數,最多2位小數)", "category": "string", "sku": "string (產品編號)", "inventory": { "quantity": "integer (非負整數)", "reserved": "integer (非負整數)" }, "images": ["string (URL陣列)"], "attributes": { "color": "string", "size": "string", "weight": "number" }, "isActive": "boolean", "createdAt": "string (ISO 8601 datetime)", "updatedAt": "string (ISO 8601 datetime)" } 2.2 標準回應格式 成功回應格式 { "success": true, "data": { // 實際資料內容 }, "meta": { "timestamp": "ISO 8601 datetime", "requestId": "UUID", "pagination": { // 僅分頁查詢時包含 "page": 1, "limit": 20, "total": 100, "totalPages": 5 } } } 錯誤回應格式 { "success": false, "error": { "code": "ERROR_CODE", "message": "錯誤訊息", "details": "詳細錯誤說明", "field": "發生錯誤的欄位 (驗證錯誤時)" }, "meta": { "timestamp": "ISO 8601 datetime", "requestId": "UUID" } } 3. API 端點設計 3.1 使用者管理 API 取得使用者清單 端點: GET /users 描述: 取得使用者清單,支援分頁和篩選 ...

October 31, 2025 · 5 min · 961 words · Eric Cheng

code review 指引

Code Review 指引 企業標準技術白皮書|版本 v3.0|2026-10-08 適用範圍:使用 GitHub(github.com、GitHub Enterprise Cloud、GitHub Enterprise Server)或 GitLab(GitLab.com、Self-Managed、Dedicated)管理原始碼,以 Java/Spring Boot 為後端、以 Vue/TypeScript/Tailwind CSS 為前端、以關聯式資料庫為儲存的企業應用系統。本指引規範程式碼審查(Code Review)的流程、角色、審查重點、平台設定與度量方式:每一條規則都說明要做到什麼、附有正確與錯誤的範例,並說明審查者要用什麼工具或方法確認。 v3.0 全面改寫 v2.0:依 Google Engineering Practices、IEEE 1028-2008、ISO/IEC 20246:2017、NIST SP 800-218 SSDF、OWASP ASVS 5.0、OWASP Top 10:2025、SLSA v1.2 Source Track、ISO/IEC 27001:2022 與 DORA 2025 重新組織內容,並新增「AI 輔助審查與審查 AI 產出」一章。每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的程式碼與審查意見是否正確。範例均經工具實測(見 附錄 F)。各技術領域的完整寫作規範請見 程式寫作指引、安全程式碼指引 與 測試與品質保證指引;本文從「審查」的角度把它們串成一套可執行的流程。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免流程 1. Code Review 的目的、治理與國際標準 1.1 為什麼要做程式碼審查 1.2 審查的類型與選擇 1.3 國際標準與法規對照 1.4 審查的範圍與限制 2. 角色與責任 2.1 角色定義與責任分工 2.2 審查者的資格與指派 3. 審查流程與服務水準 3.1 審查生命週期 3.2 回應時限與服務水準 3.3 審查輪次與核准失效 3.4 風險分級與核准人數 3.5 同步審查、走查與正式檢查 3.6 合併與合併後 4. 作者:準備可審查的變更 4.1 小而聚焦的變更 4.2 撰寫 PR/MR 描述 4.3 提交訊息 4.4 送審前的自我審查 4.5 草稿 PR 與堆疊 PR 4.6 回應審查意見 5. 審查者:如何審查 5.1 審查前的準備 5.2 閱讀順序 5.3 檢查什麼:依重要性排序 5.4 審查的節奏與時間 5.5 在本機驗證 5.6 核准標準 6. 審查意見的撰寫與溝通 6.1 意見分級:讓作者知道哪些必須處理 6.2 好意見的結構 6.3 語氣與溝通 6.4 意見的記錄與追蹤 7. 審查重點:設計與架構 7.1 設計審查與架構決策紀錄 7.2 職責與模組邊界 7.3 簡單與適度:避免過度設計與重複造輪子 7.4 一致性:遵循既有的慣例 8. 審查重點:功能正確性與錯誤處理 8.1 需求符合度與邊界條件 8.2 輸入契約 8.3 錯誤處理 8.4 空值與 Optional 8.5 併發與交易 8.6 資源管理 8.7 金額、時間與數值 9. 審查重點:可讀性與可維護性 9.1 命名 9.2 複雜度 9.3 重複程式碼 9.4 註解與文件 9.5 技術債與範圍控制 10. 審查重點:測試 10.1 測試是否存在、是否在正確的層級 10.2 測試的品質:程式壞掉時會失敗嗎 10.3 覆蓋率作為門檻,而不是目標 10.4 測試的穩定性與可維護性 11. 審查重點:安全 11.1 安全審查的範圍與方法 11.2 輸入驗證與輸出編碼 11.3 注入 11.4 身分驗證與授權 11.5 秘密、敏感資料與日誌 11.6 密碼學 11.7 OWASP Top 10:2025 審查對照 12. 審查重點:效能與資源 12.1 資料庫存取:N+1 與查詢次數 12.2 無上限的查詢與分頁 12.3 快取 12.4 外部呼叫:逾時與重試 12.5 效能宣稱需要證據 13. 審查重點:資料庫與資料遷移 13.1 遷移腳本的管理 13.2 向後相容:擴充與收縮 13.3 鎖與線上變更 13.4 新查詢與索引 14. 審查重點:前端、UI 與無障礙 14.1 TypeScript 與 lint 設定 14.2 元件設計、狀態與非同步 14.3 無障礙(WCAG 2.2) 14.4 前端測試 14.5 UI 變更的審查 15. 審查重點:設定、CI/CD 與相依套件 15.1 應用程式設定 15.2 相依套件 15.3 CI/CD 工作流程 15.4 容器與基礎設施即程式碼 16. 審查重點:API 相容性與文件 16.1 API 契約與破壞性變更 16.2 文件與變更紀錄 17. 自動化與品質閘門 17.1 品質閘門清單 17.2 GitHub Actions 範例 17.3 GitLab CI 範例 17.4 SonarQube 設定 17.5 工具警告的抑制 17.6 審查輔助工具 18. 平台設定:GitHub 與 GitLab 18.1 平台功能對照 18.2 GitHub:Rulesets 18.3 GitHub:CODEOWNERS 18.4 GitLab:核准設定與受保護分支 18.5 GitLab:CODEOWNERS 區段 18.6 範本與自動化設定 19. AI 輔助審查與審查 AI 產出 19.1 原則:人對合併負責 19.2 AI 審查工具的選擇 19.3 AI 審查工具的安全 19.4 處理 AI 審查意見 19.5 審查 AI 產生的程式碼 20. 特殊情境 20.1 緊急修正 20.2 大型重構 20.3 自動產生的程式碼與機器人 PR 20.4 第三方程式碼與授權 20.5 跨團隊變更 20.6 正式環境的資料修正 21. 意見衝突與團隊文化 21.1 意見分歧的處理 21.2 心理安全與行為準則 21.3 建立審查文化 22. 度量與持續改善 22.1 度量的原則 22.2 收集方式 22.3 回顧與改善 23. 培訓與導入 23.1 導入路線圖 23.2 審查者培訓 23.3 審查校準 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 檢查清單與範本 B.1 作者送審前自我檢查 B.2 審查者檢查清單 B.3 快速參考卡 B.4 IDE 設定 附錄 C 工具設定與腳本 C.1 CODEOWNERS 檢查腳本 C.2 審查度量報表 C.3 審查提醒 C.4 PR 衛生檢查 C.5 審查意見標籤統計 C.6 Checkstyle 與 PMD 設定 附錄 D 術語表與常用審查用語 D.1 術語表 D.2 常用英文審查用語 附錄 E 參考資料 E.1 標準與框架 E.2 業界實務與研究 E.3 平台與工具文件 E.4 延伸閱讀 附錄 F 修訂紀錄與查證紀錄 F.1 v2.0 與 v3.0 章節對照 F.2 v2.0 錯誤修正紀錄 F.3 查證紀錄 F.4 待查證與後續更新 F.5 版本紀錄 0. 文件資訊 0.1 文件目的與讀者 程式碼審查是軟體團隊最常執行、也最容易流於形式的品質活動。一個 Pull Request(GitHub)或 Merge Request(GitLab)被按下「Approve」,可能代表審查者逐行讀過、在本機執行過測試;也可能只代表審查者看了標題,覺得「應該沒問題」。兩者在平台上看起來完全一樣,差別要等到上線後才會顯現。 ...

October 31, 2025 · 120 min · 25430 words · Eric Cheng

JdbcTemplate 安全 SQL 實作指引文件

以下是完整的 《JdbcTemplate 安全 SQL 實作指引文件》Markdown 版本,可直接放入你的 Git Repository(例如 /docs/security/jdbctemplate-sql-guideline.md),作為團隊安全規範或 Code Review checklist 使用。 # 🧭 JdbcTemplate 安全 SQL 實作指引文件 **版本:v1.0** **適用範圍:** Spring Boot 專案中使用 `JdbcTemplate` 或 `NamedParameterJdbcTemplate` 的資料存取層 **目的:** 防止 SQL Injection 攻擊與弱掃誤判 --- ## 1️⃣ 目的與原則 SQL Injection(SQL 注入)是 OWASP Top 10 的主要風險之一。 若在 API 中直接拼接 SQL 字串(尤其包含前端輸入),將導致弱掃報告出現 Injection 問題,甚至被惡意利用。 **安全實作原則:** 1. 所有 SQL 查詢必須採用 **參數化查詢(Parameterized Query)**。 2. 不可直接拼接使用者輸入字串到 SQL。 3. 動態欄位或排序需求必須使用 **白名單機制(Whitelist)**。 4. 禁止讓 client 直接傳入完整 SQL。 5. 所有 DB 帳號採用最小權限原則(Least Privilege)。 --- ## 2️⃣ 正確安全作法範例 ### ✅ 查詢範例 ```java String sql = "SELECT id, name, email FROM users WHERE email = ?"; return jdbcTemplate.query(sql, new Object[]{email}, new UserRowMapper()); ✅ 插入範例 String sql = "INSERT INTO users (name, email) VALUES (?, ?)"; jdbcTemplate.update(sql, name, email); ✅ 更新範例 String sql = "UPDATE users SET status = ? WHERE id = ?"; jdbcTemplate.update(sql, status, id); ✅ 刪除範例 String sql = "DELETE FROM users WHERE id = ?"; jdbcTemplate.update(sql, id); ✅ 動態查詢(條件可變) 重點:條件以程式判斷拼接,但參數仍使用 ? 綁定。 ...

October 31, 2025 · 3 min · 498 words · Eric Cheng

refactor 重構指引

重構指引(Refactoring Guide) 企業標準技術白皮書|版本 v2.0|2026-10-08 適用範圍:以 Java(Java 25 LTS,相容 Java 21)/Spring Boot 4 為後端、以 Vue 3/TypeScript 為前端、以關聯式資料庫為儲存,並使用 GitHub 或 GitLab 管理原始碼的企業應用系統。本指引規範「在不改變外部行為的前提下改善程式結構」的方法、時機、流程、工具與驗證方式:每一條規則都說明要做到什麼、附有正確與錯誤的範例,並說明審查者要用什麼工具或方法確認。 v2.0 全面改寫 v1.0:以 Martin Fowler《Refactoring》第二版的重構目錄、Michael Feathers《Working Effectively with Legacy Code》、Kent Beck《Tidy First?》與 Fowler 的演進式設計模式(Strangler Fig、Branch by Abstraction、Parallel Change)為方法基礎;以 ISO/IEC 25010:2023、ISO/IEC/IEEE 14764:2022、ISO/IEC 5055:2021、ISO/IEC/IEEE 12207:2017 與 DORA 2025 報告為治理基礎重新組織內容。新增 Java 現代化、前端 TypeScript/Vue、架構層、資料庫與 API 演進、OpenRewrite 大規模自動化與「AI 輔助重構與審查 AI 產出」等章。每條規則都附有範例與「驗證方式」,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的重構是否真的「沒有改變行為」。範例均經工具實測(見 附錄 F)。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀本指引 0.6 例外與豁免流程 1. 重構的定義、目的與國際標準 1.1 什麼是重構 1.2 為什麼要重構:目的與經濟效益 1.3 國際標準與研究對照 1.4 重構的範圍與限制 2. 重構原則 2.1 小步前進,每一步都保持綠燈 2.2 優先使用工具化的重構 2.3 以簡單設計為方向 3. 重構時機與決策 3.1 重構的五種時機 3.2 決定「要不要重構」:紅黃綠燈 3.3 重構、重寫或汰換 4. 程式碼異味:找出需要重構的地方 4.1 異味目錄與偵測工具對照 4.2 門檻與「新程式碼」品質閘門 5. 安全網:重構前的測試 5.1 測試是重構的前提 5.2 特性測試:記錄現在的行為 5.3 黃金主檔與核准測試 5.4 覆蓋率與變異測試:測試夠強嗎 5.5 接縫:讓無法測試的程式碼可以被測試 6. 基本重構手法 6.1 提煉函式與內聯函式(Extract Function/Inline Function) 6.2 改名與提煉變數(Rename/Extract Variable) 6.3 改變函式宣告(Change Function Declaration) 6.4 封裝變數與集合(Encapsulate Variable/Encapsulate Collection) 6.5 拆分階段與合併函式(Split Phase/Combine Functions into Class) 6.6 移除死程式碼(Remove Dead Code) 7. 搬移特性與組織資料 7.1 搬移函式與搬移欄位(Move Function/Move Field) 7.2 提煉類別與內聯類別(Extract Class/Inline Class) 7.3 以物件取代基本型別:值物件(Replace Primitive with Object) 7.4 隱藏委託與移除中間人(Hide Delegate/Remove Middle Man) 8. 簡化條件邏輯 8.1 提早返回與分解條件(Guard Clauses/Decompose Conditional) 8.2 以多型取代條件式(Replace Conditional with Polymorphism) 8.3 引入特例(Introduce Special Case) 8.4 引入斷言與以預先檢查取代例外(Introduce Assertion/Replace Exception with Precheck) 9. API 與繼承重構 9.1 參數物件、保留完整物件與移除旗標參數 9.2 分離查詢與修改、移除設值方法、以工廠函式取代建構子 9.3 處理繼承:上移、下移、提煉父類別與摺疊階層 9.4 以委託取代繼承(Replace Subclass/Superclass with Delegate) 10. Java 現代化重構 10.1 以 record 取代資料類別 10.2 模式比對與 switch 運算式 10.3 Optional 與 null 10.4 以管線取代迴圈(Replace Loop with Pipeline) 10.5 建構子驗證與 Java 25 語言特性 10.6 虛擬執行緒與併發程式的現代化 11. 前端 TypeScript/Vue 重構 11.1 型別強化:讓編譯器幫你重構 11.2 元件重構:Options API 到 Composition API 與 composable 11.3 大規模前端重構:codemod 與未使用程式碼 12. 遺留系統重構 12.1 遺留程式碼的變更步驟 12.2 Sprout 與 Wrap:在無法測試的程式碼旁邊加新功能 12.3 Mikado 方法:處理相依關係不明的大型重構 12.4 Branch by Abstraction:在主幹上替換元件 12.5 Strangler Fig:漸進汰換整個系統 13. 架構層重構 13.1 以架構測試守護重構 13.2 模組化單體:Spring Modulith 13.3 從模組化單體拆分服務 14. 資料庫與 API 的演進式重構 14.1 Parallel Change:擴充—遷移—收縮 14.2 資料庫重構 14.3 REST API 的演進 14.4 事件與訊息格式的演進 15. 大規模自動化重構 15.1 選擇自動化工具 15.2 框架升級與語法現代化 16. 效能與重構 16.1 重構與效能的關係 16.2 資料存取與快取:最容易「重構出」效能問題的地方 17. 安全與重構 17.1 安全控制不得在重構中消失 17.2 查詢、日誌與序列化:重構時常見的安全退化 18. 流程、版本控管與審查 18.1 重構型 PR 的組成 18.2 分支策略與長期重構 18.3 守護測試:重構 PR 不得改變測試的預期值 18.4 如何審查重構型 PR 19. AI 輔助重構與審查 AI 產出 19.1 AI 在重構中的角色與風險 19.2 提示範本:讓 AI 產出可審查的重構 19.3 等價性驗證:證明 AI 的重構沒有改變行為 19.4 AI 代理的重構:指示檔與防護欄 19.5 AI 重構常見錯誤總表 20. 技術債管理與度量 20.1 技術債的分類與登錄 20.2 度量重構的成效 20.3 重構的投資與時間配置 21. 反模式與常見陷阱 21.1 流程與範圍的反模式 21.2 設計與實作的反模式 21.3 v1.0 範例中的反模式更正 22. 案例研究 22.1 遺留計費模組的漸進式重構(Java) 22.2 前端元件現代化(Vue/TypeScript) 23. 導入與培訓 23.1 分階段導入 23.2 培訓:以重構套路(kata)練習 附錄 A 規則總表 A.1 依領域統計 A.2 驗證方式與範例覆蓋 A.3 規則清單 附錄 B 檢核清單與範本 B.1 重構前檢核 B.2 重構中檢核 B.3 合併前檢核(作者) B.4 審查者檢核 B.5 AI 產出重構的審查檢核 B.6 重構提案範本 B.7 重構後追蹤 附錄 C 設定檔與腳本 C.1 Maven 驗證專案設定 C.2 OpenRewrite 設定 C.3 PMD 規則集 C.4 Checkstyle 設定 C.5 架構規則(ArchUnit、Spring Modulith) C.6 CI 工作流程 C.7 commitlint 設定 C.8 熱點分析腳本 C.9 測試守護腳本 C.10 前端設定 C.11 等價性檢查腳本 附錄 D 名詞對照 附錄 E 參考資料 E.1 書籍 E.2 國際標準與規範 E.3 研究報告 E.4 線上資源 附錄 F 修訂紀錄與查證紀錄 F.1 v1.0 章節對照 F.2 v1.0 內容更正紀錄 F.3 查證紀錄 F.4 待確認事項 F.5 技術版本紀錄 0. 文件資訊 0.1 文件目的與讀者 重構(refactoring)是「在不改變軟體可觀察行為的前提下,改善其內部結構」的一系列小步驟。它聽起來簡單,實務上卻最容易出錯:一次改太多、測試不足、把功能變更混在重構裡、或是把「重寫」誤稱為「重構」,都會讓原本可控的整理工作變成難以審查、難以回復的風險。生成式 AI 讓產生「看起來更乾淨」的程式碼變得非常容易,但 AI 產出的重構常常悄悄改變了邊界條件、例外型別或執行順序;判斷一次重構有沒有改變行為,仍然是人的責任。 ...

October 31, 2025 · 104 min · 22027 words · Eric Cheng

UIUX指引

UI/UX 開發指引 企業標準技術白皮書|版本 v3.0|2026-10-09 適用範圍:以 Vue 3/TypeScript/Tailwind CSS 開發的企業 Web 應用,特別是網路銀行、保險、證券等金融服務,以及其他需要處理交易、個資與法規要求的系統。本指引規範從使用者研究、資訊架構、互動與視覺設計、Design Token、元件、表單、無障礙、內容、國際化、狀態設計,到效能、實作與品質驗證的 UI/UX 要求:每一條規則都說明要做到什麼、附有正確與錯誤的範例,並說明要用什麼工具或方法確認。 v3.0 全面改寫 v2.1:依 ISO 9241-210/-110/-11、ISO/IEC 25010:2023、WCAG 2.2(ISO/IEC 40500:2025)、WAI-ARIA 與 APG、EN 301 549 V4.1.1、European Accessibility Act、數位發展部「網站無障礙規範」115.11 版、金管會「數位金融服務包容性指引」、Design Tokens Format Module 2025.10 與 Core Web Vitals 重新組織內容。所有規則都有編號(UX-*)、等級與驗證方式,每節結尾都有「🔍 審查與驗證」,讓審查者能判斷 AI 或同事產出的介面是否正確。範例均以工具實際執行驗證(見 附錄 F)。框架工程細節見 前端開發指引,審查流程見 code review 指引。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術與標準基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀與使用本指引 0.6 例外與豁免流程 1. UX 治理與國際標準 1.1 為什麼企業需要 UI/UX 指引 1.2 國際標準與法規對照 1.3 無障礙法規與合規義務 1.4 UX 治理組織與責任 2. 以使用者為中心的設計流程 2.1 人本設計流程(ISO 9241-210) 2.2 使用者研究方法 2.3 人物誌、旅程地圖與使用情境 2.4 可用性需求與驗收條件 3. 資訊架構與導覽 3.1 資訊架構 3.2 導覽模式 3.3 頁面結構與地標 3.4 麵包屑、頁籤標題與網址 4. 互動設計原則 4.1 ISO 9241-110 互動原則與尼爾森啟發式 4.2 系統狀態與回饋 4.3 防錯、確認與復原 4.4 一致性與慣例 4.5 鍵盤與指標操作 5. 視覺設計 5.1 排版與字型 5.2 色彩與對比 5.3 間距、格線與版面 5.4 圖示與圖片 5.5 動態與動畫 5.6 資料視覺化 6. Design Token 與設計系統 6.1 Design Token 的分層 6.2 DTCG 格式與 Style Dictionary 6.3 Tailwind CSS 4 整合 6.4 主題與深色模式 7. 元件設計規範 7.1 元件的通用要求 7.2 按鈕與連結 7.3 對話框 7.4 選單、頁籤與手風琴 7.5 資料表格 7.6 通知訊息與 Toast 7.7 分頁與無限捲動 8. 表單設計與驗證 8.1 欄位標籤與說明 8.2 輸入類型與自動完成 8.3 驗證時機 8.4 錯誤訊息與錯誤摘要 8.5 多步驟表單 9. 響應式與多裝置設計 9.1 斷點與行動優先 9.2 重排與文字縮放 9.3 觸控目標與手勢 9.4 螢幕方向與容器查詢 10. 無障礙設計 10.1 WCAG 2.2 AA 符合策略 10.2 語意化 HTML 與 ARIA 使用原則 10.3 鍵盤操作與焦點管理 10.4 螢幕閱讀器與動態內容 10.5 WCAG 2.2 新增成功準則 10.6 認知無障礙 10.7 無障礙聲明與回饋管道 11. 內容設計與 UX 寫作 11.1 語氣與用語 11.2 微文案 11.3 易讀性與白話文 12. 國際化與在地化 12.1 語系與語言標示 12.2 數字、金額與日期格式 12.3 文字長度與雙向文字 13. 狀態設計 13.1 載入狀態 13.2 空狀態 13.3 錯誤狀態 13.4 離線與逾時 14. 金融情境 UX 14.1 金額、帳號與數值顯示 14.2 交易流程與確認 14.3 敏感資料遮罩與隱私 14.4 身分驗證與工作階段逾時 14.5 詐騙防範與風險提示 14.6 包容性金融服務 15. 效能與使用者體驗 15.1 Core Web Vitals 15.2 感知效能 15.3 效能預算 16. Vue 3 與 Tailwind CSS 實作落地 16.1 元件 API 設計 16.2 無障礙元件實作模式 16.3 樣式撰寫規範 16.4 元件文件與 Storybook 17. UX 品質驗證 17.1 驗證策略與金字塔 17.2 自動化無障礙檢測 17.3 手動與輔助科技測試 17.4 視覺回歸測試 17.5 可用性測試與 UX 指標 18. 設計與開發協作 18.1 設計交付 18.2 設計審查 18.3 設計系統治理與版本 19. AI 與 UX 19.1 審查 AI 產出的介面 19.2 設計 AI 功能的使用體驗 19.3 以 AI 輔助 UX 工作 附錄 A 規則總表 附錄 B 檢查清單與範本 B.1 UI 變更的 PR/MR 審查清單 B.2 設計交付與設計審查清單 B.3 螢幕閱讀器測試紀錄範本 B.4 使用者研究同意書範本 B.5 第三方 UI 元件評估清單 附錄 C 工具設定與腳本 C.1 驗證專案的結構與指令 C.2 按鈕樣式 C.3 Stylelint 規則說明 C.4 axe 設定 C.5 Playwright 設定 C.6 Lighthouse CI C.7 GitHub Actions 工作流程 C.8 GitLab CI 對應設定 附錄 D 術語表 D.1 UI/UX 與無障礙術語 D.2 產品詞彙表格式 D.3 台灣用語對照(節錄) 附錄 E 參考資料 E.1 國際標準與規範 E.2 法規 E.3 設計方法與業界實務 E.4 工具文件 附錄 F 修訂紀錄與查證紀錄 F.1 v2.1 與 v3.0 章節對照 F.2 v2.1 的錯誤與修正 F.3 查證紀錄 F.4 待確認項目 F.5 版本紀錄 0. 文件資訊 0.1 文件目的與讀者 使用者對一套系統的評價,幾乎都來自介面:按鈕按下去有沒有反應、錯誤訊息看不看得懂、轉帳前能不能確認金額、用鍵盤或螢幕閱讀器能不能完成操作。這些問題很少在需求文件中被寫清楚,卻在上線後以客訴、客服電話、交易錯誤與法規風險的形式出現。 ...

October 31, 2025 · 117 min · 24753 words · Eric Cheng

前端開發指引

前端開發指引 企業標準技術白皮書|版本 v2.0|2026-10-09 適用範圍:以 Vue 3/TypeScript/Vite/Tailwind CSS 開發的企業 Web 前端,特別是網路銀行、保險、證券等需要處理交易、個資與稽核要求的系統。本指引規範專案結構、命名、TypeScript、靜態檢查、元件、Composables、樣式、路由、狀態管理、API 串接、表單、多語系、前端安全、無障礙實作、效能、錯誤處理與可觀測性、測試、建置部署、版本控制與 CI、相依套件供應鏈、除錯,以及 AI 輔助開發的審查方法。 v2.0 全面改寫 v1.0.0:依 Vue 3.5/Vue Router 5/Pinia 4/Vite 8/TypeScript 6/Tailwind CSS 4/Vitest 5/Playwright 1.64 重新撰寫所有範例,並對照 OWASP ASVS 5.0、OWASP Top 10:2025、WCAG 2.2(ISO/IEC 40500:2025)、Core Web Vitals、RFC 9457、RFC 9700、OAuth 2.0 for Browser-Based Applications、CSP Level 3/Trusted Types、SLSA 1.2 與 CycloneDX 1.7(ECMA-424)。所有規則都有編號(FE-*)、驗證方式與範例;範例都以 vue-tsc、ESLint、Vitest、Vite 與 Playwright 實際執行過(見 附錄 F.3)。 目錄 0. 文件資訊 0.1 文件目的與讀者 0.2 技術與標準基準版本 0.3 規範等級與規則格式 0.4 與其他指引的關係 0.5 如何閱讀與使用本指引 0.6 例外與豁免流程 1. 前端治理與國際標準 1.1 前端品質與 ISO/IEC 25010 1.2 安全與法規基準 1.3 瀏覽器支援政策 1.4 版本支援與升級治理 2. 專案結構與模組邊界 2.1 標準目錄結構 2.2 路徑別名與匯入 2.3 Monorepo 與共用套件 3. 命名規範 3.1 檔案與資料夾 3.2 變數、函式與型別 3.3 TypeScript 的列舉與常數集合 3.4 Vue 元件、Props 與事件 4. TypeScript 撰寫規範 4.1 編譯器設定 4.2 型別系統的逃生門 4.3 外部資料的執行期驗證 4.4 非同步與例外 4.5 金額、數字與日期 4.6 以型別表達狀態 5. 程式風格與靜態檢查 5.1 工具分工 5.2 ESLint 5.3 Prettier 5.4 編輯器設定 5.5 提交前檢查 5.6 註解 6. Vue 元件開發規範 6.1 單檔元件結構 6.2 Props 6.3 v-model 與 defineModel 6.4 事件 6.5 插槽與泛型元件 6.6 範本 6.7 DOM 存取與識別碼 6.8 響應式 6.9 元件介面與實驗性功能 7. Composables 與邏輯重用 7.1 介面設計 7.2 副作用與清理 7.3 測試 Composables 7.4 使用 VueUse 8. 樣式與 Tailwind CSS 4 8.1 Tailwind CSS 4 設定 8.2 Class 的寫法 8.3 元件樣式與 @apply 8.4 響應式與使用者偏好 9. 路由與導覽 9.1 路由表與延遲載入 9.2 導覽守衛 9.3 路由參數 9.4 部署後的 chunk 載入失敗 9.5 檔案式路由(選用) 10. 狀態管理 10.1 狀態的分類 10.2 伺服器狀態:Pinia Colada 10.3 修改資料:useMutation 10.4 Pinia store 10.5 持久化與登出 11. API 串接與資料存取 11.1 共用的 HTTP 用戶端 11.2 API 契約與型別 11.3 錯誤格式:RFC 9457 Problem Details 11.4 逾時、重試與取消 11.5 重複送出與冪等性 12. 表單與輸入驗證 12.1 驗證的分工 12.2 欄位的寫法 12.3 後端錯誤與保留輸入 12.4 確認步驟與送出控制 13. 多語系(i18n) 13.1 設定 13.2 翻譯鍵與訊息 13.3 格式化與語系屬性 14. 前端安全 14.1 跨站腳本(XSS) 14.2 身分驗證與工作階段:BFF 模式 14.3 CSP 與安全標頭 14.4 敏感資料與瀏覽器 API 14.5 授權與檔案 14.6 閒置逾時與登出 15. 無障礙實作 15.1 語意與鍵盤 15.2 應用程式外殼:跳過連結與換頁 15.3 對話框 15.4 自動化檢測 16. 效能 16.1 量測 16.2 載入效能 16.3 執行期效能 17. 錯誤處理、日誌與可觀測性 17.1 全域錯誤處理 17.2 使用者看到的錯誤 17.3 追蹤與關聯 18. 測試 18.1 測試基礎設施 18.2 撰寫測試 18.3 涵蓋率 18.4 端對端測試 19. 建置、環境設定與部署 19.1 建置產物與環境設定 19.2 Vite 設定 19.3 容器化 19.4 nginx 設定與快取 20. 版本控制與持續整合 20.1 分支與提交 20.2 CI 工作流程 20.3 程式碼擁有者 21. 相依套件與供應鏈安全 21.1 引入與鎖定 21.2 安裝時的防護 21.3 漏洞管理與更新 21.4 軟體物料清單(SBOM)與來源證明 22. 除錯與疑難排解 22.1 除錯的流程 22.2 常見錯誤對照表 22.3 記憶體洩漏與效能問題 23. AI 輔助前端開發與審查 23.1 責任與資料保護 23.2 提供脈絡 23.3 審查 AI 產出的程式碼 附錄 A 規則總表 附錄 B 檢查清單與範本 B.1 前端 PR 範本 B.2 發布前檢查清單 B.3 手動無障礙與跨瀏覽器測試紀錄 附錄 C 工具設定與腳本 C.1 TypeScript 設定 C.2 ESLint 設定 C.3 package.json C.4 指令速查 附錄 D 術語表 附錄 E 參考資料 E.1 標準與規範 E.2 框架與工具文件 E.3 本公司相關指引 附錄 F 修訂紀錄與查證紀錄 F.1 v1 與 v2 章節對照 F.2 v1.0 的更正清單 F.3 查證紀錄 F.4 待確認與後續更新 F.5 修訂紀錄 0. 文件資訊 0.1 文件目的與讀者 前端是使用者唯一直接接觸的系統元件。轉帳按鈕按兩下是否會重複扣款、登入權杖會不會被惡意腳本讀走、網路中斷時畫面會不會卡在「載入中」、螢幕閱讀器使用者能不能完成申請,這些都由前端程式碼決定。前端的缺陷因此常以客訴、交易爭議、資安事件與法規風險的形式出現,而不只是「畫面不好看」。 ...

October 31, 2025 · 145 min · 30783 words · Eric Cheng

壓測指引

角色: 你是一個資深的系統架師,也是AP 性能調較高手 環境: OS : AIX, ap server:IBM WebSphere Liberty, datbase: db2, 使用sprint boot 開發, 壓測使用Jmeter 任務: 壓測一小時, 同時50人, 95% request 必需在3秒內完成, 請列出壓測應注意那些參數設定與調校 chatGPT 回答 好的 ✅ 以下我會用「資深系統架構師 & AP 性能調校高手」的角度,幫你整理 JMeter 壓測設定、Liberty 調校、DB2 調校、AIX/系統層級參數 四大面向,確保你的一小時壓測(50人同時、95% request < 3 秒)能達標。 1. 壓測工具 (JMeter) 層 測試場景設計 Ramp-Up 時間:避免一次 50 人瞬間打進系統,建議 30–60 秒平滑增加,觀察系統穩態。 Think Time:模擬使用者真實行為,避免「機械式打爆」;可設定 0.5–2 秒隨機等待。 持續時間模式:壓測 60 分鐘,避免只測瞬間峰值。 監控數據: 95% 响應時間 Throughput (TPS) Error Rate DB2 Connection Pool 狀況 JVM Heap/GC 次數 JMeter 參數建議 非 GUI 模式執行(jmeter -n -t test.jmx -l result.jtl) ...

October 31, 2025 · 8 min · 1672 words · Eric Cheng