計(jì)費(fèi)中心_計(jì)費(fèi)系統(tǒng)架構(gòu)設(shè)計(jì)說(shuō)明

1、計(jì)費(fèi)中心 架構(gòu)設(shè)計(jì)文檔修訂版歷史日期版本說(shuō)明作者2009-10-211.0總體設(shè)計(jì)戴小丹2009-10-271.1系統(tǒng)邊界高嵩2009-10-281.2業(yè)務(wù)流程袁志俊 目 錄目錄1.簡(jiǎn)介41.1.目的41.2.圍41.3.適用對(duì)象41.4.參考資料42.構(gòu)架目標(biāo)和約束43.業(yè)務(wù)分析43.1.概述43.2.業(yè)務(wù)主流程54.模塊劃分54.1.主要模塊54.2.工程劃分54.3.邏輯分層55.架構(gòu)設(shè)計(jì)65.1.總體結(jié)構(gòu)65.1.1.概述65.1.2.開發(fā)框架75.1.3.技術(shù)特性75.1.4.技術(shù)風(fēng)險(xiǎn)75.2.基礎(chǔ)設(shè)施75.2.1.異步框架75.2.2.日志框架85.2.3.多線程85.3

2、.系統(tǒng)設(shè)計(jì)：核心業(yè)務(wù)設(shè)計(jì)85.3.1.周期性計(jì)費(fèi)劃價(jià)流程85.3.2.非周期性計(jì)費(fèi)劃價(jià)流程95.3.3.各種維度計(jì)費(fèi)統(tǒng)計(jì)105.3.4.出賬和服務(wù)控制流程115.4.系統(tǒng)設(shè)計(jì)：詳細(xì)業(yè)務(wù)設(shè)計(jì)115.4.1.領(lǐng)域模型125.4.2.數(shù)據(jù)采集類圖125.4.3.訂單收集時(shí)序圖135.4.4.實(shí)時(shí)業(yè)務(wù)數(shù)據(jù)采集時(shí)序圖145.4.5.數(shù)據(jù)篩選分析類圖155.4.6.數(shù)據(jù)篩選分析時(shí)序圖155.4.7.實(shí)時(shí)性批價(jià)類圖165.4.8.實(shí)時(shí)性批價(jià)時(shí)序圖175.4.9.周期性批價(jià)類圖185.4.10.周期性批價(jià)時(shí)序圖195.4.11.計(jì)費(fèi)匯總類圖195.4.12.計(jì)費(fèi)匯總時(shí)序圖205.4.13.帳務(wù)管理類圖215.

3、4.14.出帳時(shí)序圖225.4.15.服務(wù)控制類圖235.4.16.固定帳期服務(wù)控制時(shí)序圖245.4.17.帳期之外扣款觸發(fā)服務(wù)控制時(shí)序圖245.5.系統(tǒng)設(shè)計(jì)：系統(tǒng)邊界接口255.5.1.收費(fèi)產(chǎn)品原始數(shù)據(jù)采集255.5.2.訂單開通業(yè)務(wù)255.5.3.訂單狀態(tài)變化通知接口265.5.4.批價(jià)接口265.5.5.計(jì)費(fèi)系統(tǒng)反饋客戶賬務(wù)欠費(fèi)狀態(tài)接口275.5.6.扣款接口275.5.7.扣款狀態(tài)回調(diào)接口285.5.8.PC2授權(quán)用戶數(shù)接口285.6.系統(tǒng)設(shè)計(jì)：數(shù)據(jù)ER圖296.服務(wù)器部署307.其它307.1.規(guī)模分析（可選）307.2.性能分析及實(shí)現(xiàn)（可選）307.3.質(zhì)量的達(dá)成（可選）308.附

4、錄（術(shù)語(yǔ)）301. 簡(jiǎn)介1.1. 目的此文檔通過(guò)對(duì)計(jì)費(fèi)中心總體的業(yè)務(wù)架構(gòu)建模，描述了計(jì)費(fèi)中心整體業(yè)務(wù)架構(gòu)設(shè)計(jì)藍(lán)圖，對(duì)后續(xù)的設(shè)計(jì)和開發(fā)提供指導(dǎo)和參照。1.2. 圍本文檔主要涉及計(jì)費(fèi)中心的總體業(yè)務(wù)架構(gòu)設(shè)計(jì)及系統(tǒng)中各個(gè)業(yè)務(wù)模塊的架構(gòu)設(shè)計(jì)。 1.3. 適用對(duì)象本文檔適用于：Ø 產(chǎn)品設(shè)計(jì)師：根據(jù)本文檔中描述的架構(gòu)模型評(píng)估需求滿足度；Ø 開發(fā)工程師：參照本文檔和詳細(xì)設(shè)計(jì)文檔進(jìn)行開發(fā)。1.4. 參考資料此軟件架構(gòu)設(shè)計(jì)參考計(jì)費(fèi)系統(tǒng)需求及相關(guān)業(yè)務(wù)文檔，如下所示：Ø ITBU業(yè)務(wù)支撐系統(tǒng)規(guī)劃V1.0.pptxØ 計(jì)費(fèi)系統(tǒng)UC文檔2. 構(gòu)架目標(biāo)和約束本文檔從全局的角度出發(fā)描述

5、了計(jì)費(fèi)系統(tǒng)的總體業(yè)務(wù)架構(gòu)，打造一個(gè)高性能、高穩(wěn)定性計(jì)費(fèi)平臺(tái)。3. 業(yè)務(wù)分析3.1. 概述目前支持計(jì)費(fèi)模式：1、 支持非實(shí)時(shí)按次計(jì)費(fèi)的后付費(fèi)業(yè)務(wù)2、 支持按天計(jì)費(fèi)的后付費(fèi)業(yè)務(wù)3、 支持按天/最大賬號(hào)數(shù)計(jì)費(fèi)的后付費(fèi)業(yè)務(wù)（按每份訂單每天授權(quán)過(guò)的最大賬號(hào)數(shù)計(jì)費(fèi)）4、 支持首次開通N天（首次使用N次）免費(fèi)的計(jì)費(fèi)策略5、 支持同一份訂單同一天暫?；謴?fù)多次僅按一天計(jì)費(fèi)（多份訂單時(shí)按每份訂單單獨(dú)計(jì)費(fèi)，即使同一天退訂再開通，按多份訂單計(jì)費(fèi)。）6、 支持用戶使用時(shí)按實(shí)際付費(fèi)者收費(fèi)（老板訂購(gòu)，業(yè)務(wù)員使用或邀請(qǐng)業(yè)務(wù)）7、 支持按設(shè)定的日期出賬業(yè)務(wù)8、 支持欠費(fèi)自動(dòng)停止欠費(fèi)服務(wù)9、 支持充值銷賬后自動(dòng)開通銷賬成功客戶的

6、服務(wù)3.2. 業(yè)務(wù)主流程4. 模塊劃分4.1. 主要模塊子系統(tǒng)功能模塊數(shù)據(jù)采集數(shù)據(jù)分析賬務(wù)管理4.2. 工程劃分略4.3. 邏輯分層略5. 架構(gòu)設(shè)計(jì)5.1. 總體結(jié)構(gòu)5.1.1. 概述本系統(tǒng)設(shè)計(jì)以覆蓋阿里巴巴所有SaaS業(yè)務(wù)為目標(biāo)，根據(jù)不收費(fèi)模式（預(yù)付費(fèi)、后付費(fèi)）進(jìn)行計(jì)費(fèi)。作為一項(xiàng)復(fù)雜、技術(shù)含量高的項(xiàng)目，SaaS業(yè)務(wù)實(shí)時(shí)計(jì)費(fèi)結(jié)算系統(tǒng)設(shè)計(jì)時(shí)從技術(shù)和系統(tǒng)設(shè)計(jì)角度看，應(yīng)遵循以下原則：開放性基于統(tǒng)一UDB用戶體系，保證系統(tǒng)之間交互接口支持多種訪問(wèn)協(xié)議，滿足多個(gè)業(yè)務(wù)產(chǎn)品線的業(yè)務(wù)模式。可擴(kuò)充性系統(tǒng)要有良好的可擴(kuò)充性。從總體結(jié)構(gòu)到具體硬件設(shè)備，都要給將來(lái)業(yè)務(wù)的新技術(shù)新產(chǎn)品預(yù)留接口，以便進(jìn)行平滑地升級(jí)和資源擴(kuò)

7、充。容錯(cuò)性和可靠性實(shí)時(shí)計(jì)費(fèi)網(wǎng)絡(luò)應(yīng)用，對(duì)系統(tǒng)的可靠性要求極高，關(guān)鍵主機(jī)系統(tǒng)不允許停機(jī)發(fā)布應(yīng)用。這就需要采取各種容錯(cuò)技術(shù)以確保系統(tǒng)正常工作，如不停機(jī)發(fā)布版本等，但是在硬件設(shè)備也需要相應(yīng)的方案支持，如雙機(jī)熱備、備份電源等技術(shù)保證服務(wù)器不出現(xiàn)停機(jī)故障。安全性在保證高可用性的同時(shí)，要有各種措施工具防止對(duì)數(shù)據(jù)的非法訪問(wèn)和篡改，口令就是一種行之有效的工具。網(wǎng)絡(luò)支撐環(huán)境也應(yīng)有相應(yīng)的安全性機(jī)制如網(wǎng)絡(luò)管理員權(quán)限，各種網(wǎng)絡(luò)設(shè)備配置權(quán)限等。5.1.2. 開發(fā)框架相關(guān)框架開發(fā)框架Webwork+Spring+Ibatis接口發(fā)布訪問(wèn)協(xié)議Hessian項(xiàng)目構(gòu)建管理Maven數(shù)據(jù)庫(kù)Oracle運(yùn)行環(huán)境Jboss-4.2.1

8、.GA開發(fā)工具Eclipse5.1.3. 技術(shù)特性技術(shù)特性概述數(shù)據(jù)異步處理為處理失敗的數(shù)據(jù)提供自動(dòng)重試等相關(guān)策略日志詳細(xì)跟蹤異常定位多任務(wù)精確統(tǒng)計(jì)數(shù)據(jù)解決多任務(wù)中出現(xiàn)重復(fù)統(tǒng)計(jì)、遺漏統(tǒng)計(jì)等問(wèn)題歷史表數(shù)據(jù)存儲(chǔ)通過(guò)數(shù)據(jù)遷移保證上億級(jí)數(shù)據(jù)存儲(chǔ)和高效檢索分區(qū)數(shù)據(jù)存儲(chǔ)通過(guò)數(shù)據(jù)遷移保證上億級(jí)數(shù)據(jù)存儲(chǔ)和高效檢索5.1.4. 技術(shù)風(fēng)險(xiǎn)1、 異步處理數(shù)據(jù)準(zhǔn)確性。2、 支持上百萬(wàn)用戶的計(jì)費(fèi)能力。3、 系統(tǒng)間聯(lián)調(diào)、集成風(fēng)險(xiǎn)。5.2. 基礎(chǔ)設(shè)施5.2.1. 異步框架5.2.2. 日志框架5.2.3. 多線程5.3. 系統(tǒng)設(shè)計(jì)：核心業(yè)務(wù)設(shè)計(jì)5.3.1. 周期性計(jì)費(fèi)劃價(jià)流程收集訂單生產(chǎn)計(jì)費(fèi)事件批價(jià)匯總訂單系統(tǒng)產(chǎn)品系統(tǒng)產(chǎn)生計(jì)

9、費(fèi)明細(xì)計(jì)費(fèi)明細(xì)表計(jì)費(fèi)匯總表計(jì)費(fèi)系統(tǒng)訂單鏡像表計(jì)費(fèi)事件表輪詢批價(jià)（每日）生成訂單鏡像產(chǎn)生計(jì)費(fèi)匯總ActionDataOther System各種維度的計(jì)費(fèi)統(tǒng)計(jì)值5.3.2. 非周期性計(jì)費(fèi)劃價(jià)流程原始消費(fèi)信息臨時(shí)表輪詢Task數(shù)據(jù)篩選批價(jià)匯總業(yè)務(wù)系統(tǒng)產(chǎn)品系統(tǒng)產(chǎn)生計(jì)費(fèi)明細(xì)計(jì)費(fèi)明細(xì)表計(jì)費(fèi)匯總表按用戶操作觸發(fā)計(jì)費(fèi)系統(tǒng)各種維度的計(jì)費(fèi)統(tǒng)計(jì)值批價(jià)獲取原始消費(fèi)信息產(chǎn)生計(jì)費(fèi)匯總ActionDataOther System5.3.3. 各種維度計(jì)費(fèi)統(tǒng)計(jì)原始消費(fèi)信息臨時(shí)表輪詢Task數(shù)據(jù)篩選業(yè)務(wù)系統(tǒng)PC2按用戶操作觸發(fā)計(jì)費(fèi)系統(tǒng)各種維度的計(jì)費(fèi)統(tǒng)計(jì)值產(chǎn)生計(jì)費(fèi)統(tǒng)計(jì)獲取原始消費(fèi)信息ActionDataOther System

10、帳號(hào)數(shù)5.3.4. 出賬和服務(wù)控制流程賬戶系統(tǒng)出帳觸發(fā)服務(wù)控制計(jì)費(fèi)匯總表計(jì)費(fèi)系統(tǒng)PC2帳期定時(shí)、手工、閥值賬單匯總表扣費(fèi)成功財(cái)務(wù)系統(tǒng)出帳期計(jì)費(fèi)事件表開通或關(guān)閉通知更改賬單狀態(tài)ActionDataOther System是否超過(guò)帳期閥值超過(guò)帳期閥值帳期閥值日觸發(fā)產(chǎn)生計(jì)費(fèi)事件訂單鏡像更改訂單狀態(tài)5.4. 系統(tǒng)設(shè)計(jì)：詳細(xì)業(yè)務(wù)設(shè)計(jì)1.2.3.4.5.5.1.5.2.5.3.5.4.5.4.1. 領(lǐng)域模型5.4.2. 數(shù)據(jù)采集類圖5.4.3. 訂單收集時(shí)序圖5.4.4. 實(shí)時(shí)業(yè)務(wù)數(shù)據(jù)采集時(shí)序圖5.4.5. 數(shù)據(jù)篩選分析類圖5.4.6. 數(shù)據(jù)篩選分析時(shí)序圖5.4.7. 實(shí)時(shí)性批價(jià)類圖5.4.8. 實(shí)時(shí)性批

11、價(jià)時(shí)序圖5.4.9. 周期性批價(jià)類圖5.4.10. 周期性批價(jià)時(shí)序圖5.4.11. 計(jì)費(fèi)匯總類圖5.4.12. 計(jì)費(fèi)匯總時(shí)序圖5.4.13. 帳務(wù)管理類圖5.4.14. 出帳時(shí)序圖5.4.15. 服務(wù)控制類圖5.4.16. 固定帳期服務(wù)控制時(shí)序圖5.4.17. 帳期之外扣款觸發(fā)服務(wù)控制時(shí)序圖5.5. 系統(tǒng)設(shè)計(jì)：系統(tǒng)邊界接口5.5.1. 收費(fèi)產(chǎn)品原始數(shù)據(jù)采集調(diào)用形式：Hessian接口名稱：insertServiceOp描述：按次收費(fèi)的產(chǎn)品項(xiàng)消費(fèi)行為記錄接口參數(shù)：名稱類型說(shuō)明BillinginfoObject本次產(chǎn)品項(xiàng)所需參數(shù)實(shí)體Billinginfo屬性表述名稱類型說(shuō)明usernameStri

12、ng當(dāng)前使用者名稱userIdString當(dāng)前使用者用戶IDpayerMemIdString付款賬戶人memId, productNameString產(chǎn)品名稱productIdString產(chǎn)品IdstartDateDate開始日期endDateDate結(jié)束日期AmountBigDemail（特殊業(yè)務(wù)）不需要批價(jià)useAgeBigDemail使用量useUnitString使用量單位返回值：名稱類型說(shuō)明resultString1:表示成功-1：表示參數(shù)錯(cuò)誤5.5.2. 訂單開通業(yè)務(wù)調(diào)用形式：Hessian接口名稱：installOrder描述：當(dāng)訂單系統(tǒng)生成一條新的訂單行記錄時(shí)，通知定計(jì)費(fèi)系統(tǒng)

13、接口參數(shù)：名稱類型說(shuō)明OrderObject計(jì)費(fèi)系統(tǒng)中訂單行鏡像Order屬性名稱類型說(shuō)明orderedString訂單行號(hào)ordercodeString訂單codecustIdString客戶IDbillingTypeString（次/年/月）productIdString產(chǎn)品IDStatusString狀態(tài)productStrategyIdString促銷策略IdstartDateDate開通日期specConditionString特征值isQuotaString是否按配額計(jì)算payerMemIdString付款人ID返回值：名稱類型說(shuō)明resultString1:表示成功-1：表示參數(shù)

14、錯(cuò)誤5.5.3. 訂單狀態(tài)變化通知接口調(diào)用形式：Hessian接口名稱：updateOrderState描述：當(dāng)訂單狀態(tài)發(fā)生變化，訂單系統(tǒng)通知計(jì)費(fèi)系統(tǒng)中訂單鏡像做同步接口參數(shù)：名稱類型說(shuō)明ordereIdString對(duì)應(yīng)訂單系統(tǒng)中訂單行號(hào)StateString狀態(tài)返回值：名稱類型說(shuō)明resultString1:表示成功-1：表示參數(shù)錯(cuò)誤5.5.4. 批價(jià)接口調(diào)用形式：Hessian接口名稱：getTotalPrice描述：進(jìn)行批價(jià)接口參數(shù)：名稱類型說(shuō)明productKeyString產(chǎn)品項(xiàng)IdfeatureListHashMap特征值measureUnitsString計(jì)量單位(年月日) 為空

15、時(shí)表示單位是個(gè)countBigDecimal購(gòu)買數(shù)量不能為空或0CurrencyString幣種，不能為空返回值：名稱類型說(shuō)明EsbResultModelorg.mule.esb.model.tcc.result.EsbResultModel返回產(chǎn)品總價(jià)model.getReturnValue():BigDecimal()-1：系統(tǒng)異常，調(diào)用失敗。-2：表示驗(yàn)證通過(guò)但未激活-3：登錄名不存在-4：校驗(yàn)失敗; 驗(yàn)證成功：返回用戶ID5.5.5. 計(jì)費(fèi)系統(tǒng)反饋客戶賬務(wù)欠費(fèi)狀態(tài)接口調(diào)用形式：Hessian接口名稱：feedbackUser描述：反饋用戶賬務(wù)信息接口參數(shù)：名稱類型說(shuō)明payerMemI

16、dString付款人Id返回值：名稱類型說(shuō)明ResultString改用戶賬務(wù)情況1：未欠費(fèi)-1：已欠費(fèi)5.5.6. 扣款接口調(diào)用形式：Hessian接口名稱：chargeAccount（具體接口名賬戶系統(tǒng)訂）描述：賬期出賬接口參數(shù)：名稱類型說(shuō)明InvoiceObject出賬單Invoice屬性名稱類型說(shuō)明guidString主鍵custIdString客戶IdcustNameString客戶名稱payerMemIdString付款人IdtotalAmountBigDecimal總金額rmbAmountBigDecimal人民幣總金額twbAmountBigDecimal臺(tái)幣總金額usdoll

17、arAmountBigDecimal美元總金額gbAmountBigDecimal港幣總金額ItemList<InvoiceItem>扣款明細(xì)InvoiceItem屬性表述返回值：名稱類型說(shuō)明guidString主鍵productIdString產(chǎn)品項(xiàng)IdproductNameString產(chǎn)品項(xiàng)名稱orderCodeString訂單行CnyString幣種AmountBigDecimal金額markAmountBigDecimal標(biāo)價(jià)金額名稱類型說(shuō)明ResultString1. 發(fā)送成功2. 發(fā)送失敗5.5.7. 扣款狀態(tài)回調(diào)接口調(diào)用形式：Hessian接口名稱：payCallback描述：賬務(wù)系統(tǒng)扣費(fèi)成功回調(diào)計(jì)費(fèi)系統(tǒng)扣費(fèi)成功通知接口參數(shù)：名稱類型說(shuō)明invoiceIdString計(jì)費(fèi)系統(tǒng)賬單IdstateString付費(fèi)情況返回值：名稱類型說(shuō)明