在職場上，你永遠(yuǎn)想不到會碰到哪些奇葩的問題，甚至這些問題還很難有現(xiàn)成的答案。比如說，作者碰到的這個沒人敢動手的線上問題，其實(shí)有文檔，基本上都不會發(fā)生。

從產(chǎn)品感知層見底層資源構(gòu)建；

從產(chǎn)品設(shè)計方案見一代產(chǎn)品經(jīng)理心路歷程；

就差告訴程序員怎么寫代碼了！??！

一個沒有人敢動手的線上問題

2023年8月的一個工作日 ，被一個產(chǎn)品（支撐供應(yīng)鏈采購業(yè)務(wù)的算法系統(tǒng)）線上問題鬧得哭笑不得。

五手開發(fā)說自己沒有改過，還說看過這里的代碼邏輯復(fù)雜，說程序邏輯存在現(xiàn)狀本就會導(dǎo)致問題?？墒牵褪遣恢绬栴}出在哪里？（擱誰身上不來氣就算你贏）

消失的產(chǎn)品設(shè)計/技術(shù)文檔

懷念一手開發(fā)、一手測試，可惜走的走、散的散，就連產(chǎn)品團(tuán)隊自己也不清楚了。另外一個現(xiàn)狀就是，作為算法產(chǎn)品，其實(shí)有很多邏輯構(gòu)建+數(shù)據(jù)構(gòu)建的模型存在，這兩部分從領(lǐng)域劃分上其實(shí)要算到開發(fā)、技術(shù)團(tuán)隊，但是開發(fā)/技術(shù)團(tuán)隊向來不喜歡做文檔沉淀的，而這個過程產(chǎn)品團(tuán)隊沒有同步參與對齊，自然在產(chǎn)品相關(guān)的過程文檔中也看不到絲毫的蹤跡。最重要的結(jié)果就是，現(xiàn)在已經(jīng)沒有人能夠說得清楚當(dāng)時的邏輯到底是什么，也沒有文檔可以翻出來查看。

看清產(chǎn)品：由表及里，從里至外

無奈作為這個產(chǎn)品的四手產(chǎn)品經(jīng)理（1.0版本已經(jīng)是四五年前的事情了，負(fù)責(zé)的產(chǎn)品經(jīng)理換了好幾個），只好從產(chǎn)品的感知層開始（看交互界面的信息結(jié)構(gòu)設(shè)計、往下再看結(jié)構(gòu)層的業(yè)務(wù)邏輯）一層一層往下推測勾勒數(shù)據(jù)結(jié)構(gòu)，然后和數(shù)據(jù)庫進(jìn)行假設(shè)驗(yàn)證（拿到數(shù)據(jù)庫的查詢權(quán)限，在測試環(huán)境驗(yàn)證上層的邏輯和數(shù)據(jù)的過程對應(yīng)），確保推演邏輯沒問題。費(fèi)老大力氣，終于勾勒出來產(chǎn)品核心對象的大致數(shù)據(jù)結(jié)構(gòu)和關(guān)聯(lián)，幾個關(guān)鍵對象怎么構(gòu)建、更新，自然也就標(biāo)定出來了問題點(diǎn)對象。

但是面對五手開發(fā)，程序員自己對代碼邏輯畢竟不熟悉，結(jié)果依然是：不敢動！

好在又翻到歷史一次上線記錄出來，以前不是動過這里一次嘛?。ㄉ弦淮胃膭舆@個地方是這個程序員改的）輕車熟路，再來一次。這下開發(fā)有了信心，搞定??

為什么重要的東西不見了？

往往面對上述這種歷史問題，處理過程中是非常依賴到過去的文檔的，但正如上文所說，文檔往往也稀釋掉了很多冰山下內(nèi)容：比如核心對象的核心數(shù)據(jù)如何構(gòu)建？比如關(guān)聯(lián)對象間的數(shù)據(jù)關(guān)聯(lián)和更新邏輯？等等。雖然偏技術(shù)范疇，但個人認(rèn)為和產(chǎn)品設(shè)計文檔能夠結(jié)合在一起的話，對于一個敏捷團(tuán)隊來說絕對是功在千秋、利在當(dāng)代。

至于為什么會出現(xiàn)產(chǎn)品技術(shù)文檔、設(shè)計文檔的內(nèi)容缺失，個人認(rèn)為有兩個方面可以去嘗試思考：

第一點(diǎn)是個人工作習(xí)慣問題，不排除負(fù)責(zé)某個產(chǎn)品的產(chǎn)品經(jīng)理和開發(fā)者，包括測試大家對所有細(xì)節(jié)都了然于胸，但是卻沒有人愿意去把這些內(nèi)容用文字、用流程圖，甚至用一個簡單的圖形的方式沉淀記錄下來；在敏捷模式里面我們說，他們都缺少owner意識。

第二點(diǎn)就是作為產(chǎn)品文檔的維護(hù)者、設(shè)計者可能根本沒有意識到、沒有參與到、或者說沒有思考到當(dāng)然也不會介入到產(chǎn)品底層的數(shù)據(jù)和關(guān)鍵對象的構(gòu)建邏輯。這就一定會為未來產(chǎn)品也在維護(hù)過程中埋下隱患，造成業(yè)務(wù)團(tuán)隊、產(chǎn)品團(tuán)隊和開發(fā)團(tuán)隊之間的脫節(jié)。這種脫節(jié)往往會可能直接影響到業(yè)務(wù)，打破敏捷的這種開發(fā)節(jié)奏，增加大家的溝通、協(xié)作成本，影響到其他項(xiàng)目的一些正常進(jìn)度。更為可怕的是，打擊產(chǎn)品相關(guān)人員的信心，導(dǎo)致沒有人愿意或者敢去介入動這個產(chǎn)品，包括未來的升級都小心翼翼，生怕再往“搖搖欲墜”的大樓上再添一塊磚瓦，那么所有人都會傾向于找到時機(jī)，重新投入資源去重構(gòu)這個產(chǎn)品，可我們明明知道 這無疑就是資源的浪費(fèi)啊。

—————-（手動分割線）—————-

題外話，往往我們透過文檔，看一份文檔的寫作風(fēng)格、邏輯表述、與關(guān)鍵技術(shù)實(shí)現(xiàn)互為支撐的要求與預(yù)留，其實(shí)也窺探一二文檔創(chuàng)作者當(dāng)時的心路歷程，妙不可言。