# WebOrganizationTree
**Repository Path**: MuYiii/web-organization-tree
## Basic Information
- **Project Name**: WebOrganizationTree
- **Description**: Web组织结构可视化工具
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-12-12
- **Last Updated**: 2024-03-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# WebOrganizationTree
## 介绍
组织结构可视化Web工具
## 软件架构
## 开发环境配置
### Windows环境配置
下载的内容过慢可以直接从[网盘处](https://pan.baidu.com/s/1JJV4vAl_XTD_jlltF86Q-Q?pwd=uj6k)下载
#### Git工具下载（可选）
注：进运行不需要Git工具，如果需要开发并提交进本仓库则需要安装改工具
- 从[Git网站](https://git-scm.com/download/win)下载安装文件
- 运行下载的exe执行文件，一路点击继续即可
- 打开命令行（CMD），运行`git -h`，如果出现Git帮助文本，表示安装成功
#### Postgresql数据库安装
可以参考[知乎文章](https://zhuanlan.zhihu.com/p/484450913)进行安装，注意文章安装版本为14.2.1，项目所用版本为12.17！
- 从[Postgresql网站](https://www.enterprisedb.com/downloads/postgres-postgresql-downloads)下载，选择12.17版本
- 以**管理员身份运行**下载的exe文件开始安装
- 根据提示设置超级用户密码、选择区域即可
- 打开命令行（CMD），切换到软件安装目录中的`bin`目录中，运行`pg_ctl start -D [数据库DATA目录]`，最后出现“服务器进程已经启动”，表示安装成功
#### 下载jdbc库
- 手动下载[jdbc文件](https://jdbc.postgresql.org/download/postgresql-42.3.4.jar)，放置到项目目录下`./backend/main/lib`目录下
#### Java环境安装和设置
- 从网盘下载并安装Java jdk
- 配置环境变量，右键我的电脑-属性-高级系统设置-环境变量
- 在系统变量中点击“新建”，变量名为`JAVA_HOME`，变量值为Java安装路径，如`C:\Program Files\Java\jdk1.8.0_131`
- 编辑系统变量的`Path`，在其中新建两个变量，分别设为`%JAVA_HOME%\bin`和`%JAVA_HOME%\jre\bin`
- 在系统变量中点击“新建”，变量名为`CLASSPATH`，变量值为`.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar`
- 在命令行（CMD）中输入`java -version`和`javac -version`，如果输出版本信息，表示安装成功
#### apache安装和配置
可以参考[文章](https://blog.csdn.net/qq_32596527/article/details/110870754)进行安装
- 从[apache网站](https://www.apachelounge.com/download/)下载软件
- 解压软件到任意目录
- 编辑软件目录下`conf/httpd.conf`文件，修改`Define SRVROOT "/Apache24"`行中的`/Apache24`为软件安装目录
- 打开命令行（CMD），切换到在软件安装目录下的`bin`目录，运行`./httpd -k install`和`./httpd -k start`
- 浏览器打开`http://localhost`，能看到apache帮助页面，表示安装成功
### Linux环境配置
下载速度过慢请尝试给apt换源
#### Postgresql数据库安装
- 安装Postgresql：`sudo apt install postgresql`
#### 下载jdbc
- 手动下载[jdbc文件](https://jdbc.postgresql.org/download/postgresql-42.3.4.jar)，放置到项目目录下`./backend/main/lib`目录下
- 或运行脚本自动下载：`./scripts/download_dependency.sh`
#### Java环境安装和设置
- 安装java：`sudo apt install openjdk-8-jre-headless -y`
- 验证安装结果：终端运行`javac -version`，能够输出版本信息说明安装成功
#### apache安装和配置
- 安装apache：`sudo apt install apache2`
- 验证安装结果：浏览器打开`http://localhost`，能看到apache帮助页面说明安装成功
## 运行说明
- 请确保环境配置成功，且数据库服务正在运行
- 导入测试数据库
```bash
createdb hong-lou-meng
psql hong-lou-meng < ./resources/hong-lou-meng.sql
```
- 设置数据库配置，修改`backend/resources/db.conf`中的`username`和`password`
- 命令行编译并运行Java程序
```bash
# Win CMD下运行`setenv.bat`，Win PowerShell下运行`setenv.ps1`
# Linux下运行`setenv.sh`
./scripts/setenv.sh # 为jdbc设置CLASSPATH环境变量
cd backend/main/java/com/JiXing
javac -d ./ ./*.java -encoding utf-8
java App
```
- 复制前端页面到apache设置的目录下
- Win需要手动将`frontend`目录下的文件复制到Apache安装目录下的`htdocs`目录中
- Linux可使用脚本自动将前端文件复制到`/var/www/html`内，`sudo ./scripts/install_frontend.sh`
- 浏览器打开`http://localhost`查看运行结果
## 参与贡献
1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request
## 特技
1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)