xx营销价值链系统设计报告.docx

《xx营销价值链系统设计报告.docx》由会员分享，可在线阅读，更多相关《xx营销价值链系统设计报告.docx（117页珍藏版）》请在三一办公上搜索。

1、系统计报告 YY制冷渠道价值链系统系统设计报告华南大区软件开发部文件编号：TD201文件版次：QMS2005文档编号 版本号 分册名称 第1册/共1册总页数正文附录编制审批生效日期XX软件股份有限公司沈阳XX软件股份有限公司修改记录版本号变更控制报告编号更改条款及内容更改人审批人更改日期目 录1.引言51.1.文档编制目的51.2.背景51.3.词汇表51.4.参考资料52.总体结构设计52.1.系统功能架构设计52.1.1.系统总体功能结构图52.1.2.功能模块详细列表52.2.系统程序结构设计62.2.1.文件路径部署设计62.2.2.文件命名规范设计62.2.3.Java类路径62.2

2、.4.类命名规范72.3.程序公用处理设计72.3.1.程序界面风格72.3.2.程序错误统一处理72.3.3.公用程序处理72.3.4.通用按钮处理说明83.基础管理详细设计83.1.首页登录93.2.权限管理103.2.1.用户管理103.2.2.角色管理163.2.3.分片管理193.3.基础数据243.3.1.代码数据维护243.3.2.单据号规则维护273.3.3.产品信息查询293.3.4.行政地区查询323.3.5.组织机构维护333.3.6.业务主体设置363.4.日志管理373.4.1.登录日志查询373.4.2.错误日志查询384.协同渠道详细设计384.1.渠道建设详细设

3、计384.1.1.客户资料维护384.1.2.终端申请404.1.3.终端申请审核444.1.4.终端资料维护474.2.销售任务详细设计504.2.1.销售任务层级设定查询504.2.2.销售期间设定查询514.2.3.年度销售任务设定524.2.4.月度销售任务设定574.3.数据采集详细设计614.3.1.销售人员维护614.3.2.销售产品设置654.3.3.竞品型号维护694.3.4.终端销售数据采集704.3.5.终端竞品数据采集754.3.6.终端销售数据调整794.3.7.经销商销售数据采集824.3.8.经销商库存数据采集875.报表统计详细设计916.接口详细设计916.1

4、.营销系统接口设计916.1.1.基础数据接口916.1.2.业务数据接口917.数据库设计927.1.基本设计开发规范927.1.1.ROW_ID927.1.2.字段Domain定义927.1.3.公用字段说明937.1.4.业务数据处理层次设计947.1.5.大小写规范947.1.6.对象命名规范：947.1.7.参数变量命名规范：977.1.8.程序体布局一般规范987.1.9.异常处理997.2.数据部属设计997.2.1.用户模式说明997.2.2.表空间997.3.数据结构设计997.3.1.数据库表设计997.3.2.数据库视图设计997.4.动态处理设计1007.5.系统JOB

5、设计1017.6.配置数据设计1017.7.数据分片处理1028.问题列表：1021. 引言1.1. 文档编制目的1.2. 背景1.3. 词汇表词汇名称词汇含义备注CMSYY制冷渠道价值链系统1.4. 参考资料参考资料作者时间备注2. 总体结构设计2.1. 系统功能架构设计2.1.1. 系统总体功能结构图2.1.2. 功能模块详细列表子系统名一级模块二级模块模块包路径代码名称代码名称基础管理sm权限管理userMgt用户管理com.neusoft. base.sm.userroleMgt角色管理com.neusoft. base.sm.roledataGroupMgt分片组管理com.neus

6、oft. base.sm.datagroupsm日志管理loginLogMgt登录日志查询errorLogMgt错误日志查询md基础数据orgGroup业务主体设置com.neusoft.base.md.orggrouporg组织机构维护com.neusoft.base.md.orgdistrict行政地区查询com.neusoft.base.md.districtproduct产品信息查询com.neusoft.base.md.productlov代码数据维护com.neusoft.base.md.lovdatabillNoRule单据号规则维护com.neusoft.base.md.bil

7、lnoruleappConfig应用参数设置com.neusoft.base.md.appconfig协同渠道(ch)ch渠道建设customer客户资料维护com.neusoft.cms.ch.customerstoreApply终端建设申请com.neusoft.cms.ch.storeapplystoreAudit终端申请审核com.neusoft.cms.ch.storeauditstore终端资料维护com.neusoft.cms.ch.store销售任务saleGoalRule销售任务层级设定查询salePeriod销售期间设定查询saleGoalYear年度销售任务设定saleG

8、oalMonth月度销售任务设定销售数据采集salePerson销售人员维护saleProd销售产品设置competeProd竞品型号维护storeSale终端销售数据采集storeCompete终端竞品数据采集storeSaleAdjust终端销售数据调整dealerSale经销商销售数据采集渠道库存channelInventory渠道库存查询经销商业务查询orderStatus订单状态信息orderVehicle物流配送信息currentAccount客户往来账信息营销费用ex营销人员pe协同知识km2.2. 系统程序结构设计2.2.1. 文件路径部署设计子系统名一级模块二级模块文件类型文

9、件路径代码名称代码名称基础管理sm权限管理userMgt用户管理JspEAPDomainbasepagessmuserDatawindowEAPDomainWEB-INFconfunieapdatawindowbasesmuserDatasetEAPDomainWEB-INFconfunieapdatasetbasesmuserJavacomneusoftbasesmuserroleMgt角色管理Jsp EAPDomainbasepagessmroleDatawindow EAPDomainWEB-INFconfunieapdatawindowbasesmroleDataset EAPDoma

10、inWEB-INFconfunieapdatasetbasesmroleJava comneusoftbasesmroledataGroupMgt分片组管理Jsp EAPDomainbasepagessmdatagroupDatawindow EAPDomainWEB-INFconfunieapdatawindowbasesm datagroup Dataset EAPDomainWEB-INFconfunieapdatasetbasesm datagroup Java comneusoftbasesmdatagroupsm日志管理loginLogMgt登录日志查询Jsp EAPDomainb

11、asepagessmlogDatawindow EAPDomainWEB-INFconfunieapdatawindowbasesmlogerrorLogMgt错误日志查询Dataset EAPDomainWEB-INFconfunieapdatasetbasesmlogJava comneusoftbasesmdatagroupmd基础数据orgGroup业务主体设置Jsp EAPDomainbasepagesmdorggroupDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemdorggroupDataset EAPDomainWEB-

12、INFconfunieapdatasetbasemdorggroup Java comneusoftbasemdorggroup org组织机构维护Jsp EAPDomainbasepagesmdorgDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemdorgDataset EAPDomainWEB-INFconfunieapdatasetbasemdorgJava comneusoftbasemdorgdistrict行政地区查询Jsp EAPDomainbasepagesmddistrictDatawindow EAPDomainWEB

13、-INFconfunieapdatawindowbasemddistrictDataset EAPDomainWEB-INFconfunieapdatasetbasemddistrict Java comneusoftbasemddistrictproduct产品信息查询Jsp EAPDomainbasepagesmdproductDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemdproductDataset EAPDomainWEB-INFconfunieapdatasetbasemdproductJava comneusoftbase

14、mdproductlov代码数据维护Jsp EAPDomainbasepagesmdlovDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemdlovDataset EAPDomainWEB-INFconfunieapdatasetbasemdlovJava comneusoftbasemdlovbillNoRule单据号规则维护Jsp EAPDomainbasepagesmdbillnoruleDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemd billnoruleDataset EA

15、PDomainWEB-INFconfunieapdatasetbasemd billnoruleJava comneusoftbasemdbillnoruleappConfig应用参数设置Jsp EAPDomainbasepagesmdappconfDatawindow EAPDomainWEB-INFconfunieapdatawindowbasemd appconf Dataset EAPDomainWEB-INFconfunieapdatasetbasemdappconfJava comneusoftbasemdappconf协同渠道(ch)ch渠道建设customer客户资料维护Jsp

16、 EAPDomaincmspageschcustomerDatawindow EAPDomainWEB-INFconfunieapdatawindowcmsch customerDataset EAPDomainWEB-INFconfunieapdatasetcmschcustomerJava comneusoftcmschcustomerstoreApply终端建设申请Jsp EAPDomaincmspageschstoreapplyDatawindow EAPDomainWEB-INFconfunieapdatawindowcmsch storeapplyDataset EAPDomain

17、WEB-INFconfunieapdatasetcmsch storeapplyJava comneusoftcmschstoreapplystoreAudit终端申请审核Jsp EAPDomaincmspageschstoreapplyDatawindow EAPDomainWEB-INFconfunieapdatawindowcmschstoreauditDataset EAPDomainWEB-INFconfunieapdatasetcmsch storeauditJava comneusoftcmschstoreauditstore终端资料维护Jsp EAPDomaincmspages

18、chstoreapplyDatawindow EAPDomainWEB-INFconfunieapdatawindowcmschstoreDataset EAPDomainWEB-INFconfunieapdatasetcmschstoreJava comneusoftcmschstore销售任务saleGoalRule销售任务层级设定查询Jsp EAPDomaincmspageschsalegoalruleDatawindow EAPDomainWEB-INFconfunieapdatawindowcmsch salegoalruleDataset EAPDomainWEB-INFconfu

19、nieapdatasetcmsch salegoalruleJava comneusoftcmschsalegoalrulesalePeriod销售期间设定查询Jsp EAPDomaincmspageschsaleperiodDatawindow EAPDomainWEB-INFconfunieapdatawindowcmsch saleperiodDataset EAPDomainWEB-INFconfunieapdatasetcmschsaleperiod Java comneusoftcmschsaleperiodsaleGoalYear年度销售任务设定Jsp EAPDomaincmsp

20、ageschsalegoalyear Datawindow EAPDomainWEB-INFconfunieapdatawindowcmsch salegoalyear Dataset EAPDomainWEB-INFconfunieapdatasetcmsch salegoalyearJava comneusoftcmschsalegoalyearsaleGoalMonth月度销售任务设定Jsp EAPDomaincmspageschsalegoalyear Datawindow EAPDomainWEB-INFconfunieapdatawindowcmsch salegoalmonthD

21、ataset EAPDomainWEB-INFconfunieapdatasetcmsch salegoalmonthJava comneusoftcmschsalegoalmonth销售数据采集salePerson 销售人员维护Jsp EAPDomaincmspageschsaleperson Datawindow EAPDomainWEB-INFconfunieapdatawindowcmschsalepersonDataset EAPDomainWEB-INFconfunieapdatasetcmschsalepersonJava comneusoftcmschsalepersonsal

22、eProd 销售产品设置Jsp EAPDomaincmspageschsaleprod Datawindow EAPDomainWEB-INFconfunieapdatawindowcmschsaleprodDataset EAPDomainWEB-INFconfunieapdatasetcmschsaleprodJava comneusoftcmschsaleprodcompeteProd 竞品型号维护Jsp EAPDomaincmspageschcompeteprod Datawindow EAPDomainWEB-INFconfunieapdatawindowcmschcompetepr

23、odDataset EAPDomainWEB-INFconfunieapdatasetcmschcompeteprodJava comneusoftcmschcompeteprodstoreSale 终端销售数据采集Jsp EAPDomaincmspageschstoresaleDatawindow EAPDomainWEB-INFconfunieapdatawindowcmschstoresaleDataset EAPDomainWEB-INFconfunieapdatasetcmschstoresaleJava comneusoftcmschstoresalestoreCompete 终端

24、竞品数据采集Jsp EAPDomaincmspageschstorecompeteDatawindow EAPDomainWEB-INFconfunieapdatawindowcmschstorecompeteDataset EAPDomainWEB-INFconfunieapdatasetcmschstorecompeteJava comneusoftcmschstorecompetestoreSaleAdjust 终端销售数据调整Jsp EAPDomaincmspageschstoresaleadjustDatawindow EAPDomainWEB-INFconfunieapdatawi

25、ndowcmschstoresaleadjustDataset EAPDomainWEB-INFconfunieapdatasetcmschstoresaleadjustJava comneusoftcmschstoresaleadjust营销费用ex营销人员pe协同知识km2.2.2. 文件命名规范设计对象命名规则范例备注datawindow业务模块名.xml角色dw：role.xml业务模块名每一个字母小写，如果此模块需要再增加datawinodw，命名rol业务模块名2.xml，业务模块名3.xml如：role2.xml，role3.xmldataset业务模块名.xml角色dw:rol

26、e.xml业务模块名每一个字母小写jspindex.jsp业务模块主页面业务模块名+modify.jsp业务模块增加、修改页面，以modifyFlag进行标识，业务模块名每一个字母小写。根据需要进行扩展2.2.3. Java类路径 基础管理 com.neusoft.base 系统管理 com.neusoft. base.sm基础数据 com.neusoft. base.md价值链系统com.neusoft.cms协同渠道 com.neusoft.cms.ch营销费用 com.neusoft.cms.ex营销人员 com.neusoft.cms.pe协同知识 com.neusoft.cms.km

27、common 通用代码、工具等.action 存放action类型java文件 .vo 存放vo类型java文件 .bo 存放bo类型java文件 .dao 存放dao类型java文件.dsa 存放dsa类型java文件.codelist 存放codelist类型java文件.impl存放实现接口类文件如下图所示：2.2.4. 类命名规范对象命名规则范例DSA业务模块名+DSA.javaRoleDSA.javaRoleGroupDSA.javaVO业务模块名+VO.javaRoleVO.javaRoleGroupVO.javaAction业务模块名+Action.javaRoleAction.

28、javaRoleGroupAction.javaBO业务模块名+BO.javaRoleBO.javaRoleGroupBO.javaDAO业务模块名+DAO.javaRoleDAO.javaRoleGroupDAO.javaCodeList业务模块名+CodeListFilter.javaRoleGroupCodeListFilter.javaimpl业务模块名+Impl.javaPartTreeCallBackImpl.java2.3. 程序公用处理设计2.3.1. 程序界面风格2.3.2. 程序错误统一处理2.3.3. 公用程序处理1：系统时间，所有取默认时间的都取数据库服务器时间，统一的

29、函数定义，PKG_MD_UTIL_BIZ. FUN_GET_SYSDATE；2：主键ROW_ID，统一通过数据库函数（PKG_MD_UTIL_BIZ. FUN_GET_ROW_ID）取，取Sequence；3：自动生成业务单据号统一通过数据库存储过程（PKG_MD_UTIL_BIZ. PRC_GET_BILL_NO）获取；4：除特别说明，所有下拉列表数据统一通过代码表对应的视图（V_LOV_LIST_DATA）获取；5：所有表的增加、修改必须通过平台统一对CREATED_BY, CREATED_DATE, LAST_UPD_BY, LAST_UPD_DATE保留字段进行设置；5：系统Sessi

30、on变量设置(session变量应该可以扩展)：USER_ID USER_CODE USER_NAME ORG_GROUP_ID ORG_GROUP_NAME ORG_NODE_ID ORG_ID ORG_CODE ORG_NAME2.3.4. 通用按钮处理说明1：基础数据启用停用通用处理：按钮名称动作说明备注“启用”按钮如果当前选中的记录的使用状态为N，则设置当前选中的记录的使用状态为Y（启用），如果启用时间为空，则设置启用时间为当前系统时间，并设置停用时间为空。“停用”按钮设置系统角色表当前选中的记录的使用状态为N（停用），并设置停用时间为当前系统时间。2：一般模块首页查询页面界面通用按钮

31、处理说明：按钮名称动作说明备注 “查询”按钮根据输入的条件进行查询，除特别说明，查询条件比较关系使用Like查询记录。“增加”按钮增加一条新记录，并进行相应模块的的编辑界面，显示空记录。“修改”按钮修改选中的一条记录，进入相应模块的编辑界面，显示当前选中的主记录的信息。3：一般模块主编辑界面通用按钮操作处理说明：按钮名称动作说明备注 “保存”按钮保存相应模块主编辑界面对当前数据所作的修改，保存前进行必要的校验，具体的校验要求在各模块中进行详细说明。 “返回”按钮关闭相应模块的主编辑界面，返回该模块的首页主浏览界面。返回前如果用户没有修改数据，则直接返回；返回前如果用户已修改数据，但没有保存，则

32、提示用户“数据已修改，是否保存？”（是、否、取消），选择是，则保存数据并返回，选择否，则不保存数据直接返回；选择取消则不返回。4：提示信息考虑采用配置文件方式？多语言（字段界面，提示信息，考虑实现的可能性）？5：grid显示提供页面按选中列进行排序的功能（框架能否支持？）6：附件管理功能，提供针对附件的管理功能，在首页查询列表页面，增加一个列，如果有附件则显示回形针图片，提供附件的上传、浏览、下载功能。3. 基础管理详细设计3.1. 首页登录3.1.1.1. 模块功能说明登录界面同原系统登录界面，输入用户名和密码验证通过过，如果用户的主体权限只有一个则直接进入主界面，如果超过一个弹出一个主体选

33、择窗口，显示用户所拥有的业务主体，选择主体后进入主界面。3.1.1.2. 界面设计说明登录界面示意图如下：主体选择界面：3.1.1.3. 模块数据对象模块界面数据表表说明分类组织分片业务主体分片登录界面T_SM_USER用户业务主表选择主体界面T_SM_USER_ORG_GROUPT_MD_ORG_GROUP用户业务主体业务主表T_SM_LOGON_LOG登录日志业务主表3.1.1.4. 详细功能说明登录成功后设置系统session变量，并进入系统主页面。并记录登录日志表：T_SM_LOGON_LOG。3.2. 权限管理3.2.1. 用户管理3.2.1.1. 模块功能说明维护系统使用用户及用户

34、所具有的角色权限、所属业务主体、以及对应主体下的角色权限和数据分片权限，管理员在维护用户时，选择业务主体、组织、角色、分片组时必须是在已授权给该管理员的业务主体、组织、角色、分片组范围内进行选择。系统初始化设置一个管理员（用户名为admin,默认密码为admin），该管理员具有所有的业务主体、组织、角色权限以便进行权限的转授。用户维护时必须设置业务主体。3.2.1.2. 界面设计说明本模块包括五个界面：首页用户浏览界面、用户编辑界面、用户角色设定界面、用户组织选择界面、用户分片组选择界面。1、首页用户浏览界面，进入本模块时打开的初始页面，并显示第一页数据。界面如下：2、用户编辑界面，其中已分配

35、角色和已分配分片组为一个tab的两个tabpage：3、用户角色设定界面：4、用户组织选择界面：5、用户分片组选择界面：3.2.1.3. 模块数据对象模块界面数据表表说明分类说明分片处理1、用户浏览界面T_SM_USER系统用户业务主表2、用户编辑界面T_SM_USER系统用户业务主表T_SM_USER_ORG_GROUP用户业务主体权限业务从表T_MD_ORG_NODE组织节点关联辅表T_MD_ORGNIZATION组织单元关联辅表T_MD_ORG_GROUP业务主体关联辅表T_SM_USER_ROLE用户角色权限业务从表T_SM_ROLE系统角色关联辅表T_SM_USER_DATA_GRO

36、UP用户分片组权限业务从表T_MD_DATA_GROUP分片组关联辅表T_MD_ORG_GROUP业务主体关联辅表3、用户角色设定界面T_SM_USER_ROLE用户角色权限主表可选的角色必须是当前登录用户在该主体下所拥有可转授的的角色。4、用户组织选择界面T_MD_ORG_NODE组织节点主表可选的组织必须是当前登录用户在在该主体下用户的可转授的组织的下级组织。5、用户分片组选择界面T_MD_DATA_GROUP分片组主表可选的组织必须是当前登录用户在该主体下用户的可转授的分片组。主要数据项说明：数据项编辑样式表表字段数据规则用户分类下拉列表框T_SM_USER_ORG_GROUPUSER_

37、TYPE取对应LIST_CODE 为 MD_USER_TYPE的下拉列表值V_MD_DATA_GROUP_SOURCENODE_DATA_TYPE分片组类别下列列表框T_SM_USER_DATA_GROUPDATA_GROUP_TYPE是否可操作下列列表框T_SM_USER_ORG_GROUP、T_SM_USER_DATA_GROUP、T_SM_USER_ROLEOPERATE_FLAG取对应LIST_CODE 为 MD_YN_FLAG的下拉列表值是否可转授下列列表框T_SM_USER_ORG_GROUP、T_SM_USER_DATA_GROUP、T_SM_USER_ROLEGRANT_FLA

38、G使用状态下列列表框T_SM_USERACTIVE_FLAG取对应LIST_CODE 为 MD_ACTIVE_FLAG的下拉列表值数据表之间关系图：3.2.1.4. 详细功能说明模块界面功能功能说明备注用户编辑界面 新增处理新增一条空记录时，界面上的“使用状态”默认为Y（即启用），同时字段“启用时间”默认为当前系统时间。验证新增时，输入新的用户编码后，点击验证，如果有相同的用户编码，则提示“该用户编码使用，请重新输入其他用户编码。”并情况输入的用户编码。“保存”对输入的“用户密码”和“验证密码”进行是否相同的判断；对“用户编码”和“用户名称”进行唯一性校验；“用户密码”需要进行加密存储。分配业

39、务主体操作选择“业务主体”后，点击“组织编码”下的弹出按钮，弹出“用户组织选择”对话框界面，同时将当前的“业务主体”数据传递给“用户组织选择”对话框中的查询条件项“业务主体”，作为“用户组织选择”的查询条件；选中一条记录后返回“组织节点ID”、“组织ID”、“组织编码”、“组织名称”到“分配业务主体”列表下对应的字段。 “是否可转授”默认值为N。“删除”：删除一条选中的“已分配业务主体”操作。分配角色操作进行“分配角色”操作前必须保存数据；选中“分配业务主体”列表中的一条记录后，点击“分配角色”，弹出“用户角色设定”对话框界面，同时将选中的“分配业务主体”中的“业务主体”数据传递给“用户角色设定”对话框中的查询条件项“业务主体”作为查询“未授予角色”的查询条件。“用户角色设定”中的操作类似“主体角色分配”的操作，同时“是否可操作”的默认值为Y，“是否可转授“的默认值为N，在“用户角色设定”界面操作点击“确定”后，刷新“已分配角色”列表中的数据。分配分片组操作首先选中“分配业务主体”列表中的一条记录后， 弹出“分片组选择”对话框界面，同时将选中的“分配业务主体”中的“业务主体”数据传递给“分片组选择”对话框中的查询条件项“业务