「專業規劃師 Jack 說:工程師 20% 時間應用於規劃。隨經驗增長,我愈發認同。個人驅動的規劃能極大提升生產率與效率,並通過均衡活動減輕壓力。」
可惜許多組織將規劃形式化、文檔化,喪失了規劃的靈活性與實效性。
核心特徵:系統開發缺乏架構規範。架構師憑藉過往經驗主觀判斷,認為文檔多餘,導致關鍵決策未顯性化、未評審、未傳遞。
| 領域 | 缺失內容示例 |
|---|---|
| 軟件架構與規範 | 語言版本、庫選型、編碼標準、內存管理策略、異常處理規約、日誌規範 |
| 硬件架構 | 客戶端/服務端配置、部署拓撲、擴展性邊界、災備架構 |
| 通信架構 | 網絡協議選型、設備互操作性、頻寬預算、安全傳輸、服務發現機制 |
| 持久化架構 | 數據庫選型、ORM 策略、分庫分表規則、緩存一致性、備份恢復 RPO/RTO |
| 應用安全架構 | 線程模型、認證授權體系、信任邊界、數據加密標準、審計日誌 |
| 系統管理架構 | 監控指標、告警分級、部署流水線、配置管理、變更控制流程 |
核心原則:以有組織方式定義系統,依賴多視圖建模。每個視圖代表一類利益相關者關注點,輕量級圖表+表格+規範說明,保證一致性。
| 視圖 | 關注點 | 典型產出 |
|---|---|---|
| 開發視圖 | 模塊劃分、依賴關係、技術棧 | 包圖、組件圖、技術選型文檔 |
| 部署視圖 | 硬件拓撲、網絡劃分、容器編排 | 部署圖、基礎設施即代碼 |
| 運行視圖 | 進程通信、線程模型、狀態流轉 | 序列圖、狀態機、併發模型文檔 |
| 安全視圖 | 信任邊界、認證鏈、加密標準 | 威脅建模、安全架構圖 |
| 數據視圖 | 實體關係、數據流、一致性邊界 | ER 圖、數據字典、遷移腳本 |
1. 建立參考架構 v1.0
└─ 包含首個產品迭代可實施的強策略(技術棧鎖定、核心模塊劃分、關鍵非功能需求滿足方案)
2. 首個產品開發期間
└─ 實踐驗證架構決策
└─ 發現偏差、補充細節、修正錯誤
3. 發布參考架構 v1.1, v1.2...
└─ 增量精煉,以產品演進驅動架構演進
4. 持續治理
└─ 架構評審會、技術債務清單、演進路線圖

/docs/adr「實現主體架構」反模式揭示了隱性經驗無法替代顯性架構的鐵律。通過多視圖建模、迭代式演進、ADR 治理,將架構從「大腦裡的圖紙」轉化為「團隊共享的契約」,是從工匠作坊走向工程化交付的關鍵一步。