软件工程实践系统设计说明书.docx

1、软件工程实践系统设计说明书福州大学校招平台系统设计说明书组员：王铭君、康小榕、李 姣、黎焕明、李彦文、欧文才指导教师：汪璟玢待就业六人组 编写 2019.4.151引言1.1编写目的本福州大学校招平台项目（以下简称校招平台项目）的需求分析（OOA）阶段中，已经将用户对本系统的需求做了详细的分析，并在需求规格说明书中进行详尽的叙述和阐明。本阶段将在系统的需求分析的基础上，对校招平台项目进行系统设计（OOD）。主要解决实现该系统需求的程序模块设计问题。包括将系统划分为若干个模块、决定各个模块之间的接口、模块之间传递的信息等。1.2项目背景校招平台系统将由三部分组成：求职者和招聘者使用的客户端、管理

2、员使用的管理端以及数据库服务器。 : : 1.3文档约定本文档按以下要求和约定进行书写：（1）页面的左边距为3.17cm，右边距为3.17cm，装订线靠左。（2）标题最多分三级：1）一级标题：1 2 3 （宋体粗体二号）2）二级标题：1.1 1.2 1.3 (黑体三号)3）三级标题：1.1.1 1.1.2 1.1.3 （黑体四号）（3）正文字体为宋体小四号，单倍行距。无特殊情况下，字体颜色均采用黑色。（4） 出现序号的段落不采用自动编号功能而采用人工编号，各级别的序号依次为（1）、1）、a)等，部分情况序号1为（一）。（5）段落首行缩进2个字符（6）本文所引用的图片均采用PNG格式进行引用。（

3、7）页码格式为当前页/总页数a.1.4阅读建议和预期的读者本文档的主要分容共分3部分：设计类图、包图、功能模块结构。设计类图部分是将需求分析阶段的分析类映射到设计类。包图部分是采用自顶向下原则、职能集中原则、互不交叉原则对系统模块进行划分。功能模块结构是根据包图，将系统分解为多个功能较单一的的过程，形成HIPO图。预期读者为本系统的设计人员和开发人员1.5参考资料1概要设计说明书（GB856788）2详细设计说明书（GB856788）2处理流程2.1 求职者应聘流程图2.1 求职者应聘流程图2.2 招聘者招聘流程图2.2 招聘者招聘流程图3设计类图在OOA阶段，我们初步建立了类图。在OOD阶段

4、，我们详细分析了类与类之间所存在的关联性，从控制类、边界类、实体类的角度出发，进一步总结梳理出系统的组织结构。3.1 登录子系统类图3.2 参与者类图3.3 智能推送类3.4 信息管理类图3.5 信息查询类图3.6 投递简历类图3.7 审核简历类图3.8 私信类图4系统体系结构设计4.1 系统分析由OOA阶段的分析可知，类图体现了校招平台在微观上的静态结构，但由于整个系统内容繁多，较为庞大，使用类图分析将大大增多工作量，因此我们从宏观上对整个系统进行分析，将之划分为互有联系又相对独立的几部分，如下图所示。4.1.1用户包图4.1.2登录包图4.1.3界面包图4.1.4 接口包图4.2 结构设计

5、进行了以上分析之后，本平台根据小组成员过去的开发经验，决定采用MVC框架模式。MVC采用单一入口模式进行项目部署和访问，准确处理好模块与模块之间的联系。MVC包括三个部分:控制器，定义后使用视图和模型，负责通信、转发请求、响应请求；视图，实现静态的图形界面设计；模型定义相应的控制器编写算法等等实现程序功能、实现具体的数据管理和数据库设计。MVC通用的模型设计如下图所示。针对MVC架构对类和操作进行分析，得到的分析结果如下图：4.3 功能模块设计根据系统需求分析对系统进行整体的模块设计，设计出校招平台的总体功能模块结构图（HIPO）。4接口设计4.1 硬件接口（1）网络接口应用通过网络获取服务器

6、上的信息。（2）位置传感器接口应用通过位置传感器获取设备位置信息。（3）自动启动接口应用通过监听开机广播完成自启动。 （4）获取手机号接口获取当前手机的手机号4.2 软件接口接口返回统一规范“resultCode”:”,“resultMsg”：”,“resultObject”:”resultCode 返回错误码resultMsg 返回错误信息resultObject 返回对象举例：1.2. resultCode: 200,3. resultObject: 4. content: 内容 5. 6.统一全局错误码（resultCode）： 200: 请求成功1000：请求参数错误。1001：请求报

7、文不是JsobObject。1002：请求参数输入无效。1999：服务器未知错误。2001：用户被冻结。2002：sessionId过期。2003：无访问权限。2004：未注册。2005：操作太过频繁。2006：密码错误。2007：获取验证码失败。2008：账号不存在或者密码错误。2009：账号已注册。2010：手机号码错误。2011：验证码错误待扩展4.3 通信接口以下所有参数传递都采用JsonObject传递，同时请求必须携带sessionId以及用户id。（1）用户登录POST：HOST/user/login/data数据别称数据名数据类型数据长度备注手机号telephonechar14

8、必填密码passwordchar128必填用户类型usertype* 用户类型：0为普通用户，1为企业。返回数据携带sessionId。（2）用户注册发起此接口之前应当先发起获取验证码接口。POST：HOST/user/register/ data数据别称数据名数据类型数据长度备注手机号telephonechar14必填密码passwordchar32必填姓名userNamechar20必填头像链接headUrlvarchar256选填邮箱emailvarchar32选填性别sexint选填学校schoolvarchar64选填专业specialtyvarchar64选填开始时间startTi

9、medatetime选填结束时间endTimedatetime选填职业occupationvarchar32选填当前城市presentCityvarchar64选填期望城市expectedCityvarchar64选填验证码validateCodechar4-6必填*红色学历部分为最高学历，头像链接即调用upload接口返回的头像url。（3）修改用户信息发起此接口之前无需发起获取验证码接口，修改信息无需验证码验证。POST：HOST/user/modifyinformation/数据同上，不过必填全部改为选填。（4）修改手机号。发起此接口之前应当先发起获取验证码接口。POST：HOST/us

10、er/modifytelephone/data数据别称数据名数据类型数据长度备注手机号telephonechar14必填验证码validateCodechar4-6必填（5）获取验证码如果用户还未注册，那么就在用户发起获取验证码请求时分配一个临时的sessionId，当用户提交请求时，通过请求的验证码和session中的验证码进行比对。POST：HOST/getvalidatecode/data数据别称数据名数据类型数据长度备注手机号telephonechar14必填（6）修改密码POST：HOST/user/changepassword/ data数据别称数据名数据类型数据长度备注原密码pa

11、sswordchar128必填新密码new_passwordchar128必填验证码validateCodechar4-6必填（7）创建简历POST：HOST/user/createresume/data数据别称数据名数据类型数据长度备注个人信息informationinformation必填教育背景degreedegree必填求职意向jobIntentionchar64必填荣誉证书certificatecertificate选填兴趣爱好hobbychar128选填项目经历projectExperienceprojectExperience选填实践经历practicalExperiencepr

12、acticalExperience选填自我评价selfEvaluationchar256选填information数据别称数据名数据类型数据长度备注手机号telephonechar14必填姓名userNamevarchar64必填简历头像链接headUrlvarchar256必填邮箱emailvarchar64必填性别sexvarchar8必填最高学历highestEducationtinyint必填职业occupationvarchar64选填当前城市presentCityvarchar64选填期望城市expectedCityvarchar64选填* 最高学历：1为本科，2为硕士研究生，3为

13、博士研究生。degree多学历可使用xml字符串代替，字符串长度限制为1024字节。具体可参考数据别称数据名数据类型数据长度备注学校schoolvarchar64必填专业specialtyvarchar64必填开始时间startTimedatetime必填结束时间endTimedatetime必填专业课程courseschar128选填certificate数据存放同上，字符限制为1024字节。数据别称数据名数据类型数据长度备注证书名namevarchar50必填获得时间acceptTimedatetime必填级别levelint必填*级别用int常量表示（static final）： 0：d

14、efault（未填写） 1：世界级2：国家级 3：省级 4：校级 5：院级projectExperience 数据存放同上，字符限制为2048字节。数据别称数据名数据类型数据长度备注项目名namevarchar128必填开始时间startTimedatetime必填结束时间endTimedatetime必填描述descriptionchar128选填职责dutychar32选填practicalExperience 数据存放同上，字符限制为2048字节。数据别称数据名数据类型数据长度备注实践项目名namevarchar128必填开始时间startTimedatetime必填结束时间endTim

15、edatetime必填描述descriptionchar128选填职责dutychar32选填（8）修改简历POST：HOST/user/modifyresume/#resume_id此项应使用查看简历，然后传参与上面“创建简历”一样。（9）删除简历POST：HOST/user/deleteresume/#resume_id（10）查看简历POST：HOST/user/viewresume/#resume_id返回简历的实例。（11）导入简历在导入之前应当先调用上传接口。POST：HOST/user/importresume/data数据别称数据名数据类型数据长度备注简历urlresumeUr

16、lString必填（12）导出简历不需要传参数，只需要传入userId和sessionId就可以了GET：HOST/user/export_resume/#userId返回数据携带下载的url。（13）搜索招聘信息POST：HOST/user/search/data数据别称数据名数据类型数据长度备注关键词keyWordchar64必填页码pageint必填返回带数据的对象数组。（14）文件上传接口POST：HOST/upload/data数据别称数据名数据类型数据长度备注文件类型fileTypeint必填文件file必填*此项常数项暂定（15）消息推送POST：HOST/notificatio

17、n/返回数据带链接、图片链接、以及标题。（16）筛选招聘信息POST：HOST/ filterjob/data数据别称数据名数据类型数据长度备注发布时间publishTimedatetime选填相关度relativitytiny_int选填地区locationvarchar40选填发布公司publicCompanyvarchar40选填相关度只需传一个非0值即可，如果相关度为0，即不按相关度排序。（17）查看招聘信息POST：HOST/viewjob/data数据别称数据名数据类型数据长度备注职位idrecruitmentIdint必填（18）查看招聘会信息POST：HOST/viewjob/

18、#job_meeting_iddata数据别称数据名数据类型数据长度备注招聘会id jobMeetingId int必填* 此处招聘会id为-1时代表查看所有招聘会信息。（19）在线投递简历POST：HOST/delivery/数据别称数据名数据类型数据长度备注职位id recruitmentIdint必填简历idresume_idint（20）查看已投递简历状态POST：HOST/delivery_status/返回数据携带所有投递状态。（21）查看求职技巧GET：HOST/skill/（22）修改企业信息POST：HOST/modifyInformation/数据别称数据名数据类型数据长度

19、备注密码passwdvarchar32必填手机号telephonevarchar14必填公司名companyNamevarchar50必填头像链接headUrlvarchar256选填邮箱emailchar32必填企业描述descriptionchar512选填验证码validateCodechar4-6必填（23）发布招聘或者兼职信息POST：HOST/publishjob/ data数据别称数据名数据类型数据长度备注职位名jobNamevarchar40必填岗位描述descriptionchar512必填联系人及联系方式contactvarchar32必填任职资格qualification

20、svarhchar128必填地点locationvarchar64必填投递要求deliveryRequestvarchar64必填工作职责dutyvarchar64必填薪资福利salaryvarchar64必填招聘或者兼职typeint必填* 招聘或者兼职为1时为招聘，为2时为兼职（24）发布校园招聘会信息POST：HOST/publishjobmeeting/ data数据别称数据名数据类型数据长度备注公司companyIdchar128必填时间timedate必填地点locationchar32必填面向人群facingPeoplechar126必填（25）审核应聘者申请应先调用“查看应聘人

21、”的接口。POST：HOST/modifydelivery/ data数据别称数据名数据类型数据长度备注投递idresumeDeliveryIdint必填更正状态deliveryStatusint必填* 此处服务器应检查当前用户是否有更正状态的权利。（26）导入招聘信息Post：HOST/importjob/data数据别称数据名数据类型数据长度备注文件urlurl必填（27）导出招聘信息GET：HOST/user/export_recruitment/#recruitment_id返回数据携带下载的url。（28）修改招聘信息同“发布招聘或者兼职信息”，不过应当先发起查看招聘信息接口请求。Post：HOST/modifyjob/（29）查询招聘会报名人数Post：HOST/getnumberofmeeting/# recruitment_id返回数据系带当前参加招聘会人数（29）查看应聘人Post：HOST/getpeople/# resume_delivery_id 如果resume_delivery_id为-1返回数据携带当前公司所有的应聘信息，其余返回具体的应聘人的信息。