作者：borisyang，騰訊 WXG 應(yīng)用開(kāi)發(fā)工程師

作為程序員，剛剛開(kāi)始學(xué)會(huì)寫(xiě)代碼，常常是接過(guò)需求就開(kāi)始擼代碼。有時(shí)候發(fā)現(xiàn)，寫(xiě)完代碼，需求變了。更多時(shí)候，覺(jué)得寫(xiě)業(yè)務(wù)代碼枯燥無(wú)聊，沒(méi)有技術(shù)含量。另外一邊的事實(shí)卻是，項(xiàng)目里面研發(fā)人數(shù)變多了，項(xiàng)目的質(zhì)量缺卻變低了，多人開(kāi)發(fā)也不過(guò)是一個(gè)個(gè)單打獨(dú)斗的組合而已。

1 研發(fā)環(huán)境日益成熟

經(jīng)歷過(guò) PC 互聯(lián)網(wǎng)的不斷深入發(fā)展，移動(dòng)互聯(lián)網(wǎng)的蓬勃生長(zhǎng)，互聯(lián)網(wǎng)進(jìn)入了成熟繁榮期，研發(fā)環(huán)境也發(fā)生了巨大變化；從原來(lái)一個(gè)人，一把鍵盤(pán)，寫(xiě)完代碼就上線，變成了更加規(guī)范的研發(fā)體系和更多人參與的共同協(xié)作。

研發(fā)流程不斷加速

為了盡可能提高需求交付速度，跟上市場(chǎng)的變化，我們通過(guò)不斷提搞軟件交付的速度，盡可能的，從需求，編碼實(shí)現(xiàn)，測(cè)試，發(fā)布的流程中不斷優(yōu)化，利用 CICD，加速迭代。

多人協(xié)作無(wú)處不在

現(xiàn)在的軟件開(kāi)發(fā)團(tuán)隊(duì)，即使再小，也有 2-3 人一起研發(fā)，更別提測(cè)試，運(yùn)維，運(yùn)營(yíng)，產(chǎn)品人員。一方面是軟件產(chǎn)品的競(jìng)爭(zhēng)日趨激烈，需求日益復(fù)雜，堆砌人力成了必然；另外一方面是專業(yè)性的要求，精密的行業(yè)自然要求精細(xì)化的職業(yè)劃分。

2 困局

研發(fā)流程的速度提上去了，團(tuán)隊(duì)的人也變多了，但是，需求變更依舊讓廣大研發(fā)同學(xué)感到痛苦，項(xiàng)目質(zhì)量還在日益變差。

需求變更之痛

需求變更的痛苦為難了廣大研發(fā)同學(xué)，前腳剛為了優(yōu)化性能，采用了 kv 存儲(chǔ)，后腳需求就變成了要支持模糊查詢；這是一種典型的架構(gòu)設(shè)計(jì)不合理，導(dǎo)致業(yè)務(wù)需求的實(shí)現(xiàn)方式受限。

更令人痛苦的，還有產(chǎn)品需求變動(dòng)多，今天簡(jiǎn)單實(shí)現(xiàn)下，上線看看效果，明天用戶脾氣很大提了個(gè)訴求，再加一個(gè)功能上線，產(chǎn)品功能變成補(bǔ)丁加補(bǔ)丁。一方面是研發(fā)同學(xué)渴望一個(gè)完整又嚴(yán)謹(jǐn)?shù)男枨?/strong>，提完需求進(jìn)入研發(fā)階段就不許改；另一方面是產(chǎn)品同學(xué)受到各方面的壓力，只希望先把主要問(wèn)題解決下，細(xì)枝末節(jié)以后再說(shuō)。

項(xiàng)目質(zhì)量變差

項(xiàng)目質(zhì)量變差，一部分歸功于補(bǔ)丁代碼的產(chǎn)生，迫于時(shí)間受限，先上一個(gè)補(bǔ)丁，卻打開(kāi)了破窗的先鋒，下一次，下一個(gè)同學(xué)就更敢于加補(bǔ)丁代碼。一個(gè)個(gè)臨時(shí)的 if else 不斷堆砌，最終導(dǎo)致了整個(gè)項(xiàng)目的代碼腐爛。我曾經(jīng)維護(hù)過(guò)一個(gè)代碼片段，超過(guò) 20 個(gè) if else，中間還有些過(guò)時(shí)的錯(cuò)誤注釋夾雜其中，維護(hù)起來(lái)令人苦不堪言。

項(xiàng)目代碼腐爛的另外一個(gè)原因是多人協(xié)作，團(tuán)隊(duì)的人越多，代碼反而變得越爛似乎成為了趨勢(shì)；為什么多人協(xié)作沒(méi)有提高代碼質(zhì)量呢？一方面，多人協(xié)作實(shí)際上只是分?jǐn)偟男枨髮?shí)現(xiàn)而已，大多數(shù)需求實(shí)現(xiàn)的分配中，反而盡可能將協(xié)作變少，避免實(shí)現(xiàn)受阻。另外一方面是，不同人的代碼模塊，設(shè)計(jì)意圖和代碼風(fēng)格也截然不同。維護(hù)前人代碼，如果沒(méi)有全局視角，了解設(shè)計(jì)意圖，也只能是往里面加補(bǔ)丁代碼了。

項(xiàng)目代碼腐爛容易導(dǎo)致程序員出現(xiàn)錯(cuò)覺(jué)，一是業(yè)務(wù)代碼沒(méi)什么料在里面，不如搞基礎(chǔ)建設(shè)；二是業(yè)務(wù)需求不可能完整又嚴(yán)謹(jǐn)，最終也會(huì)變來(lái)變?nèi)サ?#xff0c;最終質(zhì)量低下的鍋，一大半要給提需求的人。

3 怎么辦

在寫(xiě)代碼之前要進(jìn)行設(shè)計(jì)和建模。相比歷史短暫的 IT 行業(yè)，很多工業(yè)，建筑行業(yè)的精密性，都離不開(kāi)前期的設(shè)計(jì)，在分析設(shè)計(jì)之后，按照?qǐng)D紙規(guī)劃施工，寫(xiě)代碼也應(yīng)當(dāng)如此。

設(shè)計(jì)建模的有效性源于，一，重新回到業(yè)務(wù)的跑道，跟業(yè)務(wù)一致；二，設(shè)計(jì)建模才能讓協(xié)作真實(shí)有效；

為什么研發(fā)實(shí)現(xiàn)需求跟業(yè)務(wù)一致很重要呢？研發(fā)和業(yè)務(wù)需求的摩擦，本質(zhì)是研發(fā)實(shí)現(xiàn)跟實(shí)際需求不一致，無(wú)論是研發(fā)走偏了，沒(méi)有理解需求，還是需求本身不能滿足涉眾的利益，都會(huì)使得最終上線的功能需要回爐重造，折磨項(xiàng)目組的成員。業(yè)務(wù)項(xiàng)目，需求很重要，是整個(gè)項(xiàng)目質(zhì)量的源頭，源頭的問(wèn)題不處理好，會(huì)一直發(fā)散擴(kuò)大，問(wèn)題傳遞到尾部，甚至到了產(chǎn)品上線，對(duì)整體造成的損耗越大。從設(shè)計(jì)的語(yǔ)言上看，設(shè)計(jì)的層次有所不同，不僅僅有代碼細(xì)節(jié)上的設(shè)計(jì)，也有業(yè)務(wù)上高層次的設(shè)計(jì)，高層次的設(shè)計(jì)是用業(yè)務(wù)的術(shù)語(yǔ)去表達(dá)，最貼近業(yè)務(wù)實(shí)際情況，也能幫助研發(fā)同學(xué)發(fā)現(xiàn)業(yè)務(wù)中不合理的點(diǎn)。

設(shè)計(jì)建模為何能讓協(xié)作真實(shí)有效？我早先體驗(yàn)的協(xié)作流程，無(wú)非就是各自工作在自己的領(lǐng)域內(nèi)部，彼此盡量減少要協(xié)作的內(nèi)容，避免過(guò)多阻塞。研發(fā)側(cè)的協(xié)作，因?yàn)槿狈υO(shè)計(jì)，不好分工，另外一方面，多人寫(xiě)同一個(gè)模塊，也會(huì)引發(fā)沖突，所以更多將協(xié)作放在在 code review 上。但 code review 作用范圍也有限，一方面，review 成本較高，逐行閱讀代碼來(lái)厘清設(shè)計(jì)對(duì)代碼質(zhì)量要求很高，另一方面，review 時(shí)間節(jié)點(diǎn)往往發(fā)生較晚，臨近發(fā)布的時(shí)候，調(diào)整設(shè)計(jì)也不大可能。進(jìn)行設(shè)計(jì)建模能夠讓協(xié)作變得有效，一方面，設(shè)計(jì)建模前期是溝通和信息對(duì)齊，將協(xié)作的內(nèi)容提前，一方面，采用合適的圖形化工具，review 的成本是相對(duì)較低的。

4 怎么設(shè)計(jì)和建模

設(shè)計(jì)和建模分為好幾個(gè)部分

業(yè)務(wù)建模

總體上來(lái)說(shuō)，業(yè)務(wù)建模主要聚焦于分析涉眾利益，厘清業(yè)務(wù)流程。從工具上來(lái)說(shuō)，主要是用例圖，流程圖；從內(nèi)容上來(lái)說(shuō)，主要是找人（利益涉眾，系統(tǒng)執(zhí)行者），找業(yè)務(wù)實(shí)體（其余系統(tǒng)，相關(guān)的重要對(duì)象）。

分析涉眾利益

分析涉眾利益之前，需要找到涉眾，一般要經(jīng)歷以下步驟：

表格是一個(gè)很好的表達(dá)方式，我負(fù)責(zé)的一個(gè)商戶從第三方商城采購(gòu)刷臉設(shè)備，由倉(cāng)配系統(tǒng)配送設(shè)備的業(yè)務(wù)，可以表達(dá)如下：

愿景：將設(shè)備更多更快且準(zhǔn)確無(wú)誤成本低地賣給商戶。

一般而言，涉眾的利益是否被滿足直接決定了軟件產(chǎn)品的成功與否。而分析涉眾利益需要進(jìn)行詳細(xì)的調(diào)研，研發(fā)同學(xué)可以根據(jù)產(chǎn)品的調(diào)研看到對(duì)應(yīng)的涉眾，及其利益。

業(yè)務(wù)用例圖

知道了涉眾的利益之后，就要分析業(yè)務(wù)流程，并對(duì)現(xiàn)有的流程進(jìn)行改進(jìn)。軟件產(chǎn)品沒(méi)誕生之前，業(yè)務(wù)是如何被處理的，找到原來(lái)業(yè)務(wù)的處理方式則可以梳理出業(yè)務(wù)用例。

筆者負(fù)責(zé)的一個(gè)業(yè)務(wù)是向購(gòu)買設(shè)備的商戶配送設(shè)備，對(duì)于業(yè)務(wù)團(tuán)隊(duì)的實(shí)際業(yè)務(wù)來(lái)說(shuō)，用戶購(gòu)買設(shè)備有業(yè)務(wù)價(jià)值，業(yè)務(wù)用例如下：

物流公司和設(shè)備渠道商都是輔助購(gòu)買設(shè)備的執(zhí)行者，因此放到右邊。值得注意的是，業(yè)務(wù)用例要體現(xiàn)價(jià)值，雖然在實(shí)際業(yè)務(wù)流程中，商戶同時(shí)做了很多事情，比如簽收設(shè)備，但簽收設(shè)備不能反映業(yè)務(wù)價(jià)值，故而只有一個(gè)購(gòu)買設(shè)備的用例。

業(yè)務(wù)流程分析

了解了涉眾的利益并且畫(huà)出用例之后，需要分析業(yè)務(wù)流程，找到我們軟件系統(tǒng)能夠改進(jìn)的流程片段；完整的業(yè)務(wù)流程圖可能很龐大，需要關(guān)注的是其中最有可能影響涉眾利益的流程片段，如下為購(gòu)買設(shè)備業(yè)務(wù)流程中配送設(shè)備的流程片段，該片段不大符合涉眾利益；