# simplePortal

**Repository Path**: covenlonki/simplePortal

## Basic Information

- **Project Name**: simplePortal
- **Description**: 简单的公司门户网站
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2022-12-12
- **Last Updated**: 2025-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# simplePortal

#### 介绍
简单的公司门户网站
后台管理页面使用freemarker生成
使用shiro增强后台管理安全性和可配置性

#### 软件架构
1. 核心框架：springboot 2.5.6
2. 数据层: spring data jpa，hibernate
3. 项目构建工具：maven
4. Web容器：tomcat
5. 前端框架：layui
6. 数据交互：ajax
7. 数据库使用MySQL 5.7及以上版本（项目在第一次运行时，会自动创建相应的表格）
   请注意查阅服务实现层中，使用了@PostConstruct注解的部分，项目运行启动时，会自动检查权限、角色和管理员账号是否存在，若不存在，将自动创建；
   若已存在，将跳过（不进行任何操作）。


#### 系统结构
1. 前端页面
   1> 门户网站
     静态html页面，放置在src\main\resources\static\html路径下
     注：静态资源，存放在src\main\resources\static\路径 注：虽说是静态页面，但不可脱离项目单独使用，因为jq和layui是通过webjar引入，项目没有启动时无法正常载入
   2> 管理端页面
     使用freemarker模板生成（后端生成）页面,模板文件放置在src\main\resources\templates路径下

2. 后端代码（主要区分为后台管理部分(路径包含‘mgt’)和门户网站部分(路径包含‘web’)）
   1> controller 接口层 代码均有javadoc注释
   2> service 服务层
   3> dao 数据层
   4> entity 领域实体类
   5> pojo 数据实体类


#### 安装教程
1. 项目可通过maven打包成一个war，放入tomcat运行。
2. 导入开发工具eclipse或idea，可直接运行SimplePortalApplication.java启动项目。
3. 打包或运行前，请注意修改application.yml中的配置。
4. 项目运行前，请创建数据库（请注意修改yml配置文件），系统在运行后会自动创建数据库表并录入管理员信息。


#### 使用说明
1. 项目默认使用8088端口。
2. 通过/、/index、/index/、/index.html、/index.html/、/html、/html/、/html/index接口都可访问门户网站主页，如http://localhost:8088/html
3. 网站采用了响应式布局，目前移动端显示效果还在优化中。
4. 通过/mgt接口访问门户网站后台管理端，如http://localhost:8088/mgt/index
5. 管理端默认用户名：admin，密码：123456
6. 每日23点清理未使用的文件（目前清理时间写死在代码里，后续增加上传文件管理和任务配置）。
7. 系统集成knife4j，通过http://localhost:8088/doc.html 访问API接口文档。


#### 贡献
1. covenlonki