WQJ用能计费系统软件概要设计说明书 .doc

用能计费系统概要设计说明书目 录一、引言51.1、编写目的51.2、背景51.3、假定和约束51.4、定义51.5、参考资料6二、总体设计72.1、需求规定72.1.1、功能主角72.2、系统结构72.2.1、系统网络架构72.2.2、逻辑分层模型82.2.3、系统数据业务流程92.3、运行环境102.3.1、软件要求102.3.2、硬件要求102.3.3、网络要求102.4、开发规范102.4.1、代码编写规范10三、接口设计10四、数据库设计114.1、数据表设计11充缴异常记录（TE_PAYMENT_PAYRECORD）:11五、模块概要设计125.1、充值及异常处理功能12WQJ用能计费系统软件 V1.18 概要设计说明书一、引言1.1、编写目的本文档是对用能计费系统软件V1.18的要求进行详细分析和讨论后得出的概要设计说明书，旨在明确系统的总体和接口设计，以及各模块中较重要业务的流程和对象的设计。通过本概要设计说明书，可以了解到用能计费系统软件V1.18的功能边界、设计思路、模块设计等。本文档面向的读者是：用能计费系统软件V1.18项目组开发人员、测试人员、QA。1.2、背景项目名称：用能计费系统(WQJ) V1.18立项单位：研发中心开发单位：用能计费系统项目组背景概述：WQJ V1.17版本提供了相对齐全的用能计费功能，如首页展示、充值缴费、账户管理、参数设置、查询、异态用户、告警管理和日志管理功能。但费用充值功能在网络异常时，会导致充值已下装至仪表，而平台因网络原因，无法接收到通讯管理机的返回帧，界面显示充值失败，而实际上是已经充值上，给客户造成误解。1.3、假定和约束本设计文档只涉及产品部提供的需求说明书阐述部分的功能开发，不涉及用能计费系统（WQJ）V1.18开发过程中自行消化的功能需求。1.4、定义下表列出本报告中专门术语的定义、英文缩写词的原词组和意义、项目组内达成一致意见的专用词汇，同时继承全部的先前过程中定义过的词汇。词汇名称词汇含义备注1.5、参考资料编号资料名称说明第 12 页 共 12 页二、总体设计2.1、需求规定2.1.1、功能主角l 充值功能l 当用户页面操作充值或扣费时，将充值或扣费的金额发送到设备，返回该设备的响应结果。l 充值异常确认处理l 当充值异常时，客户经过人工排查（通过一段时间观察表的余额或现场人工确认），确认充值记录表中对应的记录。2.2、系统结构2.2.1、系统网络架构图2.2.1 系统网络架构图系统采用C/S+B/S架构，其中计量集抄部分延用原有的C/S架构，用能计费部分采用全新的B/S架构。系统模型主要分五层结构进行设计。图2.2.1 系统网络架构中，数据采集层包含了前置机、集中器和终端仪表等设备，终端仪表包括电能表、水表和其他类型的计量仪表，负责对用户用能情况进行计量统计，集中器属于中间设备负责将大量终端仪表通讯进行汇集并通过统一的通讯通道上送计量数据，前置机类似集中器，负责将终端计量设备的数据进行汇总和协议转换，然后上送到系统平台。图中系统平台层包含了系统平台的服务器，分别有NTS-9000主服务器和NTS-9000备服务器，以及相应的配件，如短信猫、UPS等，主要负责将前置机上送的数据进行分析处理并进行数据存储。图中B/S三层就是业务功能的设备配置，根据需要配置若干的工作站和办公电脑，提供用户进行使用操作。2.2.2、逻辑分层模型图2.2.2 逻辑分层模型图对应2.2.1节的系统网络架构，我们可以将软件系统的逻辑划分成五层模型，各模型层间相互逻辑依赖又相互松耦合。五层模型分别是界面展示层、业务逻辑层、应用服务层、系统平台层和数据采集层。该项目应用服务采用B/S架构设计，其中前三层是专门根据相应应用产品的业务需求开发，随系统架构的不同，实现也不同，在预付费系统软件V1.0中为C/S架构，在用能计费系统软件V1.1中为B/S架构。界面表示层是将登陆信息、用户账户信息、充值缴费功能、远程遥控功能、参数设置功能、查询功能等用能计费的业务功能展示在界面上，本项目中具体为用HTML5语言编写的WEB页面及相应的CSS和JS脚本；业务逻辑层是将实时库中获取到的能源用量、余额、账户信息、查询结果等数据进行逻辑转换、封装、筛选，并负责将封装好的业务数据传递给界面表示层，以及将用户提交的充值缴费、远程控制、参数设置等操作命令转达给应用服务层，本项目中具体为C#.NET开发的DLL类型的程序模块；应用服务层是将充值缴费、远程控制、参数设置等操作直接与系统平台层进行交互的服务集，本项目中为VC+编写的常驻服务模块；第四层系统平台层是整个完整系统的基础，负责系统集成、数据存储、协议转换等通用性服务，属于基础性服务，本项目中采用通用的NTS-9000系统平台实现；第五层数据采集层是负责计量集抄、原始数据采集服务，只要通讯协议使用统一的MMIJK，可兼容任意型号的前置机，目前已具备预付费计费功能的前置机有NTS-161和NTS-900C。2.2.3、系统数据业务流程图2.2.3 系统数据业务流程系统数据业务流路径主要是由终端采集设备进行计量集抄后将数据上送到后台端的系统平台，有系统平台执行原始数据的协议解析、数据分析、数据存储处理，这些存储的数据由计费应用服务相关程序进行提取、二次分析和运算后，提供给B/S的业务逻辑层进行数据交互，最终由业务逻辑层封装后展示到WEB网页中。从图2.2.3的系统数据业务流程中可以很清晰的看出，前面2.2.2中设计的五层模型结构。2.3、运行环境2.3.1、软件要求服务器操作系统：Windows Server 2008 企业版服务器数据库：SQL Server 2008 企业版服务器必选组件：IIS 7.0服务器必选组件：.NET Framework 4.0服务器辅助软件：Microsoft Office 2003客户机浏览器：Chrome、Firefox2.3.2、硬件要求服务器CPU： 双核 2.0服务器内存： 4G服务器硬盘： 1T配件：串口短信猫 SIMCOM MOD9001C2.3.3、网络要求物理网络：100M/1000M以太网络短信猫：RS232串口、USB口2.4、开发规范2.4.1、代码编写规范VC代码编写要求符合VC编程规范-00.docVC界面设计要求符合VC界面设计规范080812-00.doc三、接口设计无四、数据库设计4.1、数据表设计充缴异常记录（TE_PAYMENT_PAYRECORD）:序号字段名类型长度描述约束1IDINT4索引、标识主键2OPERATIONTIME DATETIME8操作时间3DEVICEIDSMALLINT2设备索引外键4PAYCOUNTFLOAT4缴费金额5OPERATERVARCHAR32操作者6COMPUTERNAMEVARCHAR64操作电脑7ACOUNTCODEIDVARCHAR64账号五、模块概要设计5.1、充值及异常处理功能5.1.1、功能描述1. 充值功能当用户页面操作充值或扣费时，将充值或扣费的金额发送到设备，返回该设备的响应结果。2. 充值异常确认处理当充值异常时，客户经过人工排查（通过一段时间观察表的余额或现场人工确认），确认充值记录表中对应的记录。5.1.2充值业务流程如下图所示，端发起充值请求，服务接收到充值命令后，经平台组包后下至通讯管理机，最终费用下装至仪表。仪表返回报文经通讯管理机后台将结果返回给端，并最终显示充值结果。其中为防止网络异常，导致通讯管理机返回的报文丢失或是报文超时收到，后台误判充值失败，使用户产生误解。1. 通讯时延做可配置；2. 当通讯超时后，如经过秒（可配置成几次进行轮询，每一个固定时延，比如5S一次）点抄设备的余额并与充值前余额进行比较，如差值等于充值金额，判断充值成功，返回界面。否则返回充值异常。3. 当充值异常时，端弹出对话框（充值成功或充值失败或充值异常，如是充值异常，让用户选择是立即确认或是稍后确认，跳转至冲缴记录页面进行查询）。立即确认则更新计费操作记录表及充缴记录。4. 如是稍后确认，则生成一条异常冲缴记录至冲缴异常记录表，用户通过查询充缴记录表（不同冲缴异常记录表，冲缴记录表只有成功的），当发现查询时间内有记录为充值异常时，用户通过人工排查，确认是否充值成功，如果确认则更新计费操作记录表及充缴记录。5.1.1.2、页面设计 在充值缴费界面，点击充值后，当是异常时，当充值异常时，端弹出对话框（充值成功或充值失败或充值异常，如是充值异常，让用户选择是立即确认或是稍后确认，如是稍后确认跳转至冲缴记录页面进行查询）。立即确认则更新计费操作记录表及充缴记录。 如下所示，通过查询可获取某房间充值记录，当冲缴中有充值异常时，客户通过人工排查方式，确认充值是成功的，可点击查询中的充值异常，弹出确认框，确认后，冲缴记录表增加一条冲缴成功记录，计费操作记录表中内容变成充值成功，冲缴异常记录表删除对应的记录。5.1.2.5、配置文件配置文件：parameter/TSWebService_WQJ.ini其中timeout为通讯超时判断时间 ；CtrlTimeNum点抄次数CtrlTimeSet 点抄每一次间隔时间5.1.2.6、日志文件日志文件：log/TSWebService_WQJ/*.log.*