积分系统详细设计说明书.docx
- 文档编号:28360231
- 上传时间:2023-07-10
- 格式:DOCX
- 页数:64
- 大小:572.14KB
积分系统详细设计说明书.docx
《积分系统详细设计说明书.docx》由会员分享,可在线阅读,更多相关《积分系统详细设计说明书.docx(64页珍藏版)》请在冰豆网上搜索。
积分系统详细设计说明书
详细设计说明书
文件状态:
[]草稿
[√]正式发布
[]正在修改
文件标识:
当前版本:
作者:
完成日期:
XX公司
2016年1月
版本历史
版本
日期
作者/修改人
工作内容
王勐
完成积分系统详细设计初稿。
王勐
根据内部讨论增加积分规则优先级。
1引言
1.1标识
文档标识号:
JFXT-SDD-001
软件名称:
积分系统
版本号:
1.2系统概述
分享奖励激励机制在保障密云县教育资源建设应用工作顺利开展,对师生参与资源建设分享、应用评价等活动予以鼓励和促进,从而创设良好的资源共建共享环境,促进教育教学资源建设工作可持续发展。
1.3文档概述
本条应概述本文档的用途与内容,并描述与其使用有关的保密性或私密性要求。
1.4基线
密云县教委信息中心教育云服务平台业务系统方案(合)。
2引用文件
本深化设计说明书所引用的文件有:
1.密云教育资源建设分享奖励激励机制(初稿)
3CSCI级设计决策
3.1需求概述
遵循“技术先进开放、系统前后衔接”的原则进行,通过建设积分系统,与基础平台、资源管理系统、网络存储系统、网络社交系统对接,实现保障密云县教育资源建设应用工作顺利开展,对师生参与资源建设分享、应用评价等活动予以鼓励和促进,从而创设良好的资源共建共享环境,促进教育教学资源建设工作可持续发展。
3.2系统功能
积分系统包括系统管理、积分应用、积分统计、积分活动四个子模块。
4CSCI体系结构设计
4.1体系结构
从功能和使用角度本系统划分为系统管理、积分应用、积分统计、积分活动。
系统总体框架如下:
4.1.1程序(模块)划分
积分系统用于保障密云县教育资源建设应用工作顺利开展,对师生参与资源建设分享、应用评价等活动予以鼓励和促进,从而创设良好的资源共建共享环境,促进教育教学资源建设工作可持续发展。
针对不同用户系统为其提供如下功能:
系统管理:
积分等级维护、积分规则维护;
积分应用:
数据共享与协同;
积分统计:
积分获得情况、积分消费情况;
积分活动:
活动管理;
其中积分应用功能无用户操作界面;
各系统功能清单如下:
序号
功能名称
功能说明
系统管理
1
积分等级
通过此配置实现根据个人积分获得、消费情况,为每人设置“等级称号”,系统中自动显示等级、称号、图标等明显标识。
2
积分规则
通过此配置实现积分的获得、使用、奖励、清除过期积分。
积分应用
1
数据共享与协同
通过接口的方式实现与其他系统的对接,提供用户积分信息和积分记录并完成积分的获得和使用。
积分统计
1
积分获得情况
根据相应的维度展示积分获得情况。
2
积分消费情况
根据相应的维度展示积分消费情况。
积分活动
1
活动管理
展示活动列表,提供对活动的增删改查。
4.1.2程序(模块)层次结构关系
4.2全局数据结构说明
本章说明本程序系统中使用的全局数据常量、变量和数据结构。
4.2.1常量
包括数据文件名称及其所在目录,功能说明,具体常量说明等。
4.2.2变量
包括数据文件名称及其所在目录,功能说明,具体变量说明等。
4.2.3数据结构
数据库设计:
数据库结构图:
表清单:
名称
代码
活动
JYF_HD
活动记录
JYF_HDJL
用户积分信息
JYF_YHJFXX
积分等级
JYF_JFDJ
积分规则
JYF_JFGZ
积分记录
JYF_FZJL
活动的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
活动ID
ID
活动ID
CHAR(32)
32
TRUE
TRUE
规则ID
GZID
规则ID
CHAR(32)
32
FALSE
TRUE
活动标题
HDBT
活动标题
NVARCHAR2(100)
100
FALSE
TRUE
活动内容
HDNR
活动内容
CLOB
FALSE
FALSE
活动图片
HDTP
活动图片
NVARCHAR2(200)
200
FALSE
FALSE
开始时间
KSSJ
开始时间
DATE
FALSE
FALSE
结束时间
JSSJ
结束时间
DATE
FALSE
FALSE
创建用户ID
CJYHID
创建用户ID
CHAR(32)
32
FALSE
TRUE
创建时间
CJSJ
创建时间
DATE
SYSDATE
FALSE
TRUE
修改用户ID
XGYHID
修改用户ID
CHAR(32)
32
FALSE
FALSE
修改时间
XGSJ
修改时间
DATE
FALSE
FALSE
状态
ZT
状态0停用1启用
NUMBER
(1)
1
FALSE
TRUE
完成状态
WCZT
完成状态0未完成1已完成
NUMBER
(1)
1
FALSE
TRUE
活动记录的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
活动记录ID
ID
活动记录ID
CHAR(32)
32
TRUE
TRUE
活动ID
HDID
活动ID
CHAR(32)
32
FALSE
TRUE
用户ID
YHID
用户ID
CHAR(32)
32
FALSE
TRUE
业务ID
YWID
业务ID
CHAR(32)
32
FALSE
FALSE
状态
ZT
状态0回滚1正常
NUMBER
(1)
1
FALSE
TRUE
完成状态
WCZT
完成状态0未完成1已完成
NUMBER
(1)
1
FALSE
TRUE
用户积分信息的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
用户分值信息ID
ID
用户积分信息ID
CHAR(32)
32
TRUE
TRUE
用户ID
YHID
用户ID
CHAR(32)
32
FALSE
TRUE
积分等级ID
JFDJID
积分等级ID
CHAR(32)
32
FALSE
TRUE
消费等级ID
XFDJID
消费等级ID
CHAR(32)
32
FALSE
TRUE
总积分
ZJF
总积分
NUMBER(10)
10
0
FALSE
TRUE
当前积分
DQJF
当前积分
NUMBER(10)
10
0
FALSE
TRUE
总消费
ZXF
总消费
NUMBER(10)
10
0
FALSE
TRUE
创建用户ID
CJYHID
创建用户ID
CHAR(32)
32
FALSE
TRUE
创建时间
CJSJ
创建时间
DATE
FALSE
TRUE
修改用户ID
XGYHID
修改用户ID
CHAR(32)
32
FALSE
FALSE
修改时间
XGSJ
修改时间
DATE
FALSE
FALSE
积分等级的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
积分等级ID
ID
积分等级ID
CHAR(32)
32
TRUE
TRUE
积分等级类型
JFDJLX
积分等级类型1累计获得2消费
NUMBER
(1)
1
FALSE
FALSE
等级
DJ
等级
NUMBER
(2)
2
FALSE
FALSE
等级称号
DJCH
等级称号
NVARCHAR2(15)
15
FALSE
TRUE
等级图标
DJTP
等级图标
NVARCHAR2(200)
200
FALSE
FALSE
是否默认等级
SFMRDJ
是否默认等级0否1是
NUMBER
(1)
1
FALSE
TRUE
积分要求
JFYQ
积分要求升级到此等级所需积分
NUMBER(8)
8
0
FALSE
TRUE
创建用户ID
CJYHID
创建用户ID
CHAR(32)
32
FALSE
TRUE
创建时间
CJSJ
创建时间
DATE
FALSE
TRUE
修改用户ID
XGYHID
修改用户ID
CHAR(32)
32
FALSE
FALSE
修改时间
XGSJ
修改时间
DATE
FALSE
FALSE
状态
ZT
状态0停用1启用
NUMBER
(1)
1
FALSE
TRUE
积分规则的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
规则ID
ID
规则ID
CHAR(32)
32
TRUE
TRUE
模块ID
MKID
模块ID关联基础表
CHAR(32)
32
FALSE
TRUE
功能ID
GNID
功能ID关联基础表
CHAR(32)
32
FALSE
TRUE
功能代码
GNDM
功能代码
CHAR(200)
200
FALSE
TRUE
类型
LX
类型1发放2消费3发放回滚(暂不使用)4消费回滚(暂不使用)
NUMBER
(1)
1
FALSE
TRUE
优先级
YXJ
优先级从1开
NUMBER
(2)
2
1
FALSE
TRUE
是否全局
SFQJ
是否全局0个人1全局
默认全局
NUMBER
(1)
1
1
FALSE
TRUE
是否活动使用
SFHDSY
是否活动使用0否1是
NUMBER
(1)
1
0
FALSE
FALSE
积分
JF
积分
NUMBER(10)
10
0
FALSE
TRUE
是否应用公式
SFYYGS
是否应用公式0否1是
NUMBER
(1)
1
0
FALSE
TRUE
公式
GS
公式
CLOB
FALSE
FALSE
描述
MS
描述
CLOB
FALSE
FALSE
日上限
RSX
日上限
NUMBER(10)
10
0
FALSE
TRUE
月上限
YSX
月上限
NUMBER(10)
10
0
FALSE
TRUE
总上限
ZSX
总上限
NUMBER(10)
10
0
FALSE
TRUE
创建用户ID
CJYHID
创建用户ID
CHAR(32)
32
FALSE
TRUE
创建时间
CJSJ
创建时间
DATE
SYSDATE
FALSE
TRUE
修改用户ID
XGYHID
修改用户ID
CHAR(32)
32
FALSE
FALSE
修改时间
XGSJ
修改时间
DATE
FALSE
FALSE
状态
ZT
状态0停用1启用
NUMBER
(1)
1
FALSE
TRUE
积分记录的列清单:
名称
代码
注释
数据类型
长度
默认值
主要的
强制
分值记录ID
ID
分值记录ID
CHAR(32)
32
TRUE
TRUE
用户ID
YHID
用户ID
CHAR(32)
32
FALSE
TRUE
规则ID
GZID
规则ID
CHAR(32)
32
FALSE
TRUE
功能代码
GNDM
功能代码
CHAR(200)
200
FALSE
TRUE
业务ID
YWID
业务ID
CHAR(32)
32
FALSE
FALSE
本次分值
BCJF
本次分值
NUMBER(10)
10
0
FALSE
TRUE
创建时间
CJSJ
创建时间
DATE
SYSDATE
FALSE
TRUE
4.3CSCI部件
积分系统包含如下程序(模块):
序号
程序(模块)
标识符
1
系统管理
积分等级维护
积分等级列表
JFXT-MOD-001
2
查询积分等级
JFXT-MOD-002
3
新增积分等级
JFXT-MOD-003
4
修改积分等级
JFXT-MOD-004
5
删除积分等级
JFXT-MOD-005
6
停用积分等级
JFXT-MOD-006
7
启用积分等级
JFXT-MOD-007
8
积分规则维护
积分规则列表
JFXT-MOD-008
9
查询积分规则
JFXT-MOD-009
10
新增积分规则
JFXT-MOD-010
11
修改积分规则
JFXT-MOD-011
12
删除积分规则
JFXT-MOD-012
13
停用积分规则
JFXT-MOD-013
14
启用积分规则
JFXT-MOD-014
15
积分应用
数据共享与协同
添加积分规则
JFXT-MOD-015
16
获取用户积分信息
JFXT-MOD-016
17
添加积分记录
JFXT-MOD-017
18
查询积分记录
JFXT-MOD-018
19
清理积分
JFXT-MOD-019
20
积分统计
积分情况列表
JFXT-MOD-020
21
查询积分情况
JFXT-MOD-021
22
导出积分情况
JFXT-MOD-022
23
积分活动
活动列表
JFXT-MOD-023
24
查询活动
JFXT-MOD-024
25
新增活动
JFXT-MOD-025
26
删除活动
JFXT-MOD-026
27
修改活动
JFXT-MOD-027
28
停用活动
JFXT-MOD-028
29
启用活动
JFXT-MOD-029
30
完成活动
JFXT-MOD-030
31
积分兑换
JFXT-MOD-031
4.4执行概念
本条应描述软件配置项间的执行概念。
为表示软件配置项之间的动态关系,即CSCI运行期间它们如何交互的,本条应包含图示和说明,(若适用)包括执行控制流、数据流、动态控制序列、状态转换图、时序图、配置项之间的优先关系、中断处理、时间/序列关系、异常处理、并发执行、动态分配与去分配、对象/进程/任务的动态创建与删除和其他的动态行为。
4.5接口设计
4.5.1接口标识与接口图
系统的接口标识如下:
序号
接口名称
接口标识
接口类型
接口说明
1
获取用户积分信息接口
INT-001
WebService
通过接口获取用户积分信息,用于基础平台的展示。
2
添加积分记录接口
INT-002
WebService
相应的功能模块调用此接口完成积分的获得和消费。
3
查询积分记录接口
INT-003
WebService
通过接口获取积分记录,用于基础平台的展示。
4
添加积分规则接口
INT-004
WebService
通过接口设置个性化的积分规则。
5
清理积分接口
INT-005
WebService
通过接口清理不在有效期的积分。
4.5.2获取用户积分信息接口(INT-001)
地址
resource/integral/getUserIntegral
方法名
getUserIntegral
调用方式
post
方法说明
1、该接口获取用户积分信息。
2、返回数据格式为json。
输入参数
序号
参数名称
参数类型
最大长度
说明
1
userId
string
32
用户Id
输出参数
序号
参数名称
参数类型
最大长度
说明
1
userIntegral
UserIntegral
用户积分信息
userIntegral的属性清单:
属性名称
属性类型
说明
UserId
string
用户Id
IntegralGrade
int
积分等级
IntegralTitle
string
积分称号
IntegralICON
string
积分图标
ExpenseGrade
int
消费等级
ExpenseTitle
string
消费称号
ExpenseICON
string
消费图标
TotalIntegral
int
总积分(累计积分)
currentIntegral
int
当前积分
TotalExpense
int
总消费(累计消费)
4.5.3添加积分记录接口(INT-002)
地址
resource/integral/setIntegraRecord
方法名
setIntegralRecord
调用方式
post
方法说明
1、该接口完成积分的获得和消费。
2、返回数据格式为json。
输入参数
序号
参数名称
参数类型
最大长度
说明
1
integralRecords
IntegralRecord[]
积分记录数据
输出参数
序号
参数名称
参数类型
最大长度
说明
1
message
object
提示信息
integralRecord的属性清单:
属性名称
属性类型
说明
UserId
string
用户Id
FunctionCode
string
功能代码
integralType
int
积分规则类型
BusinessId
string
业务Id
4.5.4查询积分记录接口(INT-003)
地址
resource/integral/queryIntegralRecord
方法名
queryIntegralRecord
调用方式
post
方法说明
1、该接口获取积分记录。
2、返回数据格式为json。
输入参数
序号
参数名称
参数类型
最大长度
说明
1
userId
string
32
用户Id
输出参数
序号
参数名称
参数类型
最大长度
说明
1
integralRecord
IntegralRecord[]
积分记录数据
integralRecord的属性清单:
属性名称
属性类型
说明
UserId
string
用户Id
RuleType
int
规则类型(1发放2消费3发放回滚4消费回滚)
RuleDesc
string
规则描述
Integral
int
积分
CreateDate
string
创建时间(精确到时分秒)
FunctionCode
string
功能代码
BusinessId
string
业务Id
4.5.5添加积分规则接口(INT-004)
地址
resource/integral/setIntegraRule
方法名
setIntegraRule
调用方式
post
方法说明
1、该接口添加个性化积分规则例如:
资源上传设置下载积分。
2、返回数据格式为json。
输入参数
序号
参数名称
参数类型
最大长度
说明
1
integralRule
IntegralRule[]
积分规则数据
输出参数
序号
参数名称
参数类型
最大长度
说明
1
message
object
提示信息
integralRule的属性清单:
属性名称
属性类型
说明
ModuleId
string
用户Id
FunctionId
string
功能Id
FunctionCode
string
功能代码格式功能代码+业务ID
IntegralType
int
积分规则类型当上传资源是需添加两条积分规则一天消费规则一条发放规则
Integral
int
积分
IsGlobal
int
是否全局默认个人(0)
IsEnabled
int
是否启用默认启用
(1)
Desc
string
描述
CreateName
string
创建用户
CreateTime
string
创建时间(精确到时分秒)
4.5.6清理积分接口(INT-005)
地址
resource/integral/clearIntegra
方法名
clearIntegra
调用方式
post
方法说明
1、该接口清理不在有效期内的积分。
例如一个学年过去后清理未使用积分的2/3.
2、返回数据格式为json。
输入参数
序号
参数名称
参数类型
最大长度
说明
1
integralRecord
IntegralRecord[]
积分规则数据
输出参数
序号
参数名称
参数类型
最大长度
说明
1
message
object
提示信息
integralRecord的属性清单:
属性名称
属性类型
说明
FunctionCode
string
功能代码
integralType
int
积分规则类型默认消费
(2)
BusinessId
string
业务Id
EndDate
string
结束时间
5CSCI详细设计
本章应分条描述CSCI的每个软件配置项。
如果设计的部分或全部依赖于系统状态或方式,则应指出这种依赖性。
如果该设计信息在多条中出现,则可只描述一次,而在其他条引用。
应给出或引用为理解这些设计所需的设计约定。
软件配置项的接口特性可在此处描述,也可在第4章或接口设计说明(IDD)中描述。
数据库软件配置项,或用于操作/访问数据库的软件配置项,可在此处描述,也可在数据库(顶层)设计说明(DBDD)中描述。
5.1积分等级列表(JFXT-MOD-001)
5.1.1.1功能描述
提供对积分等级的管理,点击积分等级管理显示积分等级列表。
5.1.1.2时序图
5.1.1.3输入输出
操作
输入
处理
输出
运行应用
无
积分等级列表
分页、排序
1.根据分页、排序查询积分等级。
积分等级列表
5.1.1.4异常处理
异常
处理方式
系统错误
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 积分 系统 详细 设计 说明书
![提示](https://static.bdocx.com/images/bang_tan.gif)