积分系统-详细设计说明书-v1.1

详细设计说明书文件状态：[]草稿[√]正式发布[]正在修改文件标识：当前版本：作者：完成日期：XX公司2016年1月版本历史版本日期作者/修改人工作内容V1.02016.1.19王勐完成积分系统详细设计初稿。V1.12016.1.20王勐根据内部讨论增加积分规则优先级。

目录1 引言 51.1 标识 51.2 系统概述 51.3 文档概述 51.4 基线 52 引用文件 53 CSCI级设计决策 53.1 需求概述 53.2 系统功能 64 CSCI体系结构设计 64.1 体系结构 64.1.1 程序(模块)划分 74.1.2 程序(模块)层次结构关系 84.2 全局数据结构说明 84.2.1 常量 84.2.2 变量 94.2.3 数据结构 94.3 CSCI部件 144.4 执行概念 144.5 接口设计 154.5.1 接口标识与接口图 154.5.2 获取用户积分信息接口(INT-001) 154.5.3 添加积分记录接口(INT-002) 164.5.4 查询积分记录接口(INT-003) 174.5.5 添加积分规则接口（INT-004） 184.5.6 清理积分接口（INT-005） 185 CSCI详细设计 195.1 积分等级列表（JFXT-MOD-001） 205.2 查询积分等级（JFXT-MOD-002） 205.3 新增积分等级（JFXT-MOD-003） 215.4 修改积分等级（JFXT-MOD-004） 225.5 删除积分等级（JFXT-MOD-005） 235.6 停用积分等级（JFXT-MOD-006） 245.7 启用积分等级（JFXT-MOD-007） 255.8 积分规则列表（JFXT-MOD-008） 275.9 查询积分规则（JFXT-MOD-009） 275.10 新增积分规则（JFXT-MOD-010） 285.11 修改积分规则（JFXT-MOD-011） 295.12 删除积分规则（JFXT-MOD-012） 305.13 停用积分规则（JFXT-MOD-013） 315.14 启用积分规则（JFXT-MOD-014） 335.15 添加积分规则（JFXT-MOD-015） 345.16 获取用户积分信息（JFXT-MOD-016） 355.17 添加积分记录（JFXT-MOD-017） 365.18 查询积分记录（JFXT-MOD-018） 375.19 清理积分（JFXT-MOD-019） 385.20 积分情况列表（JFXT-MOD-020） 405.21 查询积分情况（JFXT-MOD-021） 415.22 导出积分情况（JFXT-MOD-022） 425.23 活动列表（JFXT-MOD-023） 435.24 查询活动（JFXT-MOD-024） 445.25 新增活动（JFXT-MOD-025） 455.26 删除活动（JFXT-MOD-026） 465.27 修改活动（JFXT-MOD-027） 475.28 停用活动（JFXT-MOD-028） 485.29 启用活动（JFXT-MOD-029） 495.30 完成活动（JFXT-MOD-030） 505.31 积分兑换（JFXT-MOD-031） 516 需求的可追踪性 527 注解 52引言标识文档标识号：JFXT-SDD-001软件名称：积分系统版本号：V1.1系统概述分享奖励激励机制在保障密云县教育资源建设应用工作顺利开展，对师生参与资源建设分享、应用评价等活动予以鼓励和促进，从而创设良好的资源共建共享环境，促进教育教学资源建设工作可持续发展。文档概述本条应概述本文档的用途与内容，并描述与其使用有关的保密性或私密性要求。基线密云县教委信息中心教育云服务平台业务系统方案（合）_V1.32。引用文件本深化设计说明书所引用的文件有：1.密云教育资源建设分享奖励激励机制20150330（初稿）CSCI级设计决策需求概述遵循“技术先进开放、系统前后衔接”的原则进行，通过建设积分系统，与基础平台、资源管理系统、网络存储系统、网络社交系统对接，实现保障密云县教育资源建设应用工作顺利开展，对师生参与资源建设分享、应用评价等活动予以鼓励和促进，从而创设良好的资源共建共享环境，促进教育教学资源建设工作可持续发展。系统功能积分系统包括系统管理、积分应用、积分统计、积分活动四个子模块。CSCI体系结构设计体系结构从功能和使用角度本系统划分为系统管理、积分应用、积分统计、积分活动。系统总体框架如下：程序(模块)划分积分系统用于保障密云县教育资源建设应用工作顺利开展，对师生参与资源建设分享、应用评价等活动予以鼓励和促进，从而创设良好的资源共建共享环境，促进教育教学资源建设工作可持续发展。针对不同用户系统为其提供如下功能：系统管理:积分等级维护、积分规则维护；积分应用：数据共享与协同；积分统计：积分获得情况、积分消费情况；积分活动：活动管理；其中积分应用功能无用户操作界面；各系统功能清单如下：序号功能名称功能说明系统管理1积分等级通过此配置实现根据个人积分获得、消费情况，为每人设置“等级称号”，系统中自动显示等级、称号、图标等明显标识。2积分规则通过此配置实现积分的获得、使用、奖励、清除过期积分。积分应用1数据共享与协同通过接口的方式实现与其他系统的对接，提供用户积分信息和积分记录并完成积分的获得和使用。积分统计1积分获得情况根据相应的维度展示积分获得情况。2积分消费情况根据相应的维度展示积分消费情况。积分活动1活动管理展示活动列表，提供对活动的增删改查。程序(模块)层次结构关系全局数据结构说明本章说明本程序系统中使用的全局数据常量、变量和数据结构。常量包括数据文件名称及其所在目录，功能说明，具体常量说明等。变量包括数据文件名称及其所在目录，功能说明，具体变量说明等。数据结构数据库设计：数据库结构图：表清单：名称代码活动JYF_HD活动记录JYF_HDJL用户积分信息JYF_YHJFXX积分等级JYF_JFDJ积分规则JYF_JFGZ积分记录JYF_FZJL活动的列清单：名称代码注释数据类型长度默认值主要的强制活动IDID活动IDCHAR(32)32TRUETRUE规则IDGZID规则IDCHAR(32)32FALSETRUE活动标题HDBT活动标题NVARCHAR2(100)100FALSETRUE活动内容HDNR活动内容CLOBFALSEFALSE活动图片HDTP活动图片NVARCHAR2(200)200FALSEFALSE开始时间KSSJ开始时间DATEFALSEFALSE结束时间JSSJ结束时间DATEFALSEFALSE创建用户IDCJYHID创建用户IDCHAR(32)32FALSETRUE创建时间CJSJ创建时间DATESYSDATEFALSETRUE修改用户IDXGYHID修改用户IDCHAR(32)32FALSEFALSE修改时间XGSJ修改时间DATEFALSEFALSE状态ZT状态0停用1启用NUMBER(1)1FALSETRUE完成状态WCZT完成状态0未完成1已完成NUMBER(1)1FALSETRUE活动记录的列清单：名称代码注释数据类型长度默认值主要的强制活动记录IDID活动记录IDCHAR(32)32TRUETRUE活动IDHDID活动IDCHAR(32)32FALSETRUE用户IDYHID用户IDCHAR(32)32FALSETRUE业务IDYWID业务IDCHAR(32)32FALSEFALSE状态ZT状态0回滚1正常NUMBER(1)1FALSETRUE完成状态WCZT完成状态0未完成1已完成NUMBER(1)1FALSETRUE用户积分信息的列清单：名称代码注释数据类型长度默认值主要的强制用户分值信息IDID用户积分信息IDCHAR(32)32TRUETRUE用户IDYHID用户IDCHAR(32)32FALSETRUE积分等级IDJFDJID积分等级IDCHAR(32)32FALSETRUE消费等级IDXFDJID消费等级IDCHAR(32)32FALSETRUE总积分ZJF总积分NUMBER(10)100FALSETRUE当前积分DQJF当前积分NUMBER(10)100FALSETRUE总消费ZXF总消费NUMBER(10)100FALSETRUE创建用户IDCJYHID创建用户IDCHAR(32)32FALSETRUE创建时间CJSJ创建时间DATEFALSETRUE修改用户IDXGYHID修改用户IDCHAR(32)32FALSEFALSE修改时间XGSJ修改时间DATEFALSEFALSE积分等级的列清单：名称代码注释数据类型长度默认值主要的强制积分等级IDID积分等级IDCHAR(32)32TRUETRUE积分等级类型JFDJLX积分等级类型1累计获得2消费NUMBER(1)1FALSEFALSE等级DJ等级NUMBER(2)2FALSEFALSE等级称号DJCH等级称号NVARCHAR2(15)15FALSETRUE等级图标DJTP等级图标NVARCHAR2(200)200FALSEFALSE是否默认等级SFMRDJ是否默认等级0否1是NUMBER(1)1FALSETRUE积分要求JFYQ积分要求升级到此等级所需积分NUMBER(8)80FALSETRUE创建用户IDCJYHID创建用户IDCHAR(32)32FALSETRUE创建时间CJSJ创建时间DATEFALSETRUE修改用户IDXGYHID修改用户IDCHAR(32)32FALSEFALSE修改时间XGSJ修改时间DATEFALSEFALSE状态ZT状态0停用1启用NUMBER(1)1FALSETRUE积分规则的列清单：名称代码注释数据类型长度默认值主要的强制规则IDID规则IDCHAR(32)32TRUETRUE模块IDMKID模块ID关联基础表CHAR(32)32FALSETRUE功能IDGNID功能ID关联基础表CHAR(32)32FALSETRUE功能代码GNDM功能代码CHAR(200)200FALSETRUE类型LX类型1发放2消费3发放回滚（暂不使用）4消费回滚（暂不使用）NUMBER(1)1FALSETRUE优先级YXJ优先级从1开NUMBER(2)21FALSETRUE是否全局SFQJ是否全局0个人1全局默认全局NUMBER(1)11FALSETRUE是否活动使用SFHDSY是否活动使用0否1是NUMBER(1)10FALSEFALSE积分JF积分NUMBER(10)100FALSETRUE是否应用公式SFYYGS是否应用公式0否1是NUMBER(1)10FALSETRUE公式GS公式CLOBFALSEFALSE描述MS描述CLOBFALSEFALSE日上限RSX日上限NUMBER(10)100FALSETRUE月上限YSX月上限NUMBER(10)100FALSETRUE总上限ZSX总上限NUMBER(10)100FALSETRUE创建用户IDCJYHID创建用户IDCHAR(32)32FALSETRUE创建时间CJSJ创建时间DATESYSDATEFALSETRUE修改用户IDXGYHID修改用户IDCHAR(32)32FALSEFALSE修改时间XGSJ修改时间DATEFALSEFALSE状态ZT状态0停用1启用NUMBER(1)1FALSETRUE积分记录的列清单：名称代码注释数据类型长度默认值主要的强制分值记录IDID分值记录IDCHAR(32)32TRUETRUE用户IDYHID用户IDCHAR(32)32FALSETRUE规则IDGZID规则IDCHAR(32)32FALSETRUE功能代码GNDM功能代码CHAR(200)200FALSETRUE业务IDYWID业务IDCHAR(32)32FALSEFALSE本次分值BCJF本次分值NUMBER(10)100FALSETRUE创建时间CJSJ创建时间DATESYSDATEFALSETRUECSCI部件积分系统包含如下程序（模块）：序号程序（模块）标识符1系统管理积分等级维护积分等级列表JFXT-MOD-0012查询积分等级JFXT-MOD-0023新增积分等级JFXT-MOD-0034修改积分等级JFXT-MOD-0045删除积分等级JFXT-MOD-0056停用积分等级JFXT-MOD-0067启用积分等级JFXT-MOD-0078积分规则维护积分规则列表JFXT-MOD-0089查询积分规则JFXT-MOD-00910新增积分规则JFXT-MOD-01011修改积分规则JFXT-MOD-01112删除积分规则JFXT-MOD-01213停用积分规则JFXT-MOD-01314启用积分规则JFXT-MOD-01415积分应用数据共享与协同添加积分规则JFXT-MOD-01516获取用户积分信息JFXT-MOD-01617添加积分记录JFXT-MOD-01718查询积分记录JFXT-MOD-01819清理积分JFXT-MOD-01920积分统计积分情况列表JFXT-MOD-02021查询积分情况JFXT-MOD-02122导出积分情况JFXT-MOD-02223积分活动活动列表JFXT-MOD-02324查询活动JFXT-MOD-02425新增活动JFXT-MOD-02526删除活动JFXT-MOD-02627修改活动JFXT-MOD-02728停用活动JFXT-MOD-02829启用活动JFXT-MOD-02930完成活动JFXT-MOD-03031积分兑换JFXT-MOD-031执行概念本条应描述软件配置项间的执行概念。为表示软件配置项之间的动态关系，即CSCI运行期间它们如何交互的，本条应包含图示和说明，(若适用)包括执行控制流、数据流、动态控制序列、状态转换图、时序图、配置项之间的优先关系、中断处理、时间/序列关系、异常处理、并发执行、动态分配与去分配、对象/进程/任务的动态创建与删除和其他的动态行为。接口设计接口标识与接口图系统的接口标识如下：序号接口名称接口标识接口类型接口说明1获取用户积分信息接口INT-001WebService通过接口获取用户积分信息，用于基础平台的展示。2添加积分记录接口INT-002WebService相应的功能模块调用此接口完成积分的获得和消费。3查询积分记录接口INT-003WebService通过接口获取积分记录，用于基础平台的展示。4添加积分规则接口INT-004WebService通过接口设置个性化的积分规则。5清理积分接口INT-005WebService通过接口清理不在有效期的积分。获取用户积分信息接口(INT-001)地址http://[ip][port]/resource/integral/getUserIntegral方法名getUserIntegral调用方式post方法说明该接口获取用户积分信息。2、返回数据格式为json。输入参数序号参数名称参数类型最大长度说明1userIdstring32用户Id输出参数序号参数名称参数类型最大长度说明1userIntegralUserIntegral用户积分信息userIntegral的属性清单：属性名称属性类型说明UserIdstring用户IdIntegralGradeint积分等级IntegralTitlestring积分称号IntegralICONstring积分图标ExpenseGradeint消费等级ExpenseTitlestring消费称号ExpenseICONstring消费图标TotalIntegralint总积分（累计积分）currentIntegralint当前积分TotalExpenseint总消费（累计消费）添加积分记录接口(INT-002)地址http://[ip][port]/resource/integral/setIntegraRecord方法名setIntegralRecord调用方式post方法说明该接口完成积分的获得和消费。2、返回数据格式为json。输入参数序号参数名称参数类型最大长度说明1integralRecordsIntegralRecord[]积分记录数据输出参数序号参数名称参数类型最大长度说明1messageobject提示信息integralRecord的属性清单：属性名称属性类型说明UserIdstring用户IdFunctionCodestring功能代码integralTypeint积分规则类型BusinessIdstring业务Id查询积分记录接口(INT-003)地址http://[ip][port]/resource/integral/queryIntegralRecord方法名queryIntegralRecord调用方式post方法说明该接口获取积分记录。2、返回数据格式为json。输入参数序号参数名称参数类型最大长度说明1userIdstring32用户Id输出参数序号参数名称参数类型最大长度说明1integralRecordIntegralRecord[]积分记录数据integralRecord的属性清单：属性名称属性类型说明UserIdstring用户IdRuleTypeint规则类型（1发放2消费3发放回滚4消费回滚）RuleDescstring规则描述Integralint积分CreateDatestring创建时间（精确到时分秒）FunctionCodestring功能代码BusinessIdstring业务Id添加积分规则接口（INT-004）地址http://[ip][port]/resource/integral/setIntegraRule方法名setIntegraRule调用方式post方法说明该接口添加个性化积分规则例如：资源上传设置下载积分。2、返回数据格式为json。输入参数序号参数名称参数类型最大长度说明1integralRuleIntegralRule[]积分规则数据输出参数序号参数名称参数类型最大长度说明1messageobject提示信息integralRule的属性清单：属性名称属性类型说明ModuleIdstring用户IdFunctionIdstring功能IdFunctionCodestring功能代码格式功能代码+业务IDIntegralTypeint积分规则类型当上传资源是需添加两条积分规则一天消费规则一条发放规则Integralint积分IsGlobalint是否全局默认个人（0）IsEnabledint是否启用默认启用(1)Descstring描述CreateNamestring创建用户CreateTimestring创建时间（精确到时分秒）清理积分接口（INT-005）地址http://[ip][port]/resource/integral/clearIntegra方法名clearIntegra调用方式post方法说明该接口清理不在有效期内的积分。例如一个学年过去后清理未使用积分的2/3.2、返回数据格式为json。输入参数序号参数名称参数类型最大长度说明1integralRecordIntegralRecord[]积分规则数据输出参数序号参数名称参数类型最大长度说明1messageobject提示信息integralRecord的属性清单：属性名称属性类型说明FunctionCodestring功能代码integralTypeint积分规则类型默认消费（2）BusinessIdstring业务IdEndDatestring结束时间CSCI详细设计本章应分条描述CSCI的每个软件配置项。如果设计的部分或全部依赖于系统状态或方式，则应指出这种依赖性。如果该设计信息在多条中出现，则可只描述一次，而在其他条引用。应给出或引用为理解这些设计所需的设计约定。软件配置项的接口特性可在此处描述，也可在第4章或接口设计说明(IDD)中描述。数据库软件配置项，或用于操作/访问数据库的软件配置项，可在此处描述，也可在数据库(顶层)设计说明(DBDD)中描述。积分等级列表（JFXT-MOD-001）功能描述提供对积分等级的管理，点击积分等级管理显示积分等级列表。时序图输入输出操作输入处理输出运行应用无积分等级列表分页、排序1.根据分页、排序查询积分等级。积分等级列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计查询积分等级（JFXT-MOD-002）功能描述根据积分等级类型（累计积分、累计消费）、积分等级查询积分等级返回积分等级列表。时序图输入输出操作输入处理输出运行应用无查询积分等级分页、排序和积分等级类型、积分等级1.根据分页、排序、查询条件查询积分等级。积分等级列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计新增积分等级（JFXT-MOD-003）功能描述点击新增按钮弹出新增页面，输入积分等级信息保存至数据库。默认添加的积分等级是停用状态，需手动启动。时序图输入输出操作输入处理输出运行应用无点击新增输入积分等级信息监听事件按钮。保存积分等级。添加积分等级是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计修改积分等级（JFXT-MOD-004）功能描述选中积分等级点击修改按钮。修改选中的积分等级首先会判断积分等级是否停用，如果启用则提示用户不能修改，停用则弹出修改页面输入积分等级信息保存至数据库。时序图输入输出操作输入处理输出运行应用无点击修改输入积分等级信息监听事件按钮。判断积分等级是否停用。验证通过保存积分等级。修改积分等级是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计删除积分等级（JFXT-MOD-005）功能描述选中积分等级点击删除按钮。删除选中的积分等级首先会判断积分等级是否停用,如果启用则提示用户不能删除，停用则需要判断在用户积分信息中（JYF_YHJFXX.JFDJID、JYF_YHJFXX.JFDJID.XFDJID）是否存在，如果存在则不能删除，不存在在数据库中删除时序图输入输出操作输入处理输出运行应用无点击删除选择积分等级监听事件按钮。判断积分等级是否停用。判断在用户积分信息是否存在。验证通过后删除积分等级。删除积分等级是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计停用积分等级（JFXT-MOD-006）功能描述选中积分等级点击停用按钮，修改积分等级状态为停用后保存至数据库。时序图输入输出操作输入处理输出运行应用无点击停用选中积分等级监听事件按钮。保存积分等级状态停用积分等级是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计启用积分等级（JFXT-MOD-007）功能描述选中积分等级点击启用按钮。首先根据积分等级类型（累计积分、累计消费）、积分等级判断数据库中是否存在已启用的积分等级，如果存在则提示不能启用相同的积分等级，不存在则保存至数据库。同时在用户积分信息表中的查找满足此积分等级的用户并修改详情的积分等级ID或消费等级ID。备注：积分等级的积分等级类型为累计积分时对应的是积分等级ID； 积分等级的积分等级类型为累计消费时对应的是消费等级ID；时序图输入输出操作输入处理输出运行应用无点击启用选中积分等级监听事件按钮。根据积分等级类型（累计积分、累计消费）、积分等级判断数据库中是否存在已启用的积分等级。验证通过后保存积分等级状态。修改满足此积分等级用户的积分等级ID或消费等级ID。启用积分等级是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计积分规则列表（JFXT-MOD-008）功能描述提供对积分规则的管理，点击积分规则管理显示积分规则列表。时序图输入输出操作输入处理输出运行应用无积分规则列表分页、排序1.根据分页、排序查询积分规则。积分规则列表异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计查询积分规则（JFXT-MOD-009）功能描述根据功能名、模块名查询积分规则返回积分规则列表。时序图输入输出操作输入处理输出运行应用无查询积分规则分页、排序和功能名、模块名1.根据分页信息、排序、查询条件查询积分规则。积分规则列表异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计新增积分规则（JFXT-MOD-010）功能描述点击新增按钮弹出新增页面，输入积分规则信息保存至数据库。默认添加的积分规则是停用状态，需手动启动。备注：通过系统设置的系统规则只能为全局积分规则。时序图输入输出操作输入处理输出运行应用无点击新增输入积分规则信息监听事件按钮。保存积分规则。添加积分规则是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计修改积分规则（JFXT-MOD-011）功能描述选中积分规则点击修改按钮。修改选中的积分规则首先会判断积分规则是否停用，如果启用则提示用户不能修改，停用则弹出修改页面输入积分规则信息保存至数据库。备注：是否全局为个人的不能修改。时序图输入输出操作输入处理输出运行应用无点击修改输入积分规则信息监听事件按钮。判断积分规则是否停用。验证通过保存积分规则。修改积分规则是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计删除积分规则（JFXT-MOD-012）功能描述选中积分规则点击删除按钮。删除选中的积分规则首先会判断积分规则是否停用,如果启用则提示用户不能删除，停用则需要判断在积分记录中中（JYF_FZJL.GZID）是否存在，如果存在则不能删除，不存在在数据库中删除。备注：是否全局为个人的不能删除。时序图输入输出操作输入处理输出运行应用无点击删除选择积分规则监听事件按钮。判断积分规则是否停用。判断在积分记录中是否存在。验证通过后删除积分规则。删除积分规则是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计停用积分规则（JFXT-MOD-013）功能描述选中积分规则点击停用按钮，修改积分规则状态为停用后保存至数据库。备注：通过是否活动使用判断当前规则是否正在被未过期、已启用、未完成的活动使用。如果使用则不能停用。是否全局为个人的不能停用。时序图输入输出操作输入处理输出运行应用无点击停用选中积分规则监听事件按钮。保存积分规则状态停用积分规则是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计启用积分规则（JFXT-MOD-014）功能描述选中积分规则点击启用按钮。首先根据模块ID、功能ID、功能代码、规则类型和优先级判断数据库中是否存在已启用的积分规则，如果存在则提示不能启用相同的积分规则，不存在则保存至数据库。时序图输入输出操作输入处理输出运行应用无点击启用选中积分规则监听事件按钮。首先根据模块ID、功能ID、规则类型和优先级判断数据库中是否存在已启用的积分规则。验证通过后保存积分规则状态。启用积分规则是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计添加积分规则（JFXT-MOD-015）功能描述对应接口INT-004，调用接口添加个性化积分规则。时序图输入输出操作输入处理输出运行应用无其他系统调用积分规则信息1.保存积分规则。积分规则是否添加成功异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计无用户操作界面。获取用户积分信息（JFXT-MOD-016）功能描述对应接口INT-001，调用接口查询用户积分信息做相应的展示。时序图输入输出操作输入处理输出运行应用无其他系统调用用户ID1.根据用户ID获取用户积分信息。用户积分信息异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计无用户操作界面。添加积分记录（JFXT-MOD-017）功能描述对应接口INT-002。1.根据具体功能通过接口传递过来的功能代码、积分规则类型和规则状态（默认启用）在积分规则（JYF_JFGZ）中查询对应一条或多条积分规则。如果没有查到相应的积分规则直接返回消息。2.按照积分规则中的优先级排序，循环查找积分规则中日上限（JYF_JFGZ.RSX）、月上限（JYF_JFGZ.YSX）、总上限（JYF_JFGZ.ZSX）的数值和积分记录（JYF_FZJL）中的数据比对是否可以获得或消费积分，如果满足条件返回积分规则跳出循环。如果没有找到满足条件的积分规则直接返回消息。备注：数值为0则跳过验证。3.通过查找到的积分规则中的规则类型（(JYF_JFGZ.LX)）判断，如果为消费（2）则在积分记录（JYF_FZJL）中通过积分规则ID、业务ID、用户ID查找是否存在相应的消费，如果存在则直接返回消息。4.如果积分规则的‘是否活动使用’为是，查找相应积分规则对应的未过期、已启用、未完成的奖励活动（JYF_HD），假如没有找到相应的活动数据直接返回消息，否则根据参数、查找到的活动组织活动记录保存至数据库（JYF_HDJL）返回活动记录ID替换参数的业务ID。备注：主要完成积分活动奖励业务；活动记录中的业务ID为参数的业务ID；5.查询用户积分信息(JYF_YHJFXX)。6.根据参数、用户积分信息和积分规则组织积分记录保存至数据库(JYF_FZJL)。7.修改用户积分信息保存至数据库A.总积分、当前积分、消费积分修改规则： a.当规则类型（JYF_JFGZ.LX）为发放（1）时：总积分+规则积分，当前积分+规则积分，消费积分不变； b.当规则类型(JYF_JFGZ.LX)为消费（2）时：总积分不变，当前积分-规则积分，消费积分+规则积分；c.当规则类型(JYF_JFGZ.LX)为发放回滚（3）时：总积分-规则积分，当前积分-规则积分，消费积分不变；【暂不使用】d.当规则类型(JYF_JFGZ.LX)为消费回滚（4）时：总积分不变，当前积分+规则积分，消费积分-规则积分；【暂不使用】 B.积分等级ID和消费等级ID修改规则： a.总积分不变跳过。根据积分等级类型（累计获得）、总积分和积分等级状态（默认启用）在积分等级中查询相应的积分等级记录并修改积分等级ID。 b.消费积分不变跳过。根据积分等级类型（累计消费）、消费积分和积分等级状态（默认启用）在积分等级中查询相应的积分等级记录并修改消费等级ID。 C.修改修改用户ID和修改时间；8.返回消息时序图输入输出操作输入处理输出运行应用无其他系统调用功能代码、用户ID、积分规则类型、业务ID插入积分记录。修改用户积分信息是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计无用户操作界面。查询积分记录（JFXT-MOD-018）功能描述对应接口INT-003，调用接口查询用户的积分记录做相应的展示。时序图输入输出操作输入处理输出运行应用无基础平台调用用户ID1.根据用户ID获取用户的积分记录。用户积分记录异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计无用户操作界面。清理积分（JFXT-MOD-019）功能描述对应接口INT-005，调用接口清理积分。添加相应的积分规则,其中设置是否应用公式为是（1）公式设置为@YI*(2/3)，@YI是全局参数通过接口传进来的结束时间查询的未使用积分。调用添加积分记录的部分功能。添加积分记录部分功能：1.根据具体功能通过接口传递过来的功能代码、积分规则类型和规则状态（默认启用）在积分规则（JYF_JFGZ）中查询对应的规则。如果没有查到相应的积分规则直接返回消息。2.在积分记录（JYF_FZJL）中通过积分规则ID、业务ID、用户ID查找是否存在相应的消费，如果存在则直接返回消息。3.查询用户积分信息表中当前积分大于0的记录(JYF_YHJFXX)。4.循环记录根据用户ID查找结束时间前未使用积分替换@YI计算出消费积分。5.在循环内根据接口参数、用户积分信息、计算出的消费积分和积分规则组织积分记录保存至数据库(JYF_FZJL)。6.在循环内修改用户积分信息保存至数据库A.消费积分修改规则： a.消费积分+规则积分； B.消费等级ID修改规则： b.根据积分等级类型（累计消费）、消费积分和积分等级状态（默认启用）在积分等级中查询相应的积分等级记录并修改消费等级ID。 C.修改用户ID和修改时间；7.返回消息备注：积分规则表中的公式和是否应用公式只在清理积分中用到。 时序图输入输出操作输入处理输出运行应用无点击停用学年功能代码、积分规则、业务ID、结束时间监听事件按钮。插入积分记录。修改积分基本信息。清理积分是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计无用户操作界面。积分情况列表（JFXT-MOD-020）功能描述提供对积分统计的管理，点击积分统计管理显示积分情况列表。时序图输入输出操作输入处理输出运行应用无积分情况列表分页、排序1.根据分页、排序查询积分情况。积分情况列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计查询积分情况（JFXT-MOD-021）功能描述根据积分规则类型、用户范围查询积分情况返回积分情况列表。时序图输入输出操作输入处理输出运行应用无查询积分情况分页、排序和积分规则类型、用户范围（区县、学校）1.根据分页、排序、查询条件查询积分情况。积分情况列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计导出积分情况（JFXT-MOD-022）功能描述按照查询条件导出积分情况。时序图输入输出操作输入处理输出运行应用无导出积分情况积分规则类型、用户范围（区县、学校）1.根据查询条件查询积分情况并导出Excel。Excel文件异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计活动列表（JFXT-MOD-023）功能描述提供对积分活动的管理，点击积分活动管理显示活动列表。时序图输入输出操作输入处理输出运行应用无积分活动列表分页、排序1.根据分页、排序查询积分情况。积分活动列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计查询活动（JFXT-MOD-024）功能描述根据积分标题、时间范围和状态查询积分活动返回积分活动列表。时序图输入输出操作输入处理输出运行应用无查询积分活动分页、排序和标题、时间范围和状态1.根据分页、排序、查询条件查询积分活动。积分活动列表异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计新增活动（JFXT-MOD-025）功能描述点击新增按钮弹出新增页面，选择启用的适用于活动的积分规则并输入积分活动信息保存至数据库。默认添加的积分活动是停用状态，需手动启动。时序图输入输出操作输入处理输出运行应用无点击新增输入积分活动信息监听事件按钮。保存积分等级。添加积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志。2.弹出“系统错误，请联系管理员”消息窗。界面设计删除活动（JFXT-MOD-026）功能描述选中积分活动点击删除按钮。删除选中的积分活动首先会判断积分活动是否停用,如果启用则提示用户不能删除，停用则在数据库中删除。时序图输入输出操作输入处理输出运行应用无点击删除选择积分活动监听事件按钮。判断积分活动是否停用。验证通过后删除积分活动。删除积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计修改活动（JFXT-MOD-027）功能描述选中积分活动点击修改按钮。修改选中的积分活动，首先会判断积分活动是否停用，如果启用则提示用户不能修改，停用则弹出修改页面输入积分活动信息保存至数据库。时序图输入输出操作输入处理输出运行应用无点击删除选择积分活动监听事件按钮。判断积分活动是否停用。验证通过后修改积分活动。修改积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计停用活动（JFXT-MOD-028）功能描述选中积分活动点击停用按钮停用选中的积分活动首先会判断积分活动是否完成、是否已有活动记录。如果已完成或有活动记录则不能停用。修改积分活动状态为停用后保存至数据库。时序图输入输出操作输入处理输出运行应用无点击停用选中积分活动监听事件按钮。判断活动是否完成和是否存在活动记录保存积分活动状态停用积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计启用活动（JFXT-MOD-029）功能描述选中积分活动点击启用按钮，修改积分活动状态为启用后保存至数据库。备注：需判断选择的积分规则是否启用时序图输入输出操作输入处理输出运行应用无点击启用选中积分活动监听事件按钮。保存积分活动状态启用积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计完成活动（JFXT-MOD-030）功能描述选中积分活动点击完成按钮，修改积分活动完成状态为完成后保存至数据库。时序图输入输出操作输入处理输出运行应用无点击完成选中积分活动监听事件按钮。保存积分活动完成状态完成积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计积分兑换（JFXT-MOD-031）功能描述用户根据未过期、已启用、未完成的活动兑换系统中提供的实物。点击活动进行兑换。首先判断是否已参加了兑换活动，如果已参加则提示已参加此活动，未参加则在活动记录中添加一条记录并调用添加积分记录的部分功能。添加积分记录部分功能：1.根据活动上的积分规则ID找到相应的积分规则。2.查询用户积分信息(JYF_YHJFXX)。3.根据用户积分信息和积分规则组织积分记录保存至数据库(JYF_FZJL)。4.修改用户积分信息保存至数据库。A.当前积分、消费积分修改规则： a.当规则类型(JYF_JFGZ.LX)为消费（2）时：总积分不变，当前积分-规则积分，消费积分+规则积分； B.消费等级ID修改规则： a.根据积分等级类型（累计消费）、消费积分和积分等级状态（默认启用）在积分等级中查询相应的积分等级记录并修改消费等级ID。 C.修改用户ID和修改时间；5.返回消息备注：积分兑换活动用的积分规则设置‘是否活动使用’为是时序图输入输出操作输入处理输出运行应用无点击兑换选中积分活动监听事件按钮。保存积分活动记录。插入积分记录。修改积分基本信息。兑换积分活动是否成功。异常处理异常处理方式系统错误1.系统记录错误日志2.弹出“系统错误，请联系管理员”消息窗界面设计需求的可追踪性本章应包括：a.从本SDD中标识的每个软件配置项到分配给它的CSCI需求的可追踪性(亦可在4.1中提供)；b.从每个CSCI需求