← 全部概念地圖
標準

概念地圖・Kruchten 4+1 架構視圖

分類:創新

這一頁不只是把一個概念解釋一遍——一張自己畫的結構圖,加上拿台灣情境從頭走一次的實例演練、這個框架什麼時候會騙你,以及它接回 P.A.I.N. 之後長什麼樣。一頁必須交付的三層 →

4+1 架構視圖:同一情境,查出設計接縫

消防器材售服員在地下室按下送出,手機亮起完成,辦公室的服務單仍停在待回報。開發者翻程式,維運者查主機,主管問「到底送到了沒有」——三個人盯著同一套系統,手上的圖各講各的。Kruchten 4+1 架構視圖把功能、執行、程式碼與部署分開描述,再讓一組重要情境穿過它們。像這次斷線回報,只要沿路追問,哪個完成條件被漏掉,就會露出接縫。

Kruchten 4+1:中央情境回查四種架構視圖 四角依序放邏輯、開發、程序與實體視圖,中央金色方框代表情境。四支紅箭頭從中央分別指向外側方框,表示用同一情境回查四個問題。通用示例是兩人同買最後一件:邏輯看庫存保留,開發看模組依賴,程序看並行同步,實體看程序與節點的配置。方框位置沒有開發先後的意思。 同一套系統,按關注問題切換看法 邏輯視圖 Logical 功能由哪些概念合作 訂單、品項、庫存保留 回答:業務規則與關係 開發視圖 Development 原始碼如何分組與依賴 訂單模組依賴庫存介面 回答:修改與建置邊界 程序視圖 Process 執行中如何並行與同步 接單程序、庫存程序 回答:競爭、鎖定與訊息順序 實體視圖 Physical 程序配置在哪些節點 運算節點、連線、備援 回答:部署與故障邊界 +1 情境 Scenarios 兩人同買最後一件 紅箭頭=從情境回查;四個視圖並存,位置不代表先後
中央那件事要在四個看法裡都接得起來;任何一處斷掉,就回去修那個決策。

四個視圖換問題,情境負責串接

Kruchten 的 1995 年原始論文把四個視圖配上一組重要情境,讓不同角色各自找到需要的資訊。這裡將圖上的問題翻成評審時講得出口的話。

視圖看什麼圖上示例評審要找的證據
邏輯功能所需的關鍵抽象與關係訂單、品項、庫存保留最後一件的保留規則由誰負責
程序執行中的並行、同步與溝通接單程序與庫存程序同時下單如何避免重複保留
開發原始碼模組的組織與依賴訂單模組與庫存介面保留規則改動會牽動哪些模組
實體軟體在硬體或運算節點上的配置節點、連線與備援程序配置在哪裡,斷線會截斷哪一步
+1 情境重要使用案例的一段具體互動兩人同買最後一件同一條路徑能回指四個視圖的決策

一個原始碼模組可能參與多個執行程序,一個程序也可能載入多個模組。【打個比方:同一本樂譜可以交給兩組樂手演奏,兩組人也能站在同一個舞台。】模組像樂譜,程序像正在演奏的人,部署要交代舞台在哪裡——硬把三者畫成一對一,重啟與交接時就會開始認錯對象。

評審時沿著同一筆回報追五站

一、先寫清楚業務上的完成。服務單的「技師填完」「手機存下」「辦公室可見」可能是不同狀態。邏輯視圖得替它們取名、定轉換條件,派工窗口才能知道哪一步可以接手。自問:使用者看到完成時,業務上哪個承諾已經成立?

二、挑一個會同時發生的衝突。技師重送、內勤改單,兩件事可能撞在一起。程序視圖要找出誰讀、誰寫、如何協調;每支箭頭旁寫上訊息與等待條件——「有串接」還太粗。自問:兩個操作同時碰到這筆資料時,由誰決定有效結果?

三、追到真的要改的原始碼。回報格式由手機與伺服器共用,改一個欄位就可能讓舊版手機送不上來。開發視圖應留下模組依賴與維護責任,接手的人才知道去哪裡改、找誰覆核。檢查:替這次規則變更圈出必改模組,再核對版本相容的安排。

四、沿著連線剪一次。手機、接收程序與儲存服務各在什麼節點?把地下室的網路切掉,再把伺服器回覆那段切掉,實體視圖應能指出資料當時停在哪裡。自問:某個節點或連線失效後,哪一份資料還留得住?

五、讓情境帶著結果走完。「送出回報」太短。補上起始狀態、操作、故障與預期結果,逐步回查前四站。重要情境可在設計初期逼出缺漏,後續也能拿來驗證架構。自問:這段互動的每一步,都指得出負責的概念、程序、模組與節點嗎?

消防器材售服的斷線回報,走一遍

底下這家台灣中部的消防器材售服公司,是為了把這個結構講清楚而編出來的示意情境,沒有指涉任何真實公司。

實例演練
  • 情境先釘住:接收端已保存回報,回覆在半路斷掉;手機沒收到確認,又傳了一次同樣內容。兩次傳送,業務上只應留一筆回報
  • 邏輯:服務單另有回報紀錄,回報使用固定識別碼。完成條件訂為接收端確認已保存;手機在確認之前顯示待同步。內勤與技師終於用同一個完成定義
  • 程序:手機的同步程序可重送,伺服器的接收程序依識別碼辨認同一筆。即使重送同時抵達,儲存端仍須保證只建立一筆,並回傳既有結果。只在畫面上鎖住按鈕,還漏掉自動重送
  • 開發:手機的本機待送模組、共用回報格式、伺服器的接收模組,各標出依賴與維護者。識別碼與狀態欄位的變更要一起覆核。換人接手時,有具體邊界可查
  • 實體:待送資料留在手機的持久儲存,接收程序與正式紀錄存放位置另行標明。圖上圈出手機到伺服器的連線,再測回覆中斷與手機重啟。故障測試跟著資料位置走

這次演練從開頭那個「完成」往下追,找到的是確認回覆的缺口。伺服器真的存過了,手機仍不知道;直接把畫面改回成功,會讓尚未送達的另一種故障也被蓋掉。固定識別碼讓重送沿用同一筆身分,待同步狀態讓技師知道還要等哪個確認——兩項決策跨過了功能、執行、程式碼與部署。接下來才輪到測試:保存後切斷回覆、讓手機重送,核對辦公室看到的紀錄與手機顯示。若圖寫得完整、操作仍生出重複紀錄,就把測試結果帶回程序與儲存安排重查。以上為說明結構用的示意情境,僅供理解框架之用。

這組視圖什麼時候會騙你

  1. 把四個看法排成四個開發階段。「邏輯簽完才談程序」會把關鍵限制拖到後面。回報的完成狀態與斷線處理會互相牽動,開發期間需要來回修改——若某種部署讓原先的確認條件做不到,就回頭修那個條件,留下取捨理由。
  2. 中央只放最順的一條路。成功送達的演示很容易五張圖都過。舊版手機、同時修改、回覆遺失這些情境,才可能逼出不同的架構決策。挑選時寫下它的重要性:發生頻率、損失或無法補救的後果,免得情境全由展示方便程度決定。
  3. 圖畫通就算驗證完成。線條可以把等待畫得很乾淨,實際的重送順序、版本差異與儲存行為仍要測。替每個關鍵情境保留測試結果,註明適用版本。文件更新若總落後程式,下一位接手者會照著舊路徑查故障——越查越遠。

用痛點的眼光挑驗證情境

痛點視角

情境挑的是誰的麻煩,工程時間就會沿著那條路流過去。

中央那格若只寫主管要看的完整報表,開發者就會把報表那條路驗得很細。售服員蹲在地下室重打回報的時間,得先進入情境,才會得到設計上的位置。這張圖畫得出四種架構決策如何接上一次操作,畫不出那次操作值得替誰省下多少麻煩。P.A.I.N. 要補的是這個選擇的依據:誰正在卡、反覆卡在哪、他怎麼補救、誰會為改善付費。今晚翻最近一次服務回報,挑一筆曾讓技師重填、內勤重問的紀錄,把當時的操作順序交給雙方核對;等他們認出那次麻煩,再把它放到中央當下一輪評審情境。

4+1 架構視圖,常見問題

邏輯、程序、開發、實體視圖差在哪?

用一筆回報來記:邏輯先定義回報與完成狀態;程序處理傳送、接收與同時寫入;開發指向要修改的原始碼模組;實體標明手機、伺服器與連線上的配置。尤其「程序」指執行中的程序與執行緒,重點在並行和同步,單列一張業務步驟表還不夠。

為什麼叫加一?情境只能選一個嗎?

加一代表情境這個視圖,重要情境可以有多個。它把前四個看法中的元素串成一段互動,設計時可用來找元素與責任,完成後可回頭檢查。同一回報可分成正常送達、回覆遺失、舊版手機三段情境,各自留下預期結果。

小系統也一定要畫五張圖嗎?

原始論文允許省略沒有用途的視圖,小系統的邏輯與開發描述也可能合併。本文建議先列要做的決策,再決定需要幾張圖。只有單一程序與簡單部署時,可以簡短交代執行和配置;情境仍要留著,用它檢查使用者的操作承諾。

4+1 與 C4 可以一起用嗎?

可以。C4 官方模型用系統、容器、元件與程式碼做層級描述,也提供動態與部署圖。4+1 按關注問題切視圖;採用時可借用 C4 的圖法表達相關部分,再逐項核對所需資訊。四層與四視圖沒有固定的一對一配對。

架構上的接縫露出來之後,交付工作還得有人接住。《鳳凰專案》把開發與維運之間的等待攤開;中央情境要向使用者蒐集過去的行為,《媽媽測試》能幫你問得更具體。圖的尺度需要重排時,再對照C4 架構四層,替下一場評審挑合適的放大倍率。

發現引用或事實有誤?請寫信回報,我會依更正政策修正。