# jeedp

**Repository Path**: ydc123/jeedp

## Basic Information

- **Project Name**: jeedp
- **Description**: java快速开发平台-纯净版
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-09-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# Jeedp 快速开发框架

**Java 企业级快速开发平台 | 开箱即用 | 多端统一**

</div>

---

## 简介

Jeedp 是一套基于 Spring Boot 的企业级快速开发平台，提供完整的用户权限管理、数据权限控制、操作审计、系统监控等基础能力。前端采用 Vue 3 + Arco Design，移动端采用 UniApp，实现 Web 端与移动端统一架构。

## 快速开始

### 环境要求

- JDK 1.8+
- PostgreSQL 12+
- Redis 6+
- Node.js 16+
- Maven 3.6+

### 1. 克隆项目

```bash
git clone <仓库地址>
```

### 2. 初始化数据库

```bash
# 创建数据库并执行初始化脚本
psql -U postgres -d jeedp -f jeedp-server/sql/jeedp_postgres.sql
```

### 3. 启动后端

```bash
cd jeedp-server

# 方式一：IDEA 直接运行（需配置环境变量）
# 环境变量：JASYPT_ENCRYPTOR_PASSWORD=jeedp2026!

# 方式二：命令行启动
mvn spring-boot:run -Dspring-boot.run.arguments="--jasypt.encryptor.password=jeedp2026!"
```

后端服务默认启动在 `http://localhost:8080`

### 4. 启动 Web 前端

```bash
cd jeedp-web
npm install
npm run dev
```

Web 前端默认启动在 `http://localhost:5173`

### 5. 启动移动端（可选）

使用 HBuilderX 打开 `jeedp-app-uniapp` 目录，运行到浏览器或模拟器。

### 默认账号

| 账号 | 密码 | 角色 |
|------|------|------|
| admin | admin123 | 超级管理员 |

## 核心特性

### 权限体系

- **接口权限**：基于 Sa-Token 的 `@SaCheckPermission` 注解，按钮级权限控制
- **数据权限**：`@DataScope` 注解 + AOP 切面，支持全部/自定义/机构/本人等 5 种数据范围
- **子角色机制**：支持角色层级配置，用户管理时自动按子角色范围过滤可选角色
- **超级管理员**：admin 账号自动拥有通配权限 `*:*:*`

### 安全防护

- **配置加密**：数据库密码、Redis 密码等敏感配置采用 Jasypt AES 加密存储
- **敏感字段加密**：手机号、邮箱等字段数据库存储密文，查询时自动加解密
- **脱敏显示**：列表接口自动脱敏手机号、邮箱等敏感信息
- **密码策略**：支持密码强度校验、登录失败锁定、密码过期提醒

### 操作审计

- **操作日志**：`@Log` 注解自动记录增删改操作，含请求参数和响应结果
- **登录日志**：记录登录 IP、浏览器、操作系统、登录状态
- **在线用户**：实时查看当前活跃会话，支持强制下线

## 技术栈

| 层级 | 技术 | 版本 |
|------|------|------|
| 后端框架 | Spring Boot | 2.7.18 |
| 权限认证 | Sa-Token | 1.39.0 |
| ORM | MyBatis-Plus | 3.5.7 |
| 连接池 | Druid | 1.2.23 |
| 缓存 | Redis | - |
| 配置加密 | Jasypt | 3.0.5 |
| 工具库 | Hutool | 5.8.30 |
| JSON | Fastjson2 | 2.0.52 |
| 系统监控 | OSHI | 6.6.2 |
| 表格导出 | Apache Fesod | 2.0.1-incubating |
| Web 前端 | Vue 3 + Arco Design | Vue 3.4 / Arco 2.56 |
| 移动端 | UniApp | Vue 3 |
| 构建工具 | Vite | 5.3 |
| 数据库 | PostgreSQL | - |
| JDK | JDK | 1.8 |

## 功能模块

### 系统管理

| 模块 | 说明 |
|------|------|
| 用户管理 | 系统用户配置，支持数据权限过滤 |
| 机构管理 | 组织机构树形维护（公司/部门/小组） |
| 岗位管理 | 用户职务配置 |
| 角色管理 | 角色权限分配、数据范围划分、子角色配置 |
| 菜单管理 | 系统菜单、路由、按钮权限标识配置 |
| 字典管理 | 系统常用固定数据维护 |
| 参数管理 | 系统动态配置参数 |

### 系统监控

| 模块 | 说明 |
|------|------|
| 在线用户 | 当前活跃用户状态监控，支持强退 |
| 定时任务 | 在线添加/修改/删除任务调度，含执行日志 |
| 操作日志 | 系统正常操作与异常信息日志记录 |
| 登录日志 | 登录记录查询，包含异常登录信息 |
| 服务监控 | CPU、内存、磁盘、JVM 等系统信息 |
| 缓存监控 | 系统缓存信息查询与命令统计 |

### 通知公告

系统公告信息发布与维护，支持已读状态追踪。

## 项目结构

```
jeedp/
├── jeedp-server/     # 后端服务（Spring Boot）
│   ├── src/main/java/com/jeedp/
│   │   ├── common/       # 公共模块（工具类、注解、异常、常量）
│   │   ├── config/       # 配置类（拦截器、数据源、加密等）
│   │   ├── framework/    # 框架集成（Sa-Token 权限实现）
│   │   ├── monitor/      # 监控模块（在线用户、任务调度、服务监控）
│   │   └── system/       # 系统管理模块（用户、角色、菜单、机构等）
│   ├── sql/              # 数据库初始化脚本
│   └── pom.xml
├── jeedp-web/        # Web 管理端（Vue 3 + Arco Design）
│   ├── src/
│   │   ├── api/          # 接口请求
│   │   ├── views/        # 页面组件
│   │   ├── layout/       # 布局组件
│   │   ├── router/       # 路由配置
│   │   └── store/        # 状态管理（Pinia）
│   └── package.json
├── jeedp-app-uniapp/ # 移动端（UniApp + Vue 3）
│   ├── pages/        # 页面
│   ├── api/          # 接口请求
│   ├── store/        # 状态管理（Pinia）
│   └── manifest.json
└── jeedp-doc/        # 项目文档
```

## 相关文档

- [后端使用说明](jeedp-server/README.md)
- [Web 前端说明](jeedp-web/README.md)

## License

本项目仅供学习和内部使用。