當我們想用一張或幾張圖來描述我們的系統時，是不是經常遇到以下情況：
- 對著畫布無從下手、刪了又來？
- 如何用一張圖描述我的系統，并且讓產品、運營、開發都能看明白？
- 畫了一半的圖還不清楚受眾是誰？
- 畫出來的圖到底是產品圖功能圖還是技術圖又或是大雜燴？
- 圖上的框框有點少是不是要找點兒框框加進來？
- 布局怎么畫都不滿意……
如果有同樣的困惑，本文將介紹一種畫圖的方法論，來讓架構圖更清晰，
先厘清一些基礎概念
1、什么是架構？
架構就是對系統中的物體以及物體之間的關系所進行的抽象描述，是一系列的決策，
架構是結構和愿景，
系統架構是概念的體現，是對物/資訊的功能與形式元素之間的對應情況所做的分配，是對元素之間的關系以及元素同周邊環境之間的關系所做的定義，
做好架構是個復雜的任務，也是個很大的話題，本篇就不做深入了，有了架構之后，就需要讓干系人理解、遵循相關決策，
2、什么是架構圖？
系統架構圖是為了抽象地表示軟體系統的整體輪廓和各個組件之間的相互關系和約束邊界，以及軟體系統的物理部署和軟體系統的演進方向的整體視圖，
3、架構圖的作用
一圖勝千言，要讓干系人理解、遵循架構決策，就需要把架構資訊傳遞出去，架構圖就是一個很好的載體，那么，畫架構圖是為了：
- 解決溝通障礙
- 達成共識
- 減少歧義
4、架構圖分類
搜集了很多資料，分類有很多，有一種比較流行的是4+1視圖，分別為場景視圖、邏輯視圖、物理視圖、處理流程視圖和開發視圖，
★ 場景視圖
場景視圖用于描述系統的參與者與功能用例間的關系，反映系統的最終需求和互動設計，通常由用例圖表示，
★ 邏輯視圖
邏輯視圖用于描述系統軟體功能拆解后的組件關系，組件約束和邊界，反映系統整體組成與系統如何構建的程序，通常由UML的組件圖和類圖來表示，
★ 物理視圖
物理視圖用于描述系統軟體到物理硬體的映射關系，反映出系統的組件是如何部署到一組可計算機器節點上，用于指導軟體系統的部署實施程序，
★ 處理流程視圖
處理流程視圖用于描述系統軟體組件之間的通信時序，資料的輸入輸出，反映系統的功能流程與資料流程,通常由時序圖和流程圖表示，
★ 開發視圖
開發視圖用于描述系統的模塊劃分和組成，以及細化到內部包的組成設計，服務于開發人員，反映系統開發實施程序，
以上 5 種架構視圖從不同角度表示一個軟體系統的不同特征，組合到一起作為架構藍圖描述系統架構，
怎樣的架構圖是好的架構圖
上面的分類是前人的經驗總結，圖也是從網上摘來的，那么這些圖畫的好不好呢？是不是我們要依葫蘆畫瓢去畫這樣一些圖？
先不去管這些圖好不好，我們通過對這些圖的分類以及作用，思考了一下，總結下來，我們認為，在畫出一個好的架構圖之前， 首先應該要明確其受眾，再想清楚要給他們傳遞什么資訊 ，所以，不要為了畫一個物理視圖去畫物理視圖，為了畫一個邏輯視圖去畫邏輯視圖，而應該根據受眾的不同，傳遞的資訊的不同，用圖準確地表達出來，最后的圖可能就是在這樣一些分類里，那么，畫出的圖好不好的一個直接標準就是：受眾有沒有準確接收到想傳遞的資訊，
明確這兩點之后，從受眾角度來說，一個好的架構圖是不需要解釋的，它應該是自描述的，并且要具備一致性和足夠的準確性，能夠與代碼相呼應，
畫架構圖遇到的常見問題
1、方框代表什么？
為什么適用方框而不是圓形，它有什么特殊的含義嗎？隨意使用方框或者其它形狀可能會引起混淆，
2、虛線、實線什么意思？箭頭什么意思？顏色什么意思？
隨意使用線潭訓者箭頭可能會引起誤會，
3、運行時與編譯時沖突？層級沖突？
架構是一項復雜的作業，只使用單個圖表來表示架構很容易造成莫名其妙的語意混亂，
本文推薦的畫圖方法
C4 模型使用容器（應用程式、資料存盤、微服務等）、組件和代碼來描述一個軟體系統的靜態結構，這幾種圖比較容易畫，也給出了畫圖要點，但最關鍵的是，我們認為，它明確指出了每種圖可能的受眾以及意義，
下面的案例來自C4官網，然后加上了一些我們的理解，來看看如何更好的表達軟體架構
1、語境圖(System Context Diagram)
這是一個想象的待建設的互聯網銀行系統，它使用外部的大型機銀行系統存取客戶賬戶、交易資訊，通過外部電郵系統給客戶發郵件，可以看到，非常簡單、清晰，相信不需要解釋，都看的明白，里面包含了需要建設的系統本身，系統的客戶，和這個系統有互動的周邊系統，
★ 用途
這樣一個簡單的圖，可以告訴我們，要構建的系統是什么；它的用戶是誰，誰會用它，它要如何融入已有的IT環境，這個圖的受眾可以是開發團隊的內部人員、外部的技識訓非技術人員，即：
- 構建的系統是什么
- 誰會用它
- 如何融入已有的IT環境
★ 怎么畫
中間是自己的系統，周圍是用戶和其它與之相互作用的系統，這個圖的關鍵就是梳理清楚待建設系統的用戶和高層次的依賴，梳理清楚了畫下來只需要幾分鐘時間，
2、容器圖(Container Diagram)
容器圖是把語境圖里待建設的系統做了一個展開，
上圖中，除了用戶和外圍系統，要建設的系統包括一個基于javaspring mvc的web應用提供系統的功能入口，基于xamarin架構的手機app提供手機端的功能入口，一個基于java的api應用提供服務，一個mysql資料庫用于存盤，各個應用之間的互動都在箭頭線上寫明了，
看這張圖的時候，不會去關注到圖中是直角方框還是圓角方框，不會關注是實線箭頭還是虛線箭頭，甚至箭頭的指向也沒有引起太多注意，
我們有許多的畫圖方式，都對框、線的含義做了定義，這就需要畫圖的人和看圖的人都清晰的理解這些定義，才能讀全圖里的資訊，而現實是，這往往是非常高的一個要求，所以，很多圖只能看個大概的含義，
★ 用途
這個圖的受眾可以是團隊內部或外部的開發人員，也可以是運維人員，用途可以羅列為：
- 展現了軟體系統的整體形態
- 體現了高層次的技術決策
- 系統中的職責是如何分布的，容器間的是如何互動的
- 告訴開發者在哪里寫代碼
★ 怎么畫
用一個框圖來表示，內部可能包括名稱、技術選擇、職責，以及這些框圖之間的互動，如果涉及外部系統，最好明確邊界，
3、組件圖(Component Diagram)
組件圖是把某個容器進行展開，描述其內部的模塊，
★ 用途
這個圖主要是給內部開發人員看的，怎么去做代碼的組織和構建，其用途有：
- 描述了系統由哪些組件/服務組成
- 厘清了組件之間的關系和依賴
- 為軟體開發如何分解交付提供了框架
4、類圖(Code/Class Diagram)
這個圖很顯然是給技術人員看的，比較常見，就不詳細介紹了，
案例分享
下面是內部的一個實時資料工具的架構圖，作為一個應該自描述的架構圖，這里不多做解釋了，如果有看不明白的，那肯定是還畫的不夠好，
畫好架構圖可能有許多方法論，本篇主要介紹了C4這種方法，C4的理論也是不斷進化的，但不論是哪種畫圖方法論，我們回到畫圖初衷，更好的交流，我們在畫的程序中不必被條條框框所限制，簡而言之，畫之前想好：畫圖給誰看，看什么，怎么樣不解釋就看懂，
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/88192.html
標籤：其他
上一篇：查看包名和Activity