电信客户分析项目详细设计说明书

电信客户分析项目详细设计说明书XX科技股份有限公司编制目录一、 电信客户分析项目软件模块设计 3二、 电信客户分析项目系统接口及函数 32.1 数据生产 32.1.1 数据生产函数 32.2 数据采集 42.2.1 数据采集接口 42.2.2 数据存储函数 42.3 数据分析 52.3.1 数据分析函数 52.4 可视化展示 62.4.1 用户接口 62.4.2 菜单接口 72.4.3 角色接口 72.4.4 电信通话分析接口 82.4.5 电信用户分析接口 92.4.6 流量使用分析接口 92.4.7 短信使用分析接口 102.4.8 费用分析接口 10三、 电信客户分析项目系统数据格式 113.1 数值类型 113.2 日期和时间类型 123.3 字符串类型 13四、 电信客户分析项目系统数据库表结构 144.1 表结构设计 14电信客户分析项目软件模块设计表1电信客户分析模块设计表序号一级模块二级模块三级模块说明1数据生产电信客户数据生产2数据采集/存储使用Flume、Kafka组件将电信客户数据存储到HBASE中3数据分析使用MapReduce将HBASE中的数据经过分析处理之后导入到MySQL中4可视化展示系统管理系统状态监控、系统信息查看5权限管理资源管理系统菜单管理、路径管理6角色管理系统使用角色管理、权限管理7用户管理系统登录用户管理8电信客户分析通话分析单用户通话情况分析9用户分析电信用户类型分析10流量分析用户流量使用分析11短信分析用户短信使用分析12收入分析电信收入分析电信客户分析项目系统接口及函数数据生产数据生产函数函数类duct.test.MockRecords生产类TestMockRecords需求优先级高系统输入或系统外激励系统响应系统调用生产函数,设定相应的输出文件及输出路径根据设定路径，生产相应的数据文件功能需求数据生产例外以及相应处理调用的功能数据生产注释和说明数据采集数据采集接口接口地址/hhrzkg/system/dataCollection用户类系统需求优先级高系统输入或系统外激励系统响应设定flume采集的源文件和数据下沉的位置，将数据采集到kafka集群中Kafka集群出现相应的电信客户数据功能需求数据采集例外以及相应处理调用的功能数据采集注释和说明数据存储函数函数类com.hbase.consumer用户类HbaseConsumer需求优先级高系统输入或系统外激励系统响应设置kafka消费主题，使用HBASE消费数据将kafka集群中的待数据存储到HBASE中功能需求数据存储例外以及相应处理调用的功能数据存储注释和说明数据分析数据分析函数函数类com.bigdata.analysis.runner用户类CountDurationRunner需求优先级高系统输入或系统外激励系统响应配置源HBASE、目标MYSQL数据格式，配置清洗策略将HBASE数据经过分析后存储MySQL功能需求数据分析例外以及相应处理调用的功能数据分析注释和说明可视化展示用户接口接口地址/hhrzkg/system/admin用户类系统管理员需求优先级高用户输入或系统外激励系统响应1.用户输入用户名、密码1.比对输入用户是否存在，并返回相应结果。2.新增用户；3.删除用户；4.修改用户。功能需求用户登录系统、用户修改信息、管理员新增和删除用户例外以及相应处理调用的功能系统登录、用户信息修改、新增和删除用户注释和说明菜单接口接口地址/hhrzkg/system/res用户类系统管理员需求优先级高用户输入或系统外激励系统响应1.用户输入菜单名称、菜单地址、上级目录。1.比对输入菜单是否存在，并返回相应结果。2.新增菜单；3.删除菜单；4.比对输入菜单是否存在，不存在即修改菜单。功能需求系统管理员查询、新增、修改、删除菜单例外以及相应处理调用的功能菜单查询、新增、修改、删除注释和说明角色接口接口地址/hhrzkg/system/role用户类系统管理员需求优先级高用户输入或系统外激励系统响应1.用户输入角色名称、角色权限1.显示角色名称、权限等信息2.新增角色；3.删除角色；4.比对输入角色是否存在，不存在即修改角色。功能需求用户授权，系统管理员对角色新增、删除、修改、查询例外以及相应处理调用的功能角色查询、新增、修改、删除注释和说明电信通话分析接口接口地址/hhrzkg/system/call用户类系统用户需求优先级高用户输入或系统外激励系统响应1.用户输入用户名称1.显示用户近一年的通话次数和通话时间功能需求图形化展示通话记录分析例外以及相应处理调用的功能通话分析注释和说明电信用户分析接口接口地址/hhrzkg/system/contactsDetail用户类系统用户需求优先级高用户输入或系统外激励系统响应电信用户的账号使用情况、5G用户情况、VIP数量、手机类型使用情况功能需求图形化展示用户情况例外以及相应处理调用的功能用户分析注释和说明流量使用分析接口接口地址/hhrzkg/system/flow用户类系统用户需求优先级高用户输入或系统外激励系统响应电信用户流量套餐及使用情况功能需求图形化展示用户流量使用情况例外以及相应处理调用的功能流量分析注释和说明短信使用分析接口接口地址/hhrzkg/system/message用户类系统用户需求优先级高用户输入或系统外激励系统响应电信用户短信套餐及使用情况功能需求图形化展示用户短信使用情况例外以及相应处理调用的功能短信分析注释和说明费用分析接口接口地址/hhrzkg/system/fee用户类系统用户需求优先级高用户输入或系统外激励系统响应电信各月收入比例情况功能需求图形化展示电信费用来源分析例外以及相应处理调用的功能费用分析注释和说明电信客户分析项目系统数据格式数值类型这些类型包括严格数值数据类型(INTEGER、SMALLINT、DECIMAL和NUMERIC)，以及近似数值数据类型(FLOAT、REAL和DOUBLEPRECISION)。关键字INT是INTEGER的同义词，关键字DEC是DECIMAL的同义词。BIT数据类型保存位字段值，并且支持MyISAM、MEMORY、InnoDB和BDB表。作为SQL标准的扩展，MySQL也支持整数类型TINYINT、MEDIUMINT和BIGINT。下面的表显示了需要的每个整数类型的存储和范围。表2数值数据格式表类型大小范围（有符号）范围（无符号）用途TINYINT1byte(-128，127)(0，255)小整数值SMALLINT2bytes(-32768，32767)(0，65535)大整数值MEDIUMINT3bytes(-8388608，8388607)(0，16777215)大整数值INT或INTEGER4bytes(-2147483648，2147483647)(0，4294967295)大整数值BIGINT8bytes(-9,223,372,036,854,775,808，9223372036854775807)(0，18446744073709551615)极大整数值FLOAT4bytes(-3.402823466E+38，-1.175494351E-38)，0，(1.175494351E-38，3.402823466351E+38)0，(1.175494351E-38，3.402823466E+38)单精度

浮点数值DOUBLE8bytes(-1.7976931348623157E+308，-2.2250738585072014E-308)，0，(2.2250738585072014E-308，1.7976931348623157E+308)0，(2.2250738585072014E-308，1.7976931348623157E+308)双精度

浮点数值DECIMAL对DECIMAL(M,D)，如果M>D，为M+2否则为D+2依赖于M和D的值依赖于M和D的值小数值日期和时间类型表示时间值的日期和时间类型为DATETIME、DATE、TIMESTAMP、TIME和YEAR。每个时间类型有一个有效值范围和一个"零"值，当指定不合法的MySQL不能表示的值时使用"零"值。TIMESTAMP类型有专有的自动更新特性，将在后面描述。表3日期时间数据格式表类型大小(bytes)范围格式用途DATE31000-01-01/9999-12-31YYYY-MM-DD日期值TIME3'-838:59:59'/'838:59:59'HH:MM:SS时间值或持续时间YEAR11901/2155YYYY年份值DATETIME81000-01-0100:00:00/9999-12-3123:59:59YYYY-MM-DDHH:MM:SS混合日期和时间值TIMESTAMP41970-01-0100:00:00/2038结束时间是第

2147483647

秒，北京时间

2038-1-1911:14:07，格林尼治时间2038年1月19日凌晨03:14:07YYYYMMDDHHMMSS混合日期和时间值，时间戳字符串类型字符串类型指CHAR、VARCHAR、BINARY、VARBINARY、BLOB、TEXT、ENUM和SET。该节描述了这些类型如何工作以及如何在查询中使用这些类型。表4字符串数据格式表类型大小用途CHAR0-255bytes定长字符串VARCHAR0-65535bytes变长字符串TINYBLOB0-255bytes不超过255个字符的二进制字符串TINYTEXT0-255bytes短文本字符串BLOB0-65535bytes二进制形式的长文本数据TEXT0-65535bytes长文本数据MEDIUMBLOB0-16777215bytes二进制形式的中等长度文本数据MEDIUMTEXT0-16777215bytes中等长度文本数据LONGBLOB0-4294967295bytes二进制形式的极大文本数据LONGTEXT0-4294967295bytes极大文本数据电信客户分析项目系统数据库表结构表结构设计我们将分析的结果数据保存到Mysql中，以方便Web端进行查询展示。1)表：db_telecom.tb_contacts_detail用于用户基本信息。列备注类型id自增主键int(11)NOTNULLtelephone手机号码varchar(255)NOTNULLname用户姓名varchar(255)NOTNULLcontact_type用户状态varchar(255)NOTNULLcontact_5G是否5G用户varchar(255)NOTNULLphone_brand手机品牌varchar(255)NOTNULLphone_model手机模型varchar(255)NOTNULLvip_gradeVip等级varchar(255)NOTNULL2)表：db_telecom.tb_call用于存放某个时间维度下通话次数与通话时长的总和。列备注类型id自增主键int(11)NOTNULLname姓名varchar(255)NOTNULLid_contact查询人的电话号码varchar(255)NOTNULLcall_sum通话次数总和int(11)NOTNULLcall_duration_sum通话时长总和int(11)NOTNULLyear年份int(11)NOTNULLmonth月份int(11)NOTNULLday日期int(11)NOTNULL3)表：db_telecom.tb_fee用于电信收入情况列备注类型id自增主键int(11)NOTNULLmonth月份int(11)NOTNULLvoice语音收入float(10,2)NOTNULLflow流量收入float(10,2)NOTNULLout_flow套餐外流量收入float(10,2)NOTNULLout_voice套餐外语音收入float(10,2)NOTNULL4)表：db_telecom.tb_flow流量使用情况列备注类型id自增主键int(11)NOTNULLname姓名varchar(255)NOTNULLtelephone电话号码varchar(255)NOTNULLflow_package流量套餐类型varchar(255)NOTNULLlast_month_surplus上月剩余float(5,2)NOTNULLthis_month_flow本月流量float(5,2)NOTNULLused_flow已使用float(5,2)NOTNULLresidual_flow剩余float(5,2)NOTNULL5)表：db_tele