# Panda

**Repository Path**: notify/panda

## Basic Information

- **Project Name**: Panda
- **Description**: Abp.vNext8.1 + EF Core8.0 的微服务开源框架 项目支持 消息推送 工作流 认证中心基于OAuth2.0实现
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2024-05-24
- **Last Updated**: 2025-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<br />

<h1 align="center">Panda</h1>

<br />

<h4 align="center">
    <p>
        <a href="./README.md">English</a>|
        <b>中文</b> 
    </p>
</h4>

<p align="center">ABP + EF Core 的微服务开源框架</p>

<p align="center">⭐ 支持 工作流 与 消息推送 ⭐</p>

<br />

<p align="center">💬 QQ 群: 240647629</p>

<br />

<p align="center">
    <img src="https://img.shields.io/badge/language-csharp-orange?style=plastic"/>
    <img src="https://img.shields.io/github/stars/842549829/Panda?style=plastic"/>
    <img src="https://img.shields.io/github/forks/842549829/Panda?style=plastic"/>
    <img src="https://img.shields.io/github/license/842549829/Panda?style=plastic"/>
    <img src="https://img.shields.io/github/issues/842549829/Panda?style=plastic"/>
    <img src="https://img.shields.io/github/repo-size/842549829/Panda?style=plastic"/>
    <img src="https://img.shields.io/github/last-commit/842549829/Panda?style=plastic" />
</p>

<br />

## 🚀 快速体验
> [体验地址](http://139.9.70.213)  
   注意: 由于服务器内存非常小目前工作流和消息通知功能服务未启动使用中如果出现卡死则是服务器死了请联系作者从起服务器或者可以联系作者捐赠服务器

<br /> 

## 🥇 功能列表 （持续更新）

- [x] 用户管理
- [x] 角色管理
- [x] 菜单管理
- [x] 部门管理
- [x] 登录日志
- [x] 操作日志
- [x] 系统公告
- [x] 文件上传
- [x] 定时任务
- [x] 消息推送
- [x] 工作流
- [x] 文件分片上传
- [x] 数据权限模块

## 核心技术

### 后端 C# Asp.Net Core

- [x] 动态 API：ABP
- [x] ORM 框架：EF Core
- [x] 鉴权授权：OpenIddict
- [x] 工作流：workflow-core
- [x] 日志：Serilog
- [x] 模块化：ABP
- [x] 依赖注入：Autofac
- [x] 对象映射：AutoMapper
- [x] 工作单元：ABP
- [x] 多租户：ABP
- [x] 本地缓存：ABP
- [x] 分布式缓存：Redis
- [x] 事件总线：ABP
- [x] 微服务：ABP
- [x] 消息通知：SignalR

### 前端 Vue 3
> [!NOTE]
> [前端项目开源地址](https://gitee.com/notify/panda.net.web)


- [x] 组件库：element-plus
- [x] 路由：vue-router
- [x] 存储：pinia
- [x] 打包：vite	
- [x] 异步请求：axios
- [x] 图表：echarts
- [x] 审批流：jsplumb
- [x] 拖拽：vuedraggable
- [x] 自定义表单：vue + element-plus 实现

## 项目结构

```bash
# 安装abp cli 
dotnet tool install -g Volo.Abp.Cli
# 更新abp cli
dotnet tool update -g Volo.Abp.Cli
# 创建项目	
abp new Panda.Net -u none --separate-auth-server -dbms mysql -d ef
```

### Panda.Net.AuthServer 认证中心

> [!TIP]
> 参考文档:
> 
> OpenIddict
> 
> https://note.youdao.com/s/I7rsNw8N

启动命令
```bash
dotnet Panda.Net.AuthServer.dll --urls https://localhost:44365
```
- [x] 密码模式
- [x] 授权码模式
- [x] 客户端模式
- [x] 设备码授权模式(可用于App扫码登录)
- [x] 简单模式( OAuth2.1 已弃用不再实现) 
	- 新增 postman 测试 json, 放在 `src/Panda.Net.AuthServer/postman/postman_collection.json`
	- 如图所示
	- <img src="images/1.png" width="300px"/>
 
### Panda.Net.HttpApi.Host 服务中心

> [!TIP]
> 参考文档:
> 
> Abp 扩展 User 表
> 
> https://note.youdao.com/s/7oP7XG2O

启动命令
```bash
dotnet Panda.Net.HttpApi.Host.dll --urls https://localhost:44368
```

### Panda.Workflow.HttpApi.Host 工作流

启动命令
```cmd
dotnet Panda.Workflow.HttpApi.Host.dll --urls https://localhost:44598
```

截图： 
<table>
  <tr>
    <td><img src="module/workflow/images/1.png" /></td>
    <td><img src="module/workflow/images/2.png" /></td>
    <td><img src="module/workflow/images/3.png" /></td>
    <td><img src="module/workflow/images/4.png" /></td>
  </tr>
  <tr>
    <td><img src="module/workflow/images/5.png" /></td>
    <td><img src="module/workflow/images/6.png" /></td>
    <td><img src="module/workflow/images/7.png" /></td>
    <td><img src="module/workflow/images/8.png" /></td>
  </tr>
  <tr>
    <td><img src="module/workflow/images/9.png" /></td>
    <td><img src="module/workflow/images/10.png" /></td>
    <td><img src="module/workflow/images/11.png" /></td>
  </tr>
</table>
	
### 数据库还原

```bash
# 安装 dotnet ef cli
dotnet tool install --global dotnet-ef
# 更新 dotnet ef cli
dotnet tool update --global dotnet-ef
# 生成迁移文件
dotnet ef migrations add init -c NetDbContext
# 更新数据库
dotnet ef database update -c NetDbContext
# 生成迁移脚本 ( 用于生成环境 )
dotnet ef migrations script --verbose -i --project "存放项目绝对路径" -c NetDbContext -o "存放脚本绝对路径"
# 生成某一次迭代更新的脚本, 从这个迭代 20240329102615_file1 到 20240408082719_announcement 迭代版本之间的差异脚本
dotnet ef migrations script --verbose -i --project "./" -c NetDbContext -o "./2.sql"  20240329102615_file1 20240408082719_announcement
```
## 脚本还原
```bash
#还原脚本
新建数据库panda
执行脚本 src/Panda.Net.EntityFrameworkCore/panda.sql 
```	

<br />

## 📢 版本说明 

-  v1.0  权限管理+菜单管理+部门管理+登录日志+操作日志+系统公告+文件上传+定时任务+消息推送+工作流+文件分片上传+审批流模块
-  v1.1  添加数据权限模块
-  v2.0  前端实现数据权限模块
-  v2.1  修复文件上传内存泄漏问题