云平台开发文档

1.平台结构

• Part.1 基于Swoole的TCP服务器

  • 建立TCP服务器的作用

    该TCP服务器用于与各设备的传感器直接交互并将得到的数据存入redis缓存数据库中，并由管理平台向用户展示。

  • 主要模块

    • 设备登录/注销

      允许用户设备向TCP服务器发送登录请求。请求格式为 {"m":"login","msg":{"id":"xxx","key":"***"}} 其中id对应的值为管理平台生成的设备ID，key对应的值为管理平台生成的设备秘钥。服务器会查询Mysql数据库判断是否能够登录。

    • 连接保持/接收数据

      由于TCP服务器采用的是与管理平台不同的连接方式(TCP服务器为TCP长连接，管理平台为HTTP)所以需要心跳包等设计来保持连接， 并且要考虑到网络状况不佳时的断开重连机制。同时服务器会接收设备发送的数据并根据数据的类型以及是否有WebHook做出相应的处理.

    • Redis数据库读写

      设备发送给服务器的数据最终会保存到Redis数据库中并由管理平台读取展示给用户。数据读写主要要考虑到存储的类型，读写效率等硬件方面的因素。

• Part.2 基于Fastadmin的管理平台

  • 管理平台功能

    管理平台允许用户创建/管理设备与传感器，获取传感器的数据并根据用户选定的类型以不同的形式向用户展示数据

  • 主要模块

    • 用户管理

      提供用户注册，用户登录，找回密码等基本功能。

    • 创建/管理设备与传感器

      允许用户创建/管理设备和传感器。 用户可以为设备命名，在设备中创建传感器。传感器根据使用的数据类型分为数值传感器、文本传感器、开关传感器、GPS传感器和图像传感器，不同的传感器会在数据展示部分已不同的形式展示数据。 平台会为每个设备设置专有的设备ID和秘钥，该秘钥用于验证用户设备的登录、ID用于区分不同的用户设备。

    • 展示/导出数据

      平台会从Mysql数据库(暂定，之后可能会改为Redis数据库)中读取设备发送的数据并已不同的形式展示给用户。 目前允许的数据类型有 数值型，文本型，开关型，GPS型和图像型。数值型会自动生成以时间为横坐标，数值为纵坐标的折线图。GPS型会通过百度地图API生成路线图。文本型，开关型和图像型都会以表格的形式展示数据。

    • WebHook

      用户可以在传感器中添加WebHook指向自己的服务器，平台会在接收到设备数据之后将数据转发到用户的服务器由用户来处理数据。

2.平台连接

3.开发进度

• TCP服务器
  • 设备登录 （已完成）
  • 数据交互 （未完成）
  • Redis交互 （未完成）
• 云管理平台
  • 用户注册/登录 (已完成)
  • 创建/管理/删除设备 (已完成)
  • 创建/管理/删除传感器 (已完成)
  • 接收/展示数据 (Mysql已完成，之后会改为Redis)
  • WebHook （未开始）

4.当前开发目标

• 完成WebHook

  WebHook在整个平台中属于较为独立的部分而且其所需要的前置基础也都已经完成。WebHook的实现比较简单只需要掌握php和Mysql即可进行开发。

• 完成TCP服务器与Redis数据库的交互

  TCP服务器与Redis数据库的交互属于平台中较为重要的环节，并且要考虑到在多设备连接时操作数据库的效率和安全问题，所以这部分依然由林嘉琪负责。

• 修改数据存储方式(Mysql->Redis)

  目前管理平台获取数据的方式是从Mysql数据库中获取数据，但是由于Mysql数据库的读写速度有限，不适合做频繁的写入与读取，所以之后会将Mysql数据库改为更适合频繁读写的Redis数据库。

5.额外-WebHook具体实现

• WebHook完整流程

• 需要实现的部分
  • 提供接口给TCP服务器调用
  • 查询数据库获得该传感器的所有WebHook地址
  • 访问这些地址，发送数据。