demo-设计说明书

1、系统设计说明书1. 目标与范围建立号码库系统的目的是为了有效管理公司的号码资源，在日常业务推广中能够正确、充分而高效地利用，减少人工操作，提高工作效率。营销系统和号码库管理系统密切相关，本文档一并表述。首期号码库系统采用数据库存储，时机成熟采用文件索引的存储策略。2. 术语与缩写黑名单：不允许有任何下行短信，即便有上行短信。黄名单：禁止营销。可以有正常的上下行短信3. 系统体系结构设计3.1. 体系结构3.2. 系统组成部分1、 业务支撑子系统：提供UI，完成入库安排、出库安排、营销安排以及相应的查询页面。提供号码管理、黑名管理、网关管理等功能。2、 号码管理子系统：完成号码入库、号码出库、号

2、码归属地判定、黑名单过滤等功能。注：该系统首期采用数据库实现。随号码量增长，转到文件索引方式存储。3、 营销子系统：根据营销安排，完成短信/WAP push 信息营销功能。包括流量控制、监控报警、日志输出等模块。3.3. 系统运行流程3.3.1. 入库流程 3.3.2. 营销流程3.4. 网络拓扑4. 数据库设计4.1. 物理模型设计4.2. 表定义4.2.1. 号段表名称代码数据类型注释号段prefixvarchar2(7)地区编码area_idvarchar2(5)运营商类型carrier_idnumber(1)1.移动；2.联通；3.网通；4.电信号段品牌mobile_typenumbe

3、r(2)0:未知；1.全球通；2.动感地带 3.神州行；4.联通G网；5.联通C网；6.小灵通4.2.2. 号码入库表名称代码数据类型注释入库批次import_idnumber(9)从1开始，自增序列入库批次名称import_namevarchar(255)末位为8为全网营销,其他为地网营销省份编码province_idvarchar2(5)地区编码area_idvarchar2(5)000：表示未知地区运营商类型carrier_idnumber(1)1.移动；2.联通；3.网通；4.电信用户类型user_typenumber(1)0：未知；1.彩铃用户；2.非彩铃用户用户品牌mobile_t

4、ypenumber(1)0:未知；1.全球通；2.动感地带 3.神州行；4.联通G网；5.联通C网；6.小灵通俱乐部会员状态club_statusnumber(1)0:未知;1：非会员 2.普通会员 3.高级会员消费状态consume_statusnumber(1)0.未知；1高端用户 2 中端用户3低端用户活跃程度active_degreenumber(1)0.9；共9级是否搜索用户is_searchnumber(1)0:否；1：是号码来源sourcenumber(1)1:BI提供；2：销售提供号码文件名称file_namevarchar2(255)文件名全称号码数量loader_count

5、number(10)成功入库号码数量success_countnumber(10)当前操作状态statusnumber(2)0:号码传输中；1:号码就绪；2:号码入库中；3号码入库完毕；其他：错误入库开始时间loader_dateDATE操作员IDoperator_idINTEGER号码提供者providervarchar2(20)入库安排时间order_dateDATE备注memovarchar2(255)4.2.3. 号码出库表名称代码数据类型注释营销批次sender_idINTEGER从1开始，自增序列入库批次import_idINTEGER省份编码province_idvarchar2

6、(5)地区编码area_idvarchar2(5)000：表示未知地区运营商类型carrier_idnumber(1)1.移动；2.联通；3.网通；4.电信用户类型user_typenumber(1)0：未知；1.彩铃用户；2.非彩铃用户用户品牌mobile_typenumber(1)0:未知；1.全球通；2.动感地带 3.神州行；4.联通G网；5.联通C网；6.小灵通活跃程度active_degreenumber(1)0.9；共9级是否搜索用户is_searchnumber(1)0:否；1：是营销间隔天数daysnumber(2)至上次营销的时间间隔号码来源sourcenumber(1)1:

7、BI提供；2：销售提供出库号码数量export_countnumber(10)成功出库号码数量success_countnumber(10)当前操作状态statusnumber(2)0:号码未出库；1:号码出库中；2:号码就绪；其他：错误号码文件名称file_namevarchar2(255)文件名全称出库时间export_timevarchar(10)出库操作耗费时间的描述备注memovarchar2(255)4.2.4. 号码表名称代码数据类型注释手机号码msisdnvarchar2(11)入库批次loader_idnumber(9)从1开始，自增序列地区编码area_idvarchar2

8、(5)出库次数export_countnumber(5)上次提取日export_daynumber(9)从1970.1.1开始的天数4.2.5. 地区列表名称代码数据类型注释地区编码area_idvarchar2(5)省份表_省份编码province_idvarchar2(5)地区名称area_namevarchar2(20)4.2.6. 省份表名称代码数据类型注释省份编码province_idvarchar2(5)省份名称province_namevarchar2(20)4.2.7. 营销安排表名称代码数据类型注释营销批次sender_idnumber(9)从1开始，自增序列营销名称send

9、er_namevarchar(255)网关编号gateway_idvarchar2(6)通过中央平台发送的已8结尾。接入号码sp_novarchar2(20)扩展号码ext_novarchar2(20)消息类型msg_typenumber(1)0:普通短信；1:长短信；2:WAP PUSH消息正文msg_contentvarchar2(2000)WapPush标题和URL之间用<br>分隔。发送速度speednumber(9)单位：条/毫秒号码来源sourcenumber(1)0:号码库；1：操作员提供号码文件名称file_namevarchar2(255)source=1时有意义

10、；文件名全称监控手机号码monitor_msisdnvarchar2(255)号码间用逗号分隔营销号码数量sender_countnumber(10)号码来源为1时有意义实际发送的号码数量real_countnumber(10)成功发送号码数量success_countnumber(10)由营销系统在发送完毕后更新营销省份province_idvarchar2(5)营销地区area_idvarchar2(5)营销类型sender_typenumber(2)0:普通营销;1.针对活动的营销2: UCIP营销;3: IVR营销4: 竞价营销;5: 运营商营销6: 结信营销；7、IVR+竞价营销当前

11、操作状态statusnumber(2)0:号码准备中；1:号码就绪；2:号码发送中；3号码发送完毕状态描述status_descvarchar2(255)错误状态描述营销开始时间launch_dateDATE营销终止时间over_dateDATE装载营销任务时，会检测但是是否是否超过终止时间，是则不回启动营销任务。实际营销开始时间real_launch_dateDATE由营销系统在发送完毕后更新实际营销完成时间real_over_dateDATE由营销系统在发送完毕后更新状态更新时间cur_return_timeDATE营销程序回写营销状态的时间当前发送数量cur_send_countnumb

12、er(10)当前成功发送数量cur_success_countnumber(10)发送线程个数send_thread_cntnumber(3)操作员IDoperator_idINTEGER营销安排时间order_dateDATE安排营销任务的时间备注memovarchar2(255)4.2.8. 营销日志名称代码数据类型注释营销批次sender_idnumber(9)从1开始，自增序列手机号码user_idvarchar2(22)发送时间send_dtdate发送结果resultvarchar(6)000000：成功4.2.9. 黑名单名称代码数据类型注释手机号码msisdnVARCHAR(2

13、0)号码类型typenumber(1)1.黑名单；2.黄名单添加时间enter_dateDATE添加操作员operatoridNUMBER(8)5. 营销系统设计与维护5.1. 设计原则1.营销进程在Crontab中启动，最小时间间隔3分钟（为避免数据库异常造成重复营销）。2.每次营销进程运行只启动一个待营销任务,多线程发送。该进程用Linux系统下$RANDOM来标识，称之为进程标识。3.每营销任务输出两个log。一个为营销日志，log文件名格式为：营销进程标识-营销任务ID-营销开始时间.log。记录格式为：手机号码,营销任务ID,发送结果一个为营销Debug日志(log4j)，记录程序运

14、行情况，文件名格式为：Batch_营销进程标识_进程启动时间.log4.营销速度的策略：设定最大线程个数为m,营销速度n条/秒当1>n时，营销程序创建1个线程，每线程1/n秒发送一条。当1<n<m时，营销程序创建n个线程,每线程发送速度为1条/秒当n>m时，营销程序创建m个线程，每线程发送速度为n/m条。5.2. 营销流程1检索t_msisdn_sender表， 所负责省份是否存在待执行营销任务。没有，程序退出。否则下一步； 2.检查营销各个参数是否正确，错误，程序退出。3.http方式下载号码(压缩方式)文件，将号码文件缓存在tmp目录中。4.解压缩并装载号码文件，根

15、据号码数量，计算启动的线程个数和每线程发送速度。5.如果营销网关编号尾数为8。则装载中央音乐平台发送接口模块。如果不为8，则为全网转地网营销，装载本地接入网关RMI接口模块。如营销类型为WapPush，则装载全网WapPush模块！6.给营销监控号码发送营销开始信息，发送营销语。7.启动发送线程，进行营销。如果营销为当当前时间大于系统预设终止时间时，营销线程退出。8.启动营销监控线程，回写营销状态：包括号码数量、成功发送数量等。9.营销完毕，给营销监控号码发送营销统计信息，并发送营销语。10.营销终止，回写营销状态。5.3. 程序说明程序位置：mineBss项目net.unison.mineb

16、ss.batchsend5.4. 配置文件1. 启动脚本：startBatchSend.sh#!/bin/shPATH=$PATH:/usr/local/java/bin:.JAVA_HOME=/usr/local/javaexport PATH JAVA_HOMELANG=zh_CN.GBKLC_ALL=zh_CN.GBKexport LANG LC_ALLSMS_HOME=/usr/local/mine/minebssSTART_CP=$SMS_HOME/build:$SMS_HOME/conf:$SMS_HOME/libfor file in $SMS_HOME/lib/*.jar ;d

17、o START_CP=$START_CP:$file;done;export START_CPCURTIME= date +%Y%m%d%H%M%Scd $SMS_HOME$JAVA_HOME/bin/java -Xms128M -Xmx512M -cp $START_CP net.unison.minebss.batchsend.BatchMain $CURTIME$RANDOM >/dev/null 2>&1 &2. 配置文件说明：batchSender.xml<import resource="dbContext.xml"/>&

18、lt;!- Hibernate 配置 -><bean id="sessionFactory"class="org.springframework.orm.hibernate3.LocalSessionFactoryBean"><property name="dataSource"><ref bean="dataSource" /></property><property name="hibernateProperties"><

19、;props><prop key="hibernate.dialect">org.hibernate.dialect.Oracle9Dialect</prop><prop key="hibernate.show_sql">true</prop><!- <prop key="hibernate.connection.release_mode">after_transaction</prop> -></props></propert

20、y><property name="mappingResources"><list><value>net/unison/minebss/batchsend/dao/TMsisdnExport.hbm.xml</value><value>net/unison/minebss/batchsend/dao/TMsisdnSender.hbm.xml</value></list></property></bean> <!- 营销Log配置：供BI采集 ->

21、<bean id="biLogger" class="net.unison.minebss.batchsend.BILog"> <property name="logPath" value="./logs/GM"></property> </bean> <!- 营销Log配置：供日志查询 -> <bean id="sendLog" class="net.unison.minebss.util.TimeRollingLog

22、"> <property name="dateFormat" value="yyyyMMddHHmmss"></property> <property name="fieldSeparator" value="|"></property> <property name="logPath" value="./logs"></property> <property name="

23、prefix" value="x"></property> <property name="suffix" value="send.log"></property> <property name="interval" value="1"></property> </bean> <!- 黑名单数据访问对象 -> <bean id="blacklistDao" class=&

24、quot;net.unison.minebss.blacklist.BlackListDao"> <property name="baseHome" value="./temp"></property> </bean> <!- 全网Wap Push -> <bean id="wapPushSender" class="net.unison.iodplatform.core.transfer.sms.WapPushSender"> <p

25、roperty name="serverURL"> <value>50:9903/axis1/services/WapPush</value> </property> <property name="deviceID"> <value>1128001</value> </property> <property name="password"> <value>898123998237&l

26、t;/value> </property> </bean> <!- 全网下行程序 -> <bean id="globalSender" class="net.unison.minebss.batchsend.GlobalMessageSender"> <property name="blacklistDao"> <ref bean="blacklistDao"/> </property> <property name=&

27、quot;wapPushSender"> <ref bean="wapPushSender"/> </property> </bean> <!- 地网下行程序 -> <bean id="mtSubmit" class="net.unison.minebss.router.mt.SubmitService"> </bean> <bean id="localSender" class="net.unison.mine

28、bss.batchsend.LocalMessageSender"> <property name="blacklistDao"> <ref bean="blacklistDao"/> </property> <property name="wapPushSender"> <ref bean="wapPushSender"/> </property> <property name="serviceID"

29、 value="SMSPUSH"/> <property name="smsSubmit"> <ref bean="mtSubmit"/> </property> </bean> <!- 营销程序配置 -> <bean id="batchSender" class="net.unison.minebss.batchsend.BatchMain"> <!所负责的营销省份 -> <property nam

30、e="permitProvinces"> <set> <!- 1.14 -><value>000</value> <value>020</value> <value>021</value> <value>022</value> <value>0351</value><value>0871</value><value>0471</value><value>0891<

31、;/value><value>0951</value><value>0991</value><!- 1.16 -><value>010</value><value>023</value><value>024</value><value>025</value><value>027</value><value>028</value><value>029</value>

32、<value>0311</value><value>0371</value><value>0431</value><value>0451</value><value>0531</value><value>0551</value><value>0571</value><value>0591</value><value>0731</value><value>0771<

33、/value><value>0791</value><value>0851</value><value>0898</value><value>0931</value><value>0971</value> </set> </property> <!- 营销号码下载URL。为空则在本地文件中获取 -> <property name="downloadURL"><value><!CDATA

34、84:8080/output></value></property> <!- 最大线程数 -> <property name="maxThreads" value="100" /> <!- 统计信息生成时间间隔（分钟) -> <property name="statistInterval" value="1"></property> <!- 营销最早开始时间 -> <prop

35、erty name="startTime" value="000000"></property> <!- 营销最晚开始时间 -> <property name="endTime" value="230000"></property> <!- 营销监控日志位置 -> <property name="debufLogPath" value="./logs"></property> <!

36、- 营销监控日志格式 -> <property name="layoutPattern" value="%d %-5p %t %c - %m%n"></property> <property name="logLevel" value="debug"></property> <!- 下行程序 -> <property name="globalSender"> <ref bean="globalSende

37、r"/> </property> <property name="localSender"> <ref bean="localSender"/> </property> <!- 营销Debug日志 -> <property name="biLog"> <ref bean="biLogger"/> </property> <!- <property name="sendLog"> <ref bean="sendLog"/> </property> -> </bean>5.5. 营销日志格式5.5.1. BI采集的日