我发现多数需求分析说明书~写得毫无h(hun)?多数公司的做法是写完该需求说明书之后,把它扔一?埋头苦干写程序了(jin).一斚wq和公司寚w求分析的认识不够有关,另一斚w,也和需求分析编写方式不合?以至它的价值难以体现有?
软gE序,从最l的抽象意义而言,是计机pȝ对自然语a的翻?而需求分析充当了(jin)译d的急先?很难惌,如果没有一份好的需求说明书,针对客户含糊不清的自然语a描述,开发者能做出一个符合要求的优秀软g.然?什么是好的需求说明书?应具备什么样的特?我认为好的需求说明书应有由如下三个阶D?l多ơ@环反馈而逐渐形成:
1 调研阶段:
客户和需求分析师讨论pȝ该具有的功能.客户希望pȝ能做什?辑ֈ什么样的效?需求分析师的责L认真听取客户的原始言?通过讨论,语言的提炼和客户达成p,最l得到确切的需?-客户希望pȝ能做什?q一q程q用的是自然语言,需求分析师必须具备良好的沟通能?文字表达能力,q且必须具备客户领域内的相关业务知识,不用用户不懂的计算Z业词?
参与人员:需求分析师,客户,pȝ设计?
q用工具:自然语言.
阶段成果:调研记录?
2 定功能l构和设计系l原?
需求分析师和系l设计师讨论客户的需?需求分析师针对调研阶段的记?逐点提出客户需?q用uml的用例概?和系l设计师q行讨论.pȝ设计师根据这些需?q用他的技?知识和经?之分解ȝ为系l的功能l构.(此处仅针对应用系l而言,对于其他pȝ,可能q要ȝq程l构或部|结?得到功能l构之后,pȝ设计师还要构建系l原?该原型用于和客户q行更好的交?
在这一阶段之后,׃得到?jin)功能分解表和系l原?需求分析师和系l设计师已明白系l的雏Ş,该成果将作ؓ(f)开发者和客户l箋q行讨论的基.
参与人员:需求分析师,pȝ设计?或该设计师领导的相关团队).
q用工具:uml,构徏原型的相兛_h?
阶段成果:功能分解?pȝ原型.(大致的业务流E图)
3 ~写需求分析说明书
在参照功能分解表和系l原型的基础?需求分析师和系l设计师~写pȝ的需求分析说明书.该需求分析说明书作ؓ(f)客户和系l开发者的桥梁,既表达了(jin)客户惌pȝ做什么的愿望,又反映了(jin)pȝ开发者针Ҏ(gu)需求得到的努力成果(功能分解表和pȝ原型).通过该说明书,对系l具有的功能和最l可能的形?客户和开发者达成共?
有可能经q多ơ的1,2阶段的反?最l才得到需求分析说明书.各阶D늚成果应妥善保?
参与人员:需求分析师,pȝ设计?客户.
q用工具:自然语言,功能分解?pȝ原型.
阶段成果:改进的功能分解表,pȝ原型,(业务程?,需求分析说明书.
W?阶段,是开发者得到自然语a需求的阶段.该阶D늚重要性不a而喻.
W?阶段,是需求分析编写的核心(j)阶段.很多公司?x)有意无意忽略该阶?实,该阶D耗费的h力和旉挺多,但这个阶D决不能马虎的进?甚至忽略.只有详尽的将自然语言译成功能需求表,qؓ(f)此构建原?开发者对pȝI竟能做什么和未来该怎么做的认识才会(x)逐渐加深.q且,对应的功能界?能够让客户大致认识到最l的pȝ?x)是什么样?他能够据此提?gu)q满意?修改或者增加需?
我主张在构徏功能分解表的时?界面的相关控g,字段,标签都一一列出,q且和原型的界面相对?q样在功能分解表/需求分析说明书定之后,开发者就有可能根据这些控?字段/标签立业务层的接口和数据库pȝ的表l构,减少?jin)概要设计阶D|作的工作?
以下是一个分解功能的例子:
功能:修改我的资料
功能q?用户可以更新个h资料
界面控g:姓名文本?输入姓名),邮箱文本?输入邮箱),密码文本?输入文本),认密码文本?输入认密码),所属组别选择?nbsp;(输入所属组?,地址文本?输入地址),备注文本?输入备注).提交按钮.
界面标签(Label):Ҏ(gu)界面控g描述q行配对.如姓名文本框的标{是"姓名".不再赘述.
界面:见图(修改我的资料)
只有l过详尽完备?,2阶段?我们才可能进行第3阶段,?,2阶段的成果综合v?和客戯一步讨论需?客户可能?x)对功能分解不满?对原型有异议.q样我们必须q回?,2阶段,再次分解功能,修改原型.直到客户满意为止.
在这个基?我们才可能编写最l的需求说明分析书.我认?严格按照上述程q行~写的需求说明书,是好的.它的特点ȝ如下:
1)l历q反复功能分解和原型构徏.客户因原型而清楚认识到自己惌pȝ的Ş?开发者经多次反馈明确?jin)系l所具备的功?
2)~写良好的功能分解表,能够帮助开发者进一步设计业务接?
3)构徏成型的原?有助于开发者设计数据库pȝ.
4)*明确的业务流E图,能够协助开发者构建系l的业务?
用户的需求永q在变化,没错.但如果我们按照上q步骤努力在分析阶段弄清楚客L(fng)需?以后的开发维护阶D就能将需求变更的代h(hun)降到最?只有对事物认识越深刻,才越有可能认识到事物可能存在的变?q条哲学法则在需求分析阶D同样适用.
l过以上讨论,我们可以看Cؓ(f)什么多数公司的需求分析书难以辑ֈ预期要求.它们没有功能分解阶段,没有原型构徏阶段,没有反馈认识再加q阶段....q样的需求分析书,仅仅为构构?对系l的开发毫无帮?(我还看到q有人用三天写完一个系l的需求分析书)接踵下去的Y件开发阶D?如何q行?q样做出来的软g,能好到哪里去?
一Ҏ(gu)?ȝ方家. :-)
]]>
1.1 ~写目的
本说明书是客户与软gpȝ开发者的沟通桥?客户Ҏ(gu)需求说明书提出需?阐述pȝ能做什?软gpȝ开发者根据此需?阐述需求实现的功能与界?q将之清晰明白的反映到本说明书中,以供客户审阅.
本说明书的预期读者ؓ(f)客户,业务需求分析h?pȝ设计人员,目理人员,软g开发h员等pȝ开发的相干参与?
1.2 目背景
软g开发过E中无可避免的存在源码缺?以下UBUG).在Y件系l的开发维护阶D阶D?对BUG的修复管理工作必不可?本系l提供了(jin)bug的管理功?客户可应用本pȝ单有效的理BUG,以协助Y件系l的开发维护工?
1.3 定义,~写词和W号
BUG:软gpȝ在功能或界面斚w所产生的缺?
2 pȝq行环境
2.1 g环境
2.1.1 一?86微机,CPU主频?00MHZ以上,内存大于512MB.
2.2 软g环境
2.2.1 WINDOWS 或类 LINUX 操作pȝ.该操作系l应能正常运行JAVA虚拟?
2.2.2 安装IE6或FIREFOX1.5览?br> 2.2.3 安装J2SDK,要求版本?.4以上.
2.2.4 安装TOMCAT或其他支持SERVLET 2.3 的WEB 服务?
2.2.5 安装MYSQL数据?要求版本?.0以上.
3 pȝ用例说明
3.1 pȝ用例说明
3.1.1 用例名称:用户查看BUG列表
用例~号:1
用例说明:用户点击"查看我的BUG"标签,查看属于自己的BUG列表.或者点?查看所有BUG"标签,查看所有BUG列表.q能Ҏ(gu)自定 义的条gqo(h)?查看W合特定条g的BUG.
前置条g:用户已登录系l?
3.1.2 用例名称:用户查看BUG详情
用例~号:2
用例说明:在BUG列表上存在HTML链接,用户点击该链?可以看到BUG的详l情?q且用户可以修改BUG的状?修改旉.
前置条g:用户已登录系l?br>
3.1.3 用例名称:用户增加新BUG
用例~号:3
用例说明:用户点击"增加新的BUG"界面,q入增加新BUG界面.可以增加新的BUG到系l?
前置条g:用户已登录系l?br>
3.1.4 用例名称:用户理BUG列表qo(h)?br> 用例~号:4
用例说明:用户可以增删改BUG条gqo(h)?在BUG列表?可以通过选取qo(h)器查看符合特定条件的BUG(请参照用?).
前置条g:用户已登录系l?
3.1.5 用例名称:用户修改个h资料
用例~号:5
用例说明:用户可以修改个h资料,例如修改EMAIL,住址{?
前置条g:用户已登录系l?
3.1.6 用例名称:用户理帐号
用例~号:6
用例说明:pȝ理员可以增删改新的用户.
前置条g:用户已登录系l?且该用户必须是系l管理员.
3.1.7 用例名称:用户理开发组
用例~号:7
用例说明:pȝ理员可以增删改开发组.在增加新BUG界面,该组名用于划分BUG的归?
前置条g:用户已登录系l?且该用户必须是系l管理员.
3.2 单的用例?br> 见图:
4 pȝ功能分解
4.1 BUG理
4.1.1 列出我的BUG
功能q?以分늚列表方式列出指派l我的bug,可以选择某条记录q行修改,可以弹出框Ş式查看bug详情.
界面控g:序号Radio(可以选择某条记录),修改按钮(对记录进行修?
界面标签(指Label):可选项,序号,概述,紧急程?状?所有h,发现旉.
HTML链接:序号
4.1.2 查看所有bug
功能q?以分늚列表方式列出所有bug,可以选择某条记录q行修改,可以弹出框Ş式查看bug详情.可以按过滤器查看W合?nbsp; qo(h)器条件的bug.
界面控g:序号Radio(可以选择某条记录),修改按钮(对记录进行修?,qo(h)器选择?选择某个qo(h)?.
界面标签(指Label):可选项,序号,概述,紧急程?状?所有h,发现旉.
HTML链接:序号
4.1.3 增加新的bug
功能q?用户可以增加新的bug
界面控g:所属模块选择?讑֮bug的所属模?,发现旉日期控g(定bug的发现时?,发现者选择?定bug的发现?,?nbsp; 态选择?定bug的状?,截止期限日期控g(定bug的徏议修Ҏ(gu)?,指派l选择?选择bug的所有h),描述文本?输入 bug的描q?,附g一(文g选择?,附g?文g选择?,附g?文g选择?.提交按钮.
界面标签(指Label):Ҏ(gu)界面控g描述q行配对.如所属模块选择框的标签?所属模?.不再赘述.
4.2 个h资料
4.2.1 修改我的资料
功能q?用户可以更新个h资料
界面控g:姓名文本?输入姓名),邮箱文本?输入邮箱),密码文本?输入文本),认密码文本?输入认密码),所属组别?nbsp; 择框(输入所属组?,地址文本?输入地址),备注文本?输入备注).提交按钮.
界面标签(Label):Ҏ(gu)界面控g描述q行配对.如姓名文本框的标{是"姓名".不再赘述.
4.3 qo(h)器配|?br> 4.3.1 列出qo(h)?br> 功能q?列表方式列出该用h增加的过滤器,可以选择某条记录q行修改,可以弹出框Ş式查看过滤器详情,可以删除某条?nbsp; ?
界面控g:序号Radio(可以选择某条记录),修改按钮(对记录进行修?,删除按钮(Ҏ(gu)条记录进行删?
界面标签(Label):可选项,序号,qo(h)器名U?
4.3.2 增加新过滤器
功能q?用户可以增加新的qo(h)?每个用户只能有最?0个过滤器.
界面控g:qo(h)器名U文本框(输入qo(h)器名U?,状态选择?选择状?,所属模块选择?选择模块),发现者选择?选择发现?nbsp; ),指派l选择?选择bug的所有h),发现旉D|间选择?选择发现起始旉),发现旉D|间选择?选择发现l止旉 ),截止旉D|间选择?选择截止起始旉),截止旉D|间选择?选择截止l止旉).提交按钮.
界面标签(Label):Ҏ(gu)界面控g描述q行配对.如过滤器名称文本框的标签?qo(h)器名U?.不再赘述.
4.4 pȝ理
4.4.1 用户列表
功能q?列表方式列出所有用?可以选择某条记录q行修改,可以弹出框Ş式查看某用户详情,可以删除某条记录.
界面控g:序号Radio(可以选择某条记录),修改按钮(对记录进行修?,删除按钮(Ҏ(gu)条记录进行删?
界面标签(Label):可选项,dID,Email,?sh)?职位
4.4.2 增加新用?br> 功能q?增加新用?br> 界面控g:dID文本?输入用户帐号),姓名文本?输入姓名),邮箱文本?输入邮箱),密码文本?输入文本),认密码文本 ?输入认密码),是否理员选择?讑֮是否理?,地址文本?输入地址),备注文本?输入备注).提交按钮.
界面标签(Label):Ҏ(gu)界面控g描述q行配对.如姓名文本框的标{是"姓名".不再赘述.
4.4.3 开发组列表
功能q?列表方式列出所有开发组,可以选择某条记录q行修改,可以弹出框Ş式查看某记录详情,可以删除某条记录.
界面控g:序号Radio(可以选择某条记录),修改按钮(对记录进行修?,删除按钮(Ҏ(gu)条记录进行删?
界面标签(Label):可选项,开发组名称,描述.
4.4.4 增加新开发组
功能q?增加新开发组.
界面控g:l名U文本框(输入开发组名称),备注文本?输入备注).提交按钮.
界面标签(Label):l名U?备注.
4.4.5 日志列表
功能q?分页列出pȝ日志.用户删除某条记录,可以弹出框Ş式查看某条记录详?
界面控g:删除按钮.
界面标签(Label):可选项,日志旉,用户ID,操作概述.
]]>
?Diego,对这个系l的看法怎样?
D:?我觉得我们遗漏了(jin)某些东西.查看bug列表?是允许所有用h看呢?q是l过pȝ验证的用?
?.... 我觉得应该是l过pȝ验证的用户吧.
D:不一?如果用户要登录之后才能看到bug列表,不方?理想状况应该打开pȝp看到.
?但是你要考虑q么一个问?假设bug按发现时间的序分页列出且bug的数量很?很可能在W一该用户看不到属于自qbug,他就以ؓ(f)没有bug.假如我们要求他必dd,那我们就可以Ҏ(gu)他的d信息,列出他的bug的L,bug的列?..{等.
D:我上当当|购书的时?发现他们可以在不d的情况下C用户的浏览历?我猜惌可以通过写用L(fng)cookie实现.
?但我们公司的技术h员对q项技术不?我可不能凭猜确定这个需?
(虽然Diego跃跃Ʋ试,但看C有先生坚决的色,也只有妥?
D:好吧,那我们就必须先登?再看列表.
(于是乌有先生~写pȝ的用例如?)
用例1:用户查看bug列表
1.用户点击"bug列表"标签,查看属于自己的bug列表.
前置条g:用户已登录系l?
(该用例获得一致通过)
(乌有先生~写pȝ用例2)
用例2:用户查看bug详细信息
1.用户点击bug列表中的某个bug,q入bug详细信息面.
2.用户可以修改bug的状?修改旉.
前置条g:用户已登录系l?
D:我发?如果pȝ要求用户必须先登录才能查看bug,那么此时pȝ列出的bug都是他的,列出其他人的bug好像没什么必?
?但是你要考虑,假设我是目l理或者测试组l长,我想看到所有bug的列?pȝ列出所有bugq是必要?
D:解决办法有两U?1)讉Kpȝ的时?Ҏ(gu)某种逻辑(如时?模块,bug性质)列出bug的列?大家不用d可以看?我称q个?公共bug列表界面".用户一讉Kpȝp看到q个界面. 2)或者用L(fng)录之??列出所有bug"列表.当然,用户q可以构造自qqo(h)?以决定列出bug的条?
?那么其实"列出所有bug"?列出自己的bug"功能可以合ƈC?只不q默认状态列出属于自qbug,单的选取条g后又可以列出所有bug.
D:?q种x不错.而且,各自选择应该能汇L一个名U?姑且UC滤器.用户可以建几个常用的qo(h)器以供快捷?
?好办?
(于是乌有先生修改用例1如下:)
用例1:用户查看bug列表
1.用户点击"bug列表"标签,查看bug列表. (此时列出的所有bug属于该用?.
2.用户可以选择某些条g,pȝҎ(gu)q些条g列出相应的bug.如果什么条仉不?pȝ列出所有bug.
前置条g:用户已登录系l?
(乌有先生l箋~写用例如下)
用例3:用户dbug
1.用户炚w?dbug"标签,q入dbug界面.
2.用户可以dbug,讑֮bug的简单描q?详细描述,bug的发现时?修复旉,所属模?d?所有h,修改?状?
用例4:用户增删改过滤器
1.用户点击"qo(h)器列?标签,查看当前qo(h)器列表和当前所采用的过滤器.
2.用户可以增删Ҏ(gu)的过滤器.
(乌有满意的伸懒?
?我想差不多了(jin).q个pȝ实不算太复?
D:我设计个原型,然后一h子虚先生l箋讨论.
?好的,加a(b)!
]]>
]]>