<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>Feature Flag on Eric 個人部落格</title><link>https://chihhung.github.io/Blog/tags/feature-flag/</link><description>Recent content in Feature Flag on Eric 個人部落格</description><generator>Hugo</generator><language>zh-TW</language><lastBuildDate>Tue, 06 Oct 2026 00:00:00 +0000</lastBuildDate><atom:link href="https://chihhung.github.io/Blog/tags/feature-flag/index.xml" rel="self" type="application/rss+xml"/><item><title>Feature Flag 登記表範本（Feature Flag Register Template）</title><link>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/deployment/featureflagregister_template/</link><pubDate>Tue, 06 Oct 2026 00:00:00 +0000</pubDate><guid>https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/templates/deployment/featureflagregister_template/</guid><description>&lt;h1 id="feature-flag-登記表範本feature-flag-register"&gt;Feature Flag 登記表範本（Feature Flag Register）&lt;/h1&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;參照標準&lt;/strong&gt;：OpenFeature 規格（CNCF）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;文件用途&lt;/strong&gt;：登記每個 Feature Flag 的用途、擁有者、預設值與移除日期，避免旗標變成無人管理的技術債&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;適用階段&lt;/strong&gt;：開發、部署與維運階段&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;範本版本&lt;/strong&gt;：v2.0（2026-10-06）｜對應《軟體開發標準程序教學手冊》v2.0 第 8.4 節&lt;/p&gt;&lt;/blockquote&gt;
&lt;hr&gt;
&lt;h2 id="-章節目錄"&gt;📋 章節目錄&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;&lt;a href="#1-%E6%97%97%E6%A8%99%E7%99%BB%E8%A8%98"&gt;旗標登記&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#2-%E8%AE%8A%E6%9B%B4%E7%B4%80%E9%8C%84"&gt;變更紀錄&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#3-%E6%B8%85%E7%90%86%E6%AA%A2%E6%9F%A5"&gt;清理檢查&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="#4-%E5%AF%A9%E6%9F%A5%E8%88%87%E9%A9%97%E8%AD%89"&gt;審查與驗證&lt;/a&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;hr&gt;
&lt;h2 id="1-旗標登記"&gt;1. 旗標登記&lt;/h2&gt;
&lt;h3 id="-範本"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;旗標名稱&lt;/th&gt;
&lt;th&gt;類型&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;th&gt;擁有者&lt;/th&gt;
&lt;th&gt;預設值（安全值）&lt;/th&gt;
&lt;th&gt;目前狀態&lt;/th&gt;
&lt;th&gt;建立日&lt;/th&gt;
&lt;th&gt;預計移除日&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{kebab-case 名稱}&lt;/td&gt;
&lt;td&gt;{發布／營運開關／實驗／權限}&lt;/td&gt;
&lt;td&gt;{說明}&lt;/td&gt;
&lt;td&gt;{姓名}&lt;/td&gt;
&lt;td&gt;{值與理由}&lt;/td&gt;
&lt;td&gt;{各環境狀態}&lt;/td&gt;
&lt;td&gt;{日期}&lt;/td&gt;
&lt;td&gt;{日期}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明"&gt;📖 使用說明&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;類型&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;th&gt;生命週期&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;發布（Release）&lt;/td&gt;
&lt;td&gt;隱藏未完成功能、逐步開放&lt;/td&gt;
&lt;td&gt;短：全面開放後 30 天內移除&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;營運開關（Ops）&lt;/td&gt;
&lt;td&gt;緊急關閉高耗能或不穩定功能（Kill Switch）&lt;/td&gt;
&lt;td&gt;長：需定期確認仍需要&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;實驗（Experiment）&lt;/td&gt;
&lt;td&gt;A/B 測試&lt;/td&gt;
&lt;td&gt;實驗結束即移除&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;權限（Permission）&lt;/td&gt;
&lt;td&gt;依客戶或方案開放功能&lt;/td&gt;
&lt;td&gt;長：視同產品設定&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;ul&gt;
&lt;li&gt;預設值必須是「安全」的行為（通常是舊流程或關閉）：旗標服務故障時不得啟用未完成的功能&lt;/li&gt;
&lt;li&gt;名稱用 kebab-case，描述行為而非人名或工單號&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;旗標名稱&lt;/th&gt;
&lt;th&gt;類型&lt;/th&gt;
&lt;th&gt;用途&lt;/th&gt;
&lt;th&gt;擁有者&lt;/th&gt;
&lt;th&gt;預設值（安全值）&lt;/th&gt;
&lt;th&gt;目前狀態&lt;/th&gt;
&lt;th&gt;建立日&lt;/th&gt;
&lt;th&gt;預計移除日&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;new-leave-quota-check&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;發布&lt;/td&gt;
&lt;td&gt;新版特休額度檢查&lt;/td&gt;
&lt;td&gt;Tech Lead 王&lt;/td&gt;
&lt;td&gt;&lt;code&gt;false&lt;/code&gt;（走舊檢查）&lt;/td&gt;
&lt;td&gt;DEV on／UAT on／PRD 25%&lt;/td&gt;
&lt;td&gt;2026-09-20&lt;/td&gt;
&lt;td&gt;2026-11-15&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;admin-xml-import&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;營運開關&lt;/td&gt;
&lt;td&gt;管理後台 XML 匯入（RA-2026-07 期間關閉）&lt;/td&gt;
&lt;td&gt;資安 李&lt;/td&gt;
&lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;全環境 off&lt;/td&gt;
&lt;td&gt;2025-03-01&lt;/td&gt;
&lt;td&gt;不移除（每季確認）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="2-變更紀錄"&gt;2. 變更紀錄&lt;/h2&gt;
&lt;h3 id="-範本-1"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;時間&lt;/th&gt;
&lt;th&gt;旗標&lt;/th&gt;
&lt;th&gt;環境&lt;/th&gt;
&lt;th&gt;變更&lt;/th&gt;
&lt;th&gt;執行者&lt;/th&gt;
&lt;th&gt;核准者&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{YYYY-MM-DD HH:MM}&lt;/td&gt;
&lt;td&gt;{名稱}&lt;/td&gt;
&lt;td&gt;{環境}&lt;/td&gt;
&lt;td&gt;{舊值 → 新值}&lt;/td&gt;
&lt;td&gt;{姓名}&lt;/td&gt;
&lt;td&gt;{姓名}&lt;/td&gt;
&lt;td&gt;{原因／工單}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明-1"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;正式環境的旗標變更等同上線，必須留稽核紀錄並經核准&lt;/li&gt;
&lt;li&gt;優先使用旗標平台內建的稽核日誌，本表作為摘要&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-1"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;時間&lt;/th&gt;
&lt;th&gt;旗標&lt;/th&gt;
&lt;th&gt;環境&lt;/th&gt;
&lt;th&gt;變更&lt;/th&gt;
&lt;th&gt;執行者&lt;/th&gt;
&lt;th&gt;核准者&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;2026-10-06 10:00&lt;/td&gt;
&lt;td&gt;&lt;code&gt;new-leave-quota-check&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;PRD&lt;/td&gt;
&lt;td&gt;0% → 25%&lt;/td&gt;
&lt;td&gt;DevOps 林&lt;/td&gt;
&lt;td&gt;PO 王&lt;/td&gt;
&lt;td&gt;漸進開放（CHG-2026-118）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="3-清理檢查"&gt;3. 清理檢查&lt;/h2&gt;
&lt;h3 id="-範本-2"&gt;📝 範本&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;旗標名稱&lt;/th&gt;
&lt;th&gt;是否已全面開放或廢止&lt;/th&gt;
&lt;th&gt;程式中引用處&lt;/th&gt;
&lt;th&gt;清理 PR&lt;/th&gt;
&lt;th&gt;狀態&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;{名稱}&lt;/td&gt;
&lt;td&gt;{是／否}&lt;/td&gt;
&lt;td&gt;{檔案:行數}&lt;/td&gt;
&lt;td&gt;{PR 連結}&lt;/td&gt;
&lt;td&gt;{待清理／已移除}&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="-使用說明-2"&gt;📖 使用說明&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;每個 Sprint 檢查過期的旗標；移除旗標時同時刪除舊流程程式碼與對應測試&lt;/li&gt;
&lt;li&gt;長期不清理的旗標會產生無法測試的組合，並增加事故風險&lt;/li&gt;
&lt;/ul&gt;
&lt;h3 id="-範例-2"&gt;💡 範例&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;旗標名稱&lt;/th&gt;
&lt;th&gt;是否已全面開放或廢止&lt;/th&gt;
&lt;th&gt;程式中引用處&lt;/th&gt;
&lt;th&gt;清理 PR&lt;/th&gt;
&lt;th&gt;狀態&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;leave-attachment-v2&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;是（2026-08-01 起 100%）&lt;/td&gt;
&lt;td&gt;&lt;code&gt;LeaveController.java:88&lt;/code&gt;、&lt;code&gt;LeaveService.java:142&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;#1301&lt;/td&gt;
&lt;td&gt;已移除&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr&gt;
&lt;h2 id="4-審查與驗證"&gt;4. 審查與驗證&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本節供審查者使用，也用來檢查 AI 依本範本產出的登記表是否正確。&lt;/p&gt;</description></item></channel></rss>