软件开发详细设计文档

神玥软件开发详细

设计文档

河北神玥软件股份有限公司

2019年 1 月

说明

文档信息

项目名称

文档编号

新疆房产管理平台

用户信息

主管单位名称

S1901

河北神玥软件股份有限公司

修订记录

版本号 日期 修订说明

编写或修订

人

审核

1.0.0 2019.5.8

初稿完成

陈亮

1 引言

1.1 编写目的

说明编写详细设计方案的主要目的。 说明一个软件系统各个层次中的每个程序 （每个模

块或子程序） 和数据库系统的设计考虑， 为程序员编码提供依据。 如果一个软件系统比较简

单，层次很少， 本文件可以不单独编写， 和概要设计说明书中不重复部分合并编写。方案重

点是模块的执行流程和数据库系统详细设计的描述。

1.2 背景

待开发软件系统名称，该系统基本概念， 如该系统的类型、从属地位等；开发项目 组

名称。

1.3 参考资料

出详细设计报告引用的文献或资料，资料的作者、标题、出版单位和出版日期等信息， 必

要时说明如何得到这些资料。

1.4 术语定义与说明

列出本文档中用到的可能会引起混淆的专门术语、定义和缩写词的原文。

2 设计概述

2.1

工作任务和目标

说明详细设计的任务及详细设计所要达到的目标。

2.1.1

需求概述

所开发软件的概要描述

,

包括主要的业务需求、输入、输出、主要功能、性能等，尤其需要 描

述系统性能需求

2.1.2

运行环境概述

对本系统所依赖于运行的硬件，包括操作系统、数据库系统、中间件、接口软件、可能的性 能

监控与分析等软件环境的描述，及配置要求。

2.1.3

条件与限制

详细描述系统所受的内部和外部条件的约束和限制说明。 包括业务和技术方面的条件与限制 以

及进度、管理等方面的限制。

2.1.4

设计方法与工具

简要说明详细设计所采用的方法和使用的工具。如

HIPO

图方法、

IDEF

（

I2DEF

）方法、

E-

R

图，数据流程图、业务流程图、选用的

CASE

工具等，尽量采用标准规范和辅助工具。

3 详细需求分析

3.1

详细需求分析

详细功能需求分析、详细性能需求分析、详细资源需求分析、详细系统运行环境及限制条 件分

析

3.2

运行环境分析

3.3

限制条件分析

4 系统详细设计

4.1

系统模块设计

4.1.1

预售许可证申请

4.1.1.1 用 例设计（用例）

<>

批售房屋范围选择

预售许可证申请

开发商经办人

<>

<>

房价导入

撤销流程

审批调整

档案扫描

4.1.1.2 领域模型（类图）

描述预售许可证申请所涉及到的所有功能类与接口关

系。

+YsXkzSqlcsp(Object): HashMap

+transMap2Bean(map, obj): JsonObject

+ysxkFwfwTempSave(JSONObject): String

SpfysYsXkzSqControler SpfysYsXkzSqService

+ysXkzSqlcsp(YsxkzBean): HashMap

+ysxkFwfwTempSave(YsxkzBean): JSONObject

+ysxkzxxDyCx(YsxkzBean): List

SpfysYsXkzSqConDao

+ysXkzSqlcSq(YsxkzBean): void

+ysXkzSqlcSqSp(YsxkzBean): void

+ysXkzSqlcSqTh(YsxkzBean): void

+ysxkzxxDyCx(YsxkzBean): Map

YsxkzBean

-jgjfrq: String -

xkmj: double -xkts:

integer -pzyszfts:

integer -

pzyssyyfts: integer

-pzysbglts: integer

-pzysqtfwts:

integer -pzyszfzmj:

double -

pzyssyyfzmj: double

-pzysbglzmj: double

-pzystqfwzmj:

double -zfjj:

double -syyfjj:

double -bgljj:

double -qtfwjj:

double -xsksrq:

String -xsjsrq:

String -bz: String

-ysxkzh: string -

ysxkzbh: integer -

sqnd: String -xmbh:

String -xmmc:

String -xmdz:

String -cx: String

-zh: String -cs:

integer -jzlx:

String -jzjg:

String -ycjzmj:

double -sgjd:

String

XmBean

-xmbh: int -

xmmc: String -

xmdz: string -

jgbm: String -

quhao: String -

qiuhao: String

-ljzh: String -

zh: String -

zxjgbm: String

-ywfl: String -

ywlx: String -

xzqhbm: String

-ljzbh: int

+ysXkzSqlcSqCx(YsxkzBean): void

+ysXkzSqlcSqWcbl(YsxkzBean): void

+ysXkzSqlcSqZctj(YsxkzBean): void

+ysXkzSqlcSqLzChk(YsxkzBean): int

+ysXkzSqJy(YsxkzBean): int

+ysXkzSqlcScXkzbh(YsxkzBean): int

+ysxkFwfwdjSave(YsxkzBean): void

+ysxkFwfwdjTempDel(YsxkzBean): void

+getLpSfyCj(YsxkzBean): int

+ysxkFwfwTempSave(): void

+ysxkzxxDyCx(YsxkzBean): List

4.1.1.3 功能描述

4.1.1.

3.1

预售许可证申

请

4.1.1.3.

功能描述

(activity

1.1

graph )

4.1.1.3.1.2

用例设计

开发商经办

人

4.2.1.3.3

界面设计

参考页面原型图

图

1

预售许可证申请

4.1.1.3.1.3

前置条件

1

、已经存在项目、幢号和对应楼盘信息。 流程审批级别(一级) ：受理

--

审批

3

、业务

办理完成打印《商品房预售许可证》 。

4

、前台开发：发起流程、退回调整和撤销调用流

程审批接口

url

：

ip:port/ FWJY/spfysxkz/ysxkz_e

。参数见《输入输出》章节

前台开发：审批中和退回调用流程审批接口

url

：

ip:port / FWJY/spfysxkz /ysxkzsq_e

。

4.1.1.3.1.4

输入与输出

用

AXURE

展示并进行文字描述即可。

4.1.1.3.1.5

功能流程(

seqence graph

)

流程发起时序图：

4.1.1.3.1.6 PDL

描述

PROCEDURE

预售校验通用模块

1

、

Controller

类中：

YsXkzSqControler

的

YsXkzSqlcfq

方法加保存日志方法。

调用

CommonService

类中方法

optLogAdd

增加操作日志

参考《房管公共方法接口文档》中增加操作日志接口参数传参：

OptLogBean

中传参：

业务分类

业务类型

= "01"

= " 0501"

操作分类

= "01050101"

业务摘要

= "

预售许可证

申请

业务操作笔数

=0

业务操作金额

=0

其他参数从前台传入参数中获取

2

、

service

类中：

YsXkzSqService

调用校验

YsXkzSqDao

接口下方法

YsXkzSqlcfq

调用公共方法类

commonDao

下方法

ywFcfcpChk()

进行防重复校验

;

try{

if lcbz

等于

0 then

调用

ysxkzGzJy

方法校验竣工交付日期是否小于项目开工日期

;

if

竣工交付日期大于项目开工日期

then

//

判断是否同样的楼幢已经申请过预售许可证

调用

spfysYsXkzSqDao

下

ysXkzSqlcSqLzChk

方法 校验是否申

请过 预售许可证

if

没有申请过

then

调用

spfysYsXkzSqDao

下

ysXkzSqlcScXkzbh

方法生成预

售许 可证号

调用

spfysYsXkzSqDao

下方法

ysXkzSqlcSq

发起申请

;

返回

"

预售许可证提交申请成功

!";

返回操作成功标志(

success = true

)

;

返回操作日志用参数(

ywzy = "

预售许可证提交申请成功

"

)

返回操作日志用操作分类(

czfl = "01050101"

)

;

else then

msg = "

该项目的同一幢楼已经申请过预售许可证号！

";

返回操作成功标志(

success = false

)

;

end if;

else then

返回“竣工交付日期小于项目开工日期”

end if

else if lcbz

等于

1 then

调用

ysxkzGzJy

方法校验竣工交付日期是否小于项目开工日期

;

if

竣工交付日期大于项目开工日期

then

调用

spfysYsXkzSqDao

下

ysXkzSqlcSqLzChk

方法 校验是否申请

过预

if

没有申请过

then

调用

spfysYsXkzSqDao

下方法

ysXkzSqlcSqZctj

发起审批调整

.

返回

"

预售许可证再次提交审批

!";

返回操作成功标志(

success = true

)

;

返回操作日志用参数(

ywzy = "

预售许可证再次提交审批成功

"

) 返

回操作日志用操作分类(

czfl = "01050102"

)

;

else

返回“该项目的同一幢楼已经申请过预售许可证号！ ”

Endif;

}else

返回“竣工交付日期小于项目开工日期”

}

} else if lcbz

等于

4 then

调用

spfysYsXkzSqDao

下方法

ysXkzSqlcSqCx

撤销审批

;

返回

"

预售许可证流程撤销成功

!";

返回操作成功标志(

success = true

)

;

返回操作日志用参数(

ywzy = "

预售许可证流程撤销成功

"

) 返回

操作日志用操作分类(

czfl = "01050104"

)

;

售许可证

} else if lcbz

等于

3 then

调用

spfysYsXkzSqDao

下的方法

ysXkzSqlcSqTh

退回审批

;

返回

"

预售许可证审批退回

!";

返回操作成功标志(

success =

true

)

;

返回操作日志用参数(

ywzy = "

预售许可证审批退回

"

) 返

回操作日志用操作分类(

czfl = "01050103"

)

;

} else if lcbz

等于

2 then

if spbz

等于

1 then

调用

spfysYsXkzSqDao

下方法

ysXkzSqlcSqWcbl(bean)

完成办

理 调用

spfysYsXkzSqDao

下方法

ysxkFwfwdjSave(bean)

保存房屋范围和 单价信息到

正式表

调用

spfysYsXkzSqDao

下方法

ysxkFwfwdjTempDel(bean)

删除

房屋范 围和单价信息到临时表

返回

"

预售许可证审批通过

!";

返回操作成功标志(

success = true

)

;

返回操作日志用参数(

ywzy = "

预售许可证审批通过

"

) 返回操作

日志用操作分类(

czfl = "01050105"

)

;

else then

调用

spfysYsXkzSqDao

下方法

ysXkzSqlcSqSp(bean)

审批

返回

"

预售许可证审批成功

!";

返回操作成功标志(

success =

true

)

;

返回操作日志用参数(

ywzy = "

预售许可证审批成功

"

)

返回操作日志用操作分类(

czfl = "01050106"

)

;

}

success = true;

else then

返回

"

未找到对应审批内容，请检查传值

";

throw new Exception（"

未找到对应审批内容，请检查传值！

"）;

end if;

catch(Exception e){

}finally{

调用

commondao

下

bpmStateAdd

方法返回流程状态信息。

}

4.1.1.3.1.7

功能接口

参考接口文档内容