在线教育网系统需求分析说明书：权限矩阵与在线考试流程设计

简介在线教育网系统需求分析说明书面向计划搭建校园在线教育平台的院校信息化负责人、项目管理者与开发测试人员围绕学员管理、网上教学、校园信息发布和在线考试等核心业务梳理从项目背景、用户环境到功能边界与技术要求的需求基线帮助团队在开发前统一认识、控制范围。压缩包内仅含1个doc文档整体约2.21MB正文以需求条目、功能清单、用例描述和结构示意为主便于直接查阅与二次整理。目前已有1588人学习。文档具体展开界面权限、角色与栏目管理班级科目及教师管理教学资料上传下载与进度配合学员注册、浏览提问和答疑以及教师/学员登录、手动或系统选题、在线考试、自动与人工改卷、成绩查询等流程同时交代B/S架构、Windows 2000 Server、.NET Framework 2.0、Oracle 9i、IE6.0等环境约束并说明用Rational Rose绘制UML、PowerDesigner 11.0绘制E-R图。读者可据此快速形成功能清单、用例模型和开发任务分解作为需求评审、课程设计或项目立项的参考底稿。1. 需求先立住在线教育网系统为什么不能从页面清单开始在线教育网系统的需求分析说明书最怕写成一张功能菜单。某学校要在网络普及后补一套学习、复习、测验入口B/S结构学生打开浏览器就能进可真正难的不是首页放几个栏目而是先定清楚学员能看哪个年级的教学内容教师能改哪些资料考试从组卷到查分由谁负责。若一上来就画页面后面权限、栏目、考试流程一定会打架。这份文档适合两类人要交毕设或课设的学生需要一套能讲清楚的章节骨架要交付方案的人需要把功能清单、用例说明、权限矩阵和验收口径对齐。我的建议是先写角色和权限再拆网上教学与在线考试最后补UML用例图、E-R图和版本记录。需求分析说明书不是写给开发看的“愿望清单”而是让管理员、教师、学员三方都能对上号的操作边界。2. 角色与权限设计管理员、教师、学员和栏目维护者怎么分权在线教育网系统的权限不是登录后加几个菜单那么简单。原文档把学员管理写成会员制有相应权限才给相应功能还拆出了模块功能管理、权限设置、角色管理、栏目管理四块。这个结构如果不在需求分析说明书里落成表开发阶段就会出现“管理员能改一切、教师不知道自己能改哪科、学员能看到高年级内容”的扯皮。我的做法是先画角色再画模块最后给每个角色标数据范围。角色至少四类管理员、栏目维护人员、教师、学员数据范围至少三层全站、所带班级科目、本人。权限这块最容易翻车因为大家都觉得“先做出来再补权限”最后补的时候每个页面都要改。2.1 从会员制到RBAC权限矩阵先画表再写用例原文档写的是“对部分功能实行会员制有相应权限才能给予相应功能”这句话在需求里不能只停在一句描述。落到文档里我会把它翻成一张权限矩阵行是功能模块列是角色格子里写“全权、只读、本人范围、无权”。这样开发知道拦截点在哪答辩时也能直接指着一行说“学员打不开角色管理”。权限矩阵不需要一上来就穷举所有按钮但必须覆盖功能清单里的01模块功能管理、02权限设置、03角色管理、04栏目管理以及网上教学和在线考试的登录、组卷、改卷、查分。功能模块管理员栏目维护人员教师学员模块功能管理全权无权无权无权权限设置全权无权无权无权角色管理全权无权无权无权栏目管理全权内容维护无权只读已发布班级、科目管理全权无权只读所带班级只读本班教师管理全权无权本人资料只读无权教学资料管理全权无权所带科目增改已发布资料只读浏览教学内容全权无权不限年级本年级及以下提问、答疑全权无权解答所带科目提问本人在线考试全权无权所带班级组卷本人考试改卷全权无权所带班级主观题无权查分全权无权所带班级本人成绩这张表不是最终版但它能把“会员制”翻译成可检查的规则。比如学员这一列浏览教学内容写“本年级及以下”这是原文档明确写的教师和管理员不受限制也要在用例里单独说明。再往下每个格子的“全权”还要拆成增、删、改、查四个动作否则开发会把“管理”理解成只能看。权限设置本身也要写用例规约不能只画一个管理员小人连到“权限设置”四个字。规约至少包含用例编号、参与者、前置条件、主流程、异常流程、后置条件。下面这个模板可以直接套项目内容用例编号PERM-02用例名称设置角色对模块的权限参与者管理员前置条件管理员已登录角色已创建功能模块已登记主流程选择角色勾选模块及操作保存系统刷新该角色权限缓存异常流程角色不存在时提示先创建角色模块被停用时不允许新授权后置条件该角色下用户重新登录后按新权限显示菜单这个规约看起来朴素但它把“角色对模块的权限”和“功能模块管理”“角色的管理”三者的扩展关系说清楚了。原文档里02.1、02.2、02.3三条描述最怕写成三个孤立的句子用规约串起来评审时就能追问“角色删除了原有权限怎么办”。我的通常做法是角色删除前先检查是否还有用户绑定有绑定就先转绑或禁止删除这条要写进异常流程不留给开发临场发挥。2.2 栏目管理与角色管理的边界动态栏目不是万能后台原文档把栏目管理分成041外观样式设置和042栏目内容动态设置这个划分很实用但需求分析说明书必须把边界写死。栏目维护人员能改的是栏目名称、上级栏目、排序、样式模板、内容标题、图文内容、发布状态不能碰的是角色创建、权限勾选、模块登记。否则“栏目维护”四个字会被理解成“后台什么都能改”最后权限矩阵白做。栏目管理的数据表也要在需求里先列字段哪怕此时不写SQL字段清单也能让E-R图有落点。字段说明是否必填栏目编号系统生成唯一是栏目名称如校园动态、教育科研是上级栏目支持一级、二级栏目否排序号控制前台显示顺序是样式模板外观样式设置对应模板标识是内容类型图文、纯文本、链接是发布状态草稿、已发布、下线是操作人记录最后修改人是栏目内容和角色权限分开以后网上教学模块才不会把“课程栏目”和“教学资料”混成一锅。课程教学、学习平台、问答平台这些前台入口可以由栏目管理配置出来但学员能不能点进去、教师能不能上传仍由权限矩阵决定。这里有一个容易忽略的点动态栏目删除时已经发布的内容怎么处理。需求里通常写“下线不物理删除”或“删除前必须清空子栏目”两种都行但必须选一种。我一般会在栏目管理的异常流程里写“存在已发布内容时禁止删除先下线再迁移”这样答辩时被问到数据丢失有说法。2.3 权限需求的验收口径一条权限至少对应一个可检查动作权限写得好不好不看文档里画了几个小人看能不能被一条条检查。验收时我会准备四个账号管理员、栏目维护人员、教师、学员每个账号走一遍越权动作。学员直接输入教师管理地址应被拦截栏目维护人员打开角色管理应看不到入口教师修改非所带科目的教学资料应提示无权限管理员创建角色并只勾“栏目内容维护”该角色登录后不能出现权限设置菜单。这些动作要写进需求分析说明书的验收标准而不是等到测试阶段才想。检查项操作预期结果学员越级浏览学员访问高年级教学资料提示无权或列表不显示栏目维护越权打开角色管理页面菜单不可见直接访问被拦截教师跨科修改修改非所带科目资料保存失败并提示范围角色删除检查删除仍有用户的角色禁止删除或要求先转绑权限生效修改角色权限后重新登录菜单和操作按钮同步变化这一套写进文档需求分析说明书就不再是“功能罗列”而是能指导开发和验收的权限方案。原文档的会员制、角色管理、栏目管理三条线也就能在同一张矩阵里对上号。3. 网上教学模块班级、科目、教学资料与问答如何拆成可开发需求网上教学是在线教育网系统里最容易写虚的一块。原文档给了班级、科目创建与管理教师创建与管理教学资料管理学员注册浏览教学内容提问发表意见疑问解答这些功能编号但如果没有归属关系开发会做出“教师随便传、学员随便看”的页面。我的拆法是先定班级、科目、教师、学员四者的关系再定教学资料挂在哪个章节和进度上最后把提问答疑做成闭环。这样需求分析说明书里的每条功能都能追到数据范围和操作人。3.1 班级科目与教师管理先定归属关系再定操作原文档写管理员可以创建班级对班级修改删除同理创建老师用户修改资料删除老师用户。这里必须补一句关系一个班级有多门科目一门科目在一个班级里通常由一位教师负责但一位教师可以带多个班级的多门科目。需求里不写清多对多还是一对多E-R图就会画错。学员注册也要绑定班级和年级否则“浏览本年级及以下”没有判断依据。我一般会在文档里列一张归属关系表开发照着建关联表答辩时也能解释清楚。实体关键字段关系说明班级班级编号、班级名称、年级、状态一个班级对应多个科目科目科目编号、科目名称、所属班级科目挂在班级下教师教师编号、姓名、账号、状态教师与班级科目为多对多学员学号、姓名、班级、年级、账号状态学员属于一个班级授课关系教师编号、班级编号、科目编号记录谁教哪个班哪科班级和科目的创建、修改、删除要写异常班级下已有学员或教学资料时不允许直接删除科目已有考试记录时删除要转归档。教师删除同理先解除授课关系历史资料保留上传人。这些规则不写开发为了省事可能直接物理删除后面查历史成绩就变成黑匣子。学员注册的字段不用多但账号状态要有“正常、停用、待审核”会员制功能才有着力点。3.2 教学资料管理FLASH、视频、课件与教学进度的版本约束原文档明确教学资料包括FLASH动画、视频、课件还包含根据教学进度和节次需求发布教学资料。这个点很关键资料不是孤立文件它要挂在班级、科目、章节、教学进度上。需求分析说明书里我会给资料表加“资料类型、所属班级、所属科目、章节、教学进度、文件路径、上传人、审核状态、版本号、可见范围”。没有版本号教师改一版覆盖一版学员昨天看的和今天看的不一样出了问题连后悔药都没有。通常的做法是保留版本已发布版本对学员可见新版本审核后替换。字段说明约束资料编号系统生成唯一资料标题如第三章课件必填资料类型FLASH、视频、课件枚举所属班级关联班级必填所属科目关联科目必填章节关联教学进度必填文件路径上传后存储位置必填上传人教师账号必填审核状态待审、已发布、退回必填版本号每次修改递增必填可见范围本班、本年级、指定班级必填教学进度管理也要单独写进度名称、科目、章节、计划课时、开始时间、结束时间、状态。教师发布资料时选进度节点学员浏览时按进度展开。异常流程至少写三条上传文件类型不在允许范围时拒绝资料未发布时学员列表不显示教师只能修改自己上传且未被考试引用的资料。最后一条容易被忽略考试题目如果引用了某份资料直接删资料会让历史试卷断链。3.3 浏览、提问、答疑学员可见范围与教师响应闭环原文档写学员可以浏览本年级以及以下年级的教学内容教师或管理员不受限制学员可以针对所浏览章节提问教师针对疑问解答。这个规则要落成两条列表查询带年级条件详情页也要校验不能只在列表挡一下。提问必须绑定章节和资料否则教师不知道回答哪一段。问答状态我一般设“待解答、已解答、已关闭”学员可以补充教师回答后学员可见管理员可关闭异常提问。用例编号用例名称参与者主流程异常流程TEACH-05浏览教学内容学员选择班级科目按进度展开打开已发布资料越级访问提示无权未发布资料不显示TEACH-06提问与发表意见学员在章节下填写问题提交状态待解答内容为空拦截重复提交合并提示TEACH-07疑问解答教师查看所带科目待解答填写答案状态已解答非所带科目不可见已关闭问题不可答这套问答闭环的验收标准也要写清楚学员只能看到本年级及以下已发布资料提问必须带章节教师只能回答所带班级科目回答后学员端状态变化管理员能按状态筛选。网上教学模块写到这个程度需求分析说明书才具备可开发性而不是一句“实现网上教学”。4. 在线考试模块从登录、组卷到改卷查分的流程闭环在线考试是在线教育网系统里状态最多的一块。原文档列了用户登录、教师登录、手动选题、系统选题、在线考试、系统改卷、教师改卷、教师查分、学员查分功能编号从01到05。只列功能不会出错一写流程就会暴露问题谁先组卷试卷什么时候发布学员中途断线怎么办客观题和主观题怎么分开发布。我的写法是把考试拆成“登录身份、组卷规则、考试提交、改卷、查分”五个状态段每段写清参与者和数据变化。4.1 登录与身份教师和学员进入考试系统的不同入口原文档把登录分成0101用户登录和0102教师登录说明教师和学员进入考试系统的入口或权限不同。需求分析说明书里要写学员登录后只能看到本人可参加的考试教师登录后看到所带班级的试卷管理、改卷、查分管理员拥有全站查看权但不直接替教师改卷。登录用例的前置条件、失败提示、账号状态都要写。账号停用的学员不能进入考试教师账号被停用后不能组卷。是否锁定失败次数按学校策略在需求评审时定不在文档里拍脑袋写死。身份登录后可见可执行操作数据范围学员本人待考、已考、成绩参加考试、查本人分本人教师所带班级试卷、待改卷组卷、改主观题、查班级分所带班级科目管理员全站考试配置维护题库、处理异常全站登录用例的异常流程要写“账号或密码错误统一提示不暴露账号是否存在”这是需求文档里少写但开发容易忽略的安全细节。教师登录和学员登录可以共用一个认证入口但角色判断后进入不同工作台这样B/S结构下浏览器端不用做两套页面。4.2 组卷方式手动选题与系统选题的规则表原文档只写手动选题和系统选题没写规则。需求分析说明书必须补组卷参数否则“系统选题”会变成随机抓题。我一般让文档列一张组卷规则表试卷名称、所属班级、科目、总分、考试时长、题型分布、难度分布、抽题范围、生成方式、发布状态。手动选题由教师勾题系统选题按题型和数量随机抽取但同一试卷内不重复尽量覆盖章节。题目类型至少列单选、多选、判断、填空、简答具体以学校题库为准这个补全要写成“通常的做法”不要伪装成原文档已有内容。参数手动选题系统选题题目来源教师逐题勾选按题型、章节、难度抽取重复控制教师自查同一试卷内题目不重复分值设置逐题设分按题型模板设分适用场景小测验、指定题单元考、批量组卷发布前检查总分、题数、时长总分、题数、抽题范围组卷完成后要有“试卷预览”和“发布”两个动作预览时教师能改分值发布后学员才能看到。已发布试卷如果被修改必须走版本记录否则先考的和后考的不一样。这个规则写进需求答辩时被问“系统选题会不会抽到重复题”就能直接指规则表。4.3 改卷与查分系统改卷、教师改卷、成绩发布的状态设计原文档把改卷分成系统改卷和教师改卷查分分成教师查分和学员查分。需求里要写清客观题由系统自动判分主观题进入教师待改列表教师改完后成绩进入“待发布”发布后学员才能查。成绩状态建议设“待批阅、批阅中、待发布、已发布、已归档”。已发布后如果教师修改分数要留修改记录不能悄悄覆盖。分数汇总和优良登记评分也要挂在这个状态上否则统计口径和学员看到的不一致。状态触发动作可操作人学员可见待批阅学员提交试卷系统否批阅中客观题完成主观题分配教师否待发布教师完成主观题评分教师否已发布教师或管理员发布教师、管理员是仅本人已归档学期结束归档管理员是仅本人异常流程至少写考试中断后是否允许续考重复提交以最后一次为准还是禁止成绩发布后修改如何留痕学员查分只能查本人。教师查分范围限所带班级管理员可查全站。在线考试模块写到这里功能清单里的01到05才算串成闭环。5. 文档与建模避坑用例图、E-R图、版本记录最容易翻车的五处需求分析说明书不是把功能清单贴进Word就完事。原文档要求用Rational Rose画UML、用PowerDesigner 11.0画E-R图还给了文件状态、文件标识、版本历史和1.0.0当前版本。真正交作业或交付方案时最容易翻车的往往不是功能写少了而是图、表、编号、版本对不上。下面五条是我在同类文档里反复见到的坑每条按现象、原因、解决写照着排一遍能省很多返工。5.1 用例图只画小人参与者有了系统边界没了现象用例图里管理员、教师、学员三个小人连出十几条线到“权限设置”“教学资料管理”“在线考试”看起来热闹但评审一问“哪些是系统内做的、哪些是外部触发”就答不上来。原因把用例图当成功能清单画只关心谁点了什么没有画系统边界也没有给用例编号。解决先画一个系统边界框框内放用例用例名用动宾短语如“设置角色权限”“上传教学资料”“生成试卷”参与者放框外每个用例编号与功能清单一致。一个用例至少配一张规约规约里的主流程写正常路径异常流程写越权、空数据、重复提交。用例图不追求多权限管理四个用例、网上教学三个用例、在线考试四个用例已经够讲清楚。5.2 E-R图字段拍脑袋考试和教学资料的数据关系对不上现象E-R图里学员、教师、班级、科目、试卷都有但教学资料挂在谁下面、考试成绩关联哪张试卷、题目属于哪个科目图上没有外键开发建表时只能猜。原因先画图后想字段实体之间只连了线没有确定主键和外键。解决先列实体清单再列每个实体的主键和关键字段最后用PowerDesigner 11.0生成关系图。至少覆盖学员、教师、班级、科目、教学资料、教学进度、题目、试卷、考试记录、成绩、栏目、角色、权限。关系上要写清班级一对多科目教师与班级科目多对多试卷一对多题目考试记录关联学员和试卷成绩关联考试记录。图后附字段表评审时能逐项对。实体主键关键外键说明教学资料资料编号班级编号、科目编号、进度编号资料挂进度题目题目编号科目编号题目归科目试卷试卷编号班级编号、科目编号试卷按班级科目生成考试记录记录编号学员编号、试卷编号一次考试一条记录成绩成绩编号记录编号客观题、主观题、总分5.3 版本记录写成流水账1.0.0正在修改却找不到变更点现象文档封面写着文件状态“正在修改”、当前版本1.0.0版本历史里只有一行日期和“修改”谁改的、改了哪章、为什么改全找不到。原因把版本记录当形式只写日期不写变更点。解决版本历史表至少五列版本、状态、修订人、修改日期、备注。备注写具体如“新增在线考试组卷规则补充权限矩阵调整教学资料版本字段”。文件标识也要稳定不能今天一个名明天一个名。答辩前用“版本记录—变更点—正文位置”三列自查确保每条变更都能在正文找到落点。5.4 需求编号乱功能清单和用例说明对不上号现象功能清单用01、02、03用例说明用001、002考试模块又用0101、0201评审时指着一个用例问对应哪条功能翻半天对不上。原因编号规则没有统一各章各写各的。解决用“模块前缀两位序号”如PERM-01、TEACH-03、EXAM-02功能清单、用例规约、验收检查表共用同一编号。功能清单里写“PERM-02权限设置”用例规约标题也写“PERM-02设置角色对模块的权限”验收表里还写PERM-02。这样改一处能追三处需求分析说明书才有可维护性。5.5 非功能需求空着B/S环境、浏览器和数据库不能只写名字现象用户环境只写Windows 2000 Server、.Net Framework 2.0、Visual Studio.NET 2005、Oracle 9i、IE6.0或以上其他要求只写Rational Rose和PowerDesigner 11.0正文没有说这些约束影响什么。原因把环境清单当非功能需求以为列了软件名就够。解决分兼容性、性能、安全、备份、日志五类写。兼容性写清浏览器最低版本和分辨率性能按学校规模在评审时填并发和响应时间不编造具体数字安全写账号停用、越权拦截、成绩修改留痕备份写数据库备份频率日志写登录、权限变更、成绩发布三类操作留痕。原文档的技术栈是历史约束如果实际环境升级要在版本记录里写明不要正文一套、演示一套。6. 验收与答辩把需求分析说明书讲成一条可检查的交付链答辩时最怕从头念目录。评审想听的不是“我写了第一章第二章”而是“这份需求分析说明书能不能指导开发、能不能验收”。我的做法是准备三张表功能清单与用例规约对照表、权限矩阵检查表、E-R实体字段表。三张表能互相对上文档就立住了。现场演示按角色走不从登录页念起先用管理员创建角色并只勾栏目内容维护再用该角色登录证明看不到权限设置接着教师上传一份课件并发布到教学进度学员登录只能看到本年级已发布资料最后教师组一套试卷学员提交系统改客观题教师改主观题发布后学员查本人成绩。这条链走完评审自然知道每个模块的边界在哪。答辩问题通常集中在三处为什么学员只能看本年级及以下为什么栏目维护人员不能改角色系统选题怎么避免重复。回答时不要背功能名直接指规则学员范围写在浏览教学内容用例的异常流程里栏目维护和角色管理在权限矩阵里是两列系统选题在组卷规则表里写了同一试卷题目不重复。成绩发布后修改怎么留痕也要能指到状态表和版本记录。最后提醒一句文档里的版本号、文件状态、修订记录要跟正文一致别封面写1.0.0正文还留着上一版的章节名。从那以后我每次写需求分析说明书都强制先填权限矩阵再画用例图最后才动正文答辩前一定用学员、教师、栏目维护、管理员四个账号各走一遍越权动作。希望帮到你。本文还有配套的精品资源点击获取