diff --git a/.idea/.idea.dev-aid.dir/.idea/.gitignore b/.idea/.idea.dev-aid.dir/.idea/.gitignore new file mode 100644 index 0000000..0931f4a --- /dev/null +++ b/.idea/.idea.dev-aid.dir/.idea/.gitignore @@ -0,0 +1,13 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Rider ignored files +/projectSettingsUpdater.xml +/contentModel.xml +/.idea.dev-aid.iml +/modules.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/.idea/.idea.dev-aid.dir/.idea/encodings.xml b/.idea/.idea.dev-aid.dir/.idea/encodings.xml new file mode 100644 index 0000000..df87cf9 --- /dev/null +++ b/.idea/.idea.dev-aid.dir/.idea/encodings.xml @@ -0,0 +1,4 @@ + + + + \ No newline at end of file diff --git a/.idea/.idea.dev-aid.dir/.idea/indexLayout.xml b/.idea/.idea.dev-aid.dir/.idea/indexLayout.xml new file mode 100644 index 0000000..7b08163 --- /dev/null +++ b/.idea/.idea.dev-aid.dir/.idea/indexLayout.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/.idea/.idea.dev-aid.dir/.idea/vcs.xml b/.idea/.idea.dev-aid.dir/.idea/vcs.xml new file mode 100644 index 0000000..7ddfc9e --- /dev/null +++ b/.idea/.idea.dev-aid.dir/.idea/vcs.xml @@ -0,0 +1,12 @@ + + + + + + + + + + + + \ No newline at end of file diff --git a/pa-iot/交接文档/assets/clip_image001.png b/pa-iot/交接文档/assets/clip_image001.png new file mode 100644 index 0000000..4e3aa24 Binary files /dev/null and b/pa-iot/交接文档/assets/clip_image001.png differ diff --git a/pa-iot/交接文档/assets/clip_image002.png b/pa-iot/交接文档/assets/clip_image002.png new file mode 100644 index 0000000..4a14ec3 Binary files /dev/null and b/pa-iot/交接文档/assets/clip_image002.png differ diff --git a/pa-iot/交接文档/assets/image-20240724091848331.png b/pa-iot/交接文档/assets/image-20240724091848331.png new file mode 100644 index 0000000..a4353fd Binary files /dev/null and b/pa-iot/交接文档/assets/image-20240724091848331.png differ diff --git a/pa-iot/交接文档/交接文档.md b/pa-iot/交接文档/交接文档.md new file mode 100644 index 0000000..ba509be --- /dev/null +++ b/pa-iot/交接文档/交接文档.md @@ -0,0 +1,107 @@ +# 项目结构 + + + +![img](assets/clip_image001.png) + +从上到下依次为: + +- Webapi项目 + +- 数据库项目 + +- 接收MQTT主题消息的项目 +- 处理定时任务的项目 + +- MQTT服务器项目 + +其在服务器对应的服务(从上到下且不包含PAIoT.DataPersistence): + +- 华为云 + + - pa-iot + + - datasync + + - jobs + + - mqtt + +- 阿里云 + + - iot-api + + - datasync2 + + - jobs + + - mqttbroker + +注: + +- 需要注意的是datasync2服务位于另一台服务器。 + +- 除pa-iot对应的文件夹为api之外,其余服务所在的文件夹与其服务名相似(一致或包含其中的某个单词)。 + + + + + +# 业务逻辑 + +- **PAIOT** + +- **PAIOT.Jobs** + + - **报警逻辑:** + + - **实时数据报警:** + - **针对设置实时数据报警设置的指标:**系统对接收到的每条数据进行越限判断,在规定的持续时间内,如异常数据和总数据之比超过所设定的报警比例,则进入等待报警状态。进入报警状态后,根据报警设置和勾选的报警人确定发送对象和发送方式。 + - 报警次数:默认报警次数为1,即在进入等待报警状态后的下一次判断中进入报警状态。如果报警次数大于1,每一次的报警时间间隔由间隔时间/报警次数得出。 + - 间隔时间在报警完成后开始累计,直至间隔时间结束,系统不会再对该以判断过报警的监测点进行判断。 + + - **网关状态报警:** + + - **针对设置网关状态报警设置的指标:** 网关状态报警即在网关状态发生相应的变化时,发出对应的告警,其告警为立刻告警,收到对应的消息即刻告警,进入报警状态后,根据报警设置和勾选的报警人确定发送对象和发送方式。 + + - 网关状态发生相应变化详见网关状态逻辑,此处不再赘述。 + + - **网关IO报警:** + - **针对设置网关IO报警设置的指标:**接收到相应的event主题后,发出对应的告警,其告警为立刻告警,收到对应的消息即刻告警,进入报警状态后,根据报警设置和勾选的报警人确定发送对象和发送方式。 + + - **网关状态逻辑:** + + - **网关离线判断:** + + - 三者条件满足任一进入下一个判断。 + + - 同时满足网关在线再进入下一个判断。 + + ![img](assets/clip_image002.png) + + - 上述两个条件满足之后,进入处理 + - 状态置为0 + - 如果报警设置设置了网关离线则发送相应的消息 + - 网关掉电同上 + - 网关下的设备状态都置为0 + + ![image-20240724091848331](assets/image-20240724091848331.png) + + + + + + +注: + +- 常规的增删改查可通过接口注释知晓其作用,故未在此展示。 + +- 大部分接口都涉及租户和平台的判断,上述业务逻辑讲解不再单独提及此逻辑。 + +- 报警和设备状态相关操作引起数据库数据变动, redis需要同时作出相应变化,和数据库保持一致,上述业务逻辑讲解不再单独提及此逻辑。 + +- 各MQTT主题作用详见文件(数据采集网关控制器-mqtt通讯规范),此处不再赘述。 + +- 网关状态逻辑详见(网关在线离线逻辑判断 1.1 2024-7-3_加水印.pdf)。 + + \ No newline at end of file