# SmartAdmin

**Repository Path**: 3338904/smart-admin

## Basic Information

- **Project Name**: SmartAdmin
- **Description**: 🔥SmartAdmin以「高质量代码」为核心，「简洁、高效、安全」的快速开发平台；基于SpringBoot2/3+Sa-Token+Mybatis-Plus和Vue3 +Ant Design Vue+UniApp (提供JavaScript和TypeScript双版本、Java8和java17双版本)；满足三级等保、网络安全、数据安全等功能要求，同时重磅开源千余家企业在使用的《高质量代码规范》等
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://smartadmin.vip
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 4576
- **Created**: 2026-01-09
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# YFT-HOO 管理系统

## 项目简介

YFT-HOO 是基于 HooAdmin 框架开发的企业级中后台管理系统，采用前后端分离架构。项目专注于业务功能的快速开发，内置了完善的权限管理、系统监控、代码生成等核心功能模块。

### 技术架构

**后端技术栈：**
- Spring Boot 3.5.4
- MyBatis-Plus 3.5.12
- MySQL 8.0+
- Redis（Redisson 3.50.0）
- Sa-Token 1.44.0（权限认证）
- Knife4j 4.6.0（接口文档）
- Java 17

**前端技术栈：**
- Vue 3.4.27
- Ant Design Vue 4.2.5
- Vite 5.2.12
- Pinia 2.1.7（状态管理）
- Axios 1.6.8
- ECharts 5.4.3

## 目录结构

```
smart-admin/
├── doc/                          # 文档目录
│   └── yft_hoo.sql              # 数据库初始化脚本
├── hoo-parent/                   # 后端父项目
│   ├── hoo-base/                # 基础模块（公共组件、工具类等）
│   ├── hoo-admin/               # 管理后台模块
│   └── pom.xml                  # Maven 父配置
└── hoo-web/                      # 前端项目
    ├── src/                     # 源码目录
    │   ├── api/                # API 接口
    │   ├── components/         # 公共组件
    │   ├── views/              # 页面视图
    │   ├── router/             # 路由配置
    │   ├── store/              # 状态管理
    │   └── utils/              # 工具函数
    ├── package.json             # 依赖配置
    └── vite.config.js          # Vite 配置
```

## 快速开始

更多细节：
- 后端（hoo-admin）：`hoo-parent/hoo-admin/README.md`
- 前端（hoo-web）：`hoo-web/README.md`

### 环境要求

- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Redis 3.0+
- Maven 3.6+

### 后端启动

#### 1. 数据库初始化

```bash
# 创建数据库并导入初始化脚本
mysql -u root -p
source doc/yft_hoo.sql
```

#### 2. 配置文件修改

修改 `hoo-parent/hoo-admin/src/main/resources/dev/application.yaml` 配置文件：

```yaml
# 配置数据库连接
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/yft_hoo?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password

# 配置 Redis
redis:
  host: localhost
  port: 6379
  password: your_redis_password
```

#### 3. 编译运行

```bash
# 进入后端项目目录
cd hoo-parent

# Maven 编译打包
mvn clean install

# 启动后端服务
cd hoo-admin
mvn spring-boot:run

# 或者使用 IDE 直接运行 AdminApplication.java
```

后端服务默认运行在：`http://localhost:1024`

### 前端启动

#### 1. 安装依赖

```bash
# 进入前端项目目录
cd hoo-web

# 安装依赖（推荐使用 pnpm 或 yarn）
npm install
# 或
pnpm install
```

#### 2. 启动开发服务器

```bash
# 本地开发环境
npm run localhost

# 或开发环境
npm run dev
```

前端服务默认运行在：`http://localhost:8081`（代理到后端 `http://127.0.0.1:1024/`，以 `hoo-web/vite.config.js` 为准）

#### 3. 构建生产环境

```bash
# 测试环境
npm run build:test

# 预发布环境
npm run build:pre

# 生产环境
npm run build:prod
```

## 核心功能

### 系统管理
- 用户管理：用户的增删改查、密码重置
- 角色管理：角色权限配置、数据权限
- 菜单管理：菜单动态配置、权限分配
- 部门管理：部门层级管理
- 职位管理：职位信息维护

### 业务功能
- 分类管理：商品分类、自定义分类
- 商品管理：商品信息维护
- OA 系统：企业信息、通知公告、意见反馈

### 运维功能
- 系统监控：服务器监控、心跳检测
- 操作日志：操作记录、登录日志
- 登录限制：登录失败锁定、最大在线时长
- 数据变更追踪：重要数据的变更记录
- 定时任务：任务调度管理
- 缓存管理：Redis 缓存监控和清理
- 系统配置：系统参数配置

### 开发工具
- 代码生成器：根据数据表自动生成前后端代码
- 接口文档：Knife4j 在线接口文档
- 数据字典：字典管理
- 序列号生成：业务序列号生成规则

### 安全特性
- 三级等保配置：满足等保三级要求
- 接口加密：敏感接口数据加密传输
- 数据脱敏：敏感数据展示脱敏
- 密码复杂度：密码强度校验
- 双因素认证：可选的双因素登录
- 文件检测：上传文件安全检测

## 开发说明

### 后端开发

#### 环境配置

Maven 支持多环境配置：
- `dev`：开发环境（默认）
- `test`：测试环境
- `pre`：预发布环境
- `prod`：生产环境

```bash
# 使用指定环境打包
mvn clean package -P prod
```

#### 接口文档

启动后端服务后，访问 Knife4j 文档：
```
http://localhost:1024/doc.html
```

### 前端开发

#### 环境变量

项目支持多环境配置，配置文件位于 `hoo-web/` 目录：
- `.env.localhost`：本地环境
- `.env.development`：开发环境
- `.env.test`：测试环境
- `.env.pre`：预发布环境
- `.env.production`：生产环境

#### 路由配置

路由文件位于 `src/router/`，支持动态路由和权限控制。

#### 状态管理

使用 Pinia 进行状态管理，store 文件位于 `src/store/`。

## 默认账号

- 管理员账号：`admin`
- 默认密码：请查看数据库初始化脚本中的默认密码

**注意：** 首次登录后请及时修改默认密码！

## 数据库说明

数据库名：`yft_hoo`

主要数据表：
- `t_employee`：员工表
- `t_role`：角色表
- `t_menu`：菜单表
- `t_department`：部门表
- `t_position`：职位表
- `t_category`：分类表
- `t_goods`：商品表
- `t_operate_log`：操作日志表
- `t_login_log`：登录日志表
- `t_data_tracer`：数据变更记录表

## 常见问题

### 1. 后端启动失败

- 检查 JDK 版本是否为 17+
- 检查数据库连接配置是否正确
- 检查 Redis 是否正常运行
- 查看日志文件排查具体错误

### 2. 前端启动失败

- 检查 Node.js 版本是否为 18+
- 删除 `node_modules` 和 `package-lock.json` 重新安装
- 检查后端服务是否正常运行

### 3. 跨域问题

项目已配置 CORS，如仍有跨域问题，请检查前端 API 地址配置和后端跨域配置。

## 技术支持

- Email：

## 版本历史

### v3.0.0 (2024-01-01)

- 权限从 Spring Security 转为 Sa-Token
- 新增接口加密、解密功能
- 新增网络安全相关功能：登录限制、密码复杂度、最大在线时长等
- Ant Design Vue 升级至 4.x 版本
- 升级至 Vite 5
- Swagger 增加 Knife4j 接口文档
- 后端 sa-common 改名为 sa-base

### v2.0.0 (2022-10-22)

- 基础功能模块完善
- 系统核心功能重构

### v1.0.0 (2019-11-01)

- 项目初始版本发布

## 许可证

MIT License


## 致谢

感谢 HooAdmin 框架及所有开源贡献者！