3.1 設計思維:從餐巾紙塗鴉到系統拓撲與業務解耦

學完本節,你能夠:

  1. 用「輸入 → 黑盒子 → 輸出」描述一個模組,說出它的介面與實作分別是什麼。
  2. 判斷兩個模組之間是「高耦合」還是「低耦合」,並指出耦合發生在哪裡。
  3. 畫出一張包含使用者、核心服務、外部夥伴與資料的系統拓撲圖,並用它回答「改這裡會影響哪裡」。

壹、開場情境:只是插了一欄,整張報價表就壞了

📌 以下為教學情境(依實務改編)。

延續第 1.1 節的鍵盤外銷公司。業務主管覺得報價表少了「客戶名稱」,於是在 A 欄「產品名稱」右邊插入一欄,原本的 B~F 欄全部往右挪一格。

隔天業務按下「檢查報價毛利」:

原本的欄位 插欄後的位置 程式以為它是 結果
單位成本 (TWD) C 欄 歐元報價 判斷全部錯位
今日匯率 E 欄 毛利率(要寫入的欄) 匯率被清空
毛利率 F 欄 風控狀態(要寫入的欄) 被警告文字蓋掉

所有列都亮黃燈,而且匯率欄被程式覆寫成空白。主管只是想多記一個客戶名稱,卻弄壞了毛利防線。

問題不在主管,也不在程式碼有 bug,而在設計:1.1 節的程式寫死了「第 2 欄是成本、第 4 欄是匯率」,試算表的版面和計算邏輯綁在一起,動一處就壞一處。這種「改一處、全盤出錯」的系統,工程師稱為義大利麵式架構:所有東西像煮爛的麵條一樣纏在一起,找不到清楚的邊界。

本節要解決的問題: 怎麼把系統切成幾塊,讓每一塊可以獨立修改,而不會互相拖累?


貳、為什麼會這樣:三個基本設計觀念

1. 抽象:只看輸入和輸出

抽象的意思是:抓住核心特徵,暫時忽略與眼前決策無關的細節。

委託國際快遞把樣品從台中寄到法蘭克福時,你只在意輸入(重量、材積、起迄地、時效)和輸出(追蹤碼、送達狀態、運費帳單)。至於班機在哪裡轉機、分揀中心怎麼排班,你不需要知道,快遞公司也可以隨時改變做法。

flowchart LR I["輸入
重量、材積、起迄地、時效"] --> B["黑盒子:國際快遞服務
(航班、通關、分揀、派送)"] --> O["輸出
追蹤碼、送達狀態、運費帳單"]

在軟體裡,對外約定好的「輸入與輸出」叫介面(Interface),黑盒子裡的做法叫實作(Implementation)。只要介面不變,實作可以隨時替換,呼叫它的人完全不受影響。

2. 模組化:高內聚、低耦合

企業會按職能分部門,軟體也會按職責分模組。好的模組化有兩個指標:

指標 意思 企業組織的類比 1.1 報價表的例子
高內聚 一個模組只專心做一類事 財務部只管帳,不兼做行銷 「毛利檢查」只算毛利與亮燈,不處理匯率抓取
低耦合 模組之間的依賴少、明確、標準化 部門之間透過表單與流程往來,不直接改對方的帳 毛利檢查透過「欄位名稱」取資料,而不是記死欄位位置
flowchart LR subgraph BAD ["高耦合:彼此直接伸手"] A1["下單"] <-->|"直接改對方資料"| A2["庫存"] A2 <--> A3["財務"] A3 <--> A1 end subgraph GOOD ["低耦合:透過介面往來"] B1["下單"] -->|"介面:保留庫存"| B2["庫存"] B1 -->|"介面:開立請款"| B3["財務"] end

3. 資訊隱藏:只公開必要的東西

1972 年,David Parnas 在論文〈論模組拆分的準則〉中提出資訊隱藏:每個模組只對外公開最少必要的介面,把內部的資料結構與計算方式藏起來。

就像業務只需要知道「這筆預算核准了沒(是/否)」,不需要、也不應該直接翻閱總帳。藏起來的部分,日後修改時才不會牽連到別人。

開場情境的診斷

觀念 1.1 程式碼的現況 違反了什麼
介面 「第 2 欄是成本」是程式與試算表之間唯一的約定 這個約定藏在程式碼裡,使用者看不到,也不知道不能插欄
耦合 計算邏輯直接依賴欄位位置 版面一變,邏輯就壞
資訊隱藏 使用者改版面,等於改到程式的內部假設 內部細節沒有被隱藏

參、把規則寫下來:模組之間的「介面合約」

要降低耦合,就要把模組之間的約定明確寫出來。以報價表為例,把「程式與試算表的約定」從欄位位置改成欄位名稱:

原本的隱性約定 追問 明確的介面合約
第 2 欄是成本 使用者會不會插欄、搬欄? 程式依標題文字「單位成本 (TWD)」找欄位,位置不限
第 4 欄是匯率 誰能改標題? 標題列為合約的一部分,修改標題須通知負責人
(沒說) 找不到某個標題怎麼辦? 停止執行並跳出警告,不猜、不寫入任何資料

最後一列是重點:介面合約被破壞時,系統應該停下來告訴你,而不是悶著頭繼續算、把資料寫錯地方。

下面這段小函式示範「依標題找欄位」的做法(不需要現在就改 1.1 的程式,先理解觀念即可):

// 依「標題文字」找出欄位編號,而不是寫死第幾欄
function colOf(sheet, title) {
  const headers = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
  const idx = headers.indexOf(title);
  if (idx === -1) {
    // 合約被破壞:停止並告警,不要猜
    throw new Error(`找不到欄位「${title}」,請確認標題列沒有被修改`);
  }
  return idx + 1; // 試算表欄位從 1 開始編號
}

// 用法:const costCol = colOf(sheet, '單位成本 (TWD)');

🔍 驗收重點:找不到標題時,程式是停下來(throw),還是默默回傳一個預設欄位繼續跑?後者會把錯誤藏起來,比直接壞掉更危險。


肆、畫出系統拓撲圖

Dan Roam 在《餐巾紙的背面》提出:回答「在哪裡(Where)」的問題,最好的圖是地圖(第 2 章介紹過他的 6W 架構)。對系統來說,這張地圖就是系統拓撲圖:系統由哪些區塊組成、資料怎麼流動、邊界在哪裡。

以一家做 B2B 外銷的公司為例:

flowchart TD subgraph USER ["使用者"] C1["海外買家詢價頁"] C2["業務員報價表"] end subgraph CORE ["公司內部服務"] S1["訂單服務"] S2["匯率與關稅服務"] S3["物流服務"] DB[("交易資料庫")] end subgraph EXT ["外部夥伴"] E1["金流服務商"] E2["快遞貨態 API"] E3["關港貿單一窗口"] end USER --> S1 S1 --> S2 S1 --> S3 S1 --> DB S2 --> E3 S1 --> E1 S3 --> E2

💡 API(應用程式介面)就是兩個系統之間約定好的「服務窗口」:要送什麼資料過去、會拿回什麼結果。第 3.3 節會專門討論。

畫得出這張圖,你就能在會議上問出關鍵問題:

管理問題 在圖上怎麼看
這次的業務變更影響哪些模組? 找出變更落在哪個方塊,再沿著箭頭看誰依賴它
快遞 API 斷線,訂單會不會跟著停? 看訂單服務是「直接等待」物流回應,還是可以先接單、稍後補上
敏感資料經過哪些地方? 沿著通往資料庫的箭頭,逐一檢查誰有存取權

商管人不需要寫出每一行程式碼,但要能畫出、看懂這張圖,才能跟工程師討論「改這裡,會動到哪裡」。


伍、判斷看看:常見誤解

說法 對嗎? 說明
「模組切得越細越好」 ❌ 切太細,模組間的溝通成本會暴增。第 3.2 節的微服務就是這個取捨
「抽象就是講得很玄」 ❌ 抽象是刻意忽略跟當下決策無關的細節,反而讓事情更具體可談
「低耦合就是模組之間完全不溝通」 ❌ 是透過明確的介面溝通,而不是彼此直接伸手改對方的資料
「只要程式沒 bug,插一欄不會怎樣」 ❌ 開場情境的程式沒有 bug,壞掉的是隱性的介面約定

陸、回到情境

把「欄位位置」換成「欄位名稱」的介面合約後,主管再插入「客戶名稱」欄,程式依標題找到成本與匯率,照常運作;若有人改掉標題,程式會停下來告警,而不是把匯率覆寫掉。

這個做法仍有限制:

限制 後果 在哪一節解決
任何人都能改標題列 合約仍可能被無意破壞 第 9 章 權限與防護欄
報價、庫存、訂單仍擠在同一個試算表 資料越多,模組間的邊界越模糊 第 4.2 節 分頁拆分的 ERP 結構
只談了「怎麼切」,還沒談「切多細」 可能過度拆分 第 3.2 節 架構模式的取捨

本節小結

  1. 系統之所以「牽一髮動全身」,通常是因為模組之間存在沒寫出來的約定。
  2. 抽象讓你只看輸入與輸出;介面是對外的約定,實作可以隨時替換。
  3. 高內聚、低耦合、資訊隱藏,對應企業的分工、標準化流程與權限管理。
  4. 系統拓撲圖是商管人與工程師溝通的共同地圖。

柒、練習

  1. 找耦合(5 分鐘):打開 1.1 節的程式碼,找出所有「寫死欄位位置」的地方(提示:getRange 裡的數字)。如果把「歐元報價」搬到最後一欄,哪幾行會出錯?
  2. 畫拓撲圖(20 分鐘):以「連鎖超商會員點數折抵」為例,畫出三個模組(會員身分驗證、POS 收銀計價、總部行銷活動計點),並為每個模組寫出輸入與輸出。再標出:如果總部行銷系統斷線,收銀台還能不能結帳?
  3. 管理反思(討論):有些中小企業請外包把業務邏輯直接寫進資料庫裡,日後想加一個手機 App 卻得整套重做。請用「資訊隱藏」與「低耦合」解釋原因。如果你是老闆,簽外包合約時應該要求對方交付什麼文件?

國立臺中科技大學 國際貿易系 / 企業管理系 專用教材

《現代軟體工程:商學院的 AI 系統思維與 Agent 實踐》

作者:陳俊智 博士 Dr. Chun-Chih Chen

本書章節架構改編自陳鍾誠教授(金門大學)開源課程《現代軟體工程》(github.com/ccc115a/se,MIT 授權),內容針對商學院全面改寫與擴充。