如何寫一份程序員愛看的需求文檔?
上回分享的從需求到最終的解決方案,產(chǎn)品經(jīng)理該怎么做?得到了許多人的認(rèn)可,在這里,非常感謝大家的支持,同時也給筆者很大的信心,接下來分享的文章,希望大家能夠喜歡,enjoy~
產(chǎn)品經(jīng)理的生涯中,肯定遇到過如下的痛點吧:
1.含辛茹苦地寫完了需求文檔(PRD),開發(fā)人員卻將文檔束之高閣;
2.開發(fā)人員反復(fù)來回地確認(rèn)需求、細(xì)節(jié)邏輯等,問的你一臉懵逼,只能默默地去修改文檔;
3.開發(fā)完成,進(jìn)入測試階段,想著一鍋香噴噴的米飯就要上桌了,打開一看,居然是熱騰騰的一鍋粥~;
以上問題之所以會發(fā)生,主要的罪魁禍?zhǔn)桩?dāng)然是你的需求文檔:
1.文檔不簡潔明了,讀起來吃力,給到開發(fā),猶如給他們吃了安眠藥,開發(fā)當(dāng)然不愛看。
2.文檔的功能需求描述不清晰、邏輯不嚴(yán)謹(jǐn),開發(fā)需要反復(fù)確認(rèn)、浪費了大量時間,最后讓開發(fā)對你越來越不信任(產(chǎn)品狗,你過來,我保證不打死你……)。
3.沒有很好的把控進(jìn)度,項目跟不緊,中途容易出問題,產(chǎn)品難以達(dá)到預(yù)期。
那么,如何寫一份用戶體驗好、開發(fā)喜歡看、靠譜的需求文檔呢?筆者將從以下幾個方面展開闡述:
一、產(chǎn)品簡介
1.簡要說明產(chǎn)品的使用價值
- 我是誰(一兩句話寫清楚產(chǎn)品的身份)?
- 我有什么用(我是做什么的,我能提供什么服務(wù)等)?
- 為什么選擇我們(與競爭對手相比,我們產(chǎn)品的優(yōu)勢,核心競爭力是什么)?
2.目標(biāo)用戶、使用場景
- 產(chǎn)品的主要用戶群是誰?
- 用戶主要在什么場景下使用我們的產(chǎn)品。
二、行業(yè)概要
- 簡要闡述行業(yè)現(xiàn)狀
- 未來的發(fā)展趨勢
- 競爭對手情況分析
補(bǔ)充:如何快速了解一個行業(yè)?
1.通過艾瑞咨詢、易觀等網(wǎng)站查看行業(yè)的分析報告,深入了解整個產(chǎn)業(yè)的上下游結(jié)構(gòu);
2.通過商業(yè)模式畫布工具,分析行業(yè)主要玩家的商業(yè)模式
三、版本
按照版本來分類,點擊版本鏈接可進(jìn)入查看每個版本的文檔。
文檔的第一頁如下圖:
(一)、排期
每次的大版本開發(fā),最好對應(yīng)有一個排期表(與開發(fā)溝通確認(rèn)時間的安排),開發(fā)過程中,根據(jù)進(jìn)度情況,適當(dāng)調(diào)整時間安排。
開發(fā)人員可以根據(jù)自己負(fù)責(zé)的模塊,進(jìn)入排期詳情查看當(dāng)天的任務(wù),完成的模塊可以進(jìn)行標(biāo)記,如圖。
(二)、產(chǎn)品設(shè)計(重點)
1.實體關(guān)系圖
當(dāng)你做的產(chǎn)品是從0到1時,為了讓數(shù)據(jù)庫的開發(fā)人員更快速的了解你的產(chǎn)品,實體關(guān)系圖(E-R圖)將會發(fā)揮很大作用,數(shù)據(jù)庫的開發(fā)人員可以參考此圖來做數(shù)據(jù)表結(jié)構(gòu)的設(shè)計(具體這里就不說了,大家可以網(wǎng)上詳細(xì)了解E-R圖)。
廠家、經(jīng)銷商、客戶等這些都是屬于實體,實體包含的的屬性(字段)最好也要寫出來,如下圖舉例:
2.用戶角色權(quán)限表
涉及到角色和權(quán)限的,需要做一份全面的角色權(quán)限表格,方便開發(fā)人員參考。??
3.業(yè)務(wù)流程圖
通過業(yè)務(wù)流程圖,可以在大方向上知道產(chǎn)品的整體邏輯,業(yè)務(wù)流程圖拆解可以得到任務(wù)流程圖,任務(wù)流程圖拆解可以得到頁面流程圖。
4.全局說明
一些通用的控件、狀態(tài)等,不需要每次都說明,比如空數(shù)據(jù)、網(wǎng)絡(luò)異常、加載失敗、刷新狀態(tài)等等,只需說明一次即可。
5.需求、功能、交互說明
很多人在寫功能說明、交互說明時,總是會遺漏一些細(xì)節(jié),邏輯不嚴(yán)謹(jǐn)。從以下幾個維度去說明,將會讓你考慮的更加全面:
- 字段、字段說明、數(shù)據(jù)來源
- 前置條件、排序機(jī)制、刷新機(jī)制
- 狀態(tài)流轉(zhuǎn)(一個頁面可能有多個狀態(tài),需要說明)
- 交互操作(正常操作、異常操作)
下面,筆者將以一個頁面做舉例說明:
產(chǎn)品設(shè)計模塊里的結(jié)構(gòu)如圖:
(為了方面查看以及和視覺頁面的對照,每個頁面需要標(biāo)注編號)
(三)、非功能需求
1.埋點需求
頁面的打開率、按鈕點擊率等,如果需要記錄,則需要做說明。
埋點是數(shù)據(jù)分析的基礎(chǔ),建議使用“GrowingIO” 這個工具進(jìn)行可視化埋點,操作簡單、方便,能減少很多的工作量。
2.性能需求
請求數(shù)據(jù)的響應(yīng)時間要求、并發(fā)數(shù)要求等。
3.兼容性需求
系統(tǒng)版本的支持、多終端的支持、瀏覽器的支持等。
(四)、修改記錄
文檔的第二頁如下圖:
為了讓開發(fā)人員更方便的瀏覽,增強(qiáng)閱讀體驗,使用markdown語言來輔助寫需求文檔是最好不過了,瀏覽體驗會大大提升。
好了,本次分享到這里,感謝您的閱讀。
作者:dreamer,微信公眾號:拳頭產(chǎn)品
本文由 @dreamer 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載。
題圖來自Pexels,基于CC0協(xié)議
284595951@qq.com源文件能發(fā)我嗎?新手!可以支付報酬
請問有模板樣例嗎?比如里面的具體內(nèi)容怎么填寫等,m15500302302@163.com,初學(xué)者,不勝感激。
太不專業(yè)了
文章內(nèi)容不長,但是寫得很全面也很有價值!期待博主的新作!
有文檔模板嗎?
這個排期表你們會做進(jìn)度網(wǎng)絡(luò)圖嗎?會留有時間儲備做緩沖嗎?
搜不到作者的公眾號了,請問有新的公眾號嗎,想要文檔模板,謝謝!
#非技術(shù)出身產(chǎn)品經(jīng)理的技術(shù)溝通秘籍#
15天補(bǔ)齊程序/代碼、前端、后端、數(shù)據(jù)庫4大模塊基礎(chǔ)技術(shù)知識。助你日常溝通更順暢,產(chǎn)品設(shè)計不挖坑!
詳情戳>http://996.pm/7daXE 或咨詢起點學(xué)院蘑菇(wx:qdxymg)
這么好的需求文檔模板,居然都是圖片
關(guān)注了作者君的公眾號 幾篇文章都看過 內(nèi)容很實用 只是為什么后來都不更新了?
終于找到一個實用性強(qiáng)的了,之前看過好多篇,都說得模模糊糊的,這個只用看文章就知道以后要怎么做了
寫得真好
確實用圖表的形式畫出來看著比較清晰,很實用的文章。請問作者業(yè)務(wù)流程圖是用啥畫的啊
超級實用 謝謝作者
pitatensai@163.com
同求axure源文件 給我們ba作為參考 現(xiàn)在用word文檔亂寫一通 ba他自己也看不懂。。。。
實用,我服
很受用,有完整的下載地址么?求axure 源文件