demo-設(shè)計(jì)說(shuō)明書(shū)

1、系統(tǒng)設(shè)計(jì)說(shuō)明書(shū)1. 目標(biāo)與范圍建立號(hào)碼庫(kù)系統(tǒng)的目的是為了有效管理公司的號(hào)碼資源，在日常業(yè)務(wù)推廣中能夠正確、充分而高效地利用，減少人工操作，提高工作效率。營(yíng)銷系統(tǒng)和號(hào)碼庫(kù)管理系統(tǒng)密切相關(guān)，本文檔一并表述。首期號(hào)碼庫(kù)系統(tǒng)采用數(shù)據(jù)庫(kù)存儲(chǔ)，時(shí)機(jī)成熟采用文件索引的存儲(chǔ)策略。2. 術(shù)語(yǔ)與縮寫(xiě)黑名單：不允許有任何下行短信，即便有上行短信。黃名單：禁止?fàn)I銷?？梢杂姓５纳舷滦卸绦?. 系統(tǒng)體系結(jié)構(gòu)設(shè)計(jì)3.1. 體系結(jié)構(gòu)3.2. 系統(tǒng)組成部分1、 業(yè)務(wù)支撐子系統(tǒng)：提供UI，完成入庫(kù)安排、出庫(kù)安排、營(yíng)銷安排以及相應(yīng)的查詢頁(yè)面。提供號(hào)碼管理、黑名管理、網(wǎng)關(guān)管理等功能。2、 號(hào)碼管理子系統(tǒng)：完成號(hào)碼入庫(kù)、號(hào)碼出庫(kù)、號(hào)

2、碼歸屬地判定、黑名單過(guò)濾等功能。注：該系統(tǒng)首期采用數(shù)據(jù)庫(kù)實(shí)現(xiàn)。隨號(hào)碼量增長(zhǎng)，轉(zhuǎn)到文件索引方式存儲(chǔ)。3、 營(yíng)銷子系統(tǒng)：根據(jù)營(yíng)銷安排，完成短信/WAP push 信息營(yíng)銷功能。包括流量控制、監(jiān)控報(bào)警、日志輸出等模塊。3.3. 系統(tǒng)運(yùn)行流程3.3.1. 入庫(kù)流程 3.3.2. 營(yíng)銷流程3.4. 網(wǎng)絡(luò)拓?fù)?. 數(shù)據(jù)庫(kù)設(shè)計(jì)4.1. 物理模型設(shè)計(jì)4.2. 表定義4.2.1. 號(hào)段表名稱代碼數(shù)據(jù)類型注釋號(hào)段prefixvarchar2(7)地區(qū)編碼area_idvarchar2(5)運(yùn)營(yíng)商類型carrier_idnumber(1)1.移動(dòng)；2.聯(lián)通；3.網(wǎng)通；4.電信號(hào)段品牌mobile_typenumbe

3、r(2)0:未知；1.全球通；2.動(dòng)感地帶 3.神州行；4.聯(lián)通G網(wǎng)；5.聯(lián)通C網(wǎng)；6.小靈通4.2.2. 號(hào)碼入庫(kù)表名稱代碼數(shù)據(jù)類型注釋入庫(kù)批次import_idnumber(9)從1開(kāi)始，自增序列入庫(kù)批次名稱import_namevarchar(255)末位為8為全網(wǎng)營(yíng)銷,其他為地網(wǎng)營(yíng)銷省份編碼province_idvarchar2(5)地區(qū)編碼area_idvarchar2(5)000：表示未知地區(qū)運(yùn)營(yíng)商類型carrier_idnumber(1)1.移動(dòng)；2.聯(lián)通；3.網(wǎng)通；4.電信用戶類型user_typenumber(1)0：未知；1.彩鈴用戶；2.非彩鈴用戶用戶品牌mobile_t

4、ypenumber(1)0:未知；1.全球通；2.動(dòng)感地帶 3.神州行；4.聯(lián)通G網(wǎng)；5.聯(lián)通C網(wǎng)；6.小靈通俱樂(lè)部會(huì)員狀態(tài)club_statusnumber(1)0:未知;1：非會(huì)員 2.普通會(huì)員 3.高級(jí)會(huì)員消費(fèi)狀態(tài)consume_statusnumber(1)0.未知；1高端用戶 2 中端用戶3低端用戶活躍程度active_degreenumber(1)0.9；共9級(jí)是否搜索用戶is_searchnumber(1)0:否；1：是號(hào)碼來(lái)源sourcenumber(1)1:BI提供；2：銷售提供號(hào)碼文件名稱file_namevarchar2(255)文件名全稱號(hào)碼數(shù)量loader_count

5、number(10)成功入庫(kù)號(hào)碼數(shù)量success_countnumber(10)當(dāng)前操作狀態(tài)statusnumber(2)0:號(hào)碼傳輸中；1:號(hào)碼就緒；2:號(hào)碼入庫(kù)中；3號(hào)碼入庫(kù)完畢；其他：錯(cuò)誤入庫(kù)開(kāi)始時(shí)間loader_dateDATE操作員IDoperator_idINTEGER號(hào)碼提供者providervarchar2(20)入庫(kù)安排時(shí)間order_dateDATE備注memovarchar2(255)4.2.3. 號(hào)碼出庫(kù)表名稱代碼數(shù)據(jù)類型注釋營(yíng)銷批次sender_idINTEGER從1開(kāi)始，自增序列入庫(kù)批次import_idINTEGER省份編碼province_idvarchar2

6、(5)地區(qū)編碼area_idvarchar2(5)000：表示未知地區(qū)運(yùn)營(yíng)商類型carrier_idnumber(1)1.移動(dòng)；2.聯(lián)通；3.網(wǎng)通；4.電信用戶類型user_typenumber(1)0：未知；1.彩鈴用戶；2.非彩鈴用戶用戶品牌mobile_typenumber(1)0:未知；1.全球通；2.動(dòng)感地帶 3.神州行；4.聯(lián)通G網(wǎng)；5.聯(lián)通C網(wǎng)；6.小靈通活躍程度active_degreenumber(1)0.9；共9級(jí)是否搜索用戶is_searchnumber(1)0:否；1：是營(yíng)銷間隔天數(shù)daysnumber(2)至上次營(yíng)銷的時(shí)間間隔號(hào)碼來(lái)源sourcenumber(1)1:

7、BI提供；2：銷售提供出庫(kù)號(hào)碼數(shù)量export_countnumber(10)成功出庫(kù)號(hào)碼數(shù)量success_countnumber(10)當(dāng)前操作狀態(tài)statusnumber(2)0:號(hào)碼未出庫(kù)；1:號(hào)碼出庫(kù)中；2:號(hào)碼就緒；其他：錯(cuò)誤號(hào)碼文件名稱file_namevarchar2(255)文件名全稱出庫(kù)時(shí)間export_timevarchar(10)出庫(kù)操作耗費(fèi)時(shí)間的描述備注memovarchar2(255)4.2.4. 號(hào)碼表名稱代碼數(shù)據(jù)類型注釋手機(jī)號(hào)碼msisdnvarchar2(11)入庫(kù)批次loader_idnumber(9)從1開(kāi)始，自增序列地區(qū)編碼area_idvarchar2

8、(5)出庫(kù)次數(shù)export_countnumber(5)上次提取日export_daynumber(9)從1970.1.1開(kāi)始的天數(shù)4.2.5. 地區(qū)列表名稱代碼數(shù)據(jù)類型注釋地區(qū)編碼area_idvarchar2(5)省份表_省份編碼province_idvarchar2(5)地區(qū)名稱area_namevarchar2(20)4.2.6. 省份表名稱代碼數(shù)據(jù)類型注釋省份編碼province_idvarchar2(5)省份名稱province_namevarchar2(20)4.2.7. 營(yíng)銷安排表名稱代碼數(shù)據(jù)類型注釋營(yíng)銷批次sender_idnumber(9)從1開(kāi)始，自增序列營(yíng)銷名稱send

9、er_namevarchar(255)網(wǎng)關(guān)編號(hào)gateway_idvarchar2(6)通過(guò)中央平臺(tái)發(fā)送的已8結(jié)尾。接入號(hào)碼sp_novarchar2(20)擴(kuò)展號(hào)碼ext_novarchar2(20)消息類型msg_typenumber(1)0:普通短信；1:長(zhǎng)短信；2:WAP PUSH消息正文msg_contentvarchar2(2000)WapPush標(biāo)題和URL之間用<br>分隔。發(fā)送速度speednumber(9)單位：條/毫秒號(hào)碼來(lái)源sourcenumber(1)0:號(hào)碼庫(kù)；1：操作員提供號(hào)碼文件名稱file_namevarchar2(255)source=1時(shí)有意義

10、；文件名全稱監(jiān)控手機(jī)號(hào)碼monitor_msisdnvarchar2(255)號(hào)碼間用逗號(hào)分隔營(yíng)銷號(hào)碼數(shù)量sender_countnumber(10)號(hào)碼來(lái)源為1時(shí)有意義實(shí)際發(fā)送的號(hào)碼數(shù)量real_countnumber(10)成功發(fā)送號(hào)碼數(shù)量success_countnumber(10)由營(yíng)銷系統(tǒng)在發(fā)送完畢后更新?tīng)I(yíng)銷省份province_idvarchar2(5)營(yíng)銷地區(qū)area_idvarchar2(5)營(yíng)銷類型sender_typenumber(2)0:普通營(yíng)銷;1.針對(duì)活動(dòng)的營(yíng)銷2: UCIP營(yíng)銷;3: IVR營(yíng)銷4: 競(jìng)價(jià)營(yíng)銷;5: 運(yùn)營(yíng)商營(yíng)銷6: 結(jié)信營(yíng)銷；7、IVR+競(jìng)價(jià)營(yíng)銷當(dāng)前

11、操作狀態(tài)statusnumber(2)0:號(hào)碼準(zhǔn)備中；1:號(hào)碼就緒；2:號(hào)碼發(fā)送中；3號(hào)碼發(fā)送完畢狀態(tài)描述status_descvarchar2(255)錯(cuò)誤狀態(tài)描述營(yíng)銷開(kāi)始時(shí)間launch_dateDATE營(yíng)銷終止時(shí)間over_dateDATE裝載營(yíng)銷任務(wù)時(shí)，會(huì)檢測(cè)但是是否是否超過(guò)終止時(shí)間，是則不回啟動(dòng)營(yíng)銷任務(wù)。實(shí)際營(yíng)銷開(kāi)始時(shí)間real_launch_dateDATE由營(yíng)銷系統(tǒng)在發(fā)送完畢后更新實(shí)際營(yíng)銷完成時(shí)間real_over_dateDATE由營(yíng)銷系統(tǒng)在發(fā)送完畢后更新?tīng)顟B(tài)更新時(shí)間cur_return_timeDATE營(yíng)銷程序回寫(xiě)營(yíng)銷狀態(tài)的時(shí)間當(dāng)前發(fā)送數(shù)量cur_send_countnumb

12、er(10)當(dāng)前成功發(fā)送數(shù)量cur_success_countnumber(10)發(fā)送線程個(gè)數(shù)send_thread_cntnumber(3)操作員IDoperator_idINTEGER營(yíng)銷安排時(shí)間order_dateDATE安排營(yíng)銷任務(wù)的時(shí)間備注memovarchar2(255)4.2.8. 營(yíng)銷日志名稱代碼數(shù)據(jù)類型注釋營(yíng)銷批次sender_idnumber(9)從1開(kāi)始，自增序列手機(jī)號(hào)碼user_idvarchar2(22)發(fā)送時(shí)間send_dtdate發(fā)送結(jié)果resultvarchar(6)000000：成功4.2.9. 黑名單名稱代碼數(shù)據(jù)類型注釋手機(jī)號(hào)碼msisdnVARCHAR(2

13、0)號(hào)碼類型typenumber(1)1.黑名單；2.黃名單添加時(shí)間enter_dateDATE添加操作員operatoridNUMBER(8)5. 營(yíng)銷系統(tǒng)設(shè)計(jì)與維護(hù)5.1. 設(shè)計(jì)原則1.營(yíng)銷進(jìn)程在Crontab中啟動(dòng)，最小時(shí)間間隔3分鐘（為避免數(shù)據(jù)庫(kù)異常造成重復(fù)營(yíng)銷）。2.每次營(yíng)銷進(jìn)程運(yùn)行只啟動(dòng)一個(gè)待營(yíng)銷任務(wù),多線程發(fā)送。該進(jìn)程用Linux系統(tǒng)下$RANDOM來(lái)標(biāo)識(shí)，稱之為進(jìn)程標(biāo)識(shí)。3.每營(yíng)銷任務(wù)輸出兩個(gè)log。一個(gè)為營(yíng)銷日志，log文件名格式為：營(yíng)銷進(jìn)程標(biāo)識(shí)-營(yíng)銷任務(wù)ID-營(yíng)銷開(kāi)始時(shí)間.log。記錄格式為：手機(jī)號(hào)碼,營(yíng)銷任務(wù)ID,發(fā)送結(jié)果一個(gè)為營(yíng)銷Debug日志(log4j)，記錄程序運(yùn)

14、行情況，文件名格式為：Batch_營(yíng)銷進(jìn)程標(biāo)識(shí)_進(jìn)程啟動(dòng)時(shí)間.log4.營(yíng)銷速度的策略：設(shè)定最大線程個(gè)數(shù)為m,營(yíng)銷速度n條/秒當(dāng)1>n時(shí)，營(yíng)銷程序創(chuàng)建1個(gè)線程，每線程1/n秒發(fā)送一條。當(dāng)1<n<m時(shí)，營(yíng)銷程序創(chuàng)建n個(gè)線程,每線程發(fā)送速度為1條/秒當(dāng)n>m時(shí)，營(yíng)銷程序創(chuàng)建m個(gè)線程，每線程發(fā)送速度為n/m條。5.2. 營(yíng)銷流程1檢索t_msisdn_sender表， 所負(fù)責(zé)省份是否存在待執(zhí)行營(yíng)銷任務(wù)。沒(méi)有，程序退出。否則下一步； 2.檢查營(yíng)銷各個(gè)參數(shù)是否正確，錯(cuò)誤，程序退出。3.http方式下載號(hào)碼(壓縮方式)文件，將號(hào)碼文件緩存在tmp目錄中。4.解壓縮并裝載號(hào)碼文件，根

15、據(jù)號(hào)碼數(shù)量，計(jì)算啟動(dòng)的線程個(gè)數(shù)和每線程發(fā)送速度。5.如果營(yíng)銷網(wǎng)關(guān)編號(hào)尾數(shù)為8。則裝載中央音樂(lè)平臺(tái)發(fā)送接口模塊。如果不為8，則為全網(wǎng)轉(zhuǎn)地網(wǎng)營(yíng)銷，裝載本地接入網(wǎng)關(guān)RMI接口模塊。如營(yíng)銷類型為WapPush，則裝載全網(wǎng)WapPush模塊！6.給營(yíng)銷監(jiān)控號(hào)碼發(fā)送營(yíng)銷開(kāi)始信息，發(fā)送營(yíng)銷語(yǔ)。7.啟動(dòng)發(fā)送線程，進(jìn)行營(yíng)銷。如果營(yíng)銷為當(dāng)當(dāng)前時(shí)間大于系統(tǒng)預(yù)設(shè)終止時(shí)間時(shí)，營(yíng)銷線程退出。8.啟動(dòng)營(yíng)銷監(jiān)控線程，回寫(xiě)營(yíng)銷狀態(tài)：包括號(hào)碼數(shù)量、成功發(fā)送數(shù)量等。9.營(yíng)銷完畢，給營(yíng)銷監(jiān)控號(hào)碼發(fā)送營(yíng)銷統(tǒng)計(jì)信息，并發(fā)送營(yíng)銷語(yǔ)。10.營(yíng)銷終止，回寫(xiě)營(yíng)銷狀態(tài)。5.3. 程序說(shuō)明程序位置：mineBss項(xiàng)目net.unison.mineb

16、ss.batchsend5.4. 配置文件1. 啟動(dòng)腳本：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. 配置文件說(shuō)明：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> <!- 營(yíng)銷Log配置：供BI采集 ->

21、<bean id="biLogger" class="net.unison.minebss.batchsend.BILog"> <property name="logPath" value="./logs/GM"></property> </bean> <!- 營(yíng)銷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> <!- 黑名單數(shù)據(jù)訪問(wèn)對(duì)象 -> <bean id="blacklistDao" class=&

24、quot;net.unison.minebss.blacklist.BlackListDao"> <property name="baseHome" value="./temp"></property> </bean> <!- 全網(wǎng)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> <!- 全網(wǎng)下行程序 -> <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> <!- 地網(wǎng)下行程序 -> <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> <!- 營(yíng)銷程序配置 -> <bean id="batchSender" class="net.unison.minebss.batchsend.BatchMain"> <!所負(fù)責(zé)的營(yíng)銷省份 -> <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> <!- 營(yíng)銷號(hào)碼下載URL。為空則在本地文件中獲取 -> <property name="downloadURL"><value><!CDATA

34、84:8080/output></value></property> <!- 最大線程數(shù) -> <property name="maxThreads" value="100" /> <!- 統(tǒng)計(jì)信息生成時(shí)間間隔（分鐘) -> <property name="statistInterval" value="1"></property> <!- 營(yíng)銷最早開(kāi)始時(shí)間 -> <prop

35、erty name="startTime" value="000000"></property> <!- 營(yíng)銷最晚開(kāi)始時(shí)間 -> <property name="endTime" value="230000"></property> <!- 營(yíng)銷監(jiān)控日志位置 -> <property name="debufLogPath" value="./logs"></property> <!

36、- 營(yíng)銷監(jiān)控日志格式 -> <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> <!- 營(yíng)銷Debug日志 -> <property name="biLog"> <ref bean="biLogger"/> </property> <!- <property name="sendLog"> <ref bean="sendLog"/> </property> -> </bean>5.5. 營(yíng)銷日志格式5.5.1. BI采集的日