中国普天项目信息管理系统之工程考勤管理概要设计文档

1、.中国普天信息产业股份有限公司通信产业事业本部项目信息管理系统工程管理模块概要设计说明书文档编写： 史 爱 霞提交日期： 2009-09-21 审 批 人：_二零零九年九月文档修改维护记录撰写时间作者任务2009-9-21史爱霞文档初稿撰写2009-10-27史爱霞文档修订版1引言41.1编写目的41.2项目背景41.3术语41.4参考资料42系统设计框架概述52.1MVC模式概述52.2主要应用框架概述52.3运行环境63系统功能框架63.1总体设计方案63.2系统功能模块图73.3功能需求与程序的关系74系统数据模型设计85系统功能概要设计95.1角色权限控制95.2工程成本管理视图设计1

2、05.3模型设计105.3.1工程成本管理部分数据定义表一 E_ attendanceMonthlyManager（月考勤管理表）表二 E_ attendanceDaily（日考勤表）表三 E_ attendanceDailyManager（日考勤管理表）115.3.2关联关系115.4控制器设计125.5数据访问接口126Service接口126.1功能点126.1.1填写考勤记录126.1.2查看统计考勤记录126.1.3考勤记录管理126.2接口136.2.1MakeOutAttendanceDailyService（填写日考勤Ser

3、vice）136.2.2LookCollectAttendanceService（查看统计考勤Service）176.2.3AttendanceRecordManageService（考勤记录管理Service）211 引言1.1 编写目的 在完成了软件系统的可行性研究和需求分析的基础上，为了明确软件需求、安排项目规划与进度、组织软件开发与测试，项目小组经过讨论提出了这份概要设计说明书。此概要设计说明书对中国普天项目信息管理系统之工程成本管理模块的解决方案、功能分配、模块划分、程序的总体结构、输入输出和接口设计、运行设计及出错设计等方面作了全面的概括性说明，为该软件的详细设计奠定了基础。此文档

4、为系统分析员工作的阶段性总结，并提供项目经理、设计人员和开发人员参考。1.2 项目背景工程考勤管理模块是工程过程管理下的一个子模块，该模块的总体目标是在中国普天通信产业事业产业本部和设计院对工程进行过程中人员考勤进行管理。所开发系统名称：中国普天项目信息管理系统之工程考勤管理模块项目委托单位：中国普天股份有限公司项目开发单位：北京邮电大学软件用户：中国普天系统事业产业本部所有员工及下属部门1.3 术语日考勤表：为某工程每天所建立的考勤表月考勤表：为某工程每月所建立的考勤表。1.4 参考资料工程二期考勤界面设计说明书工程考勤规格说明需求文档2 系统设计框架概述2.1 MVC模式概述MVC英文即M

5、odel-View-Controller，即把一个应用的输入、处理、输出流程按照Model、View、Controller的方式进行分离，这样一个应用被分成三个层模型层、视图层、控制层。 视图(View)代表用户交互界面，对于Web应用来说，可以概括为HTML界面。MVC设计模式对于视图的处理仅限于视图上数据的采集和处理，以及用户的请求，而不包括在视图上的业务流程的处理。业务流程的处理交予模型(Model)处理。比如一个订单的视图只接受来自模型的数据并显示给用户，以及将用户界面的输入数据和请求传递给控制和模型。 模型(Model)：就是业务流程/状态的处理以及业务规则的制定。业务流程的处理过程

6、对其它层来说是黑箱操作，模型接受视图请求的数据，并返回最终的处理结果。业务模型的设计可以说是MVC最主要的核心。它仅仅告诉你按这种模型设计就可以利用某些技术组件，从而减少了技术上的困难。对一个开发者来说，就可以专注于业务模型的设计。控制(Controller)可以理解为从用户接收请求, 将模型与视图匹配在一起，共同完成用户的请求。划分控制层的作用也很明显，它清楚地告诉你，它就是一个分发器，选择什么样的模型，选择什么样的视图，可以完成什么样的用户请求。控制层并不做任何的数据处理。2.2 主要应用框架概述本模块采用Struts+Spring+Hibernate框架。其中Struts应用于系统的控制

7、层，用于对系统的业务流程进行控制；Spring应用于系统的业务曾，用于对系统的业务数据进行配置组装；Hibernate应用于数据持久层，用于对数据进行持久化。框架设计一个最重要的特点是实现了模型视图控制器模式（MVC），模型组件封装了内核数据和功能，从而使核心的功能独立于输出表示和输入方式。视图组件从模型获得信息并向用户显示。控制器组件与唯一的一个视图组件连接，接受用户的输入。通过模型，视图和控制器的相互分离，应用框架，使得系统可以十分灵活的适应用户多变的功能要求。此外，采用框架技术进行软件开发还包括以下的主要特点：l 利用框架开发的软件具有一致性结构，框架决定了软件产品的最终形式，利用框架建

8、立的系统很容易维护，系统之间可以很方便地相互存取，而且用户看来也是一致的。l 限制了软件设计人员一定程度的创造性行为，软件设计人员可以无须作出太多的设计决策，依照规定的方向建立应用，指导软件设计人员全面了解相关领域，充分完成需求分析，避免过早考虑实现细节，了解框架结构的软件设计人员将很快地洞悉整个系统的逻辑结构。l 大粒度的设计支持分析和设计的重用，框架把一个系统有机地分解成一群相对独立的构件，定义了各个构件间的接口和作用关系，符合软件工程中设计的模块化、独立化和信息隐藏等特征。2.3 运行环境网络环境：3 系统功能框架3.1 总体设计方案根据与普天的需求调研情况，第一阶段主要包括填写考勤记录

9、、查看统计考勤记录、考勤记录管理等三个大功能，具体情况如下：填写考勤记录：包括的功能点有：填写日考勤记录、修改日考勤记录、提交日考勤记录、查看未提交月考勤记录。查看统计考勤记录：包括的功能点有：按项目查看考勤记录、按人员查看考勤记录、按部门查看考勤记录、按项目统计考勤记录、按人员统计考勤记录、按部门统计考勤记录、导出考勤明细、导出考勤统计。考勤记录：包括的功能点有：修改考勤记录。二级功能菜单：工程考勤管理 点击工程考勤管理有三级菜单：填写考勤记录查看统计考勤记录考勤记录管理3.2 系统功能模块图工程考勤管理填写考勤记录查看统计考勤记录考勤记录管理考勤记录管理图3-1 功能模块划分3.3 功能需

10、求与程序的关系业务功能名称业务功能点对应的Action类填写日考勤记录填写日考勤记录BatchEAttendanceDailyAction修改日考勤记录AttendanceDailyAction查看未提交日考勤AttendanceDailyAction批量修改日考勤记录BatchEAttendanceDailyAction提交日考勤记录AttendanceDailyAction批量提交日考勤BatchEAttendanceDailyAction查看未提交月考勤AttendanceDailyAction提交月考勤AttendanceDailyAction批量提交月考勤BatchEAttendan

11、ceDailyAction查看月考勤详情AttendanceDailyAction查看统计考勤记录按项目查看考勤记录AttendanceLookCollectAction按人员查看考勤记录AttendanceLookCollectAction按部门查看考勤记录AttendanceLookCollectAction按项目统计考勤记录AttendanceLookCollectAction按人员统计考勤记录AttendanceLookCollectAction按部门统计考勤记录AttendanceLookCollectAction按项目导出考勤明细AttendanceExcelAction按项目导出

12、考勤统计AttendanceExcelAction按人员导出考勤明细AttendanceExcelAction按人员导出考勤统计AttendanceExcelAction按部门导出考勤明细AttendanceExcelAction按部门导出考勤统计AttendanceExcelAction考勤记录管理查询月考勤AttendanceRecordManageAction查询日考勤AttendanceRecordManageAction修改日考勤记录AttendanceRecordManageAction4 系统数据模型设计工程成本模块数据模型设计如下表所示：序号名称(英文)名称(中文)1E_ at

13、tendanceDaily日考勤2E_attendanceMonthlyManager月考勤状态3E_ attendanceDailyManager日考勤状态5 系统功能概要设计5.1 角色权限控制工程考勤管理模块共有以下几个角色：项目经理、考勤关注人员、考勤管理员。以上三种角色通过设置系统角色进行权限控制。项目经理：项目成员考勤记录的填写人员，可提交项目考勤记录。考勤关注人员：是能够查询统计所有项目组成员的出勤情况的人员。考勤管理员：负责对考勤数据进行维护，可以查看所有项目的考勤记录。各角色权限如下：功能功能点项目经理考勤关注人员考勤管理员填写考勤记录填写日考勤记录局部修改日考勤记录局部提交

14、日考勤记录局部查看未提交月考勤记录局部查看统计考勤记录按项目查询考勤记录局部全局全局按人员查询考勤记录局部全局全局按部门查询考勤记录局部全局全局按项目统计考勤记录局部全局全局按人员统计考勤记录局部全局全局按部门统计考勤记录局部全局全局考勤记录管理修改考勤记录全局 表 5-1 工程考勤管理权限表 5.2 工程成本管理视图设计见工程考勤管理界面设计说明书5.3 模型设计5.3.1 工程成本管理部分数据定义 表一 E_ attendanceMonthlyManager（月考勤管理表）序号字段备注0id标识id,自动增长1engineeringId外键，引用工程engineering 的

15、id2year_month年和月3state本月考勤记录的填写状态（待填写、待提交、已提交）工具类:FlagUtil已定义好标识4submitdate提交时间5remark备注 表二 E_ attendanceDaily（日考勤表）序号字段备注0id标识id,自动增长1employeeId外键,引用用户表id2state考勤状态：未填、请假、旷工、早退/迟到、出勤、公休-工具类:FlagUtil已定义好标识3dailyManagerId外键引用E_attendanceDailyManager表的id4makeoutDate填写日期5remark备注6engineeringId外键

16、，引用工程engineering 的id 表三 E_ attendanceDailyManager（日考勤管理表）序号字段备注0id标识id,自动增长1monthlyManagerId外键引用E_attendanceMonthlyManager表的id2daily日3year_month年月日4engineeringId外键，引用工程engineering 的id5state当日考勤记录的填写状态（待填写、待提交、已提交）6submitDate日考勤记录提交的日期7remark备注5.3.2 关联关系工程：正在实施的工程项目月考勤管理表：指的是某个工程项目某个月的考勤状态；日考勤

17、记录表：指的是某年某月某天某个人员的考勤记录；日考勤管理表：指的某年某月某天某人的日考勤状态；1、工程与月考勤管理表为一对多的关系；2、月考勤管理表与日考勤管理表为一对多的关系；3、日考勤管理表与日考勤记录表为一对多的关系；5.4 控制器设计考勤管理模块Struts-config配置文件如下：<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE struts-config PUBLIC "-/Apache Software Foundation/DTD Struts Configura

18、tion 1.1/EN" "/struts/dtds/struts-config_1_1.dtd"><struts-config><data-sources /><form-beans><form-bean name="eAttendanceDailyForm"type="com.bupt.potevio.attendance.form.EAttendanceDailyForm"></form-bean><

19、form-bean name="eAttendanceDailyDetailForm"type="com.bupt.potevio.attendance.form.EAttendanceDailyDetailForm"></form-bean></form-beans><global-exceptions /><global-forwards /><action-mappings><action path="/attendance/attendanceDaily"

20、type="org.springframework.web.struts.DelegatingActionProxy"scope="request" parameter="p" unknown="false" validate="false"><forward name="attendance_makeOut"path="engineering-attendance-makeOut"></forward><forward

21、name="searchEAttendanceDailyManagerNoSubmitByEngineeringId"path="/attendance/attendanceDaily.do?p=searchEAttendanceDailyManagerNoSubmitByEngineeringId"></forward><forward name="execute_attendance_makeOut"path="engineering-execute-attendance-makeOut"

22、;></forward><forward name="noSubmit_attendance_daily"path="engineering-noSubmit-attendance-daily"></forward><forward name="attendance_daily_detail"path="engineering-attendance-daily-detail"></forward><forward name="oSub

23、mit-attendance-monthly"path="engineering-oSubmit-attendance-monthly"></forward><forward name="attendance_monthly_detailTotal"path="engineering-attendance-monthly-detailTotal"></forward><forwardname="searchEAttendanceMonthManagerNoSubmit

24、ByEngineeringId"path="/attendance/attendanceDaily.do?p=searchEAttendanceMonthManagerNoSubmitByEngineeringId"></forward><forward name="searchEAttendanceMonthlyManagerDetail"path="/attendance/attendanceDaily.do?p=searchEAttendanceMonthlyManagerDetail">

25、</forward></action><action path="/attendance/batchEAttendanceDaily"type="org.springframework.web.struts.DelegatingActionProxy"name="eAttendanceDailyForm" scope="request" parameter="p"unknown="false" validate="false"

26、><forward name="attendance_makeOut"path="engineering-attendance-makeOut"></forward><forward name="execute_attendance_makeOut"path="engineering-execute-attendance-makeOut"></forward><forwardname="searchEAttendanceDailyByManage

27、rIdAndEngineeringId"path="/attendance/attendanceDaily.do?p=searchEAttendanceDailyByManagerIdAndEngineeringId"></forward><forwardname="searchEAttendanceDailyManagerNoSubmitByEngineeringId"path="/attendance/attendanceDaily.do?p=searchEAttendanceDailyManagerNoS

28、ubmitByEngineeringId"></forward><forward name="searchEAttendanceDailyManagerDetail"path="/attendance/attendanceDaily.do?p=searchEAttendanceDailyManagerDetail"></forward><forwardname="searchEAttendanceMonthManagerNoSubmitByEngineeringId"path=

29、"/attendance/attendanceDaily.do?p=searchEAttendanceMonthManagerNoSubmitByEngineeringId"></forward></action><!- 考勤记录管理 -><action path="/attendance/attendanceRecordManage"type="org.springframework.web.struts.DelegatingActionProxy"name="eAttend

30、anceDailyDetailForm" scope="request" parameter="p"><forward name="engineeringList"path="attendance-record-manage-definition"></forward><forward name="monthAttendanceRecordList"path="attendance-record-list-definition"&

31、gt;</forward><forward name="dailyAttendanceList"path="attendance-record-daily-list-definition"></forward><forward name="employeeAttendanceList"path="attendance-record-daily-detail-definition"></forward></action><!- 查看考勤记录

32、 -><action path="/attendance/attendanceLookCollect"type="org.springframework.web.struts.DelegatingActionProxy"scope="request" parameter="p" unknown="false" validate="false"><forward name="lookup_attendance_byengineering&quo

33、t;path="engineering-lookup-attendance-byengineering"></forward><forward name="attendance_collect"path="engineering-attendance-collect"></forward><forward name="attendance_select"path="engineering-attendance-select"></for

34、ward><forward name="lookup_attendance_bydepartment"path="engineering-lookup-attendance-bydepartment"></forward><forwardname="lookup_attendance_bydepartment_research_result"path="engineering-lookup-attendance-bydepartment-researchresult">&l

35、t;/forward><forwardname="lookup_attendance_bydepartment_statistics_result"path="engineering-lookup-attendance-bydepartment-statisticsresult"></forward><forward name="lookup_attendance_byperson"path="engineering-lookup-attendance-byperson">

36、</forward></action><!- 操作Excel -><action path="/attendance/attendanceExcelAction"type="org.springframework.web.struts.DelegatingActionProxy"scope="request" parameter="p" unknown="false" validate="false"></action&g

37、t;</action-mappings></struts-config>5.5 数据访问接口考勤访问数据访问接口如下：Spring映射文件<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd"><beans><!- 配置SessionF

38、actory -><!- 填写日考勤记录功能点Service -><bean id="makeOutAttendanceDailyService"class="com.bupt.potevio.attendance.service.impl.MakeOutAttendanceDailyServiceImpl"></bean><!- 考勤记录管理功能点Service -><bean id="attendanceRecordManageService"class="co

39、m.bupt.potevio.attendance.service.impl.AttendanceRecordManageServiceImpl"></bean><!- 查看统计考勤记录功能点Service -><bean id="lookCollectAttendanceService"class="com.bupt.potevio.attendance.service.impl.LookCollectAttendanceServiceImpl"></bean><!- 填写日考勤记录

40、功能点Action -><bean name="/attendance/attendanceDaily"class="com.bupt.potevio.attendance.action.AttendanceDailyAction"><property name="makeOutAttendanceDailyService"ref="makeOutAttendanceDailyService"></property></bean><!- 填写日考勤记录功能

41、点Action ->批量增加/修改日考勤记录-><bean name="/attendance/batchEAttendanceDaily"class="com.bupt.potevio.attendance.action.BatchEAttendanceDailyAction"><property name="makeOutAttendanceDailyService"ref="makeOutAttendanceDailyService"></property>&l

42、t;/bean><!- 考勤记录管理功能点Action -><bean name="/attendance/attendanceRecordManage"class="com.bupt.potevio.attendance.action.AttendanceRecordManageAction"><property name="attendanceRecordManageService"ref="attendanceRecordManageService"></pro

43、perty></bean><!- 查看统计考勤记录功能点Action -><bean name="/attendance/attendanceLookCollect"class="com.bupt.potevio.attendance.action.AttendanceLookCollectAction"><property name="lookCollectAttendanceService"ref="lookCollectAttendanceService">

44、;</property></bean><!- 操作Excel-><bean name="/attendance/attendanceExcelAction"class="com.bupt.potevio.attendance.action.AttendanceExcelAction"><property name="lookCollectAttendanceService"ref="lookCollectAttendanceService"></pr

45、operty></bean><bean id="sayHelloJob"class="org.springframework.scheduling.quartz.JobDetailBean"><property name="jobClass"><value>com.bupt.potevio.attendance.util.InitAttendance</value></property></bean><!- 在每一天中的特定时间调用定时器方

46、法 -><bean id="helloCronTrigger"class="org.springframework.scheduling.quartz.CronTriggerBean"><property name="jobDetail"><ref bean="sayHelloJob" /></property><property name="cronExpression"><!- 配置调用的特定时间的表达式 ->&l

47、t;value>0 11 16 * * ? *</value></property></bean><bean id="scheduler"class="org.springframework.scheduling.quartz.SchedulerFactoryBean"><property name="triggers"><ref bean="helloCronTrigger" /></property></bean&g

48、t;</beans>6 Service接口6.1 功能点6.1.1 填写考勤记录功能点：填写日考勤记录、修改日考勤记录、提交日考勤记录、查看未提交月考勤记录。6.1.2 查看统计考勤记录功能点：按项目查看考勤记录、按人员查看考勤记录、按部门查看考勤记录、按项目统计考勤记录、按人员统计考勤记录、按部门统计考勤记录。6.1.3 考勤记录管理功能点：修改日考勤记录、添加月备注。 6.2 接口6.2.1 MakeOutAttendanceDailyService（填写日考勤Service）序号方法功能说明1.public int addEAttendanceDaily(BatchEAtte

49、ndanceDailyDto batchEAttendanceDailyDto)添加（保存/提交）日考勤参数：类型BatchEAttendanceDailyDto : batchEAttendanceDailyDto 封装批量日考勤填写所需信息返回值为int0：成功；1：失败；2：在执行过程中出现异常2.public Engineering getEngineeringByEngineeringId(String engineeringId)根据工程id,得到工程实体参数：String engineeringId 工程Id返回值为 Engineering 工程实体3.public List&l

50、t;EAttendanceDaily> getEAttendanceDailyByDateAndEngineeringId(String engineeringId, String managerId)根据工程id和项目经理id，得到当日的考勤列表参数： engineeringId 工程Id；managerId 项目经理Id返回值：List<EAttendanceDaily> 日考勤记录集合4.public List<EAttendanceDailyManager> getEAttendanceDailyManagerByEngineeringIdState(St

51、ring engineeringId, String state)根据工程id和项目考勤日填写状态,得到非当前状态的日考勤管理参数：engineeringId 工程id;state 项目考勤日填写状态返回值：List<EAttendanceDailyManager> 日考勤管理集合5.public int editEAttendanceDailyManagerStateByDailyManagerId(String dailyManagerId)根据日考勤管理id更新日考勤管理的状态参数：dailyManagerId 日考勤管理实体Id返回值：返回值为int0：成功；1：失败；2：

52、在执行过程中出现异常6.public int editEAttendanceDailyManagerStateByDailyManagerId(String dailyManagerId, String managerId)根据日考勤管理id、项目经理更新日考勤管理的状态参数：dailyManagerId 日考勤管理实体Id；managerId 项目经理Id返回值：int0：成功；1：失败；2：在执行过程中出现异常7.public int editEAttendanceDailyManagerStateByDailyManagerId(String dailyManagerId)根据日考勤管理

53、id更新日考勤管理的状态参数：dailyManagerId 考勤管理实体Id返回值：int0：成功；1：失败；2：在执行过程中出现异常8.public int editEAttendanceDailyManagerStateByDailyManagerId(String dailyManagerId, String managerId)根据日考勤管理id、项目经理和提交日考勤管理参数：dailyManagerId 考勤管理实体Id；managerId 项目经理Id返回值：int；0：成功；1：失败；2：在执行过程中出现异常9.public EAttendanceDailyManager get

54、EAttendanceDailyManagerByDailyManagerId(String dailyManagerId)根据日考勤管理id,得到一个日考勤管理实体参数：dailyManagerId 日考勤管理Id返回值：EAttendanceDailyManager日考勤管理实体10.public List<EAttendanceDaily> getEAttendanceDailyNoSubmitByDailyManagerId(String dailyManagerId, String state)根据日考勤管理id和日考勤填写状态，得到非当前状态的日考勤记录参数：daily

55、ManagerId 考勤管理实体Id；state 填写状态返回值：List<EAttendanceDaily> 考勤记录的集合11.public List<EAttendanceDaily> getEAttendanceDailyNoSubmitByDailyManagerId(String dailyManagerId, String state, String managerId)根据日考勤管理id、项目经理和日考勤填写状态，得到非当前状态的日考勤记录参数：dailyManagerId 考勤管理实体Id；state 考勤状态;managerId 项目经理Id返回值：

56、List<EAttendanceDaily> 考勤记录的集合12.public int editEAttendanceDailyStateParam(String dailyId, String state,String remark)修改日考勤记录参数：dailyId 日考勤记录id;state 考勤状态;remark 备注返回值：int；0：成功；1：失败；2：在执行过程中出现异常13.public int editSaveEAttendanceDailyStateParam(String dailyId, String state,String remark, String

57、dailyManager)修改日考勤记录,更新日考勤提交状态参数：dailyId 日考勤记录id;state 考勤状态;remark 备注；dailyManager考勤管理实体Id返回值：int；0：成功；1：失败；2：在执行过程中出现异常14.public int editEAttendanceDailyState(List<AttendanceDailyDto> attendanceDailyDtoList,String dailyManagerId)批量修改日考勤记录,更新日考勤提交状态为待提交参数：attendanceDailyDto封装日考勤填写信息；dailyManag

58、erId 日考勤Id15.public int editEAttendanceMonthlyManagerStateByMonthlyManagerId(String monthManagerId)根据月考勤管理id,提交月考勤管理参数：monthManagerId月考勤管理id返回值：int；0：成功；1：失败；2：在执行过程中出现异常16.public int editEAttendanceMonthlyManagerStateByMonthlyManagerId (String monthManagerId)根据月考勤管理id,提交月考勤管理参数：monthManagerId 考勤月管理

59、 Id返回值：int；0：成功；1：失败；2：在执行过程中出现异常17.public List<EAttendanceMonthlyManager> getEAttendanceMonthlyManagerByEngineeringId(String engineeringId, String state)根据工程id,得到非当前状态的月考勤管理参数：engineeringId 工程id；state 月考勤管理状态返回值：List<EAttendanceMonthlyManager> 考勤月管理集合18.public List<String> getEAttendanceDailyTotalByMonthlyManagerId(String monthlyId)根据考勤月管理 id，查看工程某月考勤详情参数：monthlyId 考勤