中外运物流配送系统详细设计.doc

1、ICSS物流配送系统详细设计说明书中外运物流配送系统详细设计说明书中外运集团中软国际有限公司第1 页 共 161 页。编写：徐连武日期： 2004-6-10审核：日期：批准：日期：受控状态：是发布版次： 1.0日期： YYYY-MM-DD编号：-可编辑修改 -。变更记录日期版本变更说明作者2004-6-101.0初始版本徐连武签字确认系统模块对应章节对应部门负责人签字-可编辑修改 -。-可编辑修改 -。目录1引言101.1编写目的101.2范围101.3背景102系统环境102.1操作系统102.2数据库102.3客户端102.4网络及硬件113编程命名规范113.1概述 .113.2变量命名

2、的总原则 .113.2.1一般性原则 .113.2.2对特定类型数据的命名 .123.2.3关于短名称的使用 .123.2.4其他应当避免的命名问题 .123.3VISUAL STDIO.NET .133.3.1大写样式 .133.3.2区分大小写 .143.3.3命名空间命名指南 .14-可编辑修改 -。3.3.4类命名指南153.3.5接口命名指南153.3.6枚举类型命名指南153.3.7参数命名指南163.3.8方法命名指南163.3.9属性命名指南164对象设计174.1.1系统类图结构174.1.2关键类设计175模块功能详细设计265.1前台操作模块 .265.1.1客户信息管理

3、子模块 .265.1.2前台相关操作子模块 .355.2后台新闻管理功能 .445.2.1增加新闻功能 .445.2.2删除新闻功能 .455.2.3修改新闻功能 .475.2.4查询新闻功能 .495.3后台车辆管理模块 .515.3.1增加车辆功能 .515.3.2删除车辆功能 .535.3.3修改车辆功能 .55-可编辑修改 -。5.3.4查询车辆功能 .575.3.5运力调度功能 .595.4后台路线管理模块 .615.4.1增加线路功能 .615.4.2删除线路功能 .635.4.3修改线路功能 .645.4.4查询线路功能 .665.5后台配送点管理模块 .685.5.1增加配送点

4、功能 .685.5.2删除配送点功能 .705.5.3修改配送点功能 .715.5.4查询配送点功能 .735.6后台系统参数设置管理模块 .755.6.1设置分成功能 .755.6.2设置保价费比例功能 .775.6.3设置系统自动删除订单天数功能 .795.6.4设置首公斤功能 .815.6.5设置首体积功能 .835.6.6货物类别管理子模块 .855.7后台员工管理模块 .925.7.1增加员工功能 .925.7.2删除员工功能 .94-可编辑修改 -。5.7.3修改员工功能 .965.7.4查询员工功能 .985.8后台配送范围管理模块 .995.8.1增加配送范围功能 .995.8

5、.2删除配送范围功能 .1025.8.3修改配送范围功能 .1045.8.4查看配送范围功能 .1065.8.5审核配送范围及配送价格功能 .1085.9后台价格管理模块 .1095.9.1运输价格管理子模块 .1095.9.2配送价格管理子模块 .1155.10后台订单管理模块 .1175.10.1下订单功能 .1175.10.2删除订单功能 .1205.10.3修改订单功能 .1215.10.4查询订单功能 .1235.11后台收发货管理模块 .1255.11.1收货管理功能 .1255.11.2发货管理子模块 .1275.11.3生成交接单功能 .1355.12后台报表管理模块 .136

6、5.12.1生成总公司报表功能 .138-可编辑修改 -。5.12.2配送点报表子模块1385.13后台权限管理模块1435.13.1角色管理子模块1435.13.2用户角色管理功能1505.14后台客户管理模块1565.14.1增加客户功能1565.14.2修改客户功能1575.14.3查询客户功能1596数据库设计（见附件）161-可编辑修改 -。1 引言1.1 编写目的本说明书目的在于明确说明系统各功能的实现方式，指导开发员进行编码。本说明书的预期读者为：物流配送项目小组，（成员：张慧娟、董柯、于匡济、叶田、周宏博、谭鹏飞）1.2 范围主要针对中外运物流配送项目需求分析说明书提出了基本的

7、范围，实施目标和功能等信息，供实施、开发等部门使用。1.3 背景本文以物流公司物流管理为背景，开发出了一个自动化、智能化的物流管理系统。2 系统环境2.1 操作系统Server ： Windows Server 2003/20082.2 数据库开发使用SQL Server 2005 Express2.3 客户端Client : IE6/7浏览器、 Firefox 2、 Opera 9-可编辑修改 -。2.4 网络及硬件数据中心可以放在公司机房，要求申请互联网IP 地址。或者放在有关电信机房采用主机托管模式。网络中心数据服务器：P4 2.6 、 2G 内存以上，配SQL SERVER 2005网

8、络中心应用服务器: P4 2.6 、 2G 内存以上，配Jrun4.0中间件客户机：普通PC，配 :IE6 以上浏览器，网络连接3 编程命名规范3.1 概述设计、开发人员应严格遵守此套开发规范和标准，并落实到自己的设计与代码程序中。命名规范将包括：编程命名规范，业务对象命名规范，数据库命名规范，Web 站点结构命名规范等。编码规范将包括：C# 编程规范，第三方模块使用规范等。本命名规范主要针对使用Visual S规范，即编程命名规范部分。3.2 变量命名的总原则变量命名的总原则时一个通用性的原则。3.2.1一般性原则1 、变量名称应当准确完整的描述变量的含义2 、名称应当反映业务上的问题而不是

9、技术上或是编程上的解决方法3 、名称的长度应当足够长-可编辑修改 -。4 、名称的最后一部分应当有限定符5 、应当用 Count ， Index 或 Nbr 代替 Num 、No3.2.2对特定类型数据的命名1 、循环技术变量的名称应当有含义（如果循环语句的长度超过了两行或者存在着嵌套循环，尽量避免使用l,j,k之类的变量，应该使用有意义的变量）2 、临时变量的命名应当有意义3 、所有布尔型变量的命名能够直接从名称上看出为真的条件4 、命名的常量应当代表了抽象的实体而非他们所代表的值5 、从变量命名中应当可以看出变量的作用域是局部变量，模块变量或者全局变量6 、变量的名称中不同的单词首字母要大

10、写，以方便阅读3.2.3关于短名称的使用1 、如果不是绝对必须，尽量避免使用短的名称2 、如果变量中单词的所写只能缩短一两个字符则使用单词的完全拼写3 、所有单词的缩写规则应当一致3.2.4其他应当避免的命名问题1 、名称具有误导性2 、两个不同的命名具有相似的含义3 、不同的命名拼写很相似，仅差一两个字符4 、在变量名称中不应当使用数字5 、完全和变量含义不相关的命名-可编辑修改 -。3.3 VISUAL STDIO.NET3.3.1大写样式使用下面的三种大写标识符约定Pascal大小写将标识符的首字母和后面连接的每个单词的首字母都大写。可以对三字符或更多字符的标识符使用Pascal大小写。

11、Camel大小写标识符的首字母小写，而每个后面连接的单词的首字母都大写。大写标识符中的所有字母都大写。仅对与由两个或者更少字母组成的标志符使用f 该约定。下表汇总了大写规则，并提供了不同类型的标识符的示例。标识符大小写示例类PascalAppDomain枚举类型PascalErrorLevel枚举值PascalFatalError事件PascalValueChange异常类PascalWebException(注意总是以Exception 后缀结尾 )只读的静态字段PascalRedValue接口PascalIDisposable(注意 总是以 |前缀开-可编辑修改 -。始 )方法Pascal

12、ToString命名空间PascalSystem.Drawing参数CamelTypeName属性PascalBackColor受保护的实例字段CamelredValue很少使用公共实例字段PascalRedValue很少使用3.3.2区分大小写为了避免混淆和保证跨语言交互操作，请遵循下列规则：1 、 不要使用要求区分大小写的名称。对于区分大小写和不区分大小写的语言，组件都必须完全可以使用。不区分大小写的语言无法区分同一上下文中仅大小写不同的两个名称。因此，在创建组件或类中必须避免这种情况。2 、 不要创建仅是名称大小写有区别的两个命名空间。3 、 不要创建具有仅是大小写有区别的参数名称的函数

13、。4 、 不要创建具有仅是大小写有区别的类型名称的命名空间。5 、 不要创建具有仅是大小写有区别的属性名称的类型。6 、 不要创建具有仅是大小写有区别的方法名称的类型。3.3.3命名空间命名指南命名空间的一般性规则是使用公司名称，后跟技术名称和可选的功能与设计，如下所示：CompanyName.TechnologyName.Feature.Design-可编辑修改 -。3.3.4 类命名指南1、 使用名词或名词短语命名类2、 使用 Pascal 大小写3、 不要使用类型前缀， 如在类名称上对类使用C 前缀。例如，使用类名称 FileStream ，而不是 CFileStream 。4、 不要使

14、用下划线字符（_）。5、 有时候需要提供以字母|开始的类名称，虽然该类不是接口。只要|是作为类名称组成部分的整个单词的第一个字母，这便是适当的。6 、 在适当的地方，使用复合单词命名派生的类。派生类名称的第二个部分应当时基类的名称。3.3.5接口命名指南1 、 用名词或名词短语，或者描述行为的形容词命名接口。2 、 使用 Pascal 大小写。3 、 给接口名称加上字母|前缀，以指示该类型为接口。4 、 在定义类 |接口对使用相似的名称。两个名称的区别应该只是接口名称上有字母|前缀。5 、 不要使用下划线字符（_）。3.3.6枚举类型命名指南1、 对于 Enum 类型和值名称使用Pascal

15、大小写。2、 不要在 Enum 类型名称上使用Enum 后缀。3、 对大多数 Enum 类型使用单数名称，但是对作为位域的Enum 类型使用复数名称。4、 总是将 FlagAttribute添加到位域 Enum 类型。-可编辑修改 -。3.3.7参数命名指南1 、 使用描述性参数名称。参数名称应当具有足够的描述性，以便参数的名称及其类型可用于在大多数情况下确定它的含义。2 、 对参数名称使用Camel 大小写。3 、 使用描述参数的含义的名称，而不要使用描述参数的类型的名称。开发工具将提供有关参数的类型的有意义的信息。因此，通过描述意义，可以更好地使用参数名称。少用基于类型的参数名称，仅在适合

16、使用他们的地方使用它们。4 、 不要使用保留的参数。保留的参数时专用参数，如果需要，可以在未来的版本中公开它们。相反，如果在类库的未来版本中需要更多的数据，请为方法添加新的重载。5 、 不要给参数名称加匈牙利语类型表示法的前缀。3.3.8方法命名指南1 、 使用动词或动词短语命名方法。2 、 使用 Pascal 大小写。3.3.9属性命名指南1 、 使用名词或名词短语命名属性。2 、 使用 Pascal 大小写。3 、 不要使用匈牙利语表示法。4 、 考虑用于属性的基础类型相同的名称创建属性。-可编辑修改 -4 对象设计4.1.1系统类图结构。新闻类+add (): int+delete ()

17、: int+modify (): int+select (): int总公司类配送点类-地址: int-电话: int-邮箱: int-名称: int-配送点列表: ArrayList+add (): int+delete (): int+modify (): int+select (): int报表公司机构客户类-订单列表: ArrayList+add (): int+delete (): int+modify (): int+select (): int订单类-货物列表: ArrayList+add (): int+modify (): int+select (): int+delete

18、(): int用户类角色类员工类权限类+add (): int+modify (): intadd (): int+delete ()+: intmodify (): int+select ()+: intdelete (): int+select (): int司机类+add (): int+select (): int+modify (): int+delete (): int配送范围类+add (): int总公司报表+delete (): int配送点报表modify (): int+select (): int+ select (): int+ select (): int货物类+add (): int+delete (): int+modify (): int+ select (): int路线类-配送点顺序列表: ArrayList+add (): int+select (): int+delete (): int+modify (): int交接单类运力调度类+add (): int+delete (): intadd (): int+