# yzpass-admin-template

**Repository Path**: yzpass/yzpass-admin-template

## Basic Information

- **Project Name**: yzpass-admin-template
- **Description**: YZPass-企业数据字化转型后台管理系统模板，后端基于 Java 21, Spring Boot 3.4 ,Mybatis-Plus, PostgreSQL数据库；前端基于 React 18, TypeScript, Ant Design 
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-01-19
- **Last Updated**: 2025-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# yzpass

## 介绍
YZPass-admin-template-是一个企业后台管理系统模板, 基于 java + react。期望以开源的方式，提供专业的管理后台模板，助力业务团队快速开发。


1. [**在线Demo**](http://demo.yzpass.com:8080/)
2. [**一个简单的商品管理页面的开发过程**](doc/product.md)
3. [**接口权限与按钮权限**](doc/authority.md)

首页
<img alt="" src="doc/home.png" style="border:solid #ccc 1px; display: inline-block;" />

用户管理页
<img alt="" src="doc/user.png" style="border:solid #ccc 1px; display: inline-block;" />

YZPass提供了以下前端功能：
1. 路由与菜单
2. 菜单权限
3. 按钮权限
4. 用户管理和角色管理
5. Tab内容的缓存
6. 基于i18n的多语言实现
7. 基于Redux实现的全局上下文
8. 集成antd
9. 基于axios的请求封装

YZPass提供了以下后端功能：
1. SpringBoot 3.4 的接口实现
2. Swagger集成
3. Postgres SQL 数据库集成
4. JWT集成
5. Mybatis-Plus集成
6. 领域设计理念

## 安装教程
### 前提条件
你需要基本的java 和 react 相关知识。安装以下软件
1. jdk 21
2. idea (推荐，当然你也可以使用其它开发工具)
3. maven 
4. PostgreSQL db数据库
5. Node 18或以上版本
6. Visual Studio Code
7. git(代码版本管理软件)
8. dbeaver (推荐使用的数据管理软件)

* 后端基于 Java 21, Spring Boot 3.4 ,Mybatis-Plus, PostgreSQL db数据库,推荐使用 Idea 进行java开发。
* 前端基于 React 18, TypeScript, 推荐使用 visual studio code 进行前端开发
* 基于git管理代码，使用 `git clone https://gitee.com/yzpass/yzpass-admin-template.git` 下载代码

### 后端开发步骤
1. 初始化 PostgreSQL 数据库，使用 doc/init.sql 初始化
2. 修改 api/src/main/resources/application.yaml 中的数据库配置
3. 启动 ApiApplication.java
4. 如果你能看到 Tomcat started on port 8080 (http) with context path '/' 这样的提示，就说明启动成功了。

### 前端开发步骤
1. cd web
2. `npm install` 安装依赖包 
3. `npm run dev` 打开开发环境开发的服务
4. 在浏览器里打开 http://localhost:3301 即可看到网页

## 生产构建

1.  在项目根目录下，直接 `mvn package` 完成构建，构建好的jar 在 api\target\ 下面

## 参与贡献
1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

[**特性愿景与贡献招募**](doc/feature.md)

## 软件架构
1. 领域设计
2. 高级表格
3. 可审计
4. 低维护成本
5. 定时任务
6. 权限控制
7. 接口设计

## 软件安全
1. API安全
2. 用户安全
3. 资源安全