无限极项目共享10客户化开发posv2d

1、LKKHPGv2.0 项目技术详细设计文档D-PM-007商品包管理商品包详情页文档作者:创建日期:更新日期:当前版本:2016-01-14V1.0签字:LKKHPG 项目经理HAND 项目经理文档控制更改审阅日期职位签名日期职位日期作者版本更改参考2016-01-141.0目录文档控制2目录3概述5术语表5相关文档5前端详细设计6全局按钮6UI 设计6文件6页面URL 定义6控件事件7Function7商品包基本信息页10UI 设计10文件10页面URL 定义11控件事件11Function11商品包分配商品页12商品包参数页12UI 设计12文件13页面URL 定义13控件事件13Func

2、tion13商品库存组织分配13UI 设计13文件.13页面URL 定义13控件事件13Function14商品库存组织参数设置页14UI 设计14文件15页面URL 定义15控件事件15Function15详细设计17数据模型17E-R 图17UML19DTO19InvCategoryDto19InvItemCategoryDto20InvItemDto20InvItemanizationDto22InvItemPropertyDto22InvItemAttrDto23InvItemAvaliabilityDto24Controller25InvItemController25Service

3、26IInvItemService26Mapper28InvItemMapper28InvItemCategoryMapper28InvItemanizationMapper29InvItemPropertyMapper29InvItemAttrMapper30InvItemAvaliabilityMapper30附录31未结问题31已结问题31概述术语表相关文档文档作者说明术语说明前端详细设计全局按钮UI 设计文件见商品包基本信息页-文件页面 URL 定义功能名称保存商品包URL/dsis/pm/item/save参数json 格式: 商品包基本信息, 参数信息,参数信息.,商品行,商品行.

4、, 库存组织分配信息,库存参数信息库存参数信息.删除库存参数删除库存参数.库存组织分配信息,库存属性信息库存属性信息.删除库存参数删除库存参数.,控件事件Function方法名称validate参数描述校验页面数据主要逻辑校验字段，以下校验不通过，返回false：商品包基本信息字段检查格式检查长度检查其他逻辑商品包 IDString15是商品包 CodeString15是商品包名称String20是对象名称事件动作描述1、保存按钮onClickvalidate() save()2、商品发布onClickvalidateSus(1) publish()1 表示验证可发布状态3、商品撤销发布onC

5、lickvalidateSus(0) unPublish()0 表示验证可撤销发布状态功能名称撤销发布商品包URL/dsis/pm/item/unPublish参数itemId :商品包 id功能名称发布商品包URL/dsis/pm/item/publish参数itemId :商品包 id删除商品行.,删除库存组织分配.商品包类别是商品包描述String50条码String30入会套装是计算库存是库存计算方式String30商品包可用性是可兑换性是计量是最小订购数量Number5是有效日期（从）Date有效日期（至）Date有效日期至需大于等于有效日期从商品包参数校验商品行：验证商品行总数 0

6、商品价格属性字段检查格式检查长度检查其他逻辑零售价格Double是分销商价格Double是字段检查格式检查长度检查其他逻辑商品 Code是商品名称是商品数量Number2是数量是字段检查格式检查长度检查其他逻辑商品包简介是规格参数是是使用说明是注意事项是保存方式是方法名称publish参数描述发布商品包前提条件调用validateSus(1)方法返回true主要逻辑var itemId = 获取页面数据IF json.itemId = null提示先保存ELSEAjax(/dsis/pm/item/publish,itemId,function(result) showMsg(result);

7、if(result.sucs)方法名称validateSus参数type描述校验商品包状态主要逻辑IF type = 1 AND 商品包发布状态 != 已发布return trueIF type = 0 AND 商品包状态 =已发布 return true其他情况返回false方法名称save参数描述保存商品包前提条件调用validate方法返回true主要逻辑var json = 获取页面数据 Ajax(/dsis/pm/item/save,json,function(result) showMsg(result);if(result.sucs)loadDaoRender(resuata)员

8、工价格Double是兑换积分Number否PVNumber是日期范围Date否计算库存Selection否库存计算方式String30否最小订购数量Num5否全部检验通过返回true，否则返回false，并提示相关错误信息。商品包基本信息页UI 设计文件文件名描述/include/head.html公用头部pm_inv_item.html商品页面pm_inv_item.js商品JS方法名称unPublish参数描述发布商品包前提条件调用validateSus(0)方法返回true主要逻辑var itemId = 获取页面itemId Ajax(/dsis/pm/item/publish,ite

9、mId,function(result) showMsg(result);if(result.sucs)loadDaoRender(resuata)loadDaoRender(resuata)页面 URL 定义控件事件Function方法名称init参数itemId描述初始化页面数据主要逻辑如果 itemId 不为空 Ajax(/dsis/pm/item/get?itemId=itemId,itemId,function(resul t)loadDaoRender (result)否则loadDaoRender(初始值)其中初始值为:字段默认值发布状态未发布对象名称事件动作描述商品主页面onl

10、oadinit()初始化页面计算库存onChangecountStockChange()添加商品-详见v2.0_DSIS_PM_009_商品包分配商品_技术设计.doc删除分配商品-详见v2.0_DSIS_PM_009_商品包分配商品_技术设计.doc功能名称获取商品详细信息URL/dsis/pm/item/get参数itemId功能名称商品主页面URL/dsis/pm/item/main参数itemId商品包分配商品页详见v2.0_DSIS_PM_009_商品包分配商品_技术设计.doc商品包参数页UI 设计方法名称countStockChange参数描述计算库存字段改变主要逻辑var co

11、untStock= 获取计算库存字段IF countStock = 计算其他商品设置库存计算方式字段为ELSE设置库存计算方式字段为为非入会套装否商品类型商品包计算库存计算此商品商品包可用性全部可用可兑换性否最小订购数量1文件见商品包基本信息页-文件页面 URL 定义无。控件事件无。Function无。商品库存组织分配UI 设计文件见商品包基本信息页-文件页面 URL 定义无。控件事件对象名称事件动作描述添加分配组织onClickaddanization()删除分配组织onClickdeleteanization()设置onClicksetupProperties()Function商品库存组

12、织参数设置页UI 设计方法名称setupProperties参数描述打开属性配置窗口主要逻辑获取当前选择行的属性信息 row var info = pertis;将 info 信息填写在属性配置窗口的 form 中弹出属性配置窗口方法名称deleteanization参数描述删除库存组织主要逻辑var flag = 验证库存组织是否存在参数设置IF flag = true 提示删除分配将一并删除参数设置IF flag = false OR 用户选择 是 var itemId = 获取行item_id如果itemId != null将itemId 加入item的deleteItem

13、Id数组中删除库存组织分配行方法名称addanization参数描述添加库存组织主要逻辑库存组织分配行新增一行文件见商品包基本信息页-文件页面 URL 定义无。控件事件Function方法名称deleteAttr参数方法名称addAttr参数描述添加参数配置行主要逻辑库存组织参数配置行新增一行对象名称事件动作描述添加属性onClickaddAttr()删除属性onClickdeleteAttr()确定按钮onClicksaveAttr()取消按钮onClickcloseAttrWin ()方法名称closeAttrWin参数描述关闭库存参数配置窗口主要逻辑关闭库存参数配置窗口方法名称saveA

14、ttr参数描述保存参数配置行主要逻辑var propertyInfo = 获取配置窗口信息将propertyInfo加入分配库存当前选择行的properties中关闭库存参数配置窗口描述删除参数配置行主要逻辑var propertyId = 获取参数配置行的id如果propertyId!= null将propertyId加入分配库存当前选择行的deleteProperties中删除参数配置行详细设计数据模型E-R 图UMLInvItemCategoryDtoInvItemDtoDTOduct.InvItemDto字段类型数据库描述item

15、Idegerinv_item_b.item_iditemNumberStringinv_item_b.item_numberbarCodeStringinv_item_b.bar_codeitemNameStringinv_item_tl.item_name多语言列descriptionStringinv_item_tl.description多语言列starterAidStringinv_item_b.starter_aidcountStockFlagStringinv_item_b.count_stock_flagDTOcom.lkkhpg.dsis.admin.pm.category.I

16、nvItemCategoryDto字段类型数据库描述categoryItemIdegerinv_item_category_b.category_ite m_idcategoryIdegerinv_item_category_b.category_iditemIDegerinv_category_tl.item_idobjectVerNu mberegerinv.category_b.object_ver_nu mber系统标准字段requestIdegerinv_category_b.request_id系统标准字段programIdegerinv_category_gram_id

17、系统标准字段creationDateDateinv_category_b.creation_date系统标准字段createdByegerinv_category_b.created_by系统标准字段lastUpdatedByegerinv_category_b.last_updated_by系统标准字段lastUpdateDateDateinv_category_b.last_update_date系统标准字段lastUpdaoginegerinv_category_b.last_update_login系统标准字段attributeCategor yStringinv_category_b

18、.attribute_category系统标准字段attribute1attrib tue15Stringinv_category_b.attribute1attribu te15系统标准字段attribute1attrib tue15Stringinv_category_b.attribute1attribu te15系统标准字段subCategorysList-子类别countItemIdegerinv_item_b.count_item_idredeemFlagStringinv_item_b.redeem_flagtyAlertegerinv_item_b.ty_alertexpiry

19、Alertegerinv_item_b.expiry_alertminOrderQuant ityegerinv_item_b.min_order_tyvalidateFromDateinv_item_b.validate_fromvalidateToDateinv_item_b.validate_toorderFlagStringinv_item_b.order_flaginventoryFlagStringinv_item_b.inventory_flagitemTypeStringinv_item_b.item_typeuomCodeStringinv_item_b.uom_codepu

20、blishSusStringinv_item_b.publish_susobjectVerNu mberegerinv_item_b.object_ver_numb er系统标准字段requestIdegerinv_item_b.request_id系统标准字段programIdegerinv_item_gram_id系统标准字段creationDateDateinv_item_b.creation_date系统标准字段createdByegerinv_item_b.created_by系统标准字段lastUpdatedByegerinv_item_b.last_updated_by

21、系统标准字段lastUpdateDateDateinv_item_b.last_update_date系统标准字段lastUpdaoginegerinv_item_b.last_update_login系统标准字段attributeCategor yStringinv_item_b.attribute_category系统标准字段attribute1attrib tue15Stringinv_item_b.attribute1attribute15系统标准字段anizationsList-分配组织attrsList商品包参数信息avaliabilitysList可用性InvItemanizat

22、ionDtoInvItemPropertyDtoDTOduct. InvItemPropertyDto字段类型数据库描述itemPropertyIdegerinv_item_property.item_property_idanizationIdegerinv_item_property.anization_i dDTOduct. InvItemanizationDto字段类型数据库描述itemIdegerinv_item_aniztion.item_iditemIdegerinv_

23、item_aniztion.item_idanizationIdegerinv_item_aniztion.anizatio n_idanizationCodeStringinv_anization.short_codeobjectVerNu mberegerinv_item_aniztion.object_versi on_number系统标准字段requestIdegerinv_item_aniztion.request_id系统标准字段programIdegerinv_item_gram_id系统标准字段creationDateDateinv_item_anizt

24、ion.creation_da te系统标准字段createdByegerinv_item_aniztion.created_by系统标准字段lastUpdatedByegerinv_item_aniztion.last_update d_by系统标准字段lastUpdateDateDateinv_item_aniztion.last_update_date系统标准字段lastUpdaoginegerinv_item_aniztion.last_update_login系统标准字段attributeCategor yStringinv_item_aniztion.attribute_ca te

25、gory系统标准字段attribute1attrib tue15Stringinv_item_aniztion.attribute1 attribute15系统标准字段propertiesList组织参数categorysList类别InvItemAttrDtoDTOduct.InvItemAttrDto字段类型数据库描述itemAttrIdegerinv_item_attr_b.item_attr_iditemIdegerinv_item_attr_b item_idnameegerinv_item_attr_多语言列co

26、ntentStringinv_item_attr_tl.content多语言列objectVerNu mberegerinv_item_attr_b.object_ver_n umber系统标准字段requestIdegerinv_item_attr_b.request_id系统标准字段programIdegerinv_item_attr_gram_id系统标准字段itemIdegerinv_item_property.item_IdpropertyTypeStringinv_item_perty_typevalueStringinv_item_propert

27、y.valueenabledFlagStringinv_item_property.enabled_flagstartDateDateinv_item_property.start_dateendDateDateinv_item_property.end_dateobjectVerNu mberegerinv_item_property.object_ver_number系统标准字段requestIdegerinv_item_property.request_id系统标准字段programIdegerinv_item_gram_id系统标准字段creationDateD

28、ateinv_item_property.creation_date系统标准字段createdByegerinv_item_property.created_by系统标准字段lastUpdatedByegerinv_item_property.last_updated_ by系统标准字段lastUpdateDateDateinv_item_property.last_update_d ate系统标准字段lastUpdaoginegerinv_item_property.last_update_lo gin系统标准字段attributeCategor yStringinv_item_proper

29、ty.attribute_categ ory系统标准字段attribute1attrib tue15Stringinv_item_property.attribute1attr ibute15系统标准字段InvItemAvaliabilityDtoDTOduct.InvItemAvaliabilityDto字段类型数据库描述avaliabilityIdegerinv_item_avaliability.item_attr_iditemIdegerinv_item_avaliability.item_idfunctionAreaegerin

30、v_item_enabledFlagStringinv_item_avaliability.enabled_fla gstartDateDateinv_item_avaliability.start_dateendDateDateinv_item_avaliability.end_dateobjectVerNu mberegerinv_item_avaliability.object_versi on_number系统标准字段requestIdegerinv_item_avaliability.request_id系统标准字段programIdegerinv_

31、item_gram_id系统标准字段creationDateDateinv_item_avaliability.creation_dat e系统标准字段createdByegerinv_item_avaliability.created_by系统标准字段lastUpdatedByegerinv_item_avaliability.last_update d_by系统标准字段lastUpdateDateDateinv_item_avaliability.last_update_date系统标准字段lastUpdaoginegerinv_item_avaliabil

32、ity.last_update_login系统标准字段attributeCategorStringinv_item_avaliability.attribute_ca系统标准字段creationDateDateinv_item_attr_b.creation_date系统标准字段createdByegerinv_item_attr_b.created_by系统标准字段lastUpdatedByegerinv_item_attr_b.last_updated_by系统标准字段lastUpdateDateDateinv_item_attr_b.last_update_date系统标准字段lastU

33、pdaoginegerinv_item_attr_b.last_update_logi n系统标准字段attributeCategor yStringinv_item_attr_b.attribute_categor y系统标准字段attribute1attrib tue15Stringinv_item_attr_b.attribute1attribu te15系统标准字段ControllerInvItemController类名：duct.controller.InvItemControllermethodunPublishmethod

34、publishmapurl/dsis/pm/item/publish参数eger itemId返回值ResponseData详细逻辑调用 invItemService.publish(itemId)捕获 BaseException，返回 ResponseData(false)否则 返回结果 ResponseData(invItemService.getItemByKey(itemId)methodsavemapurl/dsis/pm/item/save参数duct.InvItemDto返回值ResponseData详细逻辑调用 valid

35、ator.validate(InvItemDto)验证如果验证出错，返回 ResponseData(false)，并设置错误信息调用 invItemServiave(InvItemDto)捕获 BaseException，返回 ResponseData(false) ，并设置错误信息否则 返回结果 ResponseData(InvItemDto)methodgetItemmapurl/dsis/pm/item/get参数eger itemId返回值duct.InvItemDto详细逻辑调用 invItemService.getItemBy

36、Key(itemId)并返回结果ytegoryattribute1attrib tue15Stringinv_item_avaliability.attribute1a ttribute15系统标准字段ServiceIInvItemService服务接口：duct.service.IInvItemServicemethodsave参数duct.InvItemDto返回值duct.InvItemDto事务控制Tranional实现

37、逻辑IF InvItemDto.itemId = null InvItemMapper.save (InvItemDto) ELSEInvItemMapper.update (InvItemDto)methodgetItemByKey参数eger itemId返回值duct.InvItemDto实现逻辑调用 InvItemMapper.selectByPrimaryKey(itemId)调用 InvItemCategoryMapper.selectByItemId(itemId)调用 InvItem anizationMapper.sel

38、ectByItemId(itemId)调用 InvItemPropertyMapper.selectByItemId(itemId) FOR InvItemanization LOOPFOR InvItemProperty LOOPIF InvItemProperty.anizationId = InvItemanization.anizationIdInvIperty.add(InvItemProperty)调用 InvItemAttrMapper.selectByItemId(itemId)调用 InvItemAvaliabilityMapper.selec

39、tByItemId(itemId)并返回结果mapurl/dsis/pm/item/unPublish参数eger itemId返回值ResponseData详细逻辑调用 invItemService.unPublish(itemId)捕获 BaseException，返回 ResponseData(false)否则 返回结果 ResponseData(invItemService.getItemByKey(itemId)methodpublish参数eger itemId返回值duct.InvItemDto事务控制TranionalFO

40、R category IN InvItemDto.categorys LOOP IF category.categoryItemId = null InvItemCategoryMapper.save(category) ELSEInvItemCategoryMapper.update(category)FOR anization IN InvItemDto. anizations LOOP IF anization.item Id = nullInvItem anizationMapper.save( anization) FOR property in perti

41、es LOOP InvItemPropertyMapper.save(property)ELSEInvItemanizationMapper.update(anization) FOR property perties LOOPIF pertyId = null InvItemPropertyMapper.save(property) ELSEInvItemPropertyMapper.update(property)FOR attr IN InvItemDto.attrs LOOP IF attr.itemAttrId = null In

42、vItemAttrMapper.save(attr) ELSEInvItemAttrMapper.update(attr)FOR avaliability IN InvItemDto. avaliabilitys LOOP IF avaliability. avaliabilityId= null InvItemAvaliabilityMapper.save(avaliability) ELSEInvItemAvaliabilityMapper.update(avaliability)并返回 invItemService.getItemByKey(InvItemDto.itemId)Mappe

43、rInvItemMapper类名：duct.mapper.InvItemMapperInvItemCategoryMapper类名：duct.mapper.InvItemCategoryMappermethodselectByItemId参数eger itemIdmethodupdate参数duct.InvItemDto返回值eger itemIdmethodsave参数d

44、uct.InvItemDto返回值eger itemIdmethodselectByPrimaryKey参数eger itemId返回值duct.InvItemDtomethodunPublish参数eger itemId返回值duct.InvItemDto事务控制Tranional实现逻辑调用 InvItemService.getItemByKey(itemId)获取 invItemDto 详细信息invItemDto.setPublishSus(UNPUBLISH)调用 InvItemMapper.update(itemId)返回 invItemDto实现逻辑调用 InvItemService.getItemByKey(itemId)获取 invItemDto 详细信息invItemDto.