公司内部比赛参赛项目.zip

- [hydosky-send](#hydosky-send) - [0. 前言](#0-%E5%89%8D%E8%A8%80) - [1. 使用步骤](#1-%E4%BD%BF%E7%94%A8%E6%AD%A5%E9%AA%A4) - [1.1 克隆或下载项目](#11-%E5%85%8B%E9%9A%86%E6%88%96%E4%B8%8B%E8%BD%BD%E9%A1%B9%E7%9B%AE) - [1.2 执行sql脚本](#12-%E6%89%A7%E8%A1%8Csql%E8%84%9A%E6%9C%AC) - [1.3 修改配置](#13-%E4%BF%AE%E6%94%B9%E9%85%8D%E7%BD%AE) - [1.4 本地打包](#14-%E6%9C%AC%E5%9C%B0%E6%89%93%E5%8C%85) - [1.5 执行jar包](#15-%E6%89%A7%E8%A1%8Cjar%E5%8C%85) - [1.6 修改参数，动态改变数据](#16-%E4%BF%AE%E6%94%B9%E5%8F%82%E6%95%B0%E5%8A%A8%E6%80%81%E6%94%B9%E5%8F%98%E6%95%B0%E6%8D%AE) - [2. 大屏展示数据接口及响应格式](#2-%E5%A4%A7%E5%B1%8F%E5%B1%95%E7%A4%BA%E6%95%B0%E6%8D%AE%E6%8E%A5%E5%8F%A3%E5%8F%8A%E5%93%8D%E5%BA%94%E6%A0%BC%E5%BC%8F) - [2.1 当日实时热门货物品类](#21-%E5%BD%93%E6%97%A5%E5%AE%9E%E6%97%B6%E7%83%AD%E9%97%A8%E8%B4%A7%E7%89%A9%E5%93%81%E7%B1%BB) - [2.2 实时热门货运城市](#22-%E5%AE%9E%E6%97%B6%E7%83%AD%E9%97%A8%E8%B4%A7%E8%BF%90%E5%9F%8E%E5%B8%82) - [2.3 今日订单总量、订单总额、货物总量](#23-%E4%BB%8A%E6%97%A5%E8%AE%A2%E5%8D%95%E6%80%BB%E9%87%8F%E8%AE%A2%E5%8D%95%E6%80%BB%E9%A2%9D%E8%B4%A7%E7%89%A9%E6%80%BB%E9%87%8F) - [2.4 历史订单总量、订单总额、货物总量](#24-%E5%8E%86%E5%8F%B2%E8%AE%A2%E5%8D%95%E6%80%BB%E9%87%8F%E8%AE%A2%E5%8D%95%E6%80%BB%E9%A2%9D%E8%B4%A7%E7%89%A9%E6%80%BB%E9%87%8F) - [2.5 城市货运金额统计](#25-%E5%9F%8E%E5%B8%82%E8%B4%A7%E8%BF%90%E9%87%91%E9%A2%9D%E7%BB%9F%E8%AE%A1) - [2.6 城市货运数量统计](#26--%E5%9F%8E%E5%B8%82%E8%B4%A7%E8%BF%90%E6%95%B0%E9%87%8F%E7%BB%9F%E8%AE%A1) - [2.7 全网货运品类排行](#27-%E5%85%A8%E7%BD%91%E8%B4%A7%E8%BF%90%E5%93%81%E7%B1%BB%E6%8E%92%E8%A1%8C) - [2.8 近期订单金额统计](#28-%E8%BF%91%E6%9C%9F%E8%AE%A2%E5%8D%95%E9%87%91%E9%A2%9D%E7%BB%9F%E8%AE%A1) - [3. 设计思路](#3-%E8%AE%BE%E8%AE%A1%E6%80%9D%E8%B7%AF) - [3.1 要求](#31-%E8%A6%81%E6%B1%82) - [3.2 设计](#32-%E8%AE%BE%E8%AE%A1) - [3.2.1 表设计](#321-%E8%A1%A8%E8%AE%BE%E8%AE%A1) - [3.2.2 核心功能设计](#322-%E6%A0%B8%E5%BF%83%E5%8A%9F%E8%83%BD%E8%AE%BE%E8%AE%A1) - [3.2.2.1 订单生成的间隔时间计算](#3221-%E8%AE%A2%E5%8D%95%E7%94%9F%E6%88%90%E7%9A%84%E9%97%B4%E9%9A%94%E6%97%B6%E9%97%B4%E8%AE%A1%E7%AE%97) - [3.2.2.2 根据城市系数非均匀随机选择城市](#3222-%E6%A0%B9%E6%8D%AE%E5%9F%8E%E5%B8%82%E7%B3%BB%E6%95%B0%E9%9D%9E%E5%9D%87%E5%8C%80%E9%9A%8F%E6%9C%BA%E9%80%89%E6%8B%A9%E5%9F%8E%E5%B8%82) - [3.2.2.3 近期订单金额统计](#3223-%E8%BF%91%E6%9C%9F%E8%AE%A2%E5%8D%95%E9%87%91%E9%A2%9D%E7%BB%9F%E8%AE%A1) # hydosky-send ## 0. 前言 **注意**： - 程序启动后，会使用线程自动执行订单生成程序。 - 只在营业时间（比如：9:00-18:00可配置）内生成订单，其他时间段，订单生成程序睡眠。 - 订单生成程序睡眠时间是根据每天应当生成的总订单数和营业时间总毫秒数计算出来的（具体计算过程请往下移步3.设计思路进行阅读）。 - 修改可配置的参数（城市系数、营业时间、基准城市的日订单量、订单运费区间、每单货物件数区间，以及增加新的城市），订单数量、睡眠时间可动态改变。 **环境**：mysql 5.7及以上、jdk 1.8 **项目结构**： hydosky-send # 项目名 - doc # 存放sql脚本 - src.main - java.org.hydosky.send - config # 相关配置项 - constant # 系统常量池 - controller # 接口 - data # 生成订单 及 统计数据 - entity # 实体类 - mapper # 持久化层 - response # 响应体 - schedule # 定期删除 随时间增长的数据 - service # 业务层 - util # 工具类 - vo # 视图类 - resources # 配置文件 ## 1. 使用步骤 ### 1.1 克隆或下载项目 点击Clone or download，选择项目**git地址**克隆项目到本地，或点击Download ZIP，下载一份到本地。然后使用idea或者eclipse打开项目。 ### 1.2 执行sql脚本 将项目根目录里**doc**文件夹中的**sql脚本**导入到数据库中。里面是所有的**表结构**，以及**初始化的数据**。 ### 1.3 修改配置 - 根据**环境**修改**application.yml**文件中的**数据库地址**，以及**用户名**和**密码**。 - 根据自己的需求修改项目的**访问端口**，我指定的是8108。 - resources文件下的**logback-spring.xml**文件中可指定日志的存活时间。我指定的是5天。 ### 1.4 本地打包 可以本地运行，测试一下。也可以直接执行maven打包语句，将jar包上传到服务器执行。 ### 1.5 执行jar包 使用 java -jar 包名 执行jar包，当然你也可以指定项目需要的内存大小，以及jvm参数。这里有两点要注意一下，首先要指定所使用的环境，命令是-Dspring.profiles.active=prod，这样就会加载生产环境application-prod.yml的配置，第二点是指定保存日志的路径，命令是-Dlog.basicDir=路径。 你也可以使用下面的方式，脚本我已经写好了，你按照我的方式来就行了。**当然，嫌下面的方式麻烦的话，你可以跳过了**，按照自己的方式来，Follow your heart！ 1. /home/username（此目录自己选择）下创建相应的目录及文件，username 为你登录用户名。 目录结构如下： /home/username - -- hydosky-send - -- logs # 日志存放目录，定期清除，不用担心磁盘爆满 - -- shell # 脚本存放目录 - pid.txt # 此文件主要存放进程的pid。再次启动时，停掉正在运行的，防止端口冲突 - hydosky-send-boot.sh # 启动脚本 - -- jars # jar包存放目录 - hydosky-send.jar 2. hydosky-send-boot.sh脚本内容 ```shell #! /bin/sh #SERVICE_HOME就是上面的/home/username/hydosky-send目录 SERVICE_HOME="/home/username/hydosky-send" SERVICE_PID=`cat /home/username/hydosky-send/shell/pid.txt` echo "停掉正在运行的hydosky-send后台进程，PID=${SERVICE_PID}" kill -9 $SERVICE_PID echo "PID=${SERVICE_PID}的服务已被kill" echo "hydosky-send服务重新启动" java -Xms128m -Xmx128m -Xmn56m -XX:MetaspaceSize=80m -XX:MaxDirectMemorySize=20m -Duser.timezone=Asia/Shanghai -Djava.security.edg=file:/dev/./urandom -Dlog.basicDir=${SERVICE_HOME}/logs -Dspring.profiles.active=prod -jar ${SERVICE_HOME}/jars/hydosky-send.jar & #将本次运行的服务进程PID记录到pid.txt中 echo $!> ${SERVICE_HOME}/shell/pid.txt echo "hydosky-send服务启动成功" ``` 3. 执行hydosky-send-boot.sh ```shell sh /home/username/hydosky-send/shell/hydosky-send-boot.sh ``` ### 1.6 修改参数，动态改变数据 修改城市系数、营业时间、基准城市的日订单量、订单运费区间、每单获取件数区间，以及增加新的城市，都可动态的改变订单的生成效果，即可达到统计数据的变化。 ## 2. 大屏展示数据接口及响应格式 注：统一为GET请求 ### 2.1 当日实时热门货物品类 **Path :** **/hydosky-send/statistics/date-hot-type** **响应数据格式**： ```json [ { "date": "2019-12-22", "type": "箱包皮具", "orderCount": 1 } ] ``` ### 2.2 实时热门货运城市 **Path :** **/hydosky-send/statistics/hot-city** **响应数据格式**： （以下数据为初始化数据） ```json [ { "name": "兰州", "lng": 103.823557, "lat": 36.058039, "orderCount":