在開發(fā)報(bào)表的階段,作為應(yīng)用負(fù)責(zé)人,你肯定遇到過如下的痛點(diǎn)吧:
含辛茹苦地寫完報(bào)表Mapping,開發(fā)人員卻不看文檔,要求你先講解一遍;
開發(fā)人員反復(fù)來回地確認(rèn)表和字段的含義、處理邏輯等,問的你一臉懵逼,只能默默地去修改文檔;
開發(fā)完成,進(jìn)入測(cè)試階段,想著一鍋香噴噴的米飯就要上桌了,打開一看,居然是熱騰騰的一鍋粥~;

以上問題之所以會(huì)發(fā)生,主要的罪魁禍?zhǔn)桩?dāng)然是你的Mapping,寫的有問題:
一堆文字描述,開發(fā)看起來,猶如吃了安眠藥,不想看;
抽數(shù)邏輯有遺漏或存在不清楚的點(diǎn),開發(fā)/測(cè)試需要反復(fù)確認(rèn)規(guī)則,浪費(fèi)大量時(shí)間;
簡(jiǎn)單的問題就口頭說規(guī)則,后續(xù)文檔沒有更新文檔,出現(xiàn)BUG后開始扯蛋...
那么,如何寫一份程序員愛看的報(bào)表Mapping?

將從以下6個(gè)原則來說:
1.規(guī)則的完整性。因?yàn)閷懗閿?shù)規(guī)則過程中,有時(shí)沒能把需求想清楚、或是會(huì)漏掉一些細(xì)節(jié),那么開發(fā)碰到問題就會(huì)問這點(diǎn)/場(chǎng)景/情況沒有考慮到,該如何處理?如果Mapping比較完整,偶爾有遺漏也還好,但如果非常不完整/經(jīng)常出現(xiàn)這種問題,那么開發(fā)慢慢就不愿意看這份Mapping文檔,會(huì)覺得看了也白看。因?yàn)楹芏嗉?xì)節(jié)都沒有寫清楚,那還不如就坐在旁邊碰到問題就問。所以完整性很重要,首先是體現(xiàn)你的專業(yè)性,其次是影響開發(fā)的進(jìn)度。
2.規(guī)則的準(zhǔn)確性。舉個(gè)栗子,比如說我們提供給用戶一份系統(tǒng)存量數(shù)據(jù)的手工補(bǔ)錄文檔,文檔列出了20個(gè)欄位,卻沒有標(biāo)識(shí)哪些欄位必輸或選輸、或是什么情況是必輸什么情況是選輸;再如,文檔中的A欄位我們寫出了長(zhǎng)度最多支持60位,那到底是支持60個(gè)英文字母呢還是60個(gè)漢字、萬一輸多了會(huì)怎么樣;再如,文檔中的B欄位與A欄位的長(zhǎng)度要求一樣,那么可能會(huì)寫同上,其實(shí)這樣也是不準(zhǔn)確的,因?yàn)樵陂_發(fā)眼中可能理解為B欄位與A欄位字段的值域一樣,所以為了避免產(chǎn)生歧義發(fā)生問題,必須要寫的更準(zhǔn)確些。
3.規(guī)則的清晰度。首先整個(gè)抽數(shù)規(guī)則的結(jié)構(gòu),該換行的換行、該分段的分段、該標(biāo)粗的標(biāo)粗,能夠讓開發(fā)或團(tuán)隊(duì)成員一眼就能抓住重點(diǎn),知道你的整體邏輯是什么樣的,比如以哪張表為主檔案進(jìn)行抽數(shù)、以什么樣的順序編碼性能更好、或是對(duì)性能有什么樣具體的要求(比如執(zhí)行時(shí)間不能超過1分鐘),而不是說報(bào)表重跑起來很快,不能用很快這樣的詞,更多是要使用數(shù)字。開發(fā)人員做起來才清楚,知道怎樣做才符合要求。
4.描述的簡(jiǎn)潔性。若是文字描述抽數(shù)邏輯時(shí),需要言簡(jiǎn)意賅。其一、開發(fā)不原意看一大堆字; 其二、廢話少一點(diǎn),因?yàn)橛袝r(shí)會(huì)情不自禁的寫上抽數(shù)用途等。所以要一二三點(diǎn)直接寫出邏輯,不要寫無意義的詞,否則沒法提高質(zhì)量。簡(jiǎn)潔很重要。
5.規(guī)則的穩(wěn)定型。其實(shí),抽數(shù)規(guī)則的穩(wěn)定性,與需求的理解離不開關(guān)系。經(jīng)常也會(huì)遇到報(bào)表同事吐槽,比如抽數(shù)規(guī)則改來改去。所以,無論是寫Mapping規(guī)則也好、還是進(jìn)行需求分析時(shí),最好是先將需求想清楚,與同事/領(lǐng)導(dǎo)審批、和用戶或IT確認(rèn)清楚,補(bǔ)充完復(fù)雜部分的抽數(shù)邏輯后再轉(zhuǎn)給開發(fā)。不過說回來,需求百分百不變是不可能的,比如人行下發(fā)了一封通知文件,每個(gè)人的解讀是不一樣的,用戶的理解也可能存在誤差,所以規(guī)則確認(rèn)后不要隨意變來變?nèi)ァ?/p>
6.能夠開發(fā)報(bào)表。即可執(zhí)行性,與第3點(diǎn)有點(diǎn)像。寫出來Mapping,別人看了知道該怎么開發(fā),不可有含糊點(diǎn),才有利于開發(fā)或測(cè)試。
END
歡迎關(guān)注Wx公眾號(hào):小代嘚吧嘚