中国普天项目信息管理系统之订单管理概要设计文档.doc

中国普天信息产业股份有限公司通信产业事业本部项目信息管理系统工程管理模块概要设计说明书文档编写：刘晓俊、陶惠良、张华、王昊航提交日期： 2009-07-24 审 批 人：_二零零九年七月文档修改维护记录撰写时间作者任务2009-7-11刘晓俊、陶惠良、张华、王昊航文档初稿撰写2009-7-15王昊航页面修订目 录1引言51.1编写目的51.2项目背景51.3术语51.4参考资料52任务概述62.1需求概述62.2目标62.3 运行环境63总体设计73.1总体设计方案73.2系统功能模块图83.3功能需求与程序的关系94系统数据模型设计94.1.1表一 E_projectBatch（批次单）94.1.2表二 E_packingList（装箱单）104.1.3表三 E_projectProductDetail(货物明细表)114.1.4表四 E_projectProduct（产品）114.1.5表五、E _ProjectDelivery（发货计划表一）124.1.6表六、E_ProjectDeliveryDetail（发货计划表二）124.1.7表七、E_ProjectReceivePlan（到货计划）125. 系统功能概要设计135.1 创建工程135.2收发货管理视图设计165.2.1发货计划165.2.2到货计划185.2.3发货单管理215.2.4到货确认275.2.5收发货管理查询305.2.6报表管理325.2数据模型345.2.1收发货部分数据定义345.2.1.1表一 E_projectBatch（批次单）345.2.1.2表二 E_packingList（装箱单）355.2.1.3表三 E_projectProductDetail(货物明细表)355.2.1.4表四 E_projectProduct（产品）365.2.1.5表五 E _ProjectDelivery（发货计划表一）365.2.1.6表六 E_ProjectDeliveryDetail（发货计划表二）365.2.1.7表七 E_ProjectReceivePlan（到货计划）375.2.2关联关系376Service接口386.1功能点386.1.1发货计划管理386.1.2到货计划管理386.1.3批次单管理386.1.4装箱单管理386.1.5批次单确认管理386.1.6装箱单确认管理386.1.7 收发货查询统计386.1.8 报表管理396.1.9 权限管理396.2接口396.2.1DispatchDeliveryReceivePlanService（发货计划到货计划管理Service）396.2.2DispatchBatchListService（批次单管理Service）456.2.3DispatchPackingListService（装箱单管理Service）476.2.4DispatchConfirmBatchListService（批次单确认管理Service）516.2.5DispatchConfirmPackingListService（装箱单确认管理Service）536.2.6DispatchListInquiryStaticService（收发货查询统计Service）566.2.7DispatchStaticStatementService（报表统计Service）586.2.8DispatchPermissionService（权限管理Service）591 引言1.1 编写目的 在完成了软件系统的可行性研究和需求分析的基础上，为了明确软件需求、安排项目规划与进度、组织软件开发与测试，项目小组经过讨论提出了这份概要设计说明书。此概要设计说明书对中国普天项目信息管理系统之收发货管理模块的解决方案、功能分配、模块划分、程序的总体结构、输入输出和接口设计、运行设计及出错设计等方面作了全面的概括性说明，为该软件的详细设计奠定了基础。此文档为系统分析员工作的阶段性总结，并提供项目经理、设计人员和开发人员参考。1.2 项目背景收发货模块是工程订单管理的一个子模块，该模块的总体目标是在中国普天系统事业产业本部范围内对收发货过程进行管理。所开发系统名称：中国普天项目信息管理系统之收发货管理模块项目委托单位：中国普天股份有限公司项目开发单位：北京邮电大学软件用户：中国普天系统事业产业本部所有员工及下属部门1.3 术语收发货管理：系统根据合同和创建的工程，将其中包含的各个城市（下级工程）的发货数量分批次进行发货，即制定一个发货计划。发货计划可以按照批次进行编辑，每个批次包含多个城市，每个城市可以包含对多个设备的到货量的设定。工程现场的项目经理，根据该工程本批次应到货量，对实际的收获情况进行记录，填写批次签收单，将收到的货物的数量、良品量、不良品量等进行记录1.4 参考资料工程二期模块需求规格说明书2 系统设计框架概述2.1 MVC模式概述MVC英文即Model-View-Controller，即把一个应用的输入、处理、输出流程按照Model、View、Controller的方式进行分离，这样一个应用被分成三个层模型层、视图层、控制层。 视图(View)代表用户交互界面，对于Web应用来说，可以概括为HTML界面。MVC设计模式对于视图的处理仅限于视图上数据的采集和处理，以及用户的请求，而不包括在视图上的业务流程的处理。业务流程的处理交予模型(Model)处理。比如一个订单的视图只接受来自模型的数据并显示给用户，以及将用户界面的输入数据和请求传递给控制和模型。 模型(Model)：就是业务流程/状态的处理以及业务规则的制定。业务流程的处理过程对其它层来说是黑箱操作，模型接受视图请求的数据，并返回最终的处理结果。业务模型的设计可以说是MVC最主要的核心。它仅仅告诉你按这种模型设计就可以利用某些技术组件，从而减少了技术上的困难。对一个开发者来说，就可以专注于业务模型的设计。控制(Controller)可以理解为从用户接收请求, 将模型与视图匹配在一起，共同完成用户的请求。划分控制层的作用也很明显，它清楚地告诉你，它就是一个分发器，选择什么样的模型，选择什么样的视图，可以完成什么样的用户请求。控制层并不做任何的数据处理。2.2 主要应用框架概述本模块采用Struts+Spring+Hibernate框架。其中Struts应用于系统的控制层，用于对系统的业务流程进行控制；Spring应用于系统的业务曾，用于对系统的业务数据进行配置组装；Hibernate应用于数据持久层，用于对数据进行持久化。框架设计一个最重要的特点是实现了模型视图控制器模式（MVC），模型组件封装了内核数据和功能，从而使核心的功能独立于输出表示和输入方式。视图组件从模型获得信息并向用户显示。控制器组件与唯一的一个视图组件连接，接受用户的输入。通过模型，视图和控制器的相互分离，应用框架，使得系统可以十分灵活的适应用户多变的功能要求。此外，采用框架技术进行软件开发还包括以下的主要特点：l 利用框架开发的软件具有一致性结构，框架决定了软件产品的最终形式，利用框架建立的系统很容易维护，系统之间可以很方便地相互存取，而且用户看来也是一致的。l 限制了软件设计人员一定程度的创造性行为，软件设计人员可以无须作出太多的设计决策，依照规定的方向建立应用，指导软件设计人员全面了解相关领域，充分完成需求分析，避免过早考虑实现细节，了解框架结构的软件设计人员将很快地洞悉整个系统的逻辑结构。l 大粒度的设计支持分析和设计的重用，框架把一个系统有机地分解成一群相对独立的构件，定义了各个构件间的接口和作用关系，符合软件工程中设计的模块化、独立化和信息隐藏等特征。2.3 运行环境网络环境：3 系统功能框架3.1 总体设计方案根据与普天的需求调研情况，第一阶段主要包括收发货管理、收发货查询、发货计划管理、到货计划管理、报表管理等五个大功能，具体情况如下：收发货管理：包括数据导入（装箱单、批次单），到货确认（批次单确认、装箱单确认、装箱单对应货物的确认）。发货计划管理：导入发货计划并与具体工程相关联。到货计划管理：导入到货计划并与具体工程相关联。 收发货查询：通过时间、地点、批次、货物名称等基本信息查询货物和箱子。报表管理：通过某些条件筛选导出报表。二级功能菜单：收发货管理 点击收发货管理有三级菜单：发货单管理发货计划管理到货计划管理收发货查询报表管理到货确认3.2 系统功能模块图收发货管理发货单管理发货计划管理到货计划管理收发货查询报表管理图3-1 功能模块划分到货确认各子模块的功能点简介：1、发货计划管理：(1) 导入发货计划。(2) 工程编辑。(3) 删除发货计划。（4）查看详情。2、到货计划管理：(1) 导入到货计划。(2) 工程编辑。(3) 删除到货计划。（4）查看详情。3、发货单管理：(1) 批次单管理。(2) 装箱单管理。(3) 查看发货计划。（4）查看到货计划。(5) 查看货物明细。（6）查看货物详情4、到货确认(1) 批次确认。(2) 装箱确认。(3) 查看明细。5、报表管理(1) 报表筛选查询。6、收发货查询(1) 货物查询。(2) 装箱查询。3.3 功能需求与程序的关系子模块名称功能名称对应Action名称发货计划管理导入发货计划DispatchSendplanAction工程编辑DispatchSendplanAction删除发货计划DispatchSendplanAction查看详情DispatchSendplanAction到货计划管理导入到货计划DispatchReceiveplanAction工程编辑DispatchReceiveplanAction删除到货计划DispatchReceiveplanAction查看详情DispatchReceiveplanAction发货单管理批次单管理DispatchBatchAction装箱单管理DispatchContainerAction查看发货计划DispatchSendplanAction查看到货计划DispatchReceiveplanAction查看货物明细DispatchGoodsAction查看货物详情DispatchGoodsAction到货确认批次确认DispatchBatchConfirmAction装箱确认DispatchConatinerConfirmAction货物明细确认DispatchConatinerConfirmAction报表管理报表筛选查询DispatchReportformAction收发货查询货物查询DispatchLookupAction装箱查询DispatchLookupAction4 系统数据模型设计收发货模块数据模型设计如下表所示：序号名称(英文)名称(中文)1E_projectBatch批次单2E_packingList装箱单3E_projectProductDetail货物明细4E_projectProduct产品5E _ProjectDelivery发货计划一6E_ProjectDeliveryDetail发货计划二7E_ProjectReceivePlan 到货计划5 系统功能概要设计5.1 角色权限控制与收发货管理模块相关的角色有：计划主管、项目经理、工程经理、库房管理员、生产管理员、信息主管以及关注人员。其中计划主管、生产管理员、信息主管、关注人员由系统管理员在系统角色设置中配置。项目经理、工程经理、库房管理员三个角色在工程的组织架构添加页面中添加。各角色权限如下： 表 5-1 收发货管理权限表 功能身份发货计划管理到货计划管理发货单管理收发货查询报表管理到货确认计划主管(浏览)项目经理(本地工程)(浏览)(浏览)无(浏览)工程经理(本地工程)(浏览)(浏览)无(浏览)库房管理员(本地工程)(浏览)(浏览)无信息主管生产管理员(浏览)(浏览)关注人员(只能浏览不可编辑)(浏览)(浏览)(浏览) 注：项目经理、工程经理、库房管理员只能看到自己所在的工程下的发货单红色勾表示该模块主要执行人5.2 收发货管理视图设计5.2.1 发货计划1、 点击“发货计划”二级功能，进入如下页面： 导入发货计划发货计划列表计划名称 工程编辑 查看详情 删除浙江TD计划 工程编辑 查看详情 删除 图5-2-1-1 发货计划列表页面(order_sendplan_list.jsp)点击删除，弹出对话框提示是否确定删除。2、 点击工程编辑链接，进入如下页面： 保存返回工程编辑工程名称 C工程 A工程 B工程 图 5-2-1-2 工程编辑页面 （order _project_edit.jsp）勾选相应的复选框可以把发货计划映射到相应的工程上。3、 点击“导入发货计划”后显示： 导入发货计划发货计划： *浏览发货计划名称： *校验信息数据导入返回 图5-2-1-3 导入发货计划 (order_sendplan_import.jsp)4、 点击“查看详情”后显示：地区1序号描述总数XX年XX月12341设备127411112设备259811113设备311114设备41404111114设备14391111地区2序号描述总数XX年XX月12341设备127411112设备259811113设备311114设备41404111114设备14391111地区x序号描述总数XX年XX月12341设备127411112设备259811113设备311114设备41404111114设备14391111汇总序号描述总数XX年XX月12341设备127411112设备259811113设备311114设备41404111114设备14391111图5-2-1-4 发货计划详情页面 （order_sendplan_detail.jsp）5.2.2 到货计划点击“发货计划”二级功能，进入如下页面： 返回导入到货计划到货计划列表计划名称 工程编辑 查看详情 删除浙江TD计划 工程编辑 查看详情 删除 图5-2-2-1 到货计划列表页面(order_receiveplan_list.jsp)点击工程编辑链接，进入如下页面：返回保存工程编辑工程名称 C工程 A工程 B工程 图 5-2-2-2 工程编辑页面 （order _project_edit.jsp）点击“导入到货计划”后显示：导入到货计划到货计划： *浏览到货计划名称： *校验信息 数据导入返回 图 5-2-2-3 导入到货计划页面(order_receiveplan_import.jsp)点击查看详情后显示：XX年XX月XX周批次批次发货单号需求到货日期预计到货日期实际到货日期进展风险发货通知是否已发发货单据是否已发到货单状态签收单据一月份供货地区1第1批设备12009-1-62009-1-62009-1-6已到货closedclosed完成已下单未收到设备22009-1-62009-1-62009-1-6。设备32009-1-62009-1-62009-1-6。第2批设备12009-1-132009-1-92009-1-9。设备22009-1-132009-1-92009-1-9。设备32009-1-132009-1-92009-1-9。地区2第1批设备12009-1-132009-1-132009-1-13。设备22009-1-132009-1-132009-1-13。设备32009-1-132009-1-132009-1-13。地区3第2批设备12009-1-62009-1-62009-1-6。设备22009-1-62008-12-302008-12-30。设备32009-1-62008-12-302008-12-30。第1批设备12009-1-62009-1-62009-1-6。设备22009-1-62008-12-302008-12-30。设备32009-1-62008-12-302008-12-30。第2批设备12009-1-132009-1-132009-1-13。设备22009-1-132009-1-132009-1-13。设备32009-1-132009-1-132009-1-13。图 5-2-2-4 到货计划详情页面 （order _receiveplan_detail.jsp）5.2.3 发货单管理工程列表页面： 返回工程列表工程名称工程编号 合同编号批次发货单发货计划 到货计划浙江TD工程 ZJYD0001xCP11-0580-Y3XS批次发货单 发货计划 到货计划天津TD一期 TJTD00002CP11-0898-Y3PO批次发货单 发货计划 到货计划秦皇岛TD二期 QHD00003CP11-0580-Y3XS批次发货单 发货计划 到货计划图5-2-3-1生产接口人看到的工程列表页面(order_dispatch_list.jsp)点击发货计划和到货计划可以看到已经导入的计划列表，点击列表中某一个具体计划链接，可以看到具体的计划：返回发货计划列表计划名称 查看详情 浙江TD计划 查看详情 图5-2-3-2 发货计划列表页面(order_sendplan_list.jsp )点击“查看详情”显示如下：浙江TD发货计划地区1序号描述总数XX年XX月XX年XX月123412341设备1274111111112设备2598111111113设备3111111114设备414041111111114设备143911111111地区2序号描述总数XX年XX月XX年XX月123412341设备1274111111112设备2598111111113设备3111111114设备414041111111114设备143911111111 图5-2-3-3 发货计划详情页面(order_sendplan_detail.jsp)点击“批次发货单”链接，进入页面如下： 增加浙江移动TD工程对应的批次单列表批次单号装箱个数装箱单管理 修改 删除 查看详情 ZJ-EZ01-090406045装箱单管理 修改 删除 查看详情ZJ-EZ01-090406056装箱单管理 修改 删除 查看详情导入批次单返回图5-2-3-4批次单列表页面(order_batch_list) 点击删除需弹出对话框提示是否确定删除，删除批次单后对应的装箱单信息也将被删除点击“增加”按钮，进入填写批次签收单页面： 批次单批次单号：发货信息栏项目名称：合 同 号：发货方信息收货方信息发货单位:收货单位:发货时间:到货时间:发 货 人:收 货 人:固定电话:固定电话:手 机:手 机:发货地址收货地址货物明细箱号货物名称包装类型尺寸(cm*cm*cm)重量(kg)件数(件) 图 5-2-3-5 批次单页面 (order_batch_info_jsp)点击修改和查看详情同样进入此页面点击“导入批次单”按钮，打开如下页面 ：数据校验导入批次单批次单 浏览校验信息数据导入返回图5-2-3-6批次单校验导入页面(order_batch_import.jsp)导入时，有导入进度的提示，方便用户了解信息。点击“装箱单管理”按钮，打开如下页面： 导入装箱单增加浙江TD工程ZJ-EZ01-09040604批次单对应的装箱单装箱单号货物名称 修改 删除 查看详情 ZJ-ZJ01-09BBU 1324A机箱 修改 删除 查看详情 ZJ-EZ01-07BBU 1324A S333 修改 删除 查看详情 ZJ-EZ01-08GPS安装材料 修改 删除 查看详情 返回图5-2-3-7批次单对应装箱单列表页面(order_container_list.jsp)点击删除后弹出对话框提示是否确认删除，删除装箱单后箱内货物也将被删除。点击“增加”按钮，进入填写装箱单单页面如下： 增加装箱单 箱号： * 货物名称： * 包装类型： 尺寸： 重量： 件数： * 下一步返回图5-2-3-8 增加装箱单页面 ( order_container_add.jsp)其中箱号、货物名称、件数为必填。点击下一步后进入设备装箱单页面，如下：设备装箱单 箱号：装箱日期：客户：装箱明细序号物料号序列号产品名称单位数量备注图5-2-3-9 设备装箱单页面(order_container_detail_jsp)图5-2-3-7中点击“导入装箱单”按钮，打开页面：数据校验导入装箱单装箱单浏览校验信息数据导入返回图5-2-3-9导入装箱单页面( order_container_import.jsp )图5-2-3-7中点击“查看详情”后，看到的页面如下： EZ01-09040604装箱单货物详情 货物名称 数量物料号查看明细 野战光纤A 70m3 XXXX查看明细BBU 1324A机箱4 XXXX查看明细GPS馈线3 XXXX查看明细返回图5-2-3-10货物详情页面(order_goods_info.jsp) 上图点击“查看明细”后，页面如下： 货物明细装箱单号 货物名称 物料号序列号 EZ01-09040604野战光纤A 70m XXXX 1 EZ01-09040604野战光纤A 70m XXXX 2 EZ01-09040604野战光纤A 70m XXXX 3 返回 图5-2-3-11 货物明细页面(order_goods_detail.jsp )5.2.4 到货确认库管理员看到的工程列表页面 返回工程列表工程名称工程编号合同编号到货确认管理浙江移动TD工程ZJYD0001xCP11-2006-0580-Y3XS到货确认管理天津TD一期TJTD00002CP11-2006-0898-Y3PO到货确认管理秦皇岛市TD二期QHD00003CP11-2006-0580-Y3XS到货确认管理图5-2-4-1库管理员看到的工程列表页面(order_dispatch_list.jsp)备注：谁能看到创建的按钮点击“到货确认管理”链接，打开工程到货页面 返回浙江移动TD工程到货确认批次单号 类别 确认状态 批次状态 批次确认 装箱单货物确认 编辑 ZJ-EZ01-01 正常发货 待装箱确认 齐套 批次确认 装箱单货物确认 编辑 ZJ-EZ01-02 其他 已确认 缺货 批次确认 装箱单货物确认 编辑 图5-2-4-2 工程到货页面（order_dispatch_ack.jsp）确认状态：未确认、待批次确认、待装箱确认、待货物确认、已确认 （系统经过批次确认和装箱单货物确认后自动更改）。状态更改之后不可重复确认。点击“编辑”，打开编辑页面返回保存补xxx批次齐套正常发货编辑 批次单号： ZJ-EZ01-01 类别：正常发货 批次状态：到货日期：备注： 图5-2-4-3 批次单确认页面(order_dispatch_batch_ackedit.jsp)批次单号为系统自动读入类别: 正常发货、借货、补货、其他 （必填）批次状态有：空白不填 齐套 缺货 补货 默认为空白不填（必填）到货日期为必填点击“批次确认”链接，打开批次到货确认页面 engineering_dispatch_batchconfirm.jsp缺货 损坏 齐套保存返回批次到货确认装箱单号货物名称确认情况 库房信息 分货地点 分货日期EZ01-090野战光纤A 70m EZ01-091BBU 1324A机箱 EZ01-092 GPS馈线图5-2-4-4 某工程批次到货确认页面确认情况：齐套、损坏、缺货 默认为齐套库房信息，分货地点（即站点，通过输入模糊数据与数据库信息匹配，自动列出），分货日期，非必填。点击“装箱单货物确认”链接，打开某装箱单清单，进行装箱单的确认 装箱单到货确认装箱单号 货物名称 确认情况 库房信息 分货地点 分货日期 货物确认 备注EZ01-090 野战光纤A 未确认 北京 xxxx xxxx 货物确认 备注EZ01-091 BBU 1324A未确认 北京 xxxx xxxx 货物确认 备注EZ01-092 GPS馈线 未确认 北京 xxxx xxxx 货物确认 备注图 5-2-4-5装箱单到货确认页面1、 点击备注可以进行备注编辑，页面如下：xxxxx装箱单备注编辑 备注：图5-2-4-6 装箱单备注编辑页面确认返回装箱单货物确认全选 装箱单号 货物名称 数量 物料号查看明细 验货数量缺货数量 状态 编辑 EZ01-0901 野战光纤A 70m 3 XXXX查看明细 3 1 确认 编辑 EZ01-0902 1324A机箱 4 XXXX 查看明细 4 0 待确认 编辑 EZ01-0903 GPS馈线 3 XXXX 查看明细 3 0 待确认 编辑 图 5-2-4-7 装箱单货物确认页面(order_dispatch_containerconfirm.jsp)复选框选中点击确认后 自动将验货数量变为数量值 缺货数量为0 状态为确认点击“装箱单详情编辑”后，打开页面为 xxxxxxx保存装箱单详情编辑 装箱单号:：EZ01-0901 货物名称： 野战光纤A 70m 验货数量： 缺货数量： 状态 ： 待确认 分货时间： 分货地点： 备注： 图 5-2-4-8 装箱单详情编辑页面(order_dispatch_container_ackedit.jsp )状态包括：待确认、确认、补货确认。 默认是待确认。装箱单号和货物名称是系统自动读入验货数量 缺货数量 状态 分货时间、分货地点为必填备注为非必填图5-2-4-5中点击“查看明细”后，进入货物明细确认页面： 货物明细装箱单号 货物名称数量 物料号序列号 全选EZ01-0901野战光纤A 70m 1 XXXX 1 EZ01-0902野战光纤A 70m 1 XXXX 2 EZ01-0903野战光纤A 70m 1 XXXX 3 返回确认确认 图5-2-4-9 货物明细确认页面（order_goods_acks.jsp）5.2.5 收发货管理查询 查询界面如下：返回查询收发货查询 查询内容： 货物查询 箱子查询 查询条件： 货物名称（查货物时特有 支持模糊匹配) 工程名称： 发货时间从 至到货时间从 至批次号：箱号：状态： 序列号：物料号：返回查询图 5-2-5-1 查询页面一（order_dispatch_lookup.jsp）查询结果到以下页面：返回导出货物查询结果货物名称 物料号序列号数量 批次 库房 状态 类别 备注 图5-2-5-1 查询结果页面一 (order_dispatch_lookup_detail.jsp)如果查询条件选择货物则：返回收发货查询 货物查询 箱子查询 查询条件： 工程名称： 发货时间从： 至到货时间从： 至批次号：箱号：状态： 图5-2-5-3 查询页面二（order_dispatch_lookup.jsp）箱子查询结果箱号 批次单号 货物名称 件数 库房 状态 类别 备注 图5-2-5-4查询结果页面二 (order_dispatch_lookup_detail.jsp)5.2.6 报表管理点击报表管理后进入：导出报表管理 工程名称(必选)： 货物名称（查货物时特有 支持模糊匹配)发货时间从 至到货时间从 至批次号：箱号：材料号：装箱货物名称： 序列号： 图5-2-6-1 报表查询页面（order_reportform_in.jsp）导出excel表格见“到货验货汇总表”。5.3 模型设计5.3.1 收发货部分数据定义5.3.1.1 表一 E_projectBatch（批次单）序号字段备注0ID代理主键，唯一标识1批次单号（dNo）2项目名称（project_name）3合同号（contract_no）4入库时间（Enter_time）入库时间5入库地点（Enter_address）入库地点6验货状态（Inspection_state）验货状态（包括齐套 缺货 损坏）7备注（description）8类别（category）包括：正常发货、借货、补货、其他9对应工程表ID(project_id)工程表的ID作为该表的外键10确认状态（state）包括：已确认、未确认11发货单位（Send_department）12发货时间（Send_time）13发货人（Send_person）14发货人固定电话（Send_ fixedphone）15发货人手机（Send_ cellphone）16发货人地址（