Pārlūkot izejas kodu

************* wx **********************************
中台工具整理方案

张维新 4 gadi atpakaļ
vecāks
revīzija
6ad6168e99

+ 11 - 0
docs/.vuepress/config.js

@@ -5,6 +5,7 @@ const dataCenterContent = require("../dev/data-center/index");
 const paasContent = require("../dev/paas/index");
 const revitCenterContent = require("../dev/revit-center/index");
 const sagaGraphyContent = require("../dev/saga-graphy/index");
+const dataCenterScheme = require("../dev/data-center-scheme/index");
 
 module.exports = {
     title: "数字化交付开发文档",
@@ -67,6 +68,15 @@ module.exports = {
                             { text: "系统图", link: "/dev/database/topo/" }
                         ]
                     },
+                    {
+                        text: "新版数据字典物理世界对接",
+                        items: [
+                            { text: "新版字典中台工具接口对接", link: "/dev/data-center-scheme/" },
+                            { text: "新版字典ADM对接", link: "/dev/data-center-scheme/" },
+                            { text: "新版字典对接数据中心", link: "/dev/data-center-scheme/" },
+                            { text: "新版物理世界对接数据中心", link: "/dev/data-center-scheme/" }
+                        ]
+                    },
                 ]
             },
             {
@@ -117,6 +127,7 @@ module.exports = {
             "/dev/paas/" : paasContent,
             "/dev/revit-center/" : revitCenterContent,
             "/dev/saga-graphy/": sagaGraphyContent,
+            "/dev/data-center-scheme/" : dataCenterScheme,
         }
     }
 };

+ 2 - 0
docs/dev/data-center-scheme/README.md

@@ -0,0 +1,2 @@
+# 数据中台字典、新版物理世界、新版ADM 对接方案
+

+ 3 - 0
docs/dev/data-center-scheme/dict-ADM.md

@@ -0,0 +1,3 @@
+# 新版字典ADM对接方案
+
+

+ 463 - 0
docs/dev/data-center-scheme/dict-dataplatform.md

@@ -0,0 +1,463 @@
+# 中台工具字典接口使用对接方案
+测试环境IP以及端口号
+```
+172.16.44.212:8081/paas
+```
+
+
+## 集团管理
+
+#### 查询所有集团列表 
+```
+POST: /usercenter/groupCompany/query
+```
+
+请求参数
+```
+{}
+```
+
+应答内容
+
+```
+{
+    "result": "success",
+    "data": [
+        {
+            "code": "SN",             集团id
+            "name": "苏宁集团"         集团名称
+        },
+        {
+            "code": "WD",
+            "name": "万达集团"
+        },
+        {
+            "code": "WK",
+            "name": "万科集团"
+        }
+    ],
+    "count": 3
+}
+```
+
+#### 添加集团
+
+```
+POST: /usercenter/groupCompany/save
+```
+请求参数
+```
+{
+    "code":"546455",      集团id
+    "name":"12123213"     集团名称
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success"
+}
+```
+
+#### 编辑集团信息 注意编辑集团和创建使用的同一个接口
+
+```
+POST: /usercenter/groupCompany/save
+```
+请求参数
+```
+{
+    "code":"546455",      集团id
+    "name":"12123213"     集团名称
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success"
+}
+```
+
+##### 中台工具中只修改集团名称,前端控制ID不可以修改,确保集团id入参是要修改集团ID否则会创建新的集团
+
+
+#### 集团字典搜索 功能前端自行筛选
+
+创建集团后,自动创建集团字典(字典默认为平台字典全部内容);并创建默认方案(默认为集团字典全部内容)
+
+创建集团后调用创建方案接口 ,然后调用方案订阅接口订阅所有类型,以及每个类型下的信息点
+
+#### 创建集团下默认方案
+
+```
+dict/scheme/create
+```
+
+请求参数
+
+```
+{
+    "groupId":"142563",             集团id
+    "note":null,                    备注
+    "name":"默认方案"                方案名称
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success",
+    "id":5
+}
+```
+
+
+方案中订阅类型  需要把平台级字典的所有类型查询出来  然后组合成数组调用方案订阅接口   
+方案种类型订阅信息点,需要把平台级的每个类型的信息点查出来,然后一个一个类型的信息点通过接口执行订阅
+
+## 项目管理
+
+#### 根据集团查询项目
+
+```
+POST: usercenter/project/query
+```
+
+请求参数
+
+```
+{
+    "criteria":{
+        "groupCompanyCode":"WK"   集团id
+    }
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success",
+    "data":[
+        {
+            "id":"Pj1106479820",
+            "name":"北京万科国际大厦",
+            "groupCompany":{
+                "code":"WK",
+                "name":"万科集团"
+            }
+        }
+    ],
+    "count":1
+}
+```
+
+#### 添加项目
+
+```
+POST: usercenter/project/save
+```
+
+请求参数
+
+```
+{
+    "id":"Pj3264971164",      项目id
+    "name":"测试项目",         项目名称
+    "groupCompany":{          
+        "code":"WK"           集团id
+    }
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success"
+}
+```
+#### 集团方案列表
+
+```
+POST: /dict/scheme/query
+```
+
+请求参数
+
+```
+{
+    "criteria":{
+        "groupId":"WD"  集团id
+    }
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success",
+    "data":[
+        {
+            "id":3,                         方案id
+            "name":"商业综合体",             方案名称
+            "groupId":"WD"                  集团id
+        },
+        {
+            "id":4,
+            "name":"酒店管理方案",
+            "note":"wanda03156",
+            "groupId":"WD"
+        }
+    ],
+    "count":2
+}
+```
+#### 项目设置集团方案
+
+```
+dict/scheme/project/set
+```
+
+请求参数
+
+```
+{
+    "criteria":{
+        "projectId":[    项目id列表
+            "Pj1101050029"
+        ]
+    }
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success"
+}
+```
+
+#### 编辑项目
+
+```
+POST: usercenter/project/save
+```
+
+请求参数
+
+```
+{
+    "id":"Pj1101050029",            项目id
+    "name":"东坝万达广场1",           项目名称
+    "groupCompany":{                集团对象
+        "code":"WD",                集团id
+        "name":"万达集团"            集团名称
+    }
+}
+```
+
+应答内容
+
+```
+{
+    "result":"success"
+}
+```
+
+## 集团字典
+
+### 集团字典管理
+
+#### 获取集团下类型树结构
+
+```
+ Get: dict/class?&groupId=WD&subFlag=false     //groupId: 集团id   subFlag: 是否显示所有子分类
+```
+
+应答内容
+
+```
+{
+    "result":"success",
+    "data":[
+        {
+            "code":"project",
+            "name":"项目",
+            "aliasCode":"project",
+            "aliasName":"项目"
+        },
+        {
+            "code":"building",
+            "name":"建筑",
+            "aliasCode":"building",
+            "aliasName":"建筑"
+        },
+        {
+            "code":"floor",
+            "name":"楼层",
+            "aliasCode":"floor",
+            "aliasName":"楼层"
+        },
+        {
+            "code":"space",
+            "name":"空间",
+            "aliasCode":"space",
+            "aliasName":"空间"
+        },
+        {
+            "code":"system",
+            "name":"系统",
+            "aliasCode":"system",
+            "aliasName":"系统",
+            "children":[
+                {
+                    "code":"system-AC",
+                    "name":"空调专业",
+                    "aliasCode":"system-AC",
+                    "aliasName":"空调专业",
+                    "children":[
+                        {
+                            "code":"ACAT",
+                            "name":"空调末端系统",
+                            "aliasCode":"ACAT",
+                            "aliasName":"空调末端系统",
+                            "parentCode":"system",
+                            "majorCode":"AC"
+                        },
+                        {
+                            "code":"ACAD",
+                            "name":"空调人防系统",
+                            "aliasCode":"ACAD",
+                            "aliasName":"空调人防系统",
+                            "parentCode":"system",
+                            "majorCode":"AC"
+                        }
+                    ]
+                },
+                {
+                    "code":"system-FF",
+                    "name":"消防专业",
+                    "aliasCode":"system-FF",
+                    "aliasName":"消防专业",
+                    "children":[
+                        {
+                            "code":"FFSC",
+                            "name":"防排烟系统",
+                            "aliasCode":"FFSC",
+                            "aliasName":"防排烟系统",
+                            "parentCode":"system",
+                            "majorCode":"FF"
+                        }
+                    ]
+                }
+            ]
+        },
+        {
+            "code":"equipment",
+            "name":"设备",
+            "aliasCode":"equipment",
+            "aliasName":"设备",
+            "children":[
+                {
+                    "code":"equipment-AC",
+                    "name":"空调专业",
+                    "aliasCode":"equipment-AC",
+                    "aliasName":"空调专业",
+                    "children":[
+                        {
+                            "code":"equipment-ACAT",
+                            "name":"空调末端系统",
+                            "aliasCode":"equipment-ACAT",
+                            "aliasName":"空调末端系统",
+                            "children":[
+                                {
+                                    "code":"ACATAH",
+                                    "name":"空调机组",
+                                    "aliasCode":"ACATAH",
+                                    "aliasName":"空调机组",
+                                    "parentCode":"equipment",
+                                    "majorCode":"AC",
+                                    "systemCode":"ACAT"
+                                }
+                            ]
+                        },
+                        {
+                            "code":"equipment-ACCH",
+                            "name":"中央供热系统",
+                            "aliasCode":"equipment-ACCH",
+                            "aliasName":"中央供热系统",
+                            "children":[
+                                {
+                                    "code":"ACCHWT",
+                                    "name":"供热水箱",
+                                    "aliasCode":"ACCHWT",
+                                    "aliasName":"供热水箱",
+                                    "parentCode":"equipment",
+                                    "majorCode":"AC",
+                                    "systemCode":"ACCH"
+                                }
+                            ]
+                        }
+                    ]
+                }
+            ]
+        }
+    ]
+}
+```
+
+
+
+
+
+
+
+
+
+## 注意事项
+1.某一个类型显示子分类功能新版字典还没有实现
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 
+
+

+ 8 - 0
docs/dev/data-center-scheme/index.js

@@ -0,0 +1,8 @@
+const content = [
+
+            ["/dev/data-center-scheme/dict-dataplatform", "中台工具字典接口使用对接方案"],
+            ["/dev/data-center-scheme/dict-ADM", "新版字典ADM对接方案"],
+            ["/dev/data-center-scheme/dict-dataplatform", "关系表设计"]
+];
+
+module.exports = content;

+ 222 - 5
docs/dev/paas/data-dict.md

@@ -1,4 +1,3 @@
-# 数据字典接口文档
 ### 术语说明:
 
 #### 平台级字典
@@ -33,13 +32,13 @@
 站在用户或数据字典使用方的角度来看数据字典有三层:平台级字典,集团级字典,项目级字典
 类型相同或信息点相同时项目级字典优先级最高,集团级次之,平台级字典最低,优先级高的会覆盖优先级低的
 
-使用数据字典时明确"使用的字典位于哪个层级"对需求的分析和理解会有很大帮
+使用数据字典时明确"使用的字典位于哪个层级"对需求的分析和理解会有很大帮
 
 集团级数据、集团方案、项目级数据是数据字典内部逻辑概念
 应用和服务应该关注的是项目级字典和应用订阅内容
 
 ```
-		
+
 
 ### 字段约定
 
@@ -118,9 +117,9 @@
 使用新的数据类型时,使用新的数据类型时,创建或编辑信息点需要明确指出数据类型、动静分类、是否复数、是否区间、长度(可选)、取值区间(可选)、格式(可选)
 Tree、Topology、Route、Function四种类型不再支持(有需求再加回来)
 
-动静分类(静态、脉冲、时序、阶段)应该是信息点的一个分类,不是数据类型的属性,放在这里是为了更直观更容易理解
+动静分类(静态 STATIC、脉冲 PULSE、时序 SEQUENTIAL、阶段 GRADATION)应该是信息点的一个分类,不是数据类型的属性,放在这里是为了更直观更容易理解
 根据动静分类区分动态量或静态量,静态量的值存储的是具体的数据,动态量的值存储的是表号-功能号,动态量包括脉冲量、时序量和阶段量
-根据是否区间来判断存储的值是具体值还是区间, 比如INT非区间的值12, 区间值[8, 15],为了区分开闭区间,这里实际存储为{$gt: 12, $lte: 15}, 其中$gt大于,$lt小于,$gte大于等于,$lte小于等于
+根据是否区间来判断存储的值是具体值还是区间, 比如INTEGER非区间的值12, 区间值[8, 15],为了区分开闭区间,这里实际存储为{$gt: 12, $lte: 15}, 其中$gt大于,$lt小于,$gte大于等于,$lte小于等于
 根据是否复数区分存储的值是单个值还是多个值,单个值存储形式为xxx,多个值存储形式为[xxx, yyy],如果同时是复数和区间,存储的是多个区间
 取值区间可以约束值的取值范围,可以通过取值区间做一次校验,如果是区间值,区间也应该是在取值区间的内部
 统一用DATETIME表示日期和时间,通过格式设定具体存储的内容,格式由数据字典进行维护,物理世界存储的数据严格符合格式
@@ -669,4 +668,222 @@ POST: /req/query
 |                         |        |                                      |      |
 |                         |        |                                      |      |
 
+#### 基础接口:批量添加应用订阅信息
+
+请求地址
+
+```
+POST: /app/funcid/add?groupId=SN&projectId=Pj01&app=test&classCode=project
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |   备注   |
+| --------- | --------------------------------------- | ---- |
+| classCode   | 类型编码                                | 必填 |
+| groupId   | 集团id                                  | 必填 |
+| projectId | 项目id                                  | 必填 |
+| app     | 应用id| 必填 |
+| json参数          |信息点列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+
+#### 基础接口:批量删除应用订阅信息
+
+请求地址
+
+```
+POST: /app/funcid/remove?groupId=SN&projectId=Pj01&app=test&classCode=project
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |   备注   |
+| --------- | --------------------------------------- | ---- |
+| classCode   | 类型编码                                | 必填 |
+| groupId   | 集团id                                  | 必填 |
+| projectId | 项目id                                  | 必填 |
+| app     | 应用id| 必填 |
+| json参数          |信息点列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+
+#### 基础接口:批量添加应用订阅类型
+
+请求地址
+
+```
+POST: /app/class/add?groupId=SN&projectId=Pj01&app=test
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |  备注    |
+| --------- | --------------------------------------- | ---- |
+| groupId   | 集团id                                  | 必填 |
+| projectId | 项目id                                  | 必填 |
+| app     | 应用id| 必填 |
+| json参数          |类型列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+#### 基础接口:批量删除应用订阅类型
+
+请求地址
+
+```
+POST: /app/class/remove?groupId=SN&projectId=Pj01&app=test
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |   备注   |
+| --------- | --------------------------------------- | ---- |
+| groupId   | 集团id                                  | 必填 |
+| projectId | 项目id                                  | 必填 |
+| app     | 应用id| 必填 |
+| json参数          |类型列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+
+
+#### 基础接口:批量添加方案订阅信息
+
+请求地址
+
+```
+POST: /scheme/funcid/add?schemeId=test&classCode=project
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |  备注    |
+| --------- | --------------------------------------- | ---- |
+| classCode   | 类型编码                                | 必填 |
+| schemeId     | 方案id| 必填 |
+| json参数          |信息点列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+
+#### 基础接口:批量删除方案订阅信息
+
+请求地址
+
+```
+POST: /scheme/funcid/remove?projectId=Pj01&schemeId=test&classCode=project
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |   备注   |
+| --------- | --------------------------------------- | ---- |
+| classCode   | 类型编码                                | 必填 |
+| projectId | 项目id                                  | 必填 |
+| schemeId     | 方案id| 必填 |
+| json参数          |信息点列表                                         |  列表size大于0    |
+
+返回参数
 
+```
+{
+    "result": "success"
+}
+```
+
+#### 基础接口:批量添加方案订阅类型
+
+请求地址
+
+```
+POST: /scheme/class/add?schemeId=test
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |   备注   |
+| --------- | --------------------------------------- | ---- |
+| schemeId     | 方案id| 必填 |
+| json参数          |类型列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```
+#### 基础接口:批量删除方案订阅类型
+
+请求地址
+
+```
+POST: /scheme/class/romove?schemeId=test
+```
+
+请求参数
+```json
+["ProjUnderArea","Group"]
+```
+
+| 参数名    | 说明                                    |    备注  |
+| --------- | --------------------------------------- | ---- |
+| schemeId     | 方案id| 必填 |
+| json参数          |类型列表                                         |  列表size大于0    |
+
+返回参数
+
+```
+{
+    "result": "success"
+}
+```