如何寫一份程序員愛看的需求文檔?

56 評論 247301 瀏覽 1829 收藏 9 分鐘

上回分享的從需求到最終的解決方案,產(chǎn)品經(jīng)理該怎么做?得到了許多人的認可,在這里,非常感謝大家的支持,同時也給筆者很大的信心,接下來分享的文章,希望大家能夠喜歡,enjoy~

產(chǎn)品經(jīng)理的生涯中,肯定遇到過如下的痛點吧:

1.含辛茹苦地寫完了需求文檔(PRD),開發(fā)人員卻將文檔束之高閣;

2.開發(fā)人員反復(fù)來回地確認需求、細節(jié)邏輯等,問的你一臉懵逼,只能默默地去修改文檔;

3.開發(fā)完成,進入測試階段,想著一鍋香噴噴的米飯就要上桌了,打開一看,居然是熱騰騰的一鍋粥~;

以上問題之所以會發(fā)生,主要的罪魁禍首當(dāng)然是你的需求文檔:

1.文檔不簡潔明了,讀起來吃力,給到開發(fā),猶如給他們吃了安眠藥,開發(fā)當(dāng)然不愛看。

2.文檔的功能需求描述不清晰、邏輯不嚴謹,開發(fā)需要反復(fù)確認、浪費了大量時間,最后讓開發(fā)對你越來越不信任(產(chǎn)品狗,你過來,我保證不打死你……)。

3.沒有很好的把控進度,項目跟不緊,中途容易出問題,產(chǎn)品難以達到預(yù)期。

那么,如何寫一份用戶體驗好、開發(fā)喜歡看、靠譜的需求文檔呢?筆者將從以下幾個方面展開闡述:

一、產(chǎn)品簡介

1.簡要說明產(chǎn)品的使用價值

  • 我是誰(一兩句話寫清楚產(chǎn)品的身份)?
  • 我有什么用(我是做什么的,我能提供什么服務(wù)等)?
  • 為什么選擇我們(與競爭對手相比,我們產(chǎn)品的優(yōu)勢,核心競爭力是什么)?

2.目標用戶、使用場景

  • 產(chǎn)品的主要用戶群是誰?
  • 用戶主要在什么場景下使用我們的產(chǎn)品。

二、行業(yè)概要

  • 簡要闡述行業(yè)現(xiàn)狀
  • 未來的發(fā)展趨勢
  • 競爭對手情況分析

補充:如何快速了解一個行業(yè)?

1.通過艾瑞咨詢、易觀等網(wǎng)站查看行業(yè)的分析報告,深入了解整個產(chǎn)業(yè)的上下游結(jié)構(gòu);

2.通過商業(yè)模式畫布工具,分析行業(yè)主要玩家的商業(yè)模式

三、版本

按照版本來分類,點擊版本鏈接可進入查看每個版本的文檔。

文檔的第一頁如下圖:

(一)、排期

每次的大版本開發(fā),最好對應(yīng)有一個排期表(與開發(fā)溝通確認時間的安排),開發(fā)過程中,根據(jù)進度情況,適當(dāng)調(diào)整時間安排。

開發(fā)人員可以根據(jù)自己負責(zé)的模塊,進入排期詳情查看當(dāng)天的任務(wù),完成的模塊可以進行標記,如圖。

(二)、產(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)上詳細了解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.需求、功能、交互說明

很多人在寫功能說明、交互說明時,總是會遺漏一些細節(jié),邏輯不嚴謹。從以下幾個維度去說明,將會讓你考慮的更加全面:

  • 字段、字段說明、數(shù)據(jù)來源
  • 前置條件、排序機制、刷新機制
  • 狀態(tài)流轉(zhuǎn)(一個頁面可能有多個狀態(tài),需要說明)
  • 交互操作(正常操作、異常操作)

下面,筆者將以一個頁面做舉例說明:

產(chǎn)品設(shè)計模塊里的結(jié)構(gòu)如圖:

(為了方面查看以及和視覺頁面的對照,每個頁面需要標注編號)

(三)、非功能需求

1.埋點需求

頁面的打開率、按鈕點擊率等,如果需要記錄,則需要做說明。

埋點是數(shù)據(jù)分析的基礎(chǔ),建議使用“GrowingIO” 這個工具進行可視化埋點,操作簡單、方便,能減少很多的工作量。


2.性能需求

請求數(shù)據(jù)的響應(yīng)時間要求、并發(fā)數(shù)要求等。


3.兼容性需求

系統(tǒng)版本的支持、多終端的支持、瀏覽器的支持等。

(四)、修改記錄

文檔的第二頁如下圖:

為了讓開發(fā)人員更方便的瀏覽,增強閱讀體驗,使用markdown語言來輔助寫需求文檔是最好不過了,瀏覽體驗會大大提升。

好了,本次分享到這里,感謝您的閱讀。

 

作者:dreamer,微信公眾號:拳頭產(chǎn)品

本文由 @dreamer 原創(chuàng)發(fā)布于人人都是產(chǎn)品經(jīng)理。未經(jīng)許可,禁止轉(zhuǎn)載。

題圖來自Pexels,基于CC0協(xié)議

更多精彩內(nèi)容,請關(guān)注人人都是產(chǎn)品經(jīng)理微信公眾號或下載App
評論
評論請登錄
  1. 284595951@qq.com源文件能發(fā)我嗎?新手!可以支付報酬

    來自湖南 回復(fù)
  2. 請問有模板樣例嗎?比如里面的具體內(nèi)容怎么填寫等,m15500302302@163.com,初學(xué)者,不勝感激。

    來自吉林 回復(fù)
  3. 太不專業(yè)了

    來自福建 回復(fù)
  4. 文章內(nèi)容不長,但是寫得很全面也很有價值!期待博主的新作!

    回復(fù)
  5. 有文檔模板嗎?

    來自安徽 回復(fù)
  6. 這個排期表你們會做進度網(wǎng)絡(luò)圖嗎?會留有時間儲備做緩沖嗎?

    來自安徽 回復(fù)
  7. 搜不到作者的公眾號了,請問有新的公眾號嗎,想要文檔模板,謝謝!

    來自浙江 回復(fù)
  8. #非技術(shù)出身產(chǎn)品經(jīng)理的技術(shù)溝通秘籍#
    15天補齊程序/代碼、前端、后端、數(shù)據(jù)庫4大模塊基礎(chǔ)技術(shù)知識。助你日常溝通更順暢,產(chǎn)品設(shè)計不挖坑!
    詳情戳>http://996.pm/7daXE 或咨詢起點學(xué)院蘑菇(wx:qdxymg)

    來自廣東 回復(fù)
  9. 這么好的需求文檔模板,居然都是圖片

    來自上海 回復(fù)
  10. 關(guān)注了作者君的公眾號 幾篇文章都看過 內(nèi)容很實用 只是為什么后來都不更新了?

    來自浙江 回復(fù)
  11. 終于找到一個實用性強的了,之前看過好多篇,都說得模模糊糊的,這個只用看文章就知道以后要怎么做了

    來自廣東 回復(fù)
  12. 寫得真好

    來自上海 回復(fù)
  13. 確實用圖表的形式畫出來看著比較清晰,很實用的文章。請問作者業(yè)務(wù)流程圖是用啥畫的啊

    來自北京 回復(fù)
  14. 超級實用 謝謝作者

    來自北京 回復(fù)
  15. 來自廣東 回復(fù)
  16. 同求axure源文件 給我們ba作為參考 現(xiàn)在用word文檔亂寫一通 ba他自己也看不懂。。。。

    來自廣東 回復(fù)
  17. 實用,我服

    來自北京 回復(fù)
  18. 很受用,有完整的下載地址么?求axure 源文件

    回復(fù)