enjoy-iot-新手安装手册
摘要：
本文讨论了项目的快速入门相关内容，涵盖获取源码、开发环境、编译安装、运行项目以及Docker运行等方面的操作说明。关键要点包括：
- 获取源码：
- 后端代码拉取地址为 https://gitee.com/open-enjoy/enjoy-iot，
- 前端代码拉取地址为 https://gitee.com/open-enjoy/enjoy-web 。
- 开发环境：后端需JDK=1.8、Maven >= 3.6 ，多种数据库可选（部分sql脚本待补充），Redis >= 5 ，时序数据库可选择实现对应接口；前端需特定浏览器大版本号在100以上，nodeJs v18+ ，pnpm 。
- 编译安装：推荐使用IDEA ，项目默认jdk1.8（11、17也可），按步骤配置JDK ，下载后端代码后在根目录点击install 。
- 运行项目：基础设施搭建可选择Docker快速搭建或手动搭建；启动后端项目需新增host、修改连接配置后启动服务；前端项目可在编辑器或命令行操作启动，登录账号为admin/admin123
- Docker运行 ：docker官方仓库国内访问不便，需自行更新镜像源。
1 获取源码
拉取代码
2 开发环境
2.2.1后端环境
JDK >=1.8
Maven >= 3.6
2.2.2 基础设施
数据库(必须)(数据库脚本目前只有mysql8的):
PostgreSQL、Oracle、SQL Server、DM、大金 等其它数据库，也是可以的,目前sql脚本待补充Redis >= 5 (必须)
时序数据库-(必须):
时序数据库可选择自己熟悉的,实现对应的接口即可
TDengine = 3.3.2.0 (已实现)
Elasticsearch (已实现)
Timescale (待移植)
IotDB(待贡献)
- MQ(可选)
Kafka
等 - EMQX(可选)
2.2.3 前端环境
请使用下列浏览器，浏览器大版本号需在100以上。
- Chrome >= 100
- Firefox >= 100
- Edge >= 100
前端环境
- nodeJs v18+
- pnpm
2.3 编译安装
开发工具：推荐使用IDEA
2.3.0 IDE项目配置
项目默认使用jdk1.8版本(11,17也是可以的)
2.3.1 项目JDK配置
2.3.1 安装步骤
下载后端代码： https://gitee.com/open-enjoy/enjoy-iot， 使用 idea 打开项目，等待项目加载完成以后，打开 maven 栏在根目录点击 install:
点击按钮，重新加载项目：
2.4 运行项目
2.4.1 基础设施搭建
可以使用项目中的docker-compose快速搭建运行环境mysql,redis,tdengine等服务.如果已经有这些服务,则忽略
方式一：Docker搭建
方式二：手动搭建
搭建mysql
搭建redis
搭建tdegine
2.4.2 启动后端项目
1. 新增host
可以使用switchhost 进行 host 管理。
一般位置：【C:\Windows\System32\drivers\etc】
127.0.0.1 改成你实际部署的服务器地址
127.0.0.1 eiot-server-db
127.0.0.1 iot-server-redis
127.0.0.1 eiot-server-td
2.修改连接配置
根据application.yml 可以看出当前使能了application-eiot.yml,基本的连接配置都在里面
mysql配置:
redis配置:
tdengine配置
需要在tdengine中创建数据库“eiot”
使用默认的用户名和密码即可
3.启动后端服务
2.4.3 启动前端项目
方式1:编辑器中操作
执行pnmp install
点击运行项目
方式2:命令行方式
#进入前端项目目录
#安装扩展
pnpm install
#启动项目，须等后端项目启动后，再运行前端启动
pnpm run dev
- 启动后，正常验证码会出现
使用admin/admin123 登录系统
联系作者：1571228974