概要设计说明书实例

PAGEPAGE21 引言 31.1 编写目的 31.2 背景 31.3 定义 31.4 参考资料 32 总体设计 32.1 简述 32.2 架构设计 42.2.1 系统逻辑架构图 42.2.2 系统物理架构图 42.2.3 顶层系统包图 52.2.4 业务类包图 62.2.5 子系统关系图 62.3 接口设计 62.3.1 界面框架设计 62.3.2 外部接口设计 73 子系统设计 73.1 基础信息子系统 73.1.1 子系统说明 73.1.2 类图 83.1.3 类说明 123.1.4 界面设计 193.2 我的工作台子系统 213.2.1 子系统说明 213.2.2 类图 223.2.3 类说明 263.2.4 界面设计 323.3 工作进展子系统 333.3.1 子系统说明 333.3.2 类图 343.3.3 类说明 343.3.4 界面设计 343.4 信息发布子系统 363.4.1 子系统说明 363.4.2 类图 363.4.3 类说明 373.4.4 界面设计 383.5 系统管理子系统 383.5.1 子系统说明 383.5.2 类图 393.5.3 类说明 393.5.4 界面设计 403.6 个人设置子系统 413.6.1 子系统说明 413.6.2 类图 423.6.3 类说明 433.6.4 界面设计 444 约束和假定 455 系统数据结构设计 455.1 逻辑结构设计 455.1.1 角色表（PUBLIC_ROLE） 465.1.2 权限表（PUBLIC_PRIVILEGE） 465.1.3 角色权限表（PUBLIC_ROLEPRIVILEGE） 465.1.4 部门表（PUBLIC_DEPT） 465.1.5 岗位表（PUBLIC_POST） 475.1.6 员工表（PUBLIC_MEMBER） 485.1.7 工作任务表（WORKPLAN_TASK） 485.1.8 任务分派表（WORKPLAN_ALLOTTASK） 495.1.9 工作计划表（WORKPLAN_PLAN） 495.1.10 计划任务表（WORKPLAN_PLANTASK） 505.1.11 工作日志表（WORKPLAN_WORKLOG） 505.1.12 工作汇报表（WORKPLAN_WORKREPORT） 505.1.13 信息发布表（PUBLIC_PUBLISHINFO） 505.1.14 收件箱表（PUBLIC_INBOX） 515.1.15 系统操作日志表（PUBLIC_OPERATELOG） 515.1.16 个人提醒设置表（PUBLIC_EVENTS） 525.1.17 系统表（PUBLIC_SYSTEM） 525.1.18 系统功能模块表（PUBLIC_SYSTEMMODULE） 525.2 物理结构设计 535.3 数据结构与程序的关系 536 系统出错处理设计 536.1 出错信息 536.2 补救措施 536.3 系统维护设计 53PAGEPAGE53工作计划管理系统概要设计说明书引言编写目的此概要设计说明书是为了说明整个系统的体系架构，以及需求用例的各个功能点在架构中的体现，为系统的详细设计人员进行详细设计时的输入参考文档。背景软件系统的名称：工作计划管理系统开发工具：Java开发者：定义参考资料总体设计简述系统采用流行的B/S结构模式。系统的分析设计采用面向对象的技术，应用Visio等工具进行辅助设计。架构设计系统逻辑架构图系统物理架构图顶层系统包图类包说明：业务页面：用户动态网页，主要是jsp文件。业务操作：主要控制业务访问的接口和业务流转。数据处理：提供业务的实现，包括对业务数据的增、删、改、查等操作。数据实体：业务对象的实体类。数据接口：提供数据库的访问，传递数据或返回相应数据。系统辅助：提供了供整个系统辅助的功能。业务类包图子系统关系图接口设计 界面框架设计外部接口设计说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各支持软件之间的接口关系。子系统设计基础信息子系统子系统说明基础信息子系统包括：角色管理、部门管理、岗位管理、员工管理四部分。角色管理：定义角色和系统权限之间的对应关系，方便用户权限的分配控制。部门管理：实现对公司部门基本信息的维护。岗位管理：实现对公司岗位基本信息的维护。员工管理：实现对公司员工基本信息的维护，并为员工分配角色和初始化登录系统信息。类图角色、权限部门管理岗位管理员工管理类说明角色、权限通过ID查询角色：页面得到角色ID，调用Service::角色的通过ID查询角色方法,得到指定角色的实体数据。通过名称查询角色：页面得到角色名称，调用Service::角色的通过名称查询角色方法,得到指定角色的实体数据。查询全部角色：调用Service::角色的查询全部角色方法,得到全部角色的实体数据。增加角色：在页面上得到角色的实体数据，调用Service::角色的增加角色方法，实现角色的添加。修改角色：在页面上得到修改后的角色实体数据，调用Service::角色的修改角色方法，实现角色的修改。删除角色：调用Service::删除角色方法，将指定角色的数据置为已删除状态。分配权限：调用Service::分配权限方法，给指定角色分配权限。读取角色权限：调用Service::读取角色权限方法，读取指定角色的权限数据。通过ID查询角色：调用Data::角色的通过ID查询角色方法,得到指定角色的实体数据。通过名称查询角色：调用Data::角色的通过名称查询角色方法,得到指定角色的实体数据。查询全部角色：调用Data::角色的查询全部角色方法,得到全部角色的实体数据。增加角色：调用Data::角色的增加角色方法，实现角色的添加。修改角色：调用Data::角色的修改角色方法，实现角色的修改。删除角色：调用Data::删除角色方法，将指定角色的数据置为已删除状态。分配权限：调用Data::分配权限方法，给指定角色分配权限。读取角色权限：调用Data::读取角色权限方法，读取指定角色的权限数据。通过ID查询角色：得到指定角色的实体数据。通过名称查询角色：得到指定角色的实体数据。查询全部角色：调用Data::角色的查询全部角色方法,得到全部角色的实体数据。增加角色：实现角色的添加。修改角色：实现角色的修改。删除角色：将指定角色的数据置为已删除状态。分配权限：给指定角色分配权限。读取角色权限：读取指定角色的权限数据。角色实体类数据。页面显示全部权限内容：调用Service::权限的查询全部权限或通过所属系统查询全部权限，将权限数据显示到页面上。通过所属系统查询全部权限：调用Service::权限的通过所属系统查询全部权限，读取某系统下的全部权限数据。读取用户权限：调用Service::权限的读取用户权限，读取指定用户的权限数据。查询全部权限：调用Data::权限的查询全部权限，读取全部的权限数据。通过所属系统查询全部权限：调用Data::权限的通过所属系统查询全部权限，读取某系统下的全部权限数据。读取用户权限：调用Data::权限的读取用户权限，，读取指定用户的权限数据。查询全部权限：读取全部权限数据，返回全部的权限实体类数据。通过所属系统查询全部权限：读取所属系统权限数据，返回某系统下的全部权限实体类数据。读取用户权限：读取指定用户的权限数据。权限实体类数据。部门管理 通过ID查询部门：根据部门ID，得到指定的部门实体类数据。多条件查询部门：根据多条件（部门名称、上级部门）查询对象，得到部门实体数据。查询全部部门：执行查询，获取全部部门的实体数据。增加部门：得到部门实体数据，将数据添加至库中。修改部门：得到修改后的部门实体数据，将数据保存至库中。删除部门：根据部门ID，删除指定的部门。树形显示部门：查询得到树形结构上的部门数据，并显示。此类的说明同上。此类的说明同上。部门实体类数据。岗位管理通过ID查询岗位：根据岗位ID，得到指定的岗位实体类数据。多条件查询岗位：根据多条件（岗位名称、上级岗位）查询对象，得到岗位实体数据。查询全部岗位：执行查询，获取全部岗位的实体数据。增加岗位：得到部门实体数据，将数据添加至库中。修改岗位：得到修改后的部门实体数据，将数据保存至库中。删除岗位：根据岗位ID，删除指定的岗位。树形显示岗位：查询得到树形结构上的岗位数据，并显示。此类的说明同上。此类的说明同上。岗位实体类数据。员工管理通过ID查询员工：根据员工ID，得到指定的员工实体类数据。多条件查询员工：根据多条件（工号、姓名、性别、部门、岗位、角色）查询对象，得到员工实体数据。查询全部员工：执行查询，获取全部员工的实体数据。增加员工：得到员工实体数据，将数据添加至库中。修改员工：得到修改后的员工实体数据，将数据保存至库中。删除员工：根据员工ID，删除指定的员工。员工修改登录密码：员工执行修改登录密码数据。此类的说明同上。此类的说明同上。员工实体类数据。界面设计基础信息子系统页面包括：角色管理、部门管理、岗位管理、员工管理四部分。角色管理页面部门管理页面岗位管理页面员工管理页面我的工作台子系统子系统说明我的工作台子系统包括：工作任务、工作计划、工作日志、工作汇报、审批计划五部分。工作任务：实现管理层分派任务和公司员工接收任务的管理功能。工作计划：实现公司员工制定工作计划的管理功能。工作日志：实现公司员工每天工作记录的管理功能。工作汇报：实现公司员工撰写工作汇报的管理功能。审批计划：实现管理层审批公司员工工作计划的管理功能。类图工作任务工作计划工作日志工作汇报审批计划审批计划功能的设计实现，参照类图：HYPERLINK工作计划。类说明工作任务通过ID查询任务：根据任务ID，得到指定工作任务实体类数据。多条件查询任务：根据多条件（起始日期、截止日期、任务标题、重要程度、任务状态部门、任务接收人）查询对象，得到工作任务的实体数据。查询全部任务：执行查询，获取全部工作任务的实体数据。增加任务：得到任务实体数据，将数据添加至库中。暂停任务：对指定的任务，执行暂停处理操作。处理完成任务：对指定的任务，执行完成处理操作。实时检查收到的新任务或还未做计划的任务：根据当前的用户ID，实时检查目前收到的新任务或还未做计划的任务，以便系统实时提醒用户，并弹出提醒信息。此类的说明同上。此类的说明同上。工作任务实体类数据。工作计划通过ID查询计划：根据计划ID，得到指定的工作计划实体类数据。多条件查询计划：根据多条件（起始日期、截止日期、计划标题、计划类型）查询对象，，得到工作计划实体类数据。查询全部计划：执行查询，得到全部工作计划的实体类数据。增加计划：得到计划实体数据和所属任务计划完成百分比列表，将数据添加至库中。修改计划：计划未经审批时，得到修改后的计划实体数据和所属任务计划完成百分比列表，将数据保存至库中。写计划总结：某指定的工作计划结束时，将总结内容和所属任务实际完成百分比列表数据，保存至库中。处理所属工作任务完成情况：写计划时或写总结时，保存所属工作任务列表（包括计划或实际完成百分比数据），添加至数据库。查询所属任务完成情况：根据指定的工作计划，查询其所属工作任务的完成进度情况。审批计划：管理层对某一指定的工作计划，执行审批处理，以使审批后的工作计划不能再进行修改。取消审批：管理层对某一指定的工作计划，执行取消审批处理，以使此工作计划能进行再修改。实时查询未审批的工作计划：执行查询未经管理层审批的工作计划，得到未审批的工作计划实体类数据。当有未审批信息时系统应实时提醒用户，并弹出提醒信息。多条件查询已审批的工作计划：根据多条件（起始日期、截止日期、计划比他、计划类型、创建人）查询对象，得到管理层已审批过的工作计划实体类数据。实时查询他人抄送来的工作计划：根据当前用户ID，查询得到他人抄送给自己的工作计划实体类数据。当有未阅读的信息时系统应实时提醒用户，并弹出提醒信息。处理查看未阅读的他人抄送的工作计划：根据工作计划ID，查看未阅读的他人抄送给自己的工作计划实体类数据。此类的说明同上。此类的说明同上。工作计划实体类数据。工作日志通过ID查询工作日志：根据日志ID，得到指定的工作日志实体类数据。多条件查询任务：根据多条件（起始日期、截止日期）查询对象，得到工作日志实体数据。查询全部工作日志：执行查询，得到全部的工作日志实体类数据。增加工作日志：得到工作日志实体类数据，将数据添加至库中。删除工作日志：根据日志ID，删除指定的工作日志。实时查询他人发来的工作日志：根据当前用户ID，查询得到他人发来的工作日志实体数据。当有未阅读的信息时系统应实时提醒用户，并弹出提醒信息。处理查看未阅读的他人发来的工作日志：根据工作日志ID，查看未阅读的他人发来的工作日志实体类数据。此类的说明同上。此类的说明同上。工作日志实体类数据。工作汇报通过ID查询工作汇报：根据工作汇报ID，得到指定的工作汇报实体类数据。多条件查询工作汇报：根据多条件（起始日期、截止日期）查询对象，得到工作汇报实体数据。查询全部工作汇报：执行查询，得到全部的工作汇报实体类数据。增加工作汇报：得到工作汇报实体类数据，将数据添加至库中。实时查询员工发来的工作汇报：根据当前用户ID，查询得到员工发来的工作汇报实体数据。当有未阅读的信息时系统应实时提醒用户，并弹出提醒信息。处理查看未阅读的员工发来的工作汇报：根据工作汇报ID，查看未阅读的员工发来的工作汇报实体类数据。此类的说明同上。此类的说明同上。工作汇报实体类数据。审批计划界面设计我的工作台子系统页面包括：工作任务、工作计划、工作日志、工作汇报、审批计划五部分。工作任务页面工作计划页面工作日志页面工作汇报页面审批计划页面工作进展子系统子系统说明实现管理层对公司员工工作进展情况的及时了解和跟踪。用户可根据员工姓名，对“工作任务”，“工作计划”，“工作日志”，“工作汇报”信息进行查询。查询工作任务：实现公司管理层对公司员工工作任务的执行情况的查询功能。查询工作计划：实现公司管理层对公司员工工作计划的执行情况的查询功能。查询工作日志：实现公司管理层对公司员工工作日志的查询功能。查询工作汇报：实现公司管理层对公司员工工作汇报的查询功能。类图查询工作任务查询工作任务功能的设计实现，请参照类图：HYPERLINK工作任务。查询工作计划查询工作计划功能的设计实现，请参照类图：HYPERLINK工作计划。查询工作日志查询工作日志功能的设计实现，请参照类图：HYPERLINK工作日志。查询工作汇报查询工作汇报功能的设计实现，请参照类图：HYPERLINK工作汇报。类说明界面设计工作进展子系统页面包括：查询工作任务、查询工作计划、查询工作日志、查询工作汇四部分。查询工作任务页面查询工作计划页面查询工作日志页面查询工作汇报页面信息发布子系统子系统说明实现公司内部员工之间发布信息或者通知的管理。类图类说明通过ID查询消息：根据消息ID，得到指定的消息实体类数据。多条件查询已发出的消息：根据多条件（起始日期、截止日期、接收人）查询对象，得到消息实体数据。多条件查询已收到的消息：根据多条件（起始日期、截止日期、发送人）查询对象，得到消息实体数据。发布新消息：得到发布消息实体类数据，将数据添加至库中。实时查询已收到的未阅读的消息：实时查询已收到的未阅读的消息实体类数据。当有未阅读的消息时系统应实时提醒用户，并弹出提醒信息。处理查看未阅读的消息：根据消息ID，查看未阅读的消息实体类数据。此类的说明同上。此类的说明同上。发布消息实体类数据。界面设计信息发布子系统页面包括：系统管理子系统子系统说明系统管理包括系统数据备份和系统操作日志查询功能，只有系统管理员才有权限操作此功能。系统数据备份：实现将系统数据备份到指定的路径。操作日志查询：实现查询系统数据的修改历史及登录系统用户的操作记录。类图类说明备份系统数据：执行数据备份操作，将当前系统数据库备份至指定路径。记录系统操作日志：得到登录系统人员操作日志实体类数据，将日志信息保存至库中。查询全部操作日志：执行查询，得到全部的系统操作日志实体类数据。多条件查询操作日志：根据多条件（起始日期、截止日期、姓名、功能模块、动作类型）查询对象，查询得到系统操作日志实体类数据。此类的说明同上。此类的说明同上。人员操作日志实体类数据。界面设计系统管理子系统页面包括：数据备份、操作日志两部分。数据备份页面操作日志页面个人设置子系统子系统说明个人设置子系统包括：个人提醒和修改密码两部分。个人提醒：实现员工个人对工作事务上重要事件的提醒告知功能。修改密码：实现登录用户修改维护自身密码。类图个人提醒修改密码用户修改自身登录密码功能的设计实现，请参照类图：HYPERLINK员工管理。类说明个人提醒设置个人定时提醒：得到个人提醒实体类数据，将数据添加至库中。触发已设置的个人提醒事件：触发定时提醒事件的发生。查询全部已设置的个人提醒事件：执行查询，得到全部的已设置的个人提醒事件数据。关闭已设置的提醒事件：对设置的指定提醒事件，执行关闭操作。开启已关闭的提醒事件：对已关闭的指定提醒事件，执行开启操作。删除已设置的个人提醒事件：根据指定ID，删除已设置的个人提醒事件。此类的说明同上。此类的说明同上。个人提醒实体类数据。修改密码界面设计个人设置子系统页面包括：个人提醒、修改密码两部分。个人提醒页面修改密码页面约束和假定描述系统设计中最主要的约束，这些是由客户强制要求并在需求说明书写明的。说明系统是如何来适应这些约束的。另外如果本系统跟其它外部系统交互或者依赖其它外部系统提供一些功能辅助，那么系统可能还受到其它的约束。这种情况下，要求清楚地描述与本系统有交互的软件类型（比如某某某数据库软件，某某某EMail软件）以及这样导致的约束（比如只允许纯文本的Email）。实现的语言和平台也会对系统有约束，同样在此予以说明。对于因选择具体的设计实现而导致对系统的约束，简要地描述你的想法思路，经过怎么样的权衡，为什么要采取这样的设计等等。包括运行环境的约束，简要地说明对本系统的运行环境（包括硬件环境和支持环境）的规定，详细说明参见附录C。系统数据结构设计逻辑结构设计注：表和表字段命名规范：表名的定义：规范格式：系统名_表名（字母全部大写）比如，工作计划管理系统中的某个表定义为：WORKPLAN_TASK;表字段的定义：规范格式：表名+字段名称（首字母大写），以避免字段重名出现在不同表中。比如，表WORKPLAN_TASK中的字段标识Id定义为：TaskId；表字段长度的定义：规范格式：长度一般为8的整数倍；比如，VARCHAR的长度可为8或16或24或32或64等；表字段类型为日期型的定义： 规范格式：一般日期型的字段设为VARCHAR，且长度一般为24（已精确到毫秒）公共表名的定义：规范格式：PUBLIC_表名（字母全部大写）比如，各个子系统都会用到的公共表，如角色或操作日志表可定义为：PUBLIC_ROLE，PUBLIC_OPERATELOG;角色表（PUBLIC_ROLE）字段名称中文说明键别是否空数据类型长度备注RoleId角色标识IdPKNOVARCHAR32RoleName角色名称NOVARCHAR32Remark角色说明VARCHAR128权限表（PUBLIC_PRIVILEGE）字段名称中文说明键别是否空数据类型长度备注PrivilegeId权限标识IdPKNOVARCHAR32PrivilegeCode权限编码NOVARCHAR32PrivilegeName权限名称NOVARCHAR64PrivilegeParentId上级权限IdVARCHAR32上级权限SystemId权限所属系统IdFKVARCHAR32权限所属系统角色权限表（PUBLIC_ROLEPRIVILEGE）字段名称中文说明键别是否空数据类型长度备注RoleId角色IDPK，FKNOVARCHAR32角色表外键PrivilegeId权限IDPK，FKNOVARCHAR32权限表外键部门表（PUBLIC_DEPT）字段名称中文说明键别是否空数据类型长度备注DeptId部门标识IdPKNOVARCHAR32DeptName部门名称NOVARCHAR32DeptParentId父类部门IdVARCHAR32上一级部门Tel电话VARCHAR32Fax传真VARCHAR32SortOrder排序INT4Remark备注VARCHAR128岗位表（PUBLIC_POST）字段名称中文说明键别是否空数据类型长度备注PostId岗位标识IdPKNOVARCHAR32PostName岗位名称NOVARCHAR32PostParentId父类岗位IdVARCHAR32上一级岗位DeptId所属部门IdFKVARCHAR32部门表外键Function岗位职责VARCHAR128SortOrder排序INT4员工表（PUBLIC_MEMBER）字段名称中文说明键别是否空数据类型长度备注MemberId部门标识IdPKNOVARCHAR32JobNumber工号NOVARCHAR32作为系统登录帐号使用Password登录密码NOVARCHAR32MemberName员工姓名NOVARCHAR32DeptId所属部门IdFKNOVARCHAR32部门表外键PostId所属岗位IdFKNOVARCHAR32岗位表外键Sex性别VARCHAR1Tel办公电话VARCHAR30Mobile手机VARCHAR30Email电子邮箱VARCHAR30Address住址VARCHAR64Remark备注VARCHAR128RoleId所属角色IdFKNOVARCHAR32角色表外键Status帐号状态NOVARCHAR8状态如：有效，停用；默认值为有效工作任务表（WORKPLAN_TASK）字段名称中文说明键别是否空数据类型长度备注TaskId任务标识IdPKNOVARCHAR32TaskTile任务标题NOVARCHAR32TaskContent任务内容NOVARCHAR1024Level重要程度NOVARCHAR8重要程度“★”StartDate任务开始时间NOVARCHAR24EndDate任务完成时间NOVARCHAR24CreatorId创建人IdFKNOVARCHAR32员工表外键Status任务状态NOVARCHAR8状态如：未完成、暂停、已完成AddDate创建时间NOVARCHAR24任务分派表（WORKPLAN_ALLOTTASK）字段名称中文说明键别是否空数据类型长度备注AllotId分派标识IDPKNOVARCHAR32TaskId派发的工作任务IdFKNOVARCHAR32工作任务表外键ReceiverId任务接收人IdFKNOVARCHAR32员工表外键RemainPercent任务剩余百分比NOINT4默认为100工作计划表（WORKPLAN_PLAN）字段名称中文说明键别是否空数据类型长度备注PlanId任务标识IdPKNOVARCHAR32PlanType计划类型NOVARCHAR64计划类型如：周计划、月计划、年计划PlanTitle计划标题NOVARCHAR32PlanTime计划时间NOVARCHAR32PlanContent计划内容NOVARCHAR1024PlanSum计划总结VARCHAR1024CreatorId创建人IdFKNOVARCHAR32员工表外键AddDate创建时间NOVARCHAR24AuditorId计划审批人IdFKNOVARCHAR32员工表外键IsAudit是否审批NOVARCHAR8是或否，默认值为否计划任务表（WORKPLAN_PLANTASK）字段名称中文说明键别是否空数据类型长度备注PlanId计划标识IdPK，FKNOVARCHAR32AllotId接收的任务标识IdPK，FKNOVARCHAR32PlanPercent任务计划完成百分比NOINT40到100之间FinishedPercent任务实际完成百分比INT40到100之间工作日志表（WORKPLAN_WORKLOG）字段名称中文说明键别是否空数据类型长度备注LogId工作日志标识IdPKNOVARCHAR32LogInfo日志记录NOVARCHAR1024LogSum日志小结VARCHAR1024CreatorId创建人IdFKNOVARCHAR32员工表外键AddDate创建时间NOVARCHAR24工作汇报表（WORKPLAN_WORKREPORT）字段名称中文说明键别是否空数据类型长度备注ReportId汇报标识IdPKNOVARCHAR32ReportTitle标题NOVARCHAR32ReportContent内容NOVARCHAR1024CreatorId创建人IdFKNOVARCHAR32员工表外键AddDate创建时间NOVARCHAR24信息发布表（PUBLIC_PUBLISHINFO）字段名称中文说明键别是否空数据类型长度备注InfoId消息标识IdPKNOVARCHAR32Title主题NOVARCHAR32Content内容NOVARCHAR1024CreatorId创建人IdFKNOVARCHAR32员工表外键AddDate创建时间NOVARCHAR24收件箱表（PUBLIC_INBOX）字段名称中文说明键别是否空数据类型长度备注BoxId标识IDPKN