3ITMOB物流管理系统概要设计说明书v11

1、物流管理系统概要设计说明书编写：胡博磊审核：批准：受控状态：日期：2009-09-04日期：日期：是发布版次：1.0编号：日期：2009-09-05变更记录日期版本艾更说明作者2009-09-131.0初始版本胡博磊签字确认系统模块对应章节对应部门负责人签字目录1 1引言5 51.1编写目的51.2背景51.3基线51.4特殊名词定义51.5参考资料52 2总体设计5 52.1概述52.2系统环境描述52.2.1运行环境62.2.2开发环境62.3系统总体结构设计82.3.1系统业务层次图82.3.2系统架构说明92.3.3软件架构说明（选作）92.3.4关键技术与算法142.2.3关键数据结

2、构（选作）153 3系统功能设计1515分公司151.1.1.%41.1.1.%4订单管理151.1.2.%41.1.2.%4订单发货171.1.3.%41.1.3.%4订单发货211.1.4.%41.1.4.%4货物配送241.1.5.%41.1.5.%4订单异常处理251.1.6.%41.1.6.%4本地信息设置271.1.7.%41.1.7.%4财务管理29客户端311.2.1.%41.2.1.%4运费查询311.2.2.%41.2.2.%4下订单321.2.3.%41.2.3.%4订单进度查询33总公司341.3.1.%41.3.1.%4线路管理341.3.2.%41.3.2.%4车辆

3、管理351.3.3.%41.3.3.%4班次管理361.3.4.%41.3.4.%4配送点管理381.3.5.%41.3.5.%4财务管理394 4尚待解决的问题41411 1引言3.1 编写目的本说明书目的在于明确说明系统各功能的实现方式，指导开发员进行编码。本说明书的预期读者为：系统设计者、系统开发员。3.2 背景待开发软件系统的名称：物流配送管理系统此软件系统任务提出者：客户（从事物流业）此软件系统任务开发者：IT_MOB小组此软件系统任务用户：需要提供配送的客户、配送点和物流总公司3.3 基线物流配送管理系统需求分析说明书V1.03.4 特殊名词定义客户：客户分为已达成交易的实际客户和

4、未交易的潜在客户，本文档涉及到的所有客户都是已注册并登陆客户端的用户。3.5 参考资料属于本项目的其他已发表的文件。本文件中引用的其他文献、资料以及软件开发标准。2 2总体设计概述系统环境描述系统包括的范围：物流配送管理系统。3.5.1.%43.5.1.%4运行环境分类名称版本语种操作系统WindowsXP2000简体中文操作系统的附加功能SP43简体中文数据库平台oracle92间体中文应用平台tomcat5.0间体中文邮件系统Foxmail4.2.0简体中文客户端软件MSIE7.0简体中文2.2.1.22.2.1.2硬件环境服务器最低配置推荐配置应用和数据1CPU:P42.0G1CPU:P

5、42.8G库服务器Mem：512MMem:2GHD:40GHD:120G邮件服务器Webmail2CPUcore22.4GB3.5.2.%43.5.2.%4开发环境3服务器软件环境分类名称版本语种操作系统Windowsserver2003简体中文数据库平台oracle92简体中文应用平台tomcat5.0简体中文邮件系统Foxmail4.2.0简体中文3服务器硬件环境服务器最低配置推荐配置应用服务器、数据库服务器、邮件服务器、目录服务器1CPU:P42.0G1CPU:P42.8GMem：512MMem:2GHD:40GHD:120G3开发机器软件环境分类名称版本语种操作系统WindowsXP2

6、000间体中文数据库平台oracle92间体中文应用平台tomcat5.0简体中文开发平台JDK1.5央文3开发机器硬件环境分类最低配置推荐配置开发机器1CPU:P42.0G1CPU:P42.8GMem：512MMem:2GHD:40GHD:120G系统总体结构设计3.6.1.%43.6.1.%4系统业务层次图内容描述：物流管理系统是应当前物流发展趋势的产物，旨在为物流组成的各项业务提供一个完整、统一的平台，具有信息共享，资源合理分配，业务协调统一的特点。它分为前台客户端、后台总公司与分公司端共三个子系统。图例：功能简介（类似需求分析）：客户端：查询运费，下订单和订单进度查询；分公司：订单管理

7、（下订单，订单审核，订单修改，订单状态修改），订单异常处理（订单异常处理登记，订单异常处理查询），订单发货（待发订单查询，加开班次申请，交接单生成，交接单绑定，紧急订单提醒，班次查询），交接单管理（交接单生成，交接单绑定，交接单确认，交接单修改），订单收获（交接单确认，交接单修改，班次查询），货物配送（库存订单查询，订单确认），本地信息设置（中转路线选择，配送价格申报）；总公司：配送点管理（添加新配送点，审核各配送点申报的配送费方案），财务管理（统计各部门收益，制定和调整利润分配方案），信息查询（交接单查询，订单查询），线路设置（建立基本线路，管理线路，提供线路查询），运费管理（制定和修改运费

8、方案，提供运费查询），车辆管理（维护车辆基本信息），班次管理（设置班次，为配送点提供班次查询，处理配送点加急班次申请），权限管理（权限分配，后台用户的管理）。沌口亚朝中期:亚nw朝二诉I二诉I安尊二旧二阴小旭申诉两客两值r加:0口1期二?口?二诉诉诉?回流配送管理II烹统一分公司（配送点?查询运费订单收获订单发货下定单总公司订单管理货物配送，查询订单进度“订单异常管理本地.信息设置财务管理权限管理加疗右右耳窗西”见匕笑电幺n匕含疗/光芍户嘘幺门及0#也，杆杆莒杆莒之222彳线路管理车辆菅理信息者询3.6.2.%43.6.2.%4系统架构说明说明整个系统的软硬件架构层次图例如下：3.6.3.%4

9、3.6.3.%4软件架构说明（选作）书写要求：根据系统设计的功能层次逐一说明（与需求分析中的“系统功能总体说明”部分的内容基本一致）2.2.1.2系统架构设计说明共享数据库网路基础服网络设施总公司业务功能客户端功能分公司业务功能书写要求：根据系统的功能需求设计并说明系统开发所采用的软件开发架构。书写样例：Jsp&Servlet&JavaBean架构架构结构具体架构层次如图4.1所示。数据库图4.1Jsj架构结构各层实现功能说明View层是与客户的交互层，负责提交用户请求和数据，并将后台的响应结果返回给客户层。同时提供客户提交信息的javasript验证功能。Control层负责

10、项目中业务功能实现流程的管理工作。如：具体的业务功能由哪些类来实现，实现结果有谁来显示等等，必须由Control层来决定。同时Control层还要负责与其它两层的信，这个过程还需要一些bean类来协助传递信息，另外Control层还要负责请求的转发与从定向。从Control层所负责的功能上不难想象的到在业务逻辑相对复杂的时候此层代码编写会略显繁重和复杂。Model层主要是一些实现具体业务功能的类，在这里可以统一简称为Business类。 也可以将架构中除了Servlet控制器之外的所有类统一叫做Javabean类。 从这种命名方式上可以看出，model层在实现业务功能是具体的实现方式比较自由，

11、但在业务逻辑比较复杂的情况下model层职能的划分会出现问题，可能会造成一定混乱和不便。设想一下如果可以更明确的将model层进一步划分使之变得更有条理， 这样就会增强该层的可维护性了。特别说明，图4.1中的“bean”可以看作数据封装类，它以实例对象的形式作为各层之间数据信的载体，实际上这些对象也属于业务对象，如User对象、Book对象。Jsp&Servlet&JavaBean架构特点说明.架构的优点结构简单明了，搭建时配制信息很少只有一个文件“web.xml”，该文件主要用来映射Servlet。Control层的应用一定程度上将Jsp中的Java代码分离出来，使得jsp文

12、件的复杂程度有所降低。另外该架构涉及到的架构知识较少，很容易上手。基于Java语言的WebF发技术掌握难易顺序大致可参见图4.2所示。图4.2基于Java语言的Web开发技术掌握难易顺序过图4.2可见Jsp+Servlet+JavaBean这种架构技术组合难度是很低的。.架构的缺点不能将Java代码完全从页面上脱离，页面中会用Js验证代码，使Jsp页面结构相对复杂，不易维护。Control层读取客户提交的信息要逐条操作，代码书写比较麻烦，Controler层要定义处理响应的分支和model层类的调用，使得Controler本身内容较多不便开发和维护。另外Jsp+Servlet+JavaBean

13、5技术组合层次简单，各层的代码开发较随意自主，尤其是在JavaBean实现的Model层由于完成的业务功能多种多样，如果开发人员没有很好的遵循一定开发规范或是开发思路不清晰，那么代码开发会变得混乱。为了解决这些问题，引入一定的架构技术来调理代码开发就变得很必要了。下面一节将Struts、Spring、Hibernate三种比较流行的架构技术引进架构设计中来构建一种较为复杂却层次清晰得的开发模式。具体架构层次如图4.3所示BLBL（业务逻辑层）SpringSpring区MOEappUicationFactoryxml数据库SSH架构结构图（图例1）各层实现功能及开发技术说明.四层结构的优势1）过

14、成熟的开源产品实现各层功能开发，比起自己开发能缩短开发周期，且架构所用到的开源产品均有很广泛的用户群，经受过实践的考验，质量和性能更有保障。2）层与层之间松散偶合，增加代码重用率。3）各层分工明确，这样也利于团队的明确分工。.表小层这一层是面向用户的界面，是用户与系统之间交互的媒介。如：用户在界面发送请求，系统接收请求，进行处理，然后过界面将结果呈现于用户。这一过程包括了用户动作、数据传递、界面显示。大家熟悉的MVC真式就是将这三者分离，减少三者耦合。我们在该层借助了Struts来实现。）Struts的实现的功能：管理用户的请求，做出相应的响应提供一个Controller,委派调用业务逻辑和其

15、它上层处理。处理异常，抛给StrutsAction.为显示提供一个模型。UI(Userinterface)验证。以下部分则不该在Struts显示层的编码中经常出现。因为在表示层引入这些代码，则会带来高偶合和非常麻烦的维护代价。直接的与数据库信，如JDBCM用。与你应用程序相关联的业务逻辑以及校验。.业务层业务层在实际的项目开发中，每个领域都会有自己独特的业务逻辑，?因为这样，致使项目中代码高度偶合，原本有可能被重用的代码或功能，因为与具体的业务逻辑绑定在一块而导致很难被重用。因此我们将实现这些具体逻辑的代码抽取出来分为单独的一层，其目的是希望过分层，来降低它与系统其他部分的偶合度。现实中世界是

16、变化的，既然该层实现的是现实中具体的业务逻辑，那该层的实现代码不可避免的会发生变更。怎样让该层适应最大的变化，做到最小的改动？常我们在编码的时候会尽量考虑到同一业务多种实现的兼容和可扩展的能力。因此我们在该层借助了Spring,过依赖注入、AOPS用、面向接口编程，来降低业务组件之间的偶合度，增强系统扩展性。2)Spring实现的功能：处理应用程序的业务逻辑和业务校验。管理事务。提供与其它层协同工作的接口。管理业务层级别的对象的依赖。在显示层和持久层之间增加了一个灵活的机制，使得他们不直接的联系在一起。过揭示从显示层到业务层之间的Context来得到businessservices。管理程序的

17、执行(从业务层到持久层)。4.数据持久层数据持久层在开发中与数据库进行数据交互必不可少， 常我们归为CRUU添加、读取、修改、删除)，这些操作占据了系统开发中大部分的时间，同时我们还需要考虑与数据库交互的性能问题，如连接池、数据缓存等等。系统内部的持续层不但需要大量调试时间，而且还经常缺少功能使之变得难以控制。针对这点我们引入ORMFF源架构Hibernate。2)Hibernate实现的功能：查询对象的相关信息的语句。存储，更新，删除数据库记录。支持大部分主流数据库，并且支持Parent/Child关系，事物处理，继承和多态。5.各层中的封装类各层的封装类的主要功能都是一致的，就是将有一定联

18、系的数据集合装载在其实力对象中，这样做的道路是显而易见的，过对象来传递数据集合的效率会更高更方便。显示层的FormBean类是用封装来自页面form提交的信息的，一般情况下这个类的私有变量是与页面form的元素一一对应的。另外FormBean封装类的对象还负责将要显示的信息传递到显示层，其作用是双向的。业务逻45层的ValueObject类是用来封装一定业务功能实现过程中需要的数据集合的，也就是说要封装的数据都是由业务功能的需要决定的。持久层的PersistObject类， 其实例化对象所封装的数据集是与数据库中表相对应的，即表项对应要封装的数据项。我们根据上面封装类的说明可以看出，FormB

19、eanValueObject、PersistObject、三者的作用相似都是为了封装数据信息，不同的是这些对象所在的是不同架构层面，这样做的好处是数据的处理和转递比较有条理，层次清晰易于维护。封装类在架构中的情况如图4.4所示。view（视图层）决定Jsp页面中的FormBeanBL（业务逻辑层）决定业务层的具体ValueObjecPersist（持久层）决定数据库中的表-4PersistObj各层封装类的情况（图例2）2.3.4 关键技术与算法书写要求：对系统中比较复杂的功能的实现方式或应用的特殊技术加以说明要求俗直观便于客户参考。书写样例：查询统计（科学项目的查询和统计，科学成果的查询和统

20、计，科学奖励的查询和统计,科技人才的查询和统计）组合检索：组合检索由拥有搜索权限的用户在组合类别的下拉框中选择需要查询的项目，如科技项目的检索：项目类别+项目资金+项目所属公司+时间；没有选择的项，下拉框默认为空白。点击搜索，系统将对数据库的字段进行模糊搜索，搜索结果列表显示于组合搜索下面，分页显示搜索结果。注：其它的科技成果搜索，科技奖励搜索，科技人才搜索采用统一的组合搜索形式统计图表：各分公司统计：根据用户在科技项目申请，科技成果申请，科技奖励申请，科技人才的输入的数据，当拥有该权限的用户点击各分公司统计，系统将从数据库中读取以上的部分数据，进行统计，然后以统计图形的形式显示出来，对各分公

21、司进行比较，方便领导制定企业决策。某分公司统计：当拥有权限的用户点击某分公司统计，系统将从数据库中读取这对该公司的数据进行统计，显示统计图，该统计主要面向集团和分公司领导。注：其它的科技成果搜索，科技奖励搜索，科技人才搜索采用统一的统计形式2.2.3关键数据结构（选作）书写要求：简要说明本系统中的最主要的数据结构。书写样例：3 3系统功能设计16-c7f51235b83d-Numbered_a2bbbe0a-3d7b-4105-ac0b-350af54f 分公司768-1921-4225-be97-04e1e80c7453-Numbered_738fb4a0-30027b-45ae-8947-

22、e598b1feee13-Numbered_fd7b63ee-f384 订单管理b5018b5018功能描述订单的填写可以由用户过web前台完成，也可以由收货员在配送点完成，在用户填写的情况下，需要收货员对物品的重量及体积进行审核，经过审核后确认订单完成并收取货物，最后将货物入库。如图3.1.1_1和3.1.1_2。订单编号待审状态操作口加1已审核进行审雷阵核结果00002|一待审核进行市檎结果 1 1共有2条,分为1页/每页0条，目前显示?1页造页I英一的英一页味页图3.1.11订单审核图3.1.12输入操作：客户或管理员输入订单详细信息并提交。输出效果：订单成功进入待审列表。管理员对待审列

23、表中的订单进行审核，填写相关审核结果。3.1.1.33.1.1.3功能流程图订单发货功能描述配送点理货员过查询当天该配送点的可用班次可以为仓库内货物安排发货，过查询库存内订单的目的地以及需要中转的订单列表进行安排订单，并生成交接单，在货物装货后，将交接单与班次绑定从而完成一次发货，同时系统提供紧急货物提醒功能，如果订单即将到达收货承诺日期，则进行提醒，理货员可以根据实际情况向总部提交加开班次申请，见图3.1.2_1,3.1.2_2,3.1.2_3,3.1.2_4,3.1.2_5,3.1.2_6。当日班次一览班次函号跳跳铜号抵比时间1清空条件车辆类型atat 军时同大卡隼,载也目的地点110吨一

24、1北京“我体2c2c 立方米一1开始检索共有委，妁对 I I 页.哥贝1 1陵目靛显示疳L L页值 m mJzJzmFTmFT一顶I I抹页I I班次结号魏路潴号车翎类型1载体目的地点发车时间抵达时间000001000001000001000001小卡车3030吨3(3(&力米312:0012:00 101000:0000:000 0图3.1.2_1交接单生成选择班我：|ccm日：31口口1出庭地;目的地：青岛到站时间：Hi.+fitiS:5K十客同：交接单绑定交接中端号亚法编号目的地订单野鼠rim909口10期CCi9Q901001W&W&k|0JgKULUEemop

25、oiooiI7用909口10QI1C090901001唐山,图3.1.2_3亘W W 中铜号武利名称目的地ffifi(itJT)体税1平方米)入.库日期Eft0902X101ft0902X101布图否品1.11.1LJ2009-09-012009-09-01EF汽WQS2MQ3WQS2MQ3桌子古国7 7口120Q9-fl3-0120Q9-fl3-01o-ABAB网印口 杜暑吉S1S12,02,04520D9-CIP-0120D9-CIP-01百打的的加口I I鼠桂吉用U3U3IJ才口的9 9皿加总金咂加总金咂( (元元) )00000C00C0班次编号C090831001C090831001

26、交接单编号0909cli口01.重罡查面生感交掾单图3.1.2_2待发订单查询选操订隼选操订隼C09083100E目的地目的地青品青品入年日期入年日期订重重量1kg*行单悻枳1立方米.望酋询;订单编号货物名称目的的重量西斤）体积坪方米）入库日期加急金颔阮）A090325001A090325001书包香品1.1.1 11.51.52009=00-012009=00-010.000.00A090325003A090325003烹子7.07.03.03.02009-09-012009-09-010.000.00加9082900190829001枕头2.02.04.5.4.5.2009-09-0120

27、09-09-010.000.00A090830001A090830001鼠标0.50.50.20.22009-09-012009-09-0110.0010.00察看紧急订单图3.1.2_4紧急订单提醒垃据tr中：|CO9O日310口1目皿:香岛T 入阵目蛇：20090901,订单或最1kg订单体税心为I I页J短页10黑1 1目前导示?1 1页道贡I什一面汴一页1俄页1图3.1.4_2接口设计输入操作：输入查询库存订单条件，查询库存。输出效果：以列表形式显示库存订单。输入操作过界面进行。输入操作：输入查询待配送订单条件，并查询。输出效果：列表形式显示待配送订单。输入操作过界面进行。功能流程图订

28、单异常处理功能描述订单和货物在入库、出库和运输等过程中可能会出现破损丢失等情况，要对这些异常订单记录并作出相应的处理办法。见图3.1.5_1和3.1.5_2。配送点管理员需异常订单登记表,暂存提文，图3.1.5_1异常订单查询共有2条，分为1页每贝皿条,目前显示?1支百朝?-页|仃一页四初暨旅号订单编号异常类别处理状态矍记时间R00001R00001货物道关MSMS加的物 1 1ROOOOQROOOOQ0000货物损坏2009/9/22009/9/2ROOOOGROOOOG。0000国货物损探3009/933009/93图3.1.5_2接口设计输入操作：填写异常订单登记表信息，并提交。输出效果

29、：异常订单被成功记录。输入操作过界面进行。输出效果：列表形式显示异常订单。输入操作过界面进行。功能流程图本地信息设置功能描述配送点在配送货物前，需要设置统一的配送费方案，要综合考虑自身及客户的利益，然后向总公司申报，经审核批准后，方可按次配送费方案运营。配送货物时，因条件限制，有些订单不能直达。配送点需要选择合适的中转路线，以保证订单的及时到达。配送点同时也要设置一些用户权限，保障系统安全稳定的运行。见图3.1.6_1,3.1.6_2和3.1.6_3。配送价格设置质量住积声置两刃图3.1.6_1配送价格申报一重置所有 1 1 逑茎_图3.1.6_2中转线路设置查询条件起此宜髓点北京目徐配送点上

30、海出发时何上午查询直询结果选择起嫡地签过站点目的地班法线跷状况111北京天津-海南-南章上海Kdoom北京天津-吉岛H芳州行KOOOD9查看北京石巅庄合肥,南京上海KIJ0022图3.1.6_3接口设计输入操作：分别填写以质量和以体积为单位收费的配送费方案。输出效果：系统得到一待审核的配送费方案。输入操作过界面进行。输入操作：将设置的配送费方案提交给总公司审核。输出效果：待审核方案成功被提交给总公司。输入操作过界面进行。申报点质室申报者申报时间输入操作：输入查询中转路线及班次，选择合适中转路线。输出效果：列表显示可选择中转路线及班次。输入操作过界面进行。功能流程图财务管理功能描述需要定期对财务

31、进行统计和汇报，以检验当前的运营制配送点作为一个营利性的单位,度。见图3.1.7_和3.1.7_2。坛,，十历1色统讨给景月统计列表基本统计列表照漆，分为页每页1口条，目前显示?1 1页借刘吐一页1 1rr一页1味时图3.1.7_2接口设计输入操作：查询并选择待统计订单，计算月收益。输出效果：得到每月收益。输入操作过界面进行。输入操作：输入一时间段。输出效果：显示该时间段内汇报的统计列表。输入操作过界面进行。功能流程图? 运费查询功能描述客户过输入待配送货物的配送地、质量和体积估算需要的费用。见图3.2.1_1。3t3t-地HgHg货地|省皆|城市|县区|省.-I-I| |县.，质量体积质量：

32、单位：体积：单位：|一预讨费用图3.2.11接口设计输入操作：输入货物收发地，货物质量和体积，进行估算。输出效果：输出估算出的费用。输入操作过界面进行。功能流程图? 下订单功能描述客户决定接受此配送服务后，可以进如下订单界面，填写相关订单信息，提交后即达成交易。见图3.2.2_1。订单基本信息下单时间发货配送匕收货配送已程价费物品体积物品描述图3.2.2_1接口设计输入操作：填写点单详细信息。输出效果：订单成功进入待审核列表中。输入操作过界面进行。订单编号发货城市收货城市物品类型物品质量下单更直? 订单进度查询功能描述客户需要随时了解已下订单的状态，所以系统应当提供查询订单进度的功能。见图3.

33、2.3_1。共有漆，分为1员，每页条，目前显示?1瓦首页上一页下一页末页图3.2.3_1接口设计输入操作：填写订单编号。输出效果：显示订单进度。输入操作过界面进行。功能流程图3.3.13.3.1线路管理3.3.1.13.3.1.1功能描述总公司建立配送点间基本线路，管理运输线路，为配送点提供线路查询。见图3.3.11和3.3.12。配送点间基本线路起始配送点一终1JJ诞点1查询（全选 全不选新增删除|口轴起商能点就止B型点里程tkm）落加日朗MlMl天遑北京ICOICO2009.12.S12009.12.S1期天津石家庄2002009.12.22共1页 3 每页1幅|首孙上一页|下页|产|图3

34、.3.11官看运输线路起怪e送点止配送点1,查询三选|全不选|新埴|修苏|删同编号起始配送点终止配送点总里程（出旭需役|:001天津北京L00L00直达匚002天津石家庄300300天流北京石凉庄却页1门每页10条1字页上一页下一页菽图3.3.1-23.3.1.23.3.1.2接口设计输入操作：输入配送点相关信息。输出效果：增加配送点间线路。输入操作过界面进行。输入操作：查询配送点间线路。输出效果：返回配送点间线路。输入操作过界面进行。3.3.23.3.2车辆管理3.3.2.13.3.2.1功能描述考察配送至间情况生、是否有路V/填写并查询起始1蕤止日凝点往返配送点间的车辆由总公司提供，其所有

35、权为总公司的。总公司需对其基本信息进行查看车辆信息3.3.2.23.3.2.2接口设计输入操作：输入车牌号，检索车辆信息。输出效果：显示车辆基本信息。输入操作过界面进行。3.3.2.33.3.2.3功能流程图3.3.33.3.3班次管理3.3.3.13.3.3.1功能描述总公司设置班次，为配送点提供班次查询，处理配送点加急班次。见图3.3.32。全选全不选新增修改车辆端号车牌号车辆类型主驾驶副驾教载至栽侬山30000LA909UA909U大卡车张三李四1 10 0厂5 5300002A90912大卡车王五刘六105共min每页1瞌首页上一页下一页库苴主辆与型-车牌号图3.3.21维护。见图3.3.2_1。检索班次设置起始地卜-目的地班次编号,查询全