Forráskód Böngészése

docs: 启动教程以及常见问题处理

regan 2 éve
szülő
commit
2f1717d629

+ 72 - 1
README.md

@@ -69,7 +69,6 @@ Vertx event-bus(内置)、RocketMQ,通过扩展模块可接入其它任意
 
 管理员账号密码:admin/admin123
 
-
 **注:** es版本为7.15.2,mysql版本为8.0+
 
 ##### 关系数据库切换为mysql方法(其它数据库同理)
@@ -90,6 +89,52 @@ Vertx event-bus(内置)、RocketMQ,通过扩展模块可接入其它任意
 
 2、application.xml中打开rocketmq配置
 
+#### 项目结构
+
+├data	初始化数据
+│  ├components
+│  ├converters
+│  ├init
+├doc
+├docker-compose
+├iot-common	基础框架
+│  ├iot-common-core
+│  ├iot-common-dao
+│  ├iot-common-doc
+│  ├iot-common-excel
+│  ├iot-common-log
+│  ├iot-common-oss
+│  ├iot-common-redis
+│  ├iot-common-satoken
+│  ├iot-common-tenant
+│  ├iot-common-web
+│  ├iot-common-websocket
+│  ├iot-message-bus
+│  ├iot-script-engine
+├iot-components	通讯组件
+│  ├iot-component-base	
+│  ├iot-component-converter
+│  ├iot-component-oss
+│  ├iot-component-server
+│  ├iot-component-tcp
+│  ├iot-ctwing-component
+│  ├iot-DLT645-component
+│  ├iot-emqx-component
+│  ├iot-http-biz-component
+│  ├iot-mqtt-component
+│  ├iot-websocket-component
+├iot-module	业务模块
+│  ├iot-generator	代码生成
+│  ├iot-manager	管理业务
+│  ├iot-message-notify	消息转发
+│  ├iot-rule-engine	规则引擎
+│  ├iot-screen	数据大屏
+│  ├iot-system	通用菜单权限管理
+├iot-starter	启动包
+├iot-test-tool	测试模块
+│  ├iot-test-mqtt
+│  ├iot-virtual-device
+
 
 #### 运行步骤
 1、安装jdk11
@@ -100,6 +145,32 @@ Vertx event-bus(内置)、RocketMQ,通过扩展模块可接入其它任意
 
 4、若出现报错,可能是数据没有初始化完或重复初始化,把项目根目录下.init文件和data/iotkit.xx文件删除后重启
 
+在配置好相应的jdk11环境后,推荐使用idea拉取代码,等待项目加载完成以后,先在Terminal里执行mvn clean install,然后在idea的maven操作框上点击下刷新![image-20230702173737805](doc\image-20230702173737805.png)
+
+然后就点击启动,看到如下所示日志即表示启动成功:
+
+![image-20230702174747305](doc\image-20230702174747305.png)
+
+#### 后端常见问题以及处理方式
+
+#### 1、数据初始化不成功
+
+删除以下标红的几个文件以及文件夹后,重复下上面启动项目的操作:
+
+![image-20230702173852342](doc\image-20230702173852342.png)
+
+切换成外置中间件数据库时,也注意删除相关库以及数据。
+
+##### 2、提示找不到QTbxxxxx类
+
+在Terminal里执行mvn clean install,再刷新下,这个出现的原因是因为采用了querydsl插件,打包时会生成相关的类,有可能idea的扫描不及时,导致未识别到
+
+![image-20230702173737805](doc\image-20230702173737805.png)
+
+##### 3,启动提示xxMapperxxx类bean重复
+
+处理办法同2一样,原因也类似,采用了mapstruct plus插件,打包时候会生成对应类的getset方法工具类,可能idea的扫描不及时,导致未识别到
+
 
 #### 服务器部署
 

BIN
doc/image-20230702173737805.png


BIN
doc/image-20230702173852342.png


BIN
doc/image-20230702174747305.png