3.4 業務流程設計原則:SOLID、DRY 與 KISS
學完本節,你能夠:
- 用商業例子說明 SOLID 五原則、DRY 與 KISS 各自在防止什麼問題。
- 找出一個系統中「同一條商業規則寫在好幾個地方」的狀況,並提出單一真實來源的改法。
- 讀懂一段「新增物流商只要加一列」的程式,並能判斷 AI 產出的程式碼是否過度設計。
壹、開場情境:毛利底線改了,只改到一個地方
📌 以下為教學情境(依實務改編)。
鍵盤外銷公司決定把毛利底線從 15% 提高到 18%。IT 同仁把第 1.1 節程式最上方的 MIN_MARGIN 改成 0.18,回報「改好了」。
一週後的業務會議上,同一款 B 款鍵盤(毛利率 17.5%)出現了三種說法:
| 來源 | 15% 寫在哪裡 | 有沒有更新 | 對 B 款的判斷 |
|---|---|---|---|
| 報價表程式 | MIN_MARGIN 常數 |
✅ 已改成 18% | 🛑 低於底線 |
| 主管週報試算表 | 公式 =IF(E2<0.15, "不及格", "及格") |
❌ 沒人記得 | 及格 |
| AI 報價助理 | Prompt 中寫著「毛利率低於 15% 時提醒業務」 | ❌ 沒人記得 | 不提醒 |
業務說系統亮紅燈,主管說週報顯示及格,AI 助理也沒提醒。大家花了半小時爭論「到底哪個數字是對的」。
問題不是有人粗心,而是同一條商業規則被複製到三個地方,改的時候就一定會漏。
本節要解決的問題: 有哪些設計原則,能讓系統「改一處就全部生效」,而且「加新功能不必動舊功能」?
貳、為什麼會這樣:三組設計原則
1. DRY:一條規則只寫一次
DRY(Don't Repeat Yourself)出自 Andy Hunt 與 Dave Thomas 的《程式設計師修練之道》(The Pragmatic Programmer,1999):
每一項知識在系統中,都必須有單一、明確、權威的表示。
這個「唯一權威的位置」,常被稱為單一真實來源(SSOT, Single Source of Truth)。在企業裡,它對應到主資料管理:商品規格、價格、匯率、毛利底線,都應該只有一個正式來源,其他地方一律去那裡讀。
開場情境的病因,就是違反 DRY:15% 這項知識有三份副本。
2. SOLID:讓系統好改、好擴充的五條原則
SOLID 是 Robert C. Martin 整理的五條設計原則的字首縮寫。先抓住每條的商業意義即可:
| 原則 | 一句話 | 商業類比 | 違反時的徵兆 |
|---|---|---|---|
| S 單一職責 | 一個模組只對一個會要求它改變的角色負責 | 報價規則聽財務的,出貨規則聽物流的,不要混在同一份文件 | 財務改規則,結果出貨功能壞了 |
| O 開放封閉 | 加新功能時,用「新增」的方式,不用「修改」舊的核心 | 新增一家物流商,只要簽一份標準合約,不用重寫採購流程 | 每開一個新市場,就要改一次結帳程式 |
| L 里氏替換 | 同一類的東西必須遵守同一份約定,才能互相替換 | 任何物流商都必須提供報價、取件、追蹤碼 | 換了一家物流商,通知客戶的功能就壞了 |
| I 介面隔離 | 不要強迫使用者面對他用不到的東西 | 揀貨員只看訂單編號、貨號、儲位、數量 | 揀貨畫面塞了 30 個欄位,還包含客戶個資 |
| D 依賴反轉 | 核心商業邏輯不要綁死在特定工具上 | 定價規則不應該因為從 Excel 換成資料庫就要重寫 | 換一家雲端廠商,整個報價邏輯要重做 |
💡 介面隔離還有一個附帶好處:揀貨員看不到他不需要的客戶個資,也符合個資「最小必要」的精神(第 13 章會談到最小授權原則)。
3. KISS 與 YAGNI:夠用就好
- KISS(Keep It Simple, Stupid):一般認為出自洛克希德公司的工程師 Kelly Johnson,意思是設計要簡單到現場人員都能維修。
- YAGNI(You Aren't Gonna Need It):來自極限程式設計(XP),意思是「不要為還沒發生的需求預先寫程式」。
這兩條在 AI 時代特別重要。你只要求一個計算階梯折扣的小函式,AI 可能交出一整套多層架構、好幾個類別的程式。程式越複雜,你越難驗收,日後也越難改。
參、把規則寫下來:用原則檢查開場情境
| 問題 | 違反的原則 | 改善規格 |
|---|---|---|
| 15% 寫在程式、週報公式、AI Prompt 三個地方 | DRY | 在試算表新增「參數」分頁,毛利底線只寫在一個儲存格;程式、週報、AI 助理都從這裡讀 |
| 誰都能改那個儲存格 | 單一職責(誰負責這條規則?) | 指定財務主管為唯一負責人,其他人只能讀 |
| AI 助理的 Prompt 裡寫死了數字 | DRY | Prompt 改成「毛利底線請查詢參數表」,不寫死數字 |
| (沒人說) | 參數表讀不到或格式錯誤怎麼辦? | 停止判斷並告警,不要退回使用舊的 15% |
最後一列再次出現:讀不到正式來源時,用一個「保底數字」繼續做決策,比直接停下來更危險,因為沒人會發現系統其實在用過時的規則。
肆、讀一段程式:新增物流商,只要加一列
以下用「國際運費比價」示範開放封閉原則與 DRY。費率為教學假設,重量也做了簡化(實際快遞還要考慮材積重,見第 2.4 節)。
先看一個違反開放封閉原則的寫法,每多一家物流商就要改一次核心邏輯:
// ❌ 每新增一家物流商,就要回來改這個函式
function shippingFeeBad(carrier, kg) {
if (carrier === 'DHL') return 900 + 250 * Math.ceil(kg);
else if (carrier === 'FedEx') return 850 + 270 * Math.ceil(kg);
// 新增順豐?又要改這裡,而且可能不小心改壞 DHL 那一行
}
再看較好的寫法:費率集中在最上方一張表,計算邏輯只寫一次。
// ===== 商業規則:各物流商費率(新增物流商只要加一列,計算邏輯不用改)=====
const CARRIERS = {
DHL: { base: 900, perKg: 250 }, // 基本費 NT$ 900,每公斤 NT$ 250
FedEx: { base: 850, perKg: 270 },
};
// 計算運費:重量無條件進位到整數公斤(簡化版,未考慮材積重)
function shippingFee(carrier, kg) {
const rate = CARRIERS[carrier];
if (!rate) {
throw new Error(`未設定物流商「${carrier}」的費率,請先在 CARRIERS 新增`);
}
if (!(kg > 0)) {
throw new Error('重量必須是大於 0 的數字');
}
return rate.base + rate.perKg * Math.ceil(kg);
}
// 比價:列出每家物流商的運費
for (const name of Object.keys(CARRIERS)) {
console.log(name, shippingFee(name, 2.3));
}
執行結果(2.3 公斤進位為 3 公斤):DHL NT$ 1,650、FedEx NT$ 1,660。
🔍 驗收重點(不懂語法也能檢查) - 費率是不是集中在最上方的
CARRIERS,而不是散落在程式各處?(DRY) - 新增物流商時,需不需要改shippingFee函式本身?(開放封閉) - 遇到沒設定的物流商,程式是停下來報錯,還是默默回傳 0 元運費?
這段程式可以貼到瀏覽器的開發者主控台(Chrome 按 F12 →「Console」)或任何線上 JavaScript 執行環境直接跑。
伍、跑跑看、壞給你看
| 實驗 | 操作 | 預期結果 | 想想看 |
|---|---|---|---|
| ① 新增物流商 | 在 CARRIERS 加一列 SF: { base: 600, perKg: 300 }, |
多印出一行 SF NT$ 1,500,DHL、FedEx 結果不變 | 你有沒有動到 shippingFee? |
| ② 查詢未設定的物流商 | 在最後加一行 shippingFee('UPS', 2) |
停止並顯示「未設定物流商『UPS』的費率」 | 如果回傳 0,比價結果會變成什麼? |
| ③ 漏填重量 | 呼叫 shippingFee('DHL', '') |
停止並顯示「重量必須是大於 0 的數字」 | 業務最常漏填哪些欄位? |
| ④ 改重量 | 把 2.3 改成 5 | DHL NT$ 2,150、FedEx NT$ 2,200 | 重量變大後,哪家比較便宜? |
判斷看看:AI 給了你過度設計的程式
如果 AI 交出一套有十幾個類別的程式,只為了算一個運費,可以用這段 Prompt 要求它簡化:
這段程式對目前的需求來說太複雜了。請依照 KISS 與 YAGNI 原則重寫:
1. 只處理目前確定的需求:依物流商與重量計算運費。
2. 費率集中在程式最上方的一個常數表,新增物流商只要加一列。
3. 不要為「未來可能」的需求預留架構。
4. 遇到未設定的物流商或無效重量,停止並顯示中文錯誤訊息。
5. 程式碼控制在 30 行以內,附中文註解。
陸、回到情境
把毛利底線集中到「參數」分頁、由財務主管負責、程式與 AI 助理都從同一處讀取之後,下次調整底線只要改一個儲存格,報價表、週報、AI 助理會同時生效,會議上也不會再出現三種說法。
仍有限制:
| 限制 | 後果 | 在哪一節解決 |
|---|---|---|
| 參數分頁仍可能被有編輯權限的人修改 | 底線被偷偷調低 | 第 9 章 權限隔離與內部控制 |
| 本節只示範單一試算表內的 SSOT | 多個系統之間的主資料仍可能不一致 | 第 4.2 節 ERP 主檔設計、第 12 章 SSOT |
| 原則之間會互相拉扯(拆太細違反 KISS) | 過度套用原則,反而更複雜 | 以「目前真實的變動需求」為準 |
本節小結
- DRY:一條商業規則只寫在一個地方,其他地方都去那裡讀。
- SOLID 讓系統在業務變動時好改、好擴充;最常用到的是單一職責與開放封閉。
- KISS / YAGNI 是驗收 AI 產出時的檢查鏡:夠用就好,不為假想需求加複雜度。
- 讀不到正式規則時,要停止並告警,不要用舊數字繼續判斷。
柒、練習
- 改數字(5 分鐘):FedEx 把基本費調降到 NT$ 700。你需要改哪一行?2.3 公斤時,FedEx 和 DHL 哪家便宜?差多少?
- 加功能(20 分鐘):主管希望運費滿 NT$ 3,000 時打 9 折。請先寫出規格(折扣門檻與折扣率要放在哪裡?折扣後是否進位到整數元?),再修改程式,並用 5 公斤與 10 公斤各驗算一次。
- 管理反思(討論):許多公司的「毛利率」在業務部、行銷部、會計部各有一套 Excel 公式,每季開會都在爭論數字。這違反了本節哪一條原則?如果要建立單一真實來源,應該由哪個部門負責定義?為什麼?