# IM.Easy

**Repository Path**: manong121/IM.Easy

## Basic Information

- **Project Name**: IM.Easy
- **Description**: 前后端分离的后端管理框架
基于.net 8.0和 vue3.0开发的一套可快速搭建企业级项目，内置多种丰富功能，如：权限，用户，组织机构，邮箱，文件，审计日志等
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: http://top.snailabode.cn
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 20
- **Created**: 2025-06-16
- **Last Updated**: 2025-06-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<h2 align="center"> IM.Easy 通用管理框架</h2>

#### 在线体验
> [在线体验地址](http://top.snailabode.cn)


登录名：test
密码:123456

#### 交流中心
qq1群：1041300890
如果您在使用本项目的途中遇到任何问题都可以直接在群里找到开发者，主打一个高效

#### 基本介绍
- **⭐提升 .NET 开发效率⭐**: 简化开发流程，让开发人员聚焦业务逻辑，高效完成项目。
- **⭐上手简单，学习成本低⭐**: 让新手快速入门，减少学习曲线，轻松融入开发流程。
- **⭐功能强大，易于扩展⭐**: 提供强大的基础功能，灵活的扩展性，轻松满足多样化需求。
- **⭐遵循 DRY 原则⭐**: 减少重复劳动，专注高效开发，让代码更加简洁和优雅。

#### 后端基础架构
> 项目结构：

```
├─Services                  ->[服务类库文件夹]：不同业务模块可建立不同类库；
   ├─IM.Easy.GenServices    --代码生成服务
    ......                  --其他服务模块
├─IM.Easy.Api               ->[webapi接口]。
├─IM.Easy.Core              ->[框架核心模块]；
  ├─Configuration           --处理json配置。
  ├─Cache                   --处理缓存
  .....                     --其他
├─IM.Easy.CoreServices      ->[最底层服务模块]：比如系统参数等,需要在其他业务服务模块中使用的
├─IM.Easy.Entity            ->[实体层类库]：数据实体类；
├─IM.Easy.Infrastructure    ->[基础设施]：基础结构，静态常量等；
```

> 架构截图
![系统架构](doc/images/%E5%9F%BA%E7%A1%80%E6%9E%B6%E6%9E%84%E5%9B%BE.png)


#### 功能截图

<img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/login.png"/>

<table>
    <tr>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/1.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/2.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/3.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/4.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/5.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/6.png"/></td>
    </tr>
    <tr>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/7.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/8.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/9.png"/></td>
    </tr>
     <tr>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/10.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/11.png"/></td>
        <td><img src="https://gitee.com/mrwangRefreshing/IM.Easy/raw/master/doc/images/12.png"/></td>
    </tr>
</table>

#### 功能特色
>   工作台

- :white_check_mark: 快捷功能：通过收藏形成用户快捷功能
- :white_check_mark: 其他小部件：如，天气，日历，消息日志等
- :white_check_mark: 自定义布局：可更具用户习惯进行diy自定义布局

> 消息邮箱

:+1:  邮箱管理：提供本地邮箱功能，可发送邮箱至已开通本地邮箱账户


> 用户管理

- :white_check_mark: 系统用户：管理系统相关使用使用者相关信息
- :white_check_mark: 在线用户：当前登录的在线用户
- :white_check_mark: 第三方账号：通过Gitee等第三方登录进来的基础数据

> 系统管理

- :+1: 图标管理：提供系统内置，ElementPlus，以及个性化图标三种方式，其中个性化图标方便用户打造独特性UI。
- :white_check_mark: 参数配置：系统基础参数配置，如初始密码，是否演示模式，前端主机地址等，可以部分替代appsettings.json
- :+1: 定时作业：精确到秒级别的定时作业任务，深度集成quartz.net。支持多种作业方式， 远程请求，本地程序等，详细记录相关作业日志
- :white_check_mark: 通知公告：待完善...
- :white_check_mark: 字典管理：集中化管理系统中的所有字典数据，提升维护效率。

> 权限管理

- :white_check_mark: 菜单资源：集中管理系统中的所有菜单，支持权限控制和自定义配置。
- :white_check_mark: 部门组织：管理公司或团队的部门结构，支持多级部门。
- :white_check_mark: 岗位管理：细分到组织机构的岗位管理，不同组织机构可独享岗位
- :white_check_mark: 角色管理：管理系统中的角色，分配权限，控制访问权限。
- :+1: 接口管理：集中管理系统接口，动态配置权限，访问控制，审计日志记录等多种功能，抛弃传统的硬编码。

> 消息日志

- :white_check_mark: 操作日志：记录用户在系统中的具体操作行为，包括操作时间、操作用户、操作内容、操作对象、操作结果等信息。这些日志有助于审计用户行为、定位和分析系统故障，确保系统的安全性和可追溯性。
- :white_check_mark: 系统消息：待完善...
- :white_check_mark: 登录日志：记录用户登录信息，跟踪登录时间、IP和设备等信息。
- :white_check_mark: 错误日志：记录系统中的异常和错误信息，帮助排查问题和优化系统。

> 文件管理

- :+1:  文件资源：管理和存储各类文件数据，包括文档、图片、音频、视频等不同格式的文件。
- :white_check_mark: 文件类型：明确文件所属的类别，如文本文件（.txt、.docx 等）、图像文件（.jpg、.png 等）、音频文件（.mp3、.wav 等）、视频文件（.mp4、.avi 等） ，以便于分类管理和检索。。

> 快速开发工具
- :white_check_mark:  编辑器：待完善...
- :white_check_mark: 代码生成：自动生成常用代码结构，提升开发效率，减少重复工作。

#### 快速入门

```
//拉取代码
git clone https://gitee.com/mrwangRefreshing/IM.Easy.git
```

> 启动后端

```
cd IM.Easy/IM.Easy.Api

dotnet build
//run之前请完成必要的配置
dotnet run
```

> 启动前端

```
cd IM.Easy.Vue
npm i
npm run dev
```


> 配置说明

Database.json,JWT.json为必配置文件。

- 初始化数据库
这里是列表文本配置好数据库连接字符串之后，将EnableInitDb，TableSettings，SeedSettings置为true，最后再启动项目
quartz.db在群里已分享 


#### 特别鸣谢
- :heartbeat: Ruoyi.vue：[Ruoyi](http://www.ruoyi.vip/)   
- :heartbeat: SqlSugar：[SqlSugar](https://gitee.com/dotnetchina/SqlSugar)