电力巡检系统详细设计文档

软件需求说明书案卷号 100001日期 2015 年 12 月 12日电力巡检系统软件详细设计说明书2015 年 12 月软件需求说明书文档更改历史记录序号 主要更改内容 版本号 更改人 更改时间1 提交初始版本 1.0 谢凤祥 2015-12-15234567891011121314151617181920软件需求说明书第一部分、概述1、文档说明本文档系统的描述了“大额票据登记核查”系统的设计文档。系统使用面向对象的设计方法，首先设计系统的总体结构，再设计各个用例的实现，为系统设计人员提供详细设计和具体开发依据。2、系统需求概述第二部分、系统总体结构系统设计时基于 Struts 实现 MVC 设计模型，采用三层架构，如图二所示。图二：“通讯录名片管理”系统的体系结构第三部分、系统设计关键抽象软件需求说明书用例的设计使用面向对象设计时，关键在于描述那些对象如何交互完成用例的功能，通常将对象发送消息的相互调用过程画成时序图。下面将逐一解释用例的时序图。Req3.1 公共功能req3.1.1 用户登录A,时序图AccountLogin(string loginId, string password) AccountLogin(string loginId, string password)AccountAccountBtnLogin_Click(object sender,EventArgs e)Login.aspx AccountManager AccountServiceB、描述编号 类名或方法名 功能描述1 Login.aspx aspx 页面,进入系统登录页面，表单内容包括：登录帐号(使用文本框，必填项 , 六位，字母与数字) ，密码(使用文本框, 必填项，六位，字母与数字 )（验证控件实现）用户填写表单，点击 BtnLogin 按钮确认。2 Login.aspx.cs 表示层调用 BtnLogin(object sender,EventArg e)方法收集表单信息，开始处理3 AccountManager 业务逻辑层，其 AccountLogin(string loginId,string password)方法负责判断帐户是否合法.4 AcccountService 数据层，其 AccountLogin(string loginId,string password)方法负责查询数据库匹配5 Login.aspx.cs 根据前者返回结果 Account 判断如何跳转。成功登录后根据职位不同，显示不同界面，并保存用户信息于Session。失败仍显示 Login.aspx(登录界面),被冻结的帐号无法登陆。巡检员登录成功跳转：SearchPerNewTask.aspx线路管理员登录成功：AssignFix.aspx系统管理员登录成功：AccountList.aspx软件需求说明书req3.1.2 修改个人帐户A,时序图ModifyAccount(Account account) ModifyAccount(Account account)boolboolBtnUpdateAccount_Click(object sender, EventArgs e)ShowAccountInfo(object sender, EventArgs e)ModifyAccount.aspx AccountManager AccountServiceB、描述编号 类名或方法名 功能描述1 ModifyAccount.aspxaspx 页面，个人资料修改页面，表单如下：密码，新密码，确认密码：文本框（6 位，密码加数字）仅当用户输入旧密码、新密码及确认密码时，更新密码字段其余表单部分如下：联系电话：文本框（不超过 15 位）Email：文本框（格式检验必须有 不超过 25 位）格式验证由验证控件实现，不得为空；有密码输入时，需判断新密码、确认密码是否匹配。表示层调用 ShowAccountInfo(object sender, EventArgs e)于页面展示用户当前信息(Session 中读取) 2 ModifyAccount.aspx用户填写表单，点击 BtnUpdateAccount 按钮3 ModifyAccount.aspx表示层调用 BtnUpdateAccount_Click(object sender,EventArgs e)进行表单数据收集4 AccountManager 业务层，其 ModifyAccount(Account account)方法负责逻辑处理.5 AccountService 数据层，ModifyAccount(Account account)查询数据库操作6 ModifyAccount.aspx页面提示更新结果软件需求说明书Req3.2 系统管理员模块标号 req3.2.1 查看人员列表A,时序图SearchAccount(params object args) SearchAccount(params object args)IListIListBtnSearchAccount_Click(object sender, EventArgs e)AccountList.aspx AccountManager AccountServiceB、描述编号 类名或方法名 功能描述1 AccountList.aspx aspx 页面，查询系统所有用户帐号列表（GridView:GvAccountList）列表内容包括：姓名，用户帐号，性别，入职日期，离职日期，电话，邮箱，创建时间，职位名称，用户状态，设置帐号状态链接，修改职位链接筛选条件包括：姓名，用户帐号及是否启用。前两者为文本框，后者为下拉列表（无，启用，未启用） 。页面初次加载显示默认人员列表按姓名排序，仅显示非禁用状态用户；用户填写搜索表单，点击 BtnSearchAccount按钮2 AccountList.aspx.cs表示层：BtnSearchAccount_Click(object sender,EventArgs e)进行查询表单数据收集3 AccountManager 业务层，SearchAccount(string accuntName,string loginId, string isValid)方法进行模糊查找逻辑。4 AccountService 数据访问层，其 SearchAccount(string accuntName,string loginId, string isValid)根据条件筛选，从数据库中搜索帐号数据，返回泛型 Account 集合5 AccountList.aspx 显示筛选后的帐号列表,搜索数据结果为空时页面另作提示。软件需求说明书标号 req3.2.2 增加人员A,时序图AddAccount(Account account)AddAccount(Account account)Account accountAccount accountGetAccountByLoginId(string loginId)AccountBtnAddAccount_Click(object sender, EventArgs e)UCCheckNameValid_CheckNameHandler(object sender, EventArgs e)IsLoginIdValid(string loginId)boolCreateAccount.aspx AccountManager AccountServiceB、描述编号 类名或方法名 功能描述1 CreateAccount.aspx aspx 页面,开设帐号页面，表单内容包括：用户帐号：文本框，6 位，字母与数字格式，必填姓名：文本框，长度位以内，必填性别：RadioButton 选择，男，女入职日期：JS 控件日历，格式控制，必填Email:文本框必须含有 符号（长度不超过 25 位）联系电话：文本框，数字格式，必填密码默认 000000，帐号默认启用格式验证由验证控件实现表示层：用户输入用户账号后，焦点离开文本框TxtLoginId，ajax 用户控件调用UCCheckNameValid_CheckNameHandler(object sender, EventArgs e)软件需求说明书2 AccountManager 业务层：IsLoginIdValid(string loginId)判断用户名是否存在3 AccountService 数据层：GetAccountByLoginId(string loginId)负责数据库读取4 CreateAccount.aspx.cs表示层：用户输入账号信息，点击 BtnAddAccount 按钮,调用 BtnAddAccount_Click(object sender, EventArgs e)进行表单数据收集4 AccountManager 业务层：AddAccount(Account account)负责增加帐号逻辑5 AccountService 数据层：AddAccount(Account account)负责数据库写操作6 CreateAccount.aspx Aspx 页面获取操作结果是否成功软件需求说明书req3.2.3 设置帐号状态A,时序图GetAccountById(int accountId)GetAccountById(int accountId)Account accountAccount acccountShowCurrentStatus(object sender, EventArgs e)BtnSetStatus_Click(object sender, EventArgs e)ChangeAccountStatus(bool enabled,int accountId) ModifyAccount(Account account)bool跳 跳href_EnableUserSetAccountStatus.aspx AccountManager AccountServiceAccountList.aspxB、描述编号 类名或方法名 功能描述1 AccountList.aspx aspx 页面，点击用户状态设置链接，跳转至SetAccountStatus.aspx2 SetAccountStatus.aspxaspx 页面,设置帐号状态页面，显示帐号：调用 ShowCurrentStatus(object sender, EventArgs e)方法，页面显示帐号及姓名，及当前账号状态3 AccountManager 业务层调用 GetAccountById(int accountId)负责业务逻辑4 AccountService 数据层调用 GetAccountById(int accountId)负责数据库操作5 AccountList.aspx 用户点击确认 BtnSetStatus 按钮，调用BtnSetStatus_Click(object sender, EventArgs e)进行数据收集6 AccountManager 业务层：ChangeAccountStatus(bool enabled,int accountId)负责设置帐号是否启用7 AccountService 数据层：ModifyAccount(Account account)负责数据库写操作8 SetAccountStatus.aspxAspx 页面获取操作结果是否成功,如成功则跳回AccountList.aspx软件需求说明书标号 req3.2.4 修改用户职位A,时序图ChangeAccountRole(Account account,Role role) ModifyAccount(Account account)bool跳 跳ShowAccountInfo(object sender, EventArgs e)href_SetPostGetAccountById(int accountId) GetAccountById(int accountId)Account accountAccount accountBtnSetRole_Click(object sender, EventArgs e)AccountList.aspx SetAccountPost.aspx AccountManager AccountServiceB、描述编号 类名或方法名 功能描述1 AccountList.aspx aspx 页面，点击用户职位设置链接，跳转至SetAccountPost.aspx2 SetAccountPost.aspxaspx 页面,设置帐号状态页面，显示帐号：帐号及姓名下拉列表显示职位选择，从数据库读取（数据源绑定业务层 RoleManager.GetAllRoles，数据层RoleService.GetAllServices） 。表示层调用 ShowAccountInfo(object sender, EventArgs e)获取当前需要修改的 account3 AccountManager 业务层：GetAccountById(int accountId)负责业务逻辑处理4 AccountService 数据层：GetAccountById(int accountId)负责