some changes

产品/开放平台/开放平台接口文档(内部版).md

@@ -12,6 +12,9 @@
 | 1.0.3 | `UDP`协议电量查询，实现按月、按天、按小时查询。              | 季建新 | 2021.2.21 |
 | 1.0.4 | 获取`HTTP`协议模块是否在线; 模块和项目绑定；模块和项目解除绑定；获取60分钟内负荷; 获取任意多开关任意时间段内的电量。 | 季建新 | 2021.3.19 |
 | 1.0.5 | 获取项目下的模块；获取项目下的所有模块及线路；获取任意多个线路的累积负荷；获取任意多开关任意时间段内的按小时、按天、按月电量；获取任意多开关任意时间段内的电量。 | 季建新 | 2021.3.22 |
+| 1.0.5 | 获取任意多模块任意线路任意时间段内的电压或负荷；获取任意多模块任意线路最近24小时内的电压或负荷 | 季建新 | 2021.4.1  |
+
+
 
 
 
@@ -1317,3 +1320,81 @@ DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3
 }
 ```
 
+
+
+## 获取任意多模块任意线路任意时间段内的电压或负荷
+
+请求
+
+```
+POST http://47.103.61.198:5008/api/breaker/real/random
+
+Headers:
+
+Content-Type: application/json
+DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3
+
+{
+	"StartYear":2021,
+	"StartMonth":3,
+	"StartDay":1,
+	"StartHour":2,
+	"EndYear":2021,
+	"EndMonth":3,
+	"EndDay":5,
+	"EndHour":2,
+	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
+	"Type":1 //Type为0表示请求负荷，为1表示请求电压
+}
+```
+
+
+
+响应
+
+```
+{
+    "data": {
+        "total": "221.495"
+    },
+    "isError": false,
+    "message": "success",
+    "code": 200
+}
+```
+
+
+
+## 获取任意多模块任意线路最近24小时内的电压或负荷
+
+
+
+请求
+
+```
+POST http://47.103.61.198:5008/api/breaker/real/latest
+
+Headers:
+
+Content-Type: application/json
+DD-Open-Key: bde2d876-993d-440d-aba1-3a06007a25a3
+
+{
+	"MacAddrs":["187ED5311111_1", "187ED5322222_2"],
+	"Type":0 //Type为0表示请求负荷，为1表示请求电压
+}
+```
+
+响应
+
+```
+{
+    "data": {
+        "total": "1.162"
+    },
+    "isError": false,
+    "message": "success",
+    "code": 200
+}
+```
+

产品/智能照明版/智能照明2.0.0模块化.md

@@ -0,0 +1,5 @@
+- 模块自描述：包括模块程序集名称、显示名称、版本
+- 模块可配置：通过总部运营后台配置
+- 自洽的：包括领域层、设施层、应用程序层、接口层
+- 具备基础支撑：基础领域层、基础设施层、基础类库层
+- 模块间可通讯：通过事件订阅

产品/智能照明版/智能照明2.0.0版后端.md

@@ -0,0 +1,515 @@
+> 后端讨论希望达成的目标：1、走通所有细节；2、表设计；3、任务分配；4、开始工作 
+
+# 1、前提 
+
+## 1.1 质量要求
+
+高可用
+
+```
+程序Down掉能重启：https://www.yuque.com/smartstone/nx/agent
+```
+
+高性能
+
+```
+响应时间：1秒以内
+吞吐量：200个模块、5000个开关、5秒一次的上传频率
+```
+
+高扩展
+
+```
+不同设备，不同协议
+```
+
+## 1.2 相关系统
+
+```
+--智能照明版：局域网，前后端分离，后端提供接口
+--总部运营版：云端，提供给智能照明版相关接口
+--电工端：云端，后端提供接口
+--局域网开放平台：局域网，提供给智能照明版有关设备和数据的接口
+--局域网调度平台：管理背景作业
+```
+
+## 1.3 安装
+
+实际需要安装部署方案，安装手册等。
+
+```
+--安装成服务：https://www.yuque.com/smartstone/nx/agent 
+--容器：先放一下，以后再说。
+```
+
+
+
+## 1.4 功能模块化
+
+```
+--所有功能在一个应用程序内，一次性加载，通过总部运营后台配置(一定可以做)
+--一个接口一个组件，动态加载，通过总部运营后台配置(决定做，对后期多项目开发影响巨大)
+```
+
+
+
+## 1.5 架构
+
+```
+DC.DDD.Domain
+DC.DDD.Infrastructure
+DD.Infra
+DD.Libs
+DD.ZNZM.Infra
+DD.ZNZM.Application
+DD.ZNZMP.API
+```
+
+
+
+## 1.6 脚手架
+
+```
+为各个版本打下基础
+
+--办公楼版
+--智能照明版：目前2.0，未来对单灯的控制
+--能耗版：接入三相，电量是重点
+--物流版：接入利群物流产业园内的各种设备数据
+--学生公寓版：对负荷的控制
+--工地版：管理工地用电
+--铁塔版：5G基站远程用电管理，电量计量
+```
+
+
+
+## 1.7 采用`Endpoint`模式
+
+```
+弃用Controller，采用Endpoint模式
+```
+
+
+
+## 1.8 外网接通性
+
+在智能照明版中，认定外网安装系统时是可以接通的，可以保证平常没有外网的情况下，系统也可以工作。
+
+
+
+
+
+# 2、总部运营版
+
+
+
+总部运营后台。销售员创建项目。
+
+```
+IsProject=1, IsProject=1表示这个组织有其数据库相关配置
+Name
+
+备注：如果不是具有数据库相关组织，IsProject=1;如果是调用开放平台接口的第三方，那么IsProject=0, IsThirdPaty=1；
+```
+
+财务审核项目，最终`CEO`审核通过。意味着可以对项目进行后续安装施工运维了。
+
+
+
+总部运营后台。管理员为项目设置基本信息。
+
+```
+NSpace: 用来表示在Redis缓存中的命名空间，当需要查询模块的实时数据，就会到这个命名空间中去找。项目的命名空间需要同步给开放平台，因为只有开放平台才收到模块的数据，并把数据根据命名空间存入Redis缓存。开放平台在什么时候知道项目的命名空间呢？是在总部运营后台，当把模块和项目进行绑定的时候，把该项目的命名空间同步给开放平台。
+
+APIKey: 给调用开放平台的第三方使用。如果组织是第三方合作公司，需要为项目设置APIKey。也是在模块和项目进行绑定的时候，把APIKey同步给开放平台。然后第三方方，才可以吧APIKey放在Header中调用开放平台接口。
+
+Version: 这个字段在总部运营后台的数据库hd_new中，暂时还没有，需要加上，用来表示项目属于哪个版本。
+```
+
+
+
+总部运营后台。管理员为项目配置数据库相关。
+
+```
+包括关系数据库、时序数据库、Redis数据库等。
+
+这些配置会在项目现场安装的时候，在控制台上依次选择执行，默认从云端获取这些配置，分别创建生成各种数据库。
+```
+
+
+
+总部运营后台。管理员为项目设置授权。
+
+```
+-- 使用Key
+-- 把Key保存在硬盘上，不保存在Cookie
+```
+
+
+
+总部运营后台。管理员为项目设置功能模块。
+
+```
+--基础模块：为所有项目版本可以共用的功能模块
+--版本模块：为某个项目版本特定开发的功能模块
+```
+
+
+
+总部运营后台。管理员为项目设置位置。
+
+```
+位置信息、配电间信息、电箱信息会在工程部的CAD图纸上预先标明。
+
+--设置无限级位置：大楼、楼层、区域....一版最多设置五级就够了
+--设置配电间
+--设置配电间内的电箱：电箱编号
+```
+
+
+
+总部运营后台。管理员输入模块。
+
+```
+-- 模块号：目前手动录入。以后通过批量导入，或者扫描枪扫码入库。
+-- 模块通讯方式：HTTP， UDP等等
+-- 模块软件版本
+```
+
+
+
+总部运营后台。管理员把模块和项目进行绑定。
+
+```
+--总部运营后台的projectmac记录关系
+--需要调用开放平台接口，把模块的NSpace, APIKey, 通讯方式同步给开放平台
+
+1、总部projectmacs表如下：
+Mac
+OrganizationId
+BindTime
+UnBindTime
+Protocol
+
+
+2、开放平台的projects表记录项目信息：
+NSpace
+APIKey
+
+3、开放平台的macs表记录如下：
+Mac
+ProjectId
+ProtocolType
+```
+
+
+
+
+
+总部运营后台。管理员创建电工。
+
+```
+首先会创建一个名称为总部的Organization, 然后为总部添加一个员工Employee, 并分别在User和UserRole中增加一条记录。
+```
+
+
+
+总部运营后台。管理员设置电工和项目的绑定。
+
+```
+相当于电工和某个版本的项目进行了绑定。
+```
+
+# 3、电工版
+
+
+
+电工版。电工登录后，选择项目。点击"位置上传",  扫描模块的二维码或者选择手动输入，点击确定。位置和模块信息存入总部。
+
+# 4、智能照明版
+
+
+
+智能照明版。电工点击可执行文件，自动安装时序数据库、`MySQL`、`Redis`, 初次使用默认用户名和密码，数据库信息放配置文件中，使用加密字符串。
+
+
+
+智能照明版。电工登录，如果还没有授权，进入授权页，电工输入`Key`， 系统内部会把`Key`存入硬盘，调用总部验证接口验证通过(总部记录操作记录，启用时间，操作人，等等)，然后跳转到登录页。
+
+
+
+智能照明版。电工登录，最终点击位置管理中的开关管理。
+
+```
+--电工点击下载按钮
+--电工在excel表格中输入开关的名称、第几行、第几列
+--电工上传表格
+
+在Breaker领域中：
+Row
+Column
+Addr
+
+
+```
+
+
+
+智能照明版。电工手动创建或者批量导入员工。默认员工的角色是游客。
+
+
+
+智能照明版。电工在权限管理中，把某个游客设置为管理员，管理员只有一个。电工完成工作。
+
+
+
+智能照明版。管理员登录，在权限管理中，把某个游客设置为操作员或电工。
+
+
+
+智能照明版。管理员为操作员或电工分配开关。
+
+
+
+智能照明版。管理员或电工创建场景。如果电工创建了某个场景，这个场景自动归属于这个电工。当然，同样的场景可以指定给不同的电工或操作员。
+
+```
+--关于同一个开关，在同一时间有多个合闸、分断怎么办？
+
+原则：同一个开关，如果在1分钟之内有多个指令冲突，就在场景编辑的开关列表中文字备注说明或者图标说明该开关有冲突。鼠标移动上备注说明文字或图标上时，气泡显示冲突细节，包括：和哪个场景的哪个开关时间冲突，然后建议修改开关场景触发时间或者把开关从该场景中删除。
+
+--开关状态
+
+判断场景执行情况时的开关状态，是从实时数据中取出来的状态。
+
+--场景历史执行
+
+记录执行失败的情况。记录每次场景的开关总数，未执行原因，等等。
+
+--场景执行结果
+对某个开关来说，10：00执行场景，这个场景中的最后一个开关10：02执行完毕，在QUartz中保存两条记录，一条是10：00，表示开始执行场景；另一条是10：02，表示开始判断执行结果，从实时数据中获取，并且把失败执行结果保存起来。
+
+```
+
+
+
+
+
+首页
+
+```
+--场景：当日哪些执行的
+
+--总负荷如何计算？
+每个开关的最大负荷=linetype * specification
+
+--首页数据
+首先背景作业每隔一段时间把首页数据统计到某个专属表或缓存里，这样首页打开的速度就会快；另外，再有一个背景作业，不断地把首页的变化数据通过长连接(推荐使用SignalR)推送到首页。
+
+--场景监测
+在判断场景执行结果时，通过SignalR往首页主动推送场景的执行结果。
+
+```
+
+
+
+首页点击进入的报警详情
+
+```
+同一开关的报警记录是从时序数据库的历史报警中获取
+```
+
+
+
+首页点击进入，场景执行详情
+
+| 重新执行次数 | 场景未执行原因 | 建议方案                     |
+| ------------ | -------------- | ---------------------------- |
+| 1, 2         | 模块离线       | 已上报，正在处理             |
+| 1, 2         | 开关离线       | 已上报，正在处理             |
+| 1,2          | 线下手动分断   | 已上报，正在处理             |
+| 1            | 未知原因       | 重新执行按钮                 |
+| 2            | 未知原因       | 重新执行按钮                 |
+| 3            | 未知原因       | 已重试两次，已上报，正在处理 |
+
+```
+--点击重新执行按钮
+
+点击的这行有一个加载按钮，这一行不允许再次点击，大概5-10秒，通过SignalR反馈结果。
+```
+
+
+
+首页设置
+
+```
+授权成功后，把总部有关的设置信息保存到局域网数据库
+```
+
+
+
+位置管理
+
+```
+--加载第一级位置信息，如果没有
+
+提醒电工登录电工端上传位置信息。
+
+--修改
+
+修改的时候调用总部接口。
+
+--无限级
+
+支持无限级，但实际级数不会太多。
+```
+
+
+
+开关健康管理
+
+```
+
+判断是否有外网的解决办法
+--把没有上传成功的攒下来到某个时间点批量上传
+--如果长时间没有上传，外网异常报警
+
+如何上报？
+
+前提是必须网络正常
+--自动上报
+--手动上报
+
+
+所有局域网开关健康数据汇总之总部云端数据库。
+
+开关健康指标定义策略：包括什么才算频繁跳闸次数、什么才叫多长时间不动作、什么叫异常负荷、什么叫高负荷(多长时间内)。
+
+--频繁跳闸次数
+
+从跳闸历史报警中获取。
+
+--长时间没有动作
+
+每一个开关都有一个动作记录表，记录所有的合闸和分断。开关动作记录表大致包括：
+时间
+操作人
+合闸或分断：合闸或分断分很多种，比如线下合闸、可视化合闸、场景自动触发合闸、场景手动触发合闸，等等。
+电流值：把动作之前最近一次实时数据的电流取到并保存
+电压值：
+负荷值
+
+--线上线下合闸分断次数
+
+从开关动作记录表获取。如果没有一次高负载，显示否；如果有多次高负载，记录高负载次数。开关动作还要记录每次动作当下的电流、电压、负荷等。
+
+--负荷异常次数
+
+--报警次数
+
+--预警次数
+
+--更换记录
+
+电工端来操作，包括模块或开关的更换。
+
+--高负载记录
+
+在时序数据库层面，实时数据中加一个合闸或分断的标签，求平均值时把分断状态的负荷排除出去。
+负载率=平均负载/额定负载
+```
+
+
+
+模块健康管理
+
+```
+--模块更换记录
+
+从总部获取。
+
+--离线记录
+
+从总部历史报警获取。
+
+
+```
+
+
+
+数据查询
+
+```
+--开关数据查询
+
+从时序数据库历史实时数据获取
+
+--报警数据查询
+
+从时序数据库历史报警获取。
+
+--负载数据查询
+
+从时序数据库历史实时数据获取
+
+--电费数据查询 
+
+一个小时两个时间点的电量。
+```
+
+
+
+# 5、开放平台
+
+- 合闸分断接口
+- 频繁跳闸次数判断
+- 历史实时数据
+- 报警查询
+
+
+
+# 6、系统监测
+
+```
+CPU
+内存
+网络
+应用程序挂掉
+```
+
+
+
+# 7、关于场景细节
+
+```
+--如果一个开关当前状态为线下手动分断(Control=false)，如果场景下的开关为合闸，如何处理这种情况？如何告知用户？
+
+原则：只要Control=false就不能控制。场景执行结果或可视化界面显示黄色按钮告知。
+
+--如果一个开关在多个场景中设置的时间点靠得很近怎么办？
+
+原则：
+-- 如果两个场景中的时间同一秒，后设置的这个不允许，并给提示。
+-- 如果两个场景中的时间相差几秒，允许。
+-- 根据开关场景设置的时间线判断
+-- 如果第一个场景执行失败， 重试根据时间线
+
+```
+
+
+
+# 调光灯设置负荷
+
+```
+需求：如果开关下的负载包括调光灯，在报警策略中设置功率限定，设置一个最小值和最大值，不在限定范围内就报警
+
+--如何实现？
+
+谁来设置开关是否是调光灯？电工在Excel中填写是否是调光灯。
+Breaker下应该有有一个字段表示是否包含调光灯
+在功率限定报警详情中包含两条记录，一个是上限，一个是下限
+
+
+
+```
+

运维/安装/2020淮安安装.md

@@ -24,7 +24,7 @@ ctl+alt+t
 - 确认当前目录：pwd(/home/dingding)
 - 创建目录：sudo mkdir tmp
 - 进入目录：cd tmp
-- sudo apt install curl
+- sudo apt-get install curl
 - 下载deb文件： sudo curl -OL https://dev.mysql.com/get/mysql-apt-config_0.8.15-1_all.deb 
 - 查看是否下载：ls
 - 安装：sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb
@@ -33,18 +33,49 @@ Warning: apt-key should not be used in scripts (called from postinst maintainers
 不理会
 ```
 - sudo apt-get update
+
 - sudo apt-get install mysql-server,输入root密码：teche123
+
 - mysql -u root -p
+
 - 创建用户：CREATE USER 'dd'@'%' IDENTIFIED BY 'dd@123';
+
 - 授权用户：GRANT ALL PRIVILEGES ON *.* TO 'dd'@'%';
+
 - 让授权生效：FLUSH PRIVILEGES;
+
 - 退出MySQL: exit;
+
 - 来到根目录： cd ~
+
 - 来到配置文件目录： /etc/mysql/mysql.d
+
 - 修改文件的权限：sudo chmod 666 mysqld.cnf
+
 - 修改配置文件：bind-address=0.0.0.0
+
+  ```
+  sudo apt-get intall nano
+  cd /etc/mysql/mysql.conf.d
+  nano mysqld.cnf
+  
+  mysql -u root -p
+  [Warning] World-writable config file '/etc/mysql/my.cnf' is ignored.
+  cd /etc/mysql
+  sudo chmod 775 my.cnf
+  mysql -u root -p
+  
+  
+  GRANT ALL PRIVILEGES ON *.* TO 'root'@'%';
+  UPDATE mysql.user SET host='%' WHERE user='root';
+  ```
+
+  
+
 - 查看状态：sudo systemctl status mysql
+
 - 重启服务：sudo systemctl restart mysql
+
 - 测试是否可以连接到服务器上的MySQL
 ```
 ping 192.168.8.116
@@ -55,9 +86,38 @@ sudo ufw status verbose
 其实用dd登录即可
 ```
 
+
+
+# 安装`MySQL`之二
+
+```
+https://www.fosstechnix.com/install-mysql-5-7-on-ubuntu-18-04/
+
+sudo mkdir tmp
+cd tmp
+sudo apt-get install curl
+sudo curl -OL https://dev.mysql.com/get/mysql-apt-config_0.8.15-1_all.deb 
+sudo dpkg -i mysql-apt-config_0.8.15-1_all.deb
+sudo apt-get update
+sudo apt-get install mysql-server
+mysql_secure_installation
+mysql -u root -p
+CREATE USER 'xx'@'%' IDENTIFIED BY 'xx@123'
+GRANT ALL PRIVILEGES ON *.* TO 'xx'@'%';
+FLUSH PRIVILEGES;
+sudo apt-get install nano
+sudo nano /etc/mysql/mysql.conf.d/mysqld.cnf
+bind-address = 0.0.0.0
+sudo systemctl restart mysql.service
+```
+
+
+
+
+
 # 安装Redis
 
-- 更新软件：suo apt update
+- 更新软件：sudo apt-get update
 - sudo apt install redis-server
 - 来到目录：/etc/redis
 ```
@@ -89,6 +149,31 @@ exit
 teche123
 ```
 
+# 安装`Redis`之二
+
+```
+sudo apt-get update
+sudo apt-get install redis-server 注意安装版本
+cd /etc/redis
+ls
+sudo chmod 777 redis.conf
+
+
+protected-mode:no
+# bind 127.0.0.1
+requirepass teche123
+
+sudo systemctl restart redis
+
+reids-cli -p 6000
+auth xx@123
+ping
+```
+
+
+
+
+
 # 准备
 
 - 连接MySQL数据库：192.168.8.109 3306 dd dd@123

运维/安装/2021.1.14Ubuntu配置固定IP方法.md

@@ -0,0 +1,35 @@
+```
+cd /etc/netplan
+ls
+ifconfig
+sudo apt install net-tools
+ifconfig
+	eno1
+sudo apt install nano
+sudo chmod 777 01-network-manager-all.yaml
+nano 01-network-manager-all.yaml
+```
+
+
+
+修改配置文件
+
+```
+network:
+  version: 2
+  renderer: NetworkManager
+  ethernets:
+    eno1:
+      dhcp4: no
+      addresses: [192.168.8.141/24]
+      gateway4: 192.168.8.1
+      nameservers:
+      	addresses: [192.168.8.1]
+```
+
+让生效
+
+```
+sudo netplan apply
+```
+

运维/安装/安装禅道.md

@@ -0,0 +1,157 @@
+# 安装
+
+- 解压缩到`/opt`目录下
+
+  ```
+  sudo tar -zxvf ZenTaoPMS.12.5.2.zbox_64.tar.gz -C /opt
+  ```
+
+- 一些命令
+
+  ```
+  /opt/zbox/zbox start
+  /opt/zbox/zbox stop
+  /opt/zbox/zbox  restart
+  /opt/zbox/zbox restart
+  ```
+
+- 打开网址
+
+  ```
+  192.168.8.141
+  ```
+
+- 管理员
+
+```
+admin
+Teche7208
+
+coder1
+Teche7208
+```
+
+- 修改`Apache`或`Mysql`端口
+
+```
+/opt/zbox/zbox stop
+/opt/zbox/zbox -ap 8080 -my 3307
+/opt/zbox/zbox start
+```
+
+- 访问数据库
+
+  ```
+  --设置用户名和密码
+  
+  cd /opt/zbox/auth
+  ./adduser.sh
+  root
+  123456
+  
+  --网页登录数据库
+  
+  服务器：127.0.0.1：3306
+  用户名：root
+  密码：123456
+  数据库：zentao
+  
+  -- 命令行连接数据库
+  
+  /opt/zbox/bin/mysql -u root -P 3306 -p
+  123456
+  show databases;
+  select version();
+  ```
+
+# 系统角色
+
+管理员
+
+- 维护公司
+- 添加用户
+- 维护权限
+
+
+
+项目经理
+
+- 创建项目
+- 维护模块
+- 维护计划
+- 维护需求
+- 创建发布
+
+
+
+迭代经理
+
+- 创建迭代
+- 维护团队
+- 关联项目
+- 关联需求
+- 分解任务
+
+
+
+研发人员
+
+- 领取任务和`Bug`
+- 更新状态
+- 完成任务和`Bug`
+
+
+
+测试人员
+
+- 撰写用例
+- 执行用例
+- 提交`Bug`
+- 验证`Bug`
+- 关闭`Bug`
+
+
+
+# 账号
+
+```
+
+禅道登录网址：http://192.168.8.141/zentao/my/
+
+
+用户名：congxiaolei
+密码：CongXiaoLei521
+
+
+用户名：maomin
+密码：MaoMin2020
+
+
+用户名：dadong
+密码：DaDong2020
+
+用户名：ChongChong
+密码：ChongChong
+
+
+用户名：XiaoMeng
+密码：XiaoMeng2020
+
+
+用户名：LvLiang
+密码：LvLiang2020
+
+
+用户名：LengJian
+密码：LengJian2020
+
+
+用户名：LingLuBing
+密码：LingLuBing2020
+
+
+用户名：LingPeng
+密码：LingPeng2020
+
+```
+