5.程序源碼posv2d-mm詳細技術(shù)設(shè)計v1

1、LKKHPGv2.0 項目技術(shù)詳細設(shè)計文檔D-MM-001會員管理會員詳情頁文檔作者:創(chuàng)建日期:更新日期:當前版本:2016-01-14V1.0簽字:LKKHPG 項目經(jīng)理HAND 項目經(jīng)理文檔控制更改審閱日期職位簽名日期職位日期作者版本更改參考2016-01-141.0目錄文檔控制2目錄3概述5術(shù)語表5相關(guān)文檔5前端詳細設(shè)計6全局按鈕6UI 設(shè)計6文件6頁面URL 定義6控件事件7Function7會員基本信息頁12UI 設(shè)計12文件12頁面URL 定義12控件事件13Function13聯(lián)系人信息頁13UI 設(shè)計14文件14頁面URL 定義14控件事件14Function15相關(guān)人信息頁1

2、5UI 設(shè)計15文件15頁面URL 定義15控件事件16Function16會員頁17UI 設(shè)計17文件.17頁面URL 定義17控件事件17Function18賬戶信息頁18UI 設(shè)計18文件.19頁面URL 定義19控件事件19Function19券信息頁21UI 設(shè)計21文件21頁面URL 定義21控件事件21Function21券信息頁22UI 設(shè)計22文件.22頁面URL 定義22控件事件22Function22會員等級概要頁23UI 設(shè)計23文件.23頁面URL 定義23控件事件23Function23下線信息頁24UI 設(shè)計24文件.24頁面URL 定義24控件事件24Funct

3、ion25詳細設(shè)計26數(shù)據(jù)模型26E-R 圖26UML26DTO27MemberDto27Controller29MemberController29Service29IMemberService29Mapper29MemberMapper29附錄30未結(jié)問題30已結(jié)問題30概述術(shù)語表相關(guān)文檔文檔作者說明術(shù)語說明前端詳細設(shè)計全局按鈕UI 設(shè)計文件見會員基本信息頁-文件頁面 URL 定義功能名稱保存會員URL/dsis/mm/member/save參數(shù)json 格式: member, memRelationship, memRelationship ., deleteMemRelationshi

4、p , deleteMemRelationship ., memAttribute, memAttribute ., deleteMemAttribute , deleteMemAttribute ., memSite, memSite ., deleteMemSite , deleteMemSite ., memAccount, memAccount ., deleteMemAccount , deleteMemAccount .,控件事件Function方法名稱validate參數(shù)描述校驗頁面數(shù)據(jù)主要邏輯校驗字段，以下校驗不通過，返回false：會員基本信息字段檢查格式檢查長度檢查其他邏輯

5、對象名稱事件動作描述1、保存按鈕onClickvalidate() save()2、下單onClickvalidateSus() createOrder()驗證激活狀態(tài)為此會員下單3、更改所onClickvalidateSus() changeOwnership ()驗證激活狀態(tài) 為此會員更改所功能名稱更改所URL/dsis/mm/member/changeOwnership參數(shù)memberId ：會員 id功能名稱下單URL/dsis/om/order/createOrder參數(shù)memberId ：會員 id 信息, 信息., 刪除信息, 刪除信息., 券信息, 券信息., 刪除券信息, 刪

6、除券信息., 會員等級概要, 會員等級概要.,會員IDNum9是系統(tǒng)自動生成；格式：會員 ID 前綴+7 位數(shù)（包括結(jié)尾為 4 的數(shù)字）；前綴規(guī)則見市場配置會員10是符合策略，長度范圍 6-10商業(yè)碼15否如果會員類型為公司，則此項必填，否則留空；系統(tǒng)將驗證其唯一性；在，允許輸入 8 個字符；公司名稱否手工錄入；如果會員類型為公司，則此項必填，否則留空；聯(lián)系人信息字段檢查格式檢查長度檢查其他邏輯會員英文姓名String50是至少填入一項會員中文姓名String20出生日期Date是將使用日期選取器；日期格式：YYYY/MM/DD；系統(tǒng)根據(jù)生日自動計算；在，會員小于 20 時會出現(xiàn)提醒信息；所有

7、市場都不允許會員小于18 歲；IDString20是手工錄入不同國家有不同限制；在系統(tǒng)中必須唯一；： 7 個字符： 10 個字符： 12 個字符聯(lián)系號碼Num15是手工錄入國家Selection是快速編碼 mm.member_country家庭住址String是只適用于市場；地址格式參考：市場配址格式；在地址選擇彈窗中錄入；聯(lián)系地址String是地址格式參考：市場配址格式；用戶可選擇是否與家庭住址一致；在地址選擇彈窗中錄入；語言Selection否快速編碼 mm.member_language：英語、簡體中文、繁體中文（）：英語、繁體中文（）：英語；馬來語；簡體中文種族Selection是只適

8、用于 ；快速編碼 mm.member_race；系統(tǒng)將檢查會員的國籍，如果不是 ，將自動默認種族為外國人；此項不展示在 MWS；公民類型Selection是只適用于；快速編碼 mm.member_citizen健保稅外Selection是只適用于；可選項：是/否；GST ID 號碼Num20否手工錄入；只適用于接收Selection是可選項：是/否系統(tǒng)通知接收Selection是可選項：是/否申請Checkbox是只適用于；可多選；可勾選項：證件復印件申請表賬戶復印件協(xié)議相關(guān)人信息：會員字段檢查格式檢查長度檢查其他邏輯加入String20是若加入為公司，則填寫公司Code；若加入為分銷商 AP

9、P，則填寫分銷商 APP；若加入為分銷商Web，則填寫分銷商 Web；加入日期Date是批準日期Date否如果會員狀態(tài)為“激活”，此項必填；日期格式：YYYY/MM/DD人 IDNum9是支持手動輸入和彈窗搜索；手動輸入時系統(tǒng)將自動校驗輸入的會員 ID 是否有效；人英文String50是根據(jù)所選的人 ID 自動帶出人中文String20是根據(jù)所選的人 ID 自動帶出字段檢查格式檢查長度檢查其他邏輯相關(guān)人類型Selection是mm.relationship_type中文String20是至少填入一項英文String50出生日期Num是日期格式：YYYY/MM/DDID 類型Selection是

10、快速編碼 mm.member_idIDString20是手工錄入具體關(guān)系String20是手工錄入會員等級String是從 GDS 中獲取會員當前等級接受獎金Selection是可選項：是/否旅游計劃有效月Date是日期格式：YYYYMM、：默認值是創(chuàng)建月份；：默認值為 200912旅游次數(shù)Num5是系統(tǒng)將自動計算會員參加的事件管理系統(tǒng)下的激勵旅游的次數(shù)旅游點Num是從 GDS 中獲取，獲取的為每個月的旅游點；系統(tǒng)將自動計算并；銷售點Num是由AutoShip 訂單累積的銷售點Exchange BalanceNum是Remaining BalanceNum是賬戶信息信息字段檢查格式檢查長度檢查

11、其他邏輯字段檢查格式檢查長度檢查其他邏輯付款人String30是手工錄入聯(lián)系號碼Num15是手工錄入付款地址String是地址格式參考：市場配址格式；用戶可選擇是否與聯(lián)系住址一致；在地址選擇彈窗中錄入；默認賬單地址Checkbox是只有一個賬單地址可以被選為默認賬單地址序號Num是系統(tǒng)自動生成全選Checkbox否點擊后全選收貨人String30是手工錄入聯(lián)系號碼Num15是手工錄入收貨地址String30是地址格式參考：市場配址格式；用戶可選擇是否與聯(lián)系住址一致；在地址選擇彈窗中錄入；默認收貨地址Checkbox是只有一個收貨地址可以被選為默認賬單地址CodeSelection是快速編碼 m

12、m.member_b賬戶號碼Num30是手工錄入賬戶持有人String30是手工錄入方法名稱createOrder參數(shù)描述下單前提條件調(diào)用validateSus()方法返回true主要邏輯var memberId = 獲取頁面數(shù)據(jù)IF json.memberId = null提示先保存ELSEAjax(/dsis/om/order/create,memberId,function(result) showMsg(result);if(result.sucs)loadDaoRender(resuata)方法名稱validateSus參數(shù)type描述校驗會員狀態(tài)主要邏輯IF 會員狀態(tài) = 已激活r

13、eturn true其他情況返回false方法名稱save參數(shù)描述保存會員前提條件調(diào)用validate方法返回true主要邏輯var json = 獲取頁面數(shù)據(jù) Ajax(/dsis/mm/member/save,json,function(result) showMsg(result);if(result.sucs)loadDaoRender(resuata)號Num9是手工錄入；號將隱藏，只顯示后 4 位有效日期Date15是日期格式為：MM/YY默認卡Checkbox是只有一張可以被選為默認卡狀態(tài)Selection是可選項：關(guān)閉/啟用號Num9是手工錄入；號將隱藏，只顯示后 4 位全部檢

14、驗通過返回true，否則返回false，并提示相關(guān)錯誤信息。會員基本信息頁UI 設(shè)計文件頁面 URL 定義功能名稱會員詳細信息，包括：基本信息聯(lián)系人信息文件名描述/include/head.html公用頭部mm_member.html會員頁面mm_member.js會員JS方法名稱changeOwnership參數(shù)描述發(fā)布會員前提條件調(diào)用validateSus()方法返回true主要邏輯var itemId = 獲取頁面itemId Ajax(/dsis/om/order/create,memberId,function(result) showMsg(result);if(result.su

15、cs)loadDaoRender(resuata)控件事件Function聯(lián)系人信息頁方法名稱init參數(shù)memberId描述初始化頁面數(shù)據(jù)主要邏輯如果 memberId 不為空 Ajax(/dsis/mm/member/get?memberId=memberId, memberId,function(result)loadDaoRender (result)否則loadDaoRender(初始值)其中初始值為:字段默認值所屬市場創(chuàng)建此會員資料的 DSIS 用戶的所屬市場所屬公司創(chuàng)建此會員資料的 DSIS 用戶的所屬公司會員類型個人會員角色分銷商會員狀態(tài)新對象名稱事件動作描述會員主頁面onlo

16、adinit()初始化頁面相關(guān)人信息會員信息 會員賬戶信息券信息會員等級 下線信息URL/dsis/mm/member/get參數(shù)memberIdUI 設(shè)計地址選擇彈窗：文件見會員基本信息頁-文件頁面 URL 定義控件事件功能名稱地點組件頁面URL/dsis/spm/location/pick參數(shù)Function相關(guān)人信息頁UI 設(shè)計文件見會員基本信息頁-文件頁面 URL 定義無。方法名稱uploadImage參數(shù)描述彈出窗口選擇文件主要邏輯公共地點組件，詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc對象名稱事件動作描述聯(lián)系人地址onClickpickLocation()詳見v2.0_DS

17、IS_公共組件_技術(shù)設(shè)計.doc家庭地址onClickpickLocation()詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc家庭地址onClickcopyHomeLocation()家庭地址至聯(lián)系地址上傳onClickuploadImage()上傳會員頭像控件事件Function方法名稱deleteRelationship參數(shù)描述刪除相關(guān)人主要邏輯var relationshi= 獲取行relationshi IF relationshi= null刪除相關(guān)人行ELSE IF confirm(確認刪除)將relationshi加入member的deleteRelationshi數(shù)組中方

18、法名稱addRelationship參數(shù)描述添加相關(guān)人主要邏輯相關(guān)人行新增一行對象名稱事件動作描述添加相關(guān)人onClickaddRelationship()刪除相關(guān)人onClickdeleteRelationship()會員頁UI 設(shè)計會員選擇彈窗：文件見會員基本信息頁-文件頁面 URL 定義控件事件功能名稱會員選擇頁面（詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc）URL/dsis/mm/membick參數(shù)Function賬戶信息頁UI 設(shè)計地址選擇彈窗：方法名稱pickMember參數(shù)描述詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc主要邏輯對象名稱事件動作描述人 IDonCli

19、ckpickMember()文件見會員基本信息頁-文件頁面 URL 定義控件事件Function方法名稱addSite參數(shù)描述添加地點對象名稱事件動作描述添加地點信息onClickaddSite()刪除地點信息onClickdeleteSite()地址onClickpickLocation()詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc添加 卡信息onClickaddCard()刪除 卡信息onClickdeleteCard()功能名稱會員選擇頁面（詳見v2.0_DSIS_公共組件_技術(shù)設(shè)計.doc）URL/dsis/spm/location/pick參數(shù)方法名稱deleteSite參數(shù)

20、描述刪除地點主要邏輯var cardId = 獲取行cardId IF cardId = null刪除行ELSE IF confirm(確認刪除)將cardId加入member的deleteCardId數(shù)組中方法名稱addCard參數(shù)描述添加主要邏輯信息行新增一行方法名稱deleteSite參數(shù)描述刪除地點主要邏輯var siteId = 獲取行siteId IF siteId = null刪除地點行ELSE IF confirm(確認刪除)將siteId加入member的deleteSiteId數(shù)組中主要邏輯地點信息行新增一行券信息頁UI 設(shè)計券信息從券系統(tǒng)取值保存到數(shù)據(jù)庫，此 UI 頁面只

21、顯示注釋：券信息。文件見會員基本信息頁-文件頁面 URL 定義無。控件事件無。Function無。會員等級概要頁UI 設(shè)計注釋：會員等級概要從 GDS 系統(tǒng)取值保存到數(shù)據(jù)庫，此 UI 頁面只顯示會員等級。文件見會員基本信息頁-文件頁面 URL 定義無?？丶录﨔unction無。對象名稱事件動作描述查詢onClickqueryR()功能名稱會員等級概要查詢URL/dsis/mm/r/query參數(shù)monthFrom：起始月份 monthTo：終止月份下線信息頁UI 設(shè)計注釋：會員等級概要從 GDS 系統(tǒng)取值保存到數(shù)據(jù)庫，此 UI 頁面只顯示下線數(shù)和等級信息。文件見會員基本信息頁-文件頁面 UR

22、L 定義無?？丶录ο竺Q事件動作描述查詢onClickqueryR()下線會員onClickinitDowmMember()點擊下線樹中的會員，初始化下線會員信息在下線信息頁功能名稱下線會員等級概要查詢URL/dsis/mm/r/query參數(shù)monthFrom：起始月份 monthTo：終止月份Function方法名稱initDowmMember參數(shù)描述初始化下線會員信息主要邏輯獲取dowmMember信息，初始化至頁面dowmMember = member.dowmLinedowmMemberId loadDaoRender (dowmMember)詳細設(shè)計數(shù)據(jù)模型E-R 圖UMLDT

23、OMemberDto描述使用哪些 DTO，以及與數(shù)據(jù)庫表的DTOcom.lkkhpg.dsis.admm.MemberDto字段類型數(shù)據(jù)庫描述memberIdegermm_member.member_id表 ID，主鍵，供其他表做外鍵memberTypeStringmm_member.member_type會員類型marketIdegermm_member.market_id市場 IDcompanyIdegany_id公司 IDmemberRoleStringmm_member.member_role會員角色susStringmm_member.sus會員狀態(tài)remarksStringmm_m

24、ember.remarks備注brNumberStringmm_member.br_number商業(yè)碼englishNameStringmm_member.english_name會員英文chiNameStringmm_member.chi_name會員中文genderStringmm_member.genderdobDatemm_member.dob出生日期idTypeStringmm_member.id_typeID 類型idStringmm_member.idIDphoneNumberStringmm_membhone_number聯(lián)絡(luò)號碼othhoneNumbe rStringmm_m

25、ember.other_phone_number其他聯(lián)絡(luò)號碼Stringmm_member.郵箱nationalityStringmm_member.nationality國籍countryStringmm_member.country國家homeLocationIdegermm_member.home_location_id家庭住址contactLocationIdegermm_member.contact_location_id聯(lián)系地址languageStringmm_member.language語言ratringmm_member.race種族educationStringmm_mem

26、cation學歷citizenTypeStringmm_member.citizen_type公民類型nhiTaxExcludedStringmm_member.nhi_tax_excluded健保稅外gstIdNumberStringmm_member.gst_id_numberGST ID 號碼adOptInStringmm_member.ad_opt_in接收sysMsgInStringmm_member.sys_msg_in系統(tǒng)通知接收signatureStrigmm_member.signature簽名joSiteStringmm_member.jo_site加入joD

27、ateDatemm_member.jo_date加入日期approvalDateDatemm_member.approval_date批準日期sponsorIdegermm_member.sponsor_id人 IDobjectVerNum beregermm_member.object_ver_numb er行版本號，用來處理鎖requestIdegermm_member.request_id對 Record 最后一次操作的系統(tǒng)請求 idprogramIdegermm_membrogram_id對 Record 最后一次操作的系統(tǒng)程序 idcreationDateDatemm_member.

28、creation_date表 ID，主鍵，供其他表做外鍵ControllerMemberController類名：com.lkkhpg.dsis.admm.controller.MemberControllermethodQueryMembermapurl/dsis/mm/member/query參數(shù)Member member返回值List詳細邏輯調(diào)用 iMemberServielectMembers(member)并返回結(jié)果methodgetMembermapurl/dsis/mm/member/get參數(shù)eger memberId返回值MemberDto詳細邏輯調(diào)用 iMemberServ

29、ice.getMemberByKey(memberId)并返回結(jié)果createdByegermm_member.created_by會員類型lastUpdatedByegermm_member.last_updated_by市場 IDlastUpdateDateDatemm_member.last_update_date公司 IDlastUpdaoginegermm_member.last_update_loginattributeCategoryStringmm_member.attribute_category系統(tǒng)標準字段attribute1attribut e15Stringmm_mem

30、ber.attribute1attribute15系統(tǒng)標準字段relationshipsList-相關(guān)人信息sitesList-地址信息accountsList-賬戶信息cardsList-信息rList-會員等級概要dowmLineList下線信息ServiceIMemberService服務(wù)接口：com.lkkhpg.dsis.admm.service.IMemberServicemethodSave參數(shù)Request request,methodselectMembers參數(shù)Request request, Member member返回值List實現(xiàn)邏輯調(diào)用 memberMapper.selectMembers(member)并返回結(jié)果methodselectMemberByKey參數(shù)Request request, eger memberId返回值com.lkkhpg.dsis.admm.dto.MemberDto實現(xiàn)邏輯調(diào)用 memberMapper.selectByPrimaryKey(memberId)調(diào)用 memRelationshipMapper. selectMemRelationships(memberId)調(diào)用 memRelationshipMapper