# 数字院jeecg项目模板

**Repository Path**: hu-qing21/ncme-digital-jeecg-demo

## Basic Information

- **Project Name**: 数字院jeecg项目模板
- **Description**: 12345678910
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 37
- **Created**: 2024-04-19
- **Last Updated**: 2024-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 第〇步：改名 6

> 1、改文件夹名

先在文件资源管理器中修改本项目的文件夹名字

> 2、改模块名

在左侧项目目录中右键 `ncme-business-module` - `Refactor` - `Rename` - `Rename module and dictionary`
，同时修改模块名和文件夹名，建议改为“ncme-business-{你的项目缩写}”

> 3、改swagger文档名

为了文档查看方便，强烈建议命名文档标题

依次打开：

    jeecg-boot-base-core
      /src/main/java/org/jeecg
        /config/swagger/Swagger2Config.java

在配置类的`apiInfo()`方法中修改大标题

# 第一步：初始化数据库

方式一：

> 1、确定数据库名

编辑项目目录下 `./db/mysql-jeecg-pure.sql` ，将前两行里的数据库名改为新数据库名

    CREATE DATABASE `{新数据库名}`
    USE `{新数据库名}`;

> 2、执行该sql文件建库

方式二：

> 1、查询页加载SQL文件

打开HeidiSQL，新建查询页，将`./db/mysql-jeecg-pure.sql`直接拖至查询页。

> 2、修改数据库名并执行

将前两行的数据库名修改后右键执行即可

# 第二步：修改 yml 配置

转到`jeecg-module-system\jeecg-system-start\src\main\resources`，一般关注两个环境：

* 开发环境：`application-dev.yml`
* 生产环境：`application-prod.yml`

> 1、修改端口号

    server
      port: 默认8080

> 2、修改数据库配置

首要配置`datasource`和`redis`

    #示例
    spring:
      datasource:
        dynamic:
          datasource:
            master:
              url: jdbc:mysql://192.168.66.8:3306/jeecg_pure_db?characterEncoding=UTF-8&useUnicode=true&useSSL=false&tinyInt1isBit=false&allowPublicKeyRetrieval=true&serverTimezone=Asia/Shanghai
              username: root
              password: NCME2020
              driver-class-name: com.mysql.cj.jdbc.Driver
      redis:
        database: 5
        host: 127.0.0.1
        port: 6379
        password: ''

> 3、修改上传文件夹路径

用于保存上传文件：

    jeecg:
     path:
      upload: /opt/ncme/{比如你的项目名称} 

# 第三步：检查其他配置项

> 1、确认JDK版本

Ctrl + Shift + Alt + S 打开项目结构设置，确认jdk1.8版本

> 2、确认maven配置

右侧打开maven设置，确认maven主路径、配置文件路径和本地仓库路径正确

> 3、修改启动配置

修改启动配置：`Modify Run Configuration`(第一次启动)或`Edit Configuration`

（1）配置测试环境，将`Active profiles`置为`dev`
（2）配置缩短命令行，点击`modify options`，勾上`shorten command line`，并在多出来的配置项中选择`JAR manifest`

__IDEA非专业版注意__

非专业版中没有上述的选项，则在父级pom中做修改，将要启用的profile下加上`activation`配置项

``` xml
<profiles>
  <!-- 开发 -->
  <profile>
      ...
      <activation>
          <!--默认激活配置-->
          <activeByDefault>true</activeByDefault>
      </activation>
   ...
  ...
</profiles>
```

# 第四步：测试启动

运行`jeecg-module-system` - `jeecg-system-start`中的`JeecgSystemApplication`。

成功的话打开swagger文档看一下

# 第五步：添加 Gitee仓库

> 1、清除模板git

删除根目录下的.git文件夹

> 2、初始化git

在gitee上新建空仓库，然后在项目根目录下执行以下命令：

（拿到仓库地址后替换掉下面HTTPS地址，直接整段粘贴至终端运行）

    git init
    git add .
    git commit -m "first commit"
    git remote add origin 【自己的仓库HTTPS地址】
    git push -u origin "master"

# 第五步：后端部署

在`maven选项卡`中的`Profiles`中勾选`prod`。

## jar部署方案

直接打包start模块成jar，即可运行

## war部署方案

> 1、改pom

标签指定打包方式：

    <packaging>war</packaging>

删除插件：

	<plugin>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-maven-plugin</artifactId>
	</plugin>

> 2、改WebSocketConfig配置

注释掉下面方法：

    //    @Bean
    //    public ServerEndpointExporter serverEndpointExporter() {
    //        return new ServerEndpointExporter();
    //    }

> 3、打包

可能需要先install再package

# 第六步：前端部署

> 1、用git克隆项目：https://gitee.com/jeecg/jeecgboot-vue3.git

> 2、进入根目录后，用vscode打开

前置环境:

* pnpm
* node

# 第七步:前端配置

> 1、依赖安装

右键根目录文件点击`在集成终端打开`，输入如下命令

``` shell
# 根目录下执行
pnpm install
```

> 2、配置接口

根目录打开文件`.env.development`，修改如下位置

``` javascript
VITE_PROXY = [["/jeecgboot","http://[自己的ip：端口]/jeecg-boot"],["/upload","http://localhost:3300/upload"]]
VITE_GLOB_DOMAIN_URL=http://[自己的ip：端口]/jeecg-boot
```

# 第八步：运行前端

右键根目录文件点击`在集成终端打开`，输入如下命令

``` shell
# 根目录下执行
pnpm run dev
```
# 第九步：代码生成
## GIS代码生成
1. 在jeecg前端`低代码开发-Online表单开发`中，选择`导入数据库表`，勾选要生成的GIS数据库表（目前仅支持Mysql版本）
2. 在列表中勾选新添加的GIS表，点击代码生成（目前仅支持一次生成一张表），使用前需确定GIS数据表中包含the_geom字段
3. 生成的代码在Swagger中会自动生成一个名为 "queryGeoJSON" 的接口方法，其中参数`isPackaged`默认为`false`，返回结果不包含result包装体；参数为`true`返回Result包装体格式