详细设计说明书-二改.docx

详细设计说明书版本 修订历史记录日期版本说明作者目录1.引言21.1编写目的21.2背景21.3定义21.4参考资料22.系统的结构23模块1（标识符）设计说明23.1模块描述23.2功能23.3性能23.4输入项23.5输出项23.6设计方法（算法）23.7流程逻辑33.8接口33.9存储分配33.10注释设计33.11限制条件33.12测试计划33.13尚未解决的问题34模块2（标识符）设计说明31.引言 1.1编写目的 本文档为了对综合业务管理平台中项目管理功能模块项目设计进行整体说明，确定系统总体的设计思路。本文档将作为项目调研阶段的交付物，用于确认调研结果，让客户更好地明晰理解设计概况，及确保设计的的完整性与准确性。以及为项目设计与开发人员理解项目业务需求及提供技术参考。 本文受众对象： 客户方：项目经理、用户； 开发方：项目经理、需求分析人员、系统设计人员、开发人员、测试人员。1.2背景 作为综合业务管理平台一部分，华油公司管理层要求对公司目前所从事的项目有一个整体的监控和了解，从宏观层面上进行项目的管控，系统作为综合业务管理平台一部分而不是一个专业的项目管理软件，专门的项目管理软件目前采用的是RedMine软件，负责项目实施中细节的管理，如进度、成本、质量等。项目管理模块的功能，是站在整个项目发生过程的角度，进行项目全生命周期的管理。针对华油公司公司的业务特点，结合项目管理的相关理念，参考国内外常用项目管理软件的功能，综合进行了需求提取。华油公司项目管理模块是公司业务综合管理平台系统的一部分，公司大多数项目是站在甲方立场和角度上进行管理，还有一些项目是基于乙方角度同时又有大量的外包工作，还有一些项目是申请的国家发改委的一些项目。公司面临的项目主要有软件开发项目、设备系统集成项目（智能建筑系统集成、计算机网络系统集成、安防系统集成）和应用系统集成项目。项目管理功能按照“项目前期准备（立项、可研、招投标）-项目启动-项目计划-项目实施与控制-项目收尾-系统运维”的通用IT项目管理过程，结合华油公司项目的特点，涵盖项目的全生命周期，重点关注项目关键节点和里程碑，例如：进度、成本、质量、费用、变更、资源等内容。不同的系统使用人员有不同的要求、关注点有所差异，对项目了解的细节层次也不同。由于项目管理更多的是站在甲方角度，公司管理人员要求项目管理不要深入到细节（细节有专业的项目管理软件RedMine），更多的是从宏观层面上或中观层面上把控项目的进展情况。该功能作为业务管理平台的一部分，而不是一个专用的项目管理软件，项目管理功能面向的是甲方项目经理、PMO和公司高管。设计的原则是系统只负责项目宏观管理，微观细节由专业项目管理软件redmine实现，通过系统与redmine的接口，提取redmine中关于项目管理的细节做展现或直接转入redmine的界面做展现，通过接口redmine把细节内容聚合后以整体的方式提供给系统，系统做整体展示。如遇到redmine未能提供功能而管理层有管理的要求，则系统设计实现。尽量保持住松耦合的设计理念，两个系统耦合尽量少，先明确好接口提供的功能，在进行设计实现。不同的系统使用人员有不同的业务要求、关注点有所差异，对项目了解的细节层次也不同。使用人员按角色分有如下角色：甲方项目经理；项目总监（PMO）；公司高管；公司财务人员；其他部门管理人员；1.3定义 CCB：Change Control Board，项目变更控制委员会。1.4参考资料 1. 详细设计说明书2. 科研经费管理系统 3. RedMine开源项目管理软件2.系统的结构 2.1 需求概述根据需求规格说明书中的规格要求，公司高管粗略了解各个项目的各项信息，也可以针对某一项目进行深入的了解；PMO和项目经理可以针对下辖的项目进行管理；财务人员仅针对项目的费用管理进行操作；项目组成员可以提交数据以及阅读上级发布的通知。2.2 软件结构项目管理系统系统登录项目总览项目管理系统管理通知管理新建项目管理已有项目管理已有项目项目概览进度管理资源管理成本管理质量管理项目干系人管理项目资料管理项目问题管理项目变更管理相关通知浏览系统由5个模块构成，其中项目管理模块下的管理已有项目功能由上述多个功能组成。3程序设计说明 项目管理系统部分类图3.1 系统登录模块3.1.1模块描述 通过系统登录模块登录系统，根据登录账号的角色，允许用户使用系统中不同的功能。如：仅管理员账号可以使用系统管理模块。3.1.2功能 允许用户输入账号密码；与数据库建立连接并验证账号密码是否匹配；根据所使用账号的角色确定系统展示的界面内容。3.1.3输入项 （用户输入）账号和密码。3.1.4输出项 根据账号角色展示系统界面。3.2 项目总览模块3.2.1 模块描述仅公司高管与PMO可使用，公司高管可以看到所有项目信息，PMO可看到其下辖的项目信息。系统总览部分类图3.2.2 功能展示用户可管理的所有项目概要信息，包括进度情况、费用情况等；展示最需要关心的项目，如进度滞后项目、预算超支项目等；用户可以针对某一个感兴趣的项目进行深入了解。3.2.3 输入项如果用户相对某一项目进行深入了解，可使用鼠标在列表中点击该项目打开该项目，进入项目管理模块。3.2.4 输出项根据用户角色生成列表，展示用户可管理的所有项目。提供用户选择的项目id，进入项目管理模块，打开所选项目。3.2.5 流程逻辑界面初始化获取可管理项目列表用户角色项目需关注程度生成排序后的项目列表系统管理模块系统登录模块项目管理模块用户选择项目3.2.6 数据结构Class ProOverviewList ListOverview;/存储可管理项目，提供给生成界面程序包List ListProID;/存储可管理项目id，用于获取ListOverviewvoid SortListOverview(List ListOverview, int flag);/根据需求进行排序3.2.7 尚未解决问题由于各项数据均由项目管理模块提供，可能会导致运算量较大，暂未计算需要使用时间，需注意此处延迟不能太高。3.3 系统管理模块3.3.1 模块描述系统管理员使用，设置用户账号、设置各项阈值等。 系统管理模块部分类图3.3.2 功能与数据库连接，对用户账号密码等信息进行增删改操作。设置各项阈值，如进度预警等。3.3.3 输入项管理员录入用户账号信息；管理员对各项数值阈值进行修改。3.3.4 输出项各项信息输出至数据库进行存储。3.3.5 数据结构Class SystemManagerint CreateChararcter();/创建新账户int ModifyCharacter();/允许重载，修改账户int DeleteCharacter();/删除账户int ChangeXXX();/对某一项阈值进行修改public interface Threshold/根据需求设置各种阈值3.4 通知管理模块3.4.1 模块描述所有人均可使用，但根据角色区别使用不同功能。管理层至项目经理可使用发布通知功能，底层项目成员只能使用通知浏览。（可选）针对特定项目组的通知，其他项目组成员不能浏览该通知。3.4.2 功能允许管理层发布通知；允许底层项目成员阅读通知。3.4.3 输入项管理层等输入通知信息，通知对象等信息3.4.4 输出项根据用户登录账户区别，看到不同的通知信息。（此功能可选）3.4.5 接口数据库提供接口进行增删改操作，有较为完善的技术与接口，此处不详细说明。3.5 项目管理模块项目管理模块部分类图3.5.1 新建项目（立项管理）3.5.1.1 模块描述增加新的项目必须通过立项管理手续，由项目经理提交立项建议书，提交立项建议书后即在数据库中添加相关词条。由相关部门进行内审、审批等手续后，将该项目设置为可编辑状态，相关项目成员和财务人员可对该项目进行编辑。立项管理部分类图3.5.1.2 功能项目经理提交项目建议书；相关人员进行项目书内审和审批。3.5.1.3 输入项项目经理按规格提交项目建议书。相关审批人员输入审批是否通过。3.5.1.4 数据结构Class ProProposallong ProjectID;String ProjectName;String Propounder;String ProposalUrl;/直接上传建议书文档intProposalStatus;get/set();static Class ProposalUtilstatic int UploadProposal(ProProposal proposal);static int OpenProposal(long ProjectID);static int ProposalInnerAudit(long ProjectID, Boolean action);/内审static int ProposalAudit(long ProjectID, Boolean action);/审核static int ProposalEgis(long ProjectID)/审核通过后，建立该项目的各模块3.5.1.5 流程逻辑通过上传建议书项目内审项目审核通过未通过通过未通过数据库建立模块建立词条3.5.2 进度管理3.5.2.1 模块描述3.5.2.2 功能3.5.3 资源管理3.5.5.1 模块描述管理项目的人力资源、设备资源、原材料等资源信息。资源管理系统部分类图3.5.5.2 功能资源导入，资源维护，资源日历，关键资源负荷平衡。3.5.5.3 输入项从人力资源系统或物资管理系统中导入该项目需要的资源信息。手动输入，修改信息资源信息。选定所列资源3.5.5.4 输出项显示所列资源的资源日历，对输入修改的成功确认3.5.5.5 数据结构Class ProResource / 资源类Long RecourseID;Bool ResourceStatu；Int RecourseType;String RecourseContentget/set();Class RecourceManagement Int RecourceLoad(Long RecourseID )/提供资源id，从资源数据库获取济源信息bool NewRecourceInput(Long RecourseID;Int RecourseType;String RecourseContent)/输入新的资源到资源数据库，成功返回真Bool EditRecourse（Long RecourseID，String NewContent）/编辑资源状态，内容，修改成功返回真string RecourseRecord（list）/对选中的一个或多个资源返回日历文件bool Resource Allocation（Long RecourseID，Int RecourseType）/对资源按照类型进行分配，使其负荷平衡3.5.4 项目成本管理3.5.4.1 模块描述成本管理的控制是以预算为起点，按照项目生命周期进行全过程管理。它从redmine中获取成本预算信息和成本监控信息，通过接口，反馈给系统的是项目总体成本情况，如看细节，进入redmine中浏览成本。成本管理系统部分类图3.5.4.2 功能有成本估算、成本预算、预算执行、成本监控四大基本功能。3.5.4.3 输入项输入项包括键盘输入的项目ID和鼠标选择的具体功能。3.5.4.4 输出项可把修改后的各项信息输出至相应数据库进行存储。3.5.4.5 数据结构Class ProjrctCostEstimate /成本估算long ProjectID;int EstimateCost；int InputCost(long ProjectID); /方法：录入成本，写入数据库。 Class ProjrctCostBudget /成本预算long ProjectID;int BudgetCost；static int UploadBudgetPlan (long ProjectID); /上传计划static int OpenBudgetPlan(long ProjectID); /打开计划static int BudgetAudit(long ProjectID, Boolean action);/审核get/set(); Class ProjrctBudgetExecute /预算执行long ProjectID;int BudgetType；/预算类型，包括收入合同签订、采购合同签订、分包合同签订、施工费用报销、零星采购。Int expense； /支出金额int InputBudget(long ProjectID); /录入预算，写入数据库。get/set();3.5.4.6 接口本模块与相应数据库和redmine存在参数传递。它从redmine中获取成本预算信息和成本监控信息，通过接口，反馈给系统的是项目总体成本情况，如看细节，进入redmine中浏览成本。3.5.5 质量管理3.5.6 项目干系人管理3.5.6.1 模块描述记录对项目的目的和结果施加影响的人和组织的基本信息。从数据库中获取信息，与项目关联并展示，提供修改和添加功能，可编辑干系人词条。记录每次与项目管理人员的沟通，包括沟通人员，沟通目的，沟通内容，并与项目本身绑定并存入数据库中。项目干系人管理系统部分类图3.5.6.2 功能获取项目干系人对项目干系人数据库数据进行修改对项目干系人词条进行修改创建沟通记录修改数据库中的沟通记录保存沟通记录浏览沟通记录3.5.6.3 输入项项目ID被访者沟通人姓名、沟通地点、沟通目的、沟通项目、沟通具体内容 3.5.6.4 输出项各项信息输出值数据库中进行存储 3.5.6.5 数据结构Class StakeholderLong Project ID;Long Stakeholder ID;String Stakeholder Expectation;Long Stakeholder Potion;List();Set/Get(); Class Stakeholder ListList Stakeholder List;Get List (Project ID);Add (List);Delet(List);Edit(List); Static Class Communication RecordLong Project ID;Long Communication Staff;Long Interviewee ID;Date Communication Date;String Description;Get/Set(); Class Communication Record ListList Communication Record List;Get List (Project ID);Add (List);Delet(List);Close(List); /关闭并保存至数据库 3.5.6.6 流程逻辑3.5.7 项目资料管理3.5.7.1 模块描述项目建设中，所有具有保存价值的各种形式的历史记录与项目本身关联，保存在数据库中，通过输入项目号进行查看这些资料。资源管理系统部分类图 3.5.7.2 功能载入项目资料新建项目资料修改项目资料关闭项目资料 3.5.7.3 输入项项目ID资料文件名资料说明资料具体内容 3.5.7.4 输出项数据输入数据库保存 3.5.7.5 数据结构Class Project DataLong Project ID;Long Data Name;String Data Explanation;String Data Detail;Get/Set(); Class Data ManagementList Datalist;Get Data List(Project ID);Add (Datalist);Delete(Datalist);Edit(Datalist);Close(); /关闭资料List(Datalist); /生成展示界面 3.5.7.6 流程逻辑3.5.8 项目问题管理3.5.8.1 模块描述记录突发问题在其生存期内不同阶段的信息，并提供浏览功能。项目问题系统部分类图3.5.8.2 功能开启新问题对问题进行修改、删除关闭问题浏览问题3.5.8.3 输入项项目经理录入问题的描述、发现时间、所在项目ID、问题级别记录潜在的解决方案、预计解决时间记录最终解决方案、实际解决时间3.5.8.4 输出项各项信息输出至数据库进行存储3.5.8.5 数据结构Class Problemlong ProblemID;long ProjectID;int ProblemLevel;intProblemStatus;String Description;Date DiscoveryTime;Date EndTime;String SolutionUrl;/直接上传解决方案Date SolutionTime;get/set();static Class ProblemUtilstatic long OpenProblem();/开启新问题，返回问题IDstatic int UploadProblem(Problem problem);static int BrowseProblem(long ProblemID);static int EditProblem(long ProblemID);static int CloseProblem(long ProblemID);3.5.8.6 流程逻辑开启问题录入问题关闭问题修改问题3.5.9 项目变更管理3.5.8.1 模块描述记录项目变更信息项目变更部分类图3.5.8.2 功能变更申请变更审核变更状态维护变更审计3.5.8.3 输入项项目经理或项目组人员填写变更申请单，上报CCBCCB给出审核意见，调整变更状态项目经理根据项目实际情况，实时调整变更状态3.5.8.4 输出项各项信息输出至数据库进行存储统计变更情况，以图形化方式显示3.5.8.5 数据结构Class ProjectChangelong ChangeID;long ProjectID;intChangeStatus;/包括申请状态、审批状态、批准/拒绝状态/变更正在实施、变更确认状态、变更完毕状态String ChangeRequestUrl;/直接上传变更申请单String AuditOpinionUrl;/审核意见String Notes;/附注get/set();static Class ProjectChangeUtilstatic long CreateChange(ProjectChange change);/提交变更申请，返回变更IDstatic int ChangeAudit(long ProblemID);/变更审计static int EditChangeStatus(long ProblemID);/变更状态更改3.5.8.6 流程逻辑直到变更完毕通过未通过提交变更申请变更审计变更状态更改变更拒绝3.5.10 进度管理3.5.10.1 模块描述记录和监控管理项目进度信息进度管理部分类图3.5.8.2 功能进度概况进度管理项目计划进度监控进度滞后分析进度预测3.5.8.3 输入项项目活动计划，开始时间与完成时间，项目滞后原因，项目计划更改信息，计划更改申请相应图像。3.5.8.4 输出项进度情况，进度滞后原因，进度预警级别，工作分解图，进度信息，计划更改申请反馈3.5.8.5 数据结构Class ProjecPlanlong ProjectID;Class ActID;long ActName;intStartTime;/项目计划开始时间 intEndTime;/项目计划结束时间 get/set(); /可用资源，List PlanINFO;Int ConflictDetector(PlanINFO); /检测资源冲突，工作时间冲突Int ChangeActPlan();/对LIST中的活动计划进行修改Int SaveActPlan();Long ActPlanCond