软件实训管理平台需求规格说明书(第2版).doc

软件实训管理平台需求规格说明书目录1、导言41.1目的41.2范围41.3 缩写说明41.5版本更新信息52、系统定义52.1项目来源及背景52.2用户的特点62.3项目目标63、应用环境63.1 系统运行的网络环境73.2 系统运行的硬件环境73.3 系统运行软件环境74、业务领域术语表85、业务模型95.1构建初始化业务模型95.2创建软件实训平台用例模型95.2.1、学生用例图105.2.2、教师用例图115.2.3、管理员用例图135.3 初始需求145.3.1学生注册145.3.2学生登录155.3.3学生选课165.3.4学生查看信息175.3.5教师登录235.3.6教师课程管理245.3.7教师面试管理265.3.8教师项目管理295.3.9教师查看学生信息335.3.10 管理员账户管理用例345.4创建软件实训平台静态模型356功能需求：377.非功能性需求388.性能需求398.1响应时间398.2开放性398.3可扩展性398.4系统安全性409.产品提交409.签字40Platform Requirement Specification软件实训管理平台需求规格说明书(第二版)1、导言1.1目的 该文档是关于用户对软件实训管理平台的功能和性能的要求，重点描述了软件实训管理平台的功能需求，是概念设计阶段的重要输入。 本文档的预期读者是：l 设计人员；l 开发人员； l 项目管理人员；l 测试人员；l 用户；1.2范围该文档是借助与当前系统的逻辑模型导出目标系统的逻辑模型的，解决整个项目系统的“做什么”的问题。在这里，没有涉及开发技术，而主要是通过建立模型的方式来描述用户的需求，为客户、用户、开发方等不同参与提供一个交流的平台。1.3 缩写说明JSP:Java Server Page（Java服务器页面）的缩写，一个脚本化的语言。UML：Unified Modeling Language （统一建模语言）的缩写，是一个标准的建模语言。1.5版本更新信息本文档的更新记录表1.5所示表1.5 版本更新记录修改编号修改日期修改后版本修改位置修改内容0012009-11-230.1全部初始发布版本0022009-12-40.2目录4、5部分业务领域和业务模型0032009-12-80.35业务模型2、系统定义2.1项目来源及背景本项目的主要任务是实现软件实训基地管理流程的信化，其途径是通过为软件实训基地提供一个控制管理平台，对学员在实训过程中的信息进行记录与检阅，及时了解每名学员在实训各阶段的软件水平，最终对每名学员的总体实训水平给出客观真实的评价。本项目提供学生平台和教师管理平台两个独立的平台。具体要求如下：1) 学员可以通过学生平台，进行信息注册，填写学生基本情况表，包括年级、学号、姓名、性别、年龄、所学专业、是否有软件开发经历、联系信息（E-mail，电话，手机）等；2) 通过学生平台，学员可以查看在教师管理端发布的课程信息，包括：课程名称、课程编号、课程描述、授课老师和所有配套的培训课程；3) 通过学生平台，学员根据课程信息介绍，选择自己感兴趣的实训课程（每人仅选择一门实训课程）。如果由于某种原因学员希望退课，也可以退课；4) 当面试结束后，通过学生平台，学员应能查看自己的面试结果，是否已入选所选课程学员；5) 通过学生平台，学员查看自己参与的项目的信息，包括项目度量跟踪记录，项目跟踪评审记录；6) 通过教师管理平台，教师可以进行实训课程设置与培训课程设置，实现了课程管理功能；7) 通过教师管理平台，教师对学生进行面试管理；8) 通过教师管理平台，教师可以对学员的项目信息进行跟踪，包括输入与查看。它完成了项目度量跟踪信息记录、项目开发评审跟踪信息记录和学员实训后软件水平评定功能；9) 通过教师管理平台，教师可以查询实训学生的各种信息，实训情况。2.2用户的特点本系统的用户都是网上用户，包括两类：一类是在校本科大三大四的学生，他们是寻求实习课程培训。另一类是管理用户，主要是教师和系统管理人员。教师提供课程培训和学生学习情况跟踪，系统管理员则管理系统。2.3项目目标本项目设定的目标如下：l 界面设计简洁、美观大方、友好，使操作人员的工作量最大限度地减少；l 操作简单、快捷方便；信息分类清晰、准确l 系统具有良好的运行效率，能够达到提高生产率的目的；l 系统应有良好的可扩充性，可以容易地加入其他系统的应用；l 通过这个项目可以锻炼队伍，提高团队的开发能力和项目管理能力。3、应用环境根据用户的需求陈述，可以确定本项目分为客户端和管理端，客户端主要功能是提供学生的注册、填写学生基本情况调查表、查看教师管理端发布的课程信息、选择实训课程、退课。管理端包括教师管理和系统管理。教师管理中，教师可以实现课程管理功能、面试管理功能、项目信息进行跟踪功能、查询实训学生信息。系统管理者设置管理端的用户以及相应的权限。3.1 系统运行的网络环境本系统的网络运行图如图A-2所示，无论是客户端的学生还是管理端的教师和系统管理者都可以通过网络登陆到本系统中。学生通过网络选择课程，教师通过网络发布课程信息、进行面试管理、项目跟踪。管理端的系统管理者设置管理端的用户以及相应的权限。3.2 系统运行的硬件环境本系统的硬件环境如下：客户机：普通PCl CPU：P4 1.84GHz以上l 内存：256MB以上l 能够运行IE5.0以上的机器Web服务器l CPU：P42.0GHzl 内存：1GB以上l 硬盘：80G以上数据库服务器：l CPU：P42.0GHzl 内存：1GB以上l 硬盘：80G以上3.3 系统运行软件环境本系统的软件环境如下：l 操作系统：Windows2000或以上l 数据库：SQL Server 2000l 开发工具包：JDK Version1.5l Web服务器：Tomcatl 浏览器：IE6.0以上4、业务领域术语表初始术语表：术语、词汇名称含义备注项目一个软件开发项目指的是一个有具体市场需求和客户要求为目的的、有开发计划的、有始有终的、按照预先设定好的开发进度和步骤渐进的、为完成一个软件产品或系统的制造而进行的工作和活动。项目参数包括需要资源（人、软件/硬件）、完成时间、目标任务、项目进度、风险估量等。项目度量能够指导进行一些必要的调整以避免延迟，并减少潜在问题及风险，从而使得开发时间减到最少，在项目进行的基础上评估产品质量，并且可在必要时修改技术方法以改进质量。分别就项目的五方面：需要资源（人、软件/硬件）、完成时间、目标任务、项目进度、风险估量度量项目。项目评审是关于审查和批准项目计划，项目变更和工作进展评价的一个步骤。分为优、良、中、及格、差五个评价等级。软件水平的评定软件课程分五大类别：计算机软件、计算机网络、计算机应用技术、信息系统和信息服务。每个类别又分三个水平等级：高级资格（高级工程师）、中级资格（工程师）、初级资格（助理工程师、技术员）。5、业务模型5.1构建初始化业务模型实训基地的主要人员：实训中心的管理员和教师、学生实训基地运作的方式：首先，根据单位要求，教师通过老师管理平台设置培训课程的信息，包括培训课程的介绍、内容、日程安排、主讲老师、开始时间地点、报名状态，相关项目等，发布到平台上面；然后，学生在平台上注册个人账户，登录平台之后可以查看培训课程的信息，如果感兴趣就报名，报名后如果又觉得不合适的，允许退课；接着，老师在课程开课前一个星期结束报名，修改报名状态，查阅学生选择该课程名单，通知面试时间、地点和方式。学生面试，老师登记面试结果，并录入到实训平台上；学生通过面试，成为实训课程的学员，参与课程所配置的项目时进行自我反馈以及与老师的沟通；老师把利用本平台管理实训项目、及时跟踪指导学生/小组的学习情况，并通过平台发布实训项目的进度及效果；实训结束后，老师根据实训情况评定学生的软件水平等级，分配学生到实训基地课程所关联的单位实习。5.2创建软件实训平台用例模型创建平台用例的第一步是确定系统的参与者。软件实训平台的参与者包含以下几种，根据参与者的不同角色画出各个参与者的用例图，如图5.2所示：l 学生student：学生可以通过软件实训管理平台查看课程信息、注册登录查看个人信息、面试结果、项目跟踪和度量记录、软件评定水平等信息，还可进行选课和退课等操作；l 教师teacher：对于系统来说，学生所能查看的各种信息，例如课程信息、面试结果、项目跟踪和度量记录、软件评定水平等都要教师来进行录入和更新处理；l 管理员administrator：软件实训平台管理员负责学生、教师等用户信息的维护，并还需要对数据库进行维护操作。5.2.1、学生用例图学生能够通过该系统进行如下活动：l 注册账号：学生可以在通过填写个人资料注册个人在软件实训平台上的账号，并能凭账号和密码登录该平台；l 查看课程信息：可以通过在未登录进平台界面的情况下查看实训基地开设的所有课程详细信息；l 登录平台：学生能根据个人账号和相关密码登陆到实训平台，查看信息、退课和退课；l 查看个人资料：每一个学生都在登录后查询自己的个人信息，但是不允许在未授权的情况下查询其他人的信息；l 查看项目信息：如果登录者选修上某个课程并通过面试成为某门课程的学员，那么他就可以查看自己参与的项目信息，但不能查看他人参与的项目信息；l 选课：学生登录上平台后可以在查看课程信息的时候根据课程报名状态选择自己感兴趣的课程，但是每个学生只可以选修一门实训课程；l 退课：学生可以在查看自己已经选修的课程的同时进行退课操作；通过上述活动，获得的学生用例图如图5.2-1所示。5.2.2、教师用例图教师能够通过软件实训平台进行如下活动：l 登录平台：教师能够根据管理员注册的教师的账号和相关密码登陆到平台上，进行各项操作；l 课程设置：课程的添加、修改是通过教师来进行的。课程添加时要输入课程的详细信息；教师有权去查看各种项目详细，并作修改和删除操作；l 面试管理：教师在面试完学生后，要录入面试课程和相关面试结果（通过面试的学生名单）录入，同时可以对面试结果进行查看，删除，修改等操作；l 项目管理：教师把实训项目、及时跟踪指导学生/小组的学习情况通过平台发布实训项目的进度及效果，并把度量和评审学生项目的意见和评语录入项目信息里面，并评定学生软件水平等级；l 查看学生信息：教师能够查看的学生信息个人注册信息、选择课程、面试结果、参与项目信息；通过上述活动，获得的教师用例图如图5.2-2所示5.2.3、管理员用例图管理员能够通过软件实训平台进行如下活动：l 添加/删除教师：管理者可以通过系统添加/删除老师用户，并设置账户的基本信息；l 管理用户：管理者可以设置用户的权限。通过上述活动，获得的管理员用例图如图5.2-3所示5.3 初始需求5.3.1学生注册Use caseRegisterAccountIDUC1ActorstudentPreconditions1. A student comes to the login screen.Flow of events1. The student selects “Register”;2. The platform asks the student for account name and password;3. The student enters the requested account name; 4. The platform check the whether account name already exists in system database;5. if the account name has existed5.1 return to step3;6. Else Include (Fillinformation);The student submit;7. The platform tips successfully registered and return to login screen.Postconditions1. The student successfully registers a account.Use caseFillinformationID:UC2ActorstudentPreconditions1. A student successfully obtain a valid accountFlow of events1. The platform asks the student for Student ID(学号)、real name、grade、sex、age、department、profession、development experiencel、E-mail、telephone；2. The student enters the requested personal information;Postconditions5.3.2学生登录Use caseLogInPlatform1ID:UC3ActorstudentPreconditions1. A student comes to the login screen.Primary scenario1. The system asks for the students account name and password2. The student enters the account name and password ,then select “Log in”;3. The system test and verify the account name and password is legitimate, loads and displays the accounts information4. The student successfully logs on to the platformSecondary scenarioInvalidStudentAccountPostconditionsUse caseLogInPlatform1Secondary scenario:InvalidStudentAccountID:UC4ActorstudentPreconditions1. A student comes to the login screen.Secondary scenario1. The use case begins in step 2 of the use case LogInPlatform1 when the student enters and invalid account or password2. for three invalid entriesthe system asks the student to enter the account and password again3. the system informs the student that his/her account was not recognizedPostconditions5.3.3学生选课Use caseSelectCourseID:UC5ActorstudentPreconditions1. The student is logged on the platformFlow of events1. The use case starts when the student click “Select Couse”;2. include (ViewCourseInformation);3. The student select “Select”;4. The system retrieves and displays the students course selection information5. If the number of elective course is null5.1 The system add the selected course into the students selection information and display “Successfully add elective course”6. Else 6.1 The system display “You are only allowed one elective course”7. The student confirms the selectionPostconditions5.3.4学生查看信息5.3.4.1 学生查看课程信息Use caseViewCourseInformationID:UC6ActorstudentPreconditions1. A student comes to the login screen.Primary scenario1. The platform loads all open courses, and displays as a list;2. The student click a course name from optional course list;3. The platform display a list of all details of the selected courseSecondary scenarioSearchByCourseIDPostconditionsAlternative flow 11. At any time the student may leave the course information screenPostconditionsAlternative flow 21. At any time the student may leave the login screenPostconditionsUse caseViewCourseInformationSecondary scenario ：SearchByCourseIDID:UC7ActorstudentPreconditions1. the student click a course name from optional course listSecondary scenario1. The student selects a course2. The platform searches for courses ID that match the students selecting course;3. If the platform finds the matching course the platform loads the whole details of the selected course including ID, introduction, teacher, time, schedule and state.Postconditions5.3.4.2学生查看选课信息Use caseViewCourseSelectionInformationID:UC8ActorstudentPreconditions1. The student is logged on the platformFlow of events1. The Use case begins when the student select”View course selection information2. The platform retrieves and displays the students course selection details including course name, ID, introduction, teacher, time, schedule and state(success or fail).3. The student select “Cancel the elective course”4. The system cancel the selected course from the students selection information and display “Successfully add elective course”PostconditionsExtension use caseCancelElectiveCourseIDUC9Insertion segment1. The student uses the platform to record and cancel the elective course from database, meanwhile change the number of the elective course5.3.4.5学生查看项目信息Use caseViewItemInformationID:UC10ActorstudentPreconditions1. A student became certain Course participant，namely the student passed the interview and take the selective coursePrimary scenario1. The Use case begins when the student select “ View Item Information”2. The platform display the whole details of the item in which the student involves Secondary scenarioSearchByItemIDPostconditionsUse caseViewItemInformationSecondary scenario ：SearchByItemIDID:UC11ActorstudentPreconditionsSecondary scenario1. The platform retrieves the item ID in which the student involved2. If platform finds the item ID is not nullThe platform loads the whole details of the selected course including Item ID, introduction, teacher, time, schedule and state，itemExaminationResult（优，良，中，及格，差）.3. Else3.1 The platform display “You dont involve in any item”Postconditions5.3.4.6 学生查看个人基本信息Use caseViewPersonalInformationID:UC12ActorstudentPreconditions1. A student is logged on the platform.Primary scenario1. The Use case begins when the student select “ View Personal Information”2. The platform display the whole details that the student register,1. The student selects “Change personal information” when he/she is viewing the personal information2. The platform asks the student re-enters personal information3. The student submits the revised personal information4. The platform replaces the original information from database and display the revised personal informationSecondary scenarioSearchByStudentIDPostconditionsUse caseViewPersonalInformationSecondary scenario :SearchByStudentIDID:UC13ActorstudentPreconditionsSecondary scenario1. The platform retrieves the Student ID from Student Personal Information Form till finds the ID match the students;2. The platform loads the Student ID(学号)、real name、grade、sex、age、department、profession、software experience、E-mail、telephone;PostconditionsExtension use caseChangePersonalInformationIDUC14Insertion segment1. The student uses the platform to record and update personal information from database5.3.4.7学生查看面试结果Use caseViewIInterviewResultID:UC15ActorstudentPreconditions1、A student enters into the interface of interview results managementPrimary scenario1. The use case begins when The student select “ View interview result2. The platform displays the interview result in which the student involesSecondary scenarioSearchByInterviewIDPostconditionsUse caseViewIInterviewResultSecondary scenario :SearchByInterviewIDID:UC16ActorstudentPreconditionsFlow of events1. The platform retrieves the Student ID, and then finds the students interview ID;2. According the interview ID participated by the student, the platform loads the Interview ID(学号)、interview course and its ID、interview student name and Student ID、Pass-or-not;Postconditions5.3.5教师登录Use caseLogInPlatformID:UC17ActorteacherPreconditions1. A teacher comes to the login screen.Primary scenario1. The system asks for the teachers account name and password2. The teacher enters the account name and password ,then select “Log in”;3. The system test and verify the account name and password is legitimate(合法的), loads and displays the accounts information；4. The student successfully logs on to the platformSecondary scenarioInvalidTeacherAccountPostconditionsUse caseLogInPlatformSecondary scenario:InvalidStudentAccountID:UC18ActorteacherPreconditions1. A teacher comes to the login screen.Secondary scenario1. The use case begins in step 2 of the use case LogInPlatform when the teacher enters and invalid account or password2. for three invalid entriesthe system asks the teacher to enter the account and password again3. the system informs the teacher that his/her account was not recognizedPostconditions5.3.6教师课程管理Use caseAddCourseID:UC19ActorteacherPreconditions1. 教师进入课程设置管理界面Flow of events1. 该用例开始于教师选择“添加课程信息”；2. 平台要求教师填写所要添加的课程基本信息，包括：课程编号，课程名称，课程简介，授课老师和他的编号，课程开始时间和结束时间，课程状态（可选/结束）3. 教师填写完毕，提交给平台；4. 平台保存进数据库并把新添加的课程信息显示在页面上Postconditions教师成功添加了一门课程信息Use caseViewCourseInformationID:UC20ActorteacherPreconditions1. 教师进入课程管理界面Primary scenario1. 平台加载已经开设课程信息列表，包括（ID、名称、状态）；2. 教师从列表中选择了一门课程；3. 平台显示该门课程的详细信息，包括：课程编号ID，课程名称，课程简介，授课老师和他的编号，课程开始时间和结束时间，课程状态（可选/结束）1. 教师选择“更改此课程信息”2. 平台要求教师重新填写课程信息3. 教师提交给修改后的课程信息4. 平台把修改后的课程信息替换原有的课程信息；5. 平台显示修改后的课程信息1. 教师选择“删除此课程”2. 平台根据课程ID检索到该门课程所在存储地方并删除；3. 平台显示“成功删除该门课程”Secondary scenarioSearchByCourseIDPostconditionsAlternative flow 11. At any time the teacher may leave the course information screenPostconditionsAlternative flow 21. At any time the teacher may leave the course management interfacePostconditionsUse caseViewCourseInformationSecondary scenario ：SearchByCourseIDID:UC21ActorteacherPreconditions教师从课程列表中选择了一门课程Secondary scenario1. 平台根据被选课程的ID检索出教师所要查看的课程2. If 平台找到该门课程平台加载所要查看的课程详细信息，包括：课程编号，课程名称，课程简介，授课老师和他的编号，课程开始时间和结束时间，课程状态（可选/结束）PostconditionsExtension use caseChangeCourseInformationIDUC22Insertion segment1. 教师使用平台去更改课程设置信息，从而更新数据库Extension use caseCancelCourseIDUC23Insertion segment1. 当某门课程不再开设从而作废的时候，教师使用平台永久删除该门课程，记录开设的数量；5.3.7教师面试管理Use caseAddInterviewResultID:UC24ActorteacherPreconditions教师进入面试管理界面Flow of events1. 该用例开始于教师选择“添加面试结果”；2. 平台要求教师填写所要添加的面试结果基本信息，包括：面试结果编号（以时间编号），面试课程名称，面试课程ID，面试学生姓名，面试学生学号（即ID），面试结果（通过/不通过）3. 教师填写完毕，提交给平台；4. 平台保存进数据库并显示“添加成功，是否继续添加“5. If 教师选择“是”9.1 执行步骤2；6. Else平台显示面试结果编号和新添加的编号一样的所有面试结果信息Postconditions教师成功添加了一个面试结果Use caseViewInterviewResultID:UC25ActorteacherPreconditions1. 教师进入课程管理界面Primary scenario1. 平台加载已经录入的面试结果列表，包括（面试ID、面试课程、面试课程ID）；2. 教师从列表中选择了一个面试结果；3. 平台根据所选面试结果的ID检索并加载该面试结果信息，最终在界面上显示，显示内容包括：面试结果编号（以时间编号），面试课程名称，面试课程ID，面试学生姓名，面试学生学号（即ID），面试结果（通过/不通过）1. 教师选择“更改此学生的面试结果”2. 平台要求教师重新填写该学生的面试结果3. 教师提交给修改后的该学生面试结果4. 平台把修改后的该学生面试结果替换原有的该学生面试结果；5. 平台显示修改后的该学生面试结果信息1. 教师选择“删除此面试结果”2. 平台根据面试结果ID检索到该面试结果所在存储地方并逐个删除；3. 平台显示“成功删除该面试结果”Secondary scenarioSearchByInterviewResultIDPostconditionsAlternative flow 11. At any time the teacher may leave the interview information screenPostconditionsAlternative flow 21. At any time the teacher may leave the interview management interfacePostconditionsUse caseViewInterviewResult Secondary scenario ：SearchByInterviewResultIDID:UC26ActorteacherPreconditions教师从课程列表中选择了某一面试结果Secondary scenario1. 平台根据被选面试结果的ID检索出教师所要查看的课程2. If 平台找到面试结果2.1平台加载所要查看的课程详细信息，包括：面试结果编号（以时间编号），面试课程名称，面试课程ID，面试学生姓名，面试学生学号（即ID），面试结果（通过/不通过）PostconditionsExtension use casevoidInterviewResultIDUC27Insertion segment1. 当某个课程的已经进入授课阶段，课程学员已经定下来，那么这门课程的面试结果作废，应该删除。Extension use caseupdateInterviewResultIDUC28Insertion segment1. 教师使用平台去更改某一个学生面试结果（通过/不通过），调整课程学员。5.3.8教师项目管理Use caseMeasureItemID:UC29ActorteacherPreconditions教师进入项目管理界面Flow of events1. 该用例开始于教师选择“度量项目”；2. 平台要求教师填写所要度量的项目基本信息，包括：项目编号，项目所属课程名称、课程ID，项目需要资源（人、软件/硬件）、要求完成时间、目标任务、项目进度、风险估量3. 教师填写完毕，提交给平台；4. 平台保存进数据库并显示“添加项目度量信息成功，是否继续添加“5. If 教师选择“是”5.1 执行步骤2；6. Else平台显示新度量的项目信息Postconditions教师成功度量了一个项目Use caseExaminelItemID:UC30ActorteacherPreconditions要审核的项目必须是已经度量过的项目Flow ofEvents 1. 教师选择“度量项目”2. 平台要求教师输入要审核项目的ID3. 教师输入要审核项目的ID；4. 平台检查ID是否和已经度量的项目的ID匹配5. If ID匹配平台要求教师填写审核信息：项目审核编号，项目编号，项目名称，项目审核情况（优，良，中，及格，差）教师按要求填写完毕，提交；平台保存项目评审信息。6. Else 平台提示：“改项目还没度量，不可评审！”PostconditionsUse caseViewItemInformationID:UC31ActorteacherPreconditions要查看的项目必须是已经度量的项目Primary scenario1. 平台加载已经录入的项目列表，包括（项目ID、项目名称）；2. 教师从列表中选择了一个项目；平台根据所选项目的ID检索并加载该项目信息，最终在界面上显示，显示内容包括：项目编号，项目所属课程名称、课程ID，项目需要资源（人、软件/硬件）、要求完成时间、目标任务、项目进度、风险估量、项目审核编号，项目审核情况（优，良，中，及格，差）1. 教师选择“更改此项目的信息