# Magicodes.Admin.Core **Repository Path**: JasonEarlySun/Magicodes.Admin.Core ## Basic Information - **Project Name**: Magicodes.Admin.Core - **Description**: Magicodes.Admin，是心莱科技团队打造的一套高效率、易扩展、基础设施强大、代码生成完备、理念和技术先进的敏捷开发框架，同时也是一套分布式、跨平台（linux、Docker容器支持，已提供Docker教程、腾讯云容器托管教程、Azure DevOps教程）、多终端（包括Android、IOS、H5、小程序、微信公众号）、前后端分离、持续集成（CI）、自动部署、监控支持的统一开发框架和开发解决方案。框架基于.NET Core 2.2、Angular、Ionic、EF Core、ABP和ASP.NET Zero，并在其基础上进行了封装和完善，并且编写了相关的工具（代码生成）、组件（云存储、支付、微信等等）、生成服务。 - **Primary Language**: C# - **License**: MIT - **Default Branch**: develop - **Homepage**: http://xin-lai.com - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 304 - **Created**: 2025-06-04 - **Last Updated**: 2025-06-04 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Magicodes.Admin ## 说明 Magicodes.Admin，是心莱科技团队打造的一套高效率、易扩展、基础设施强大、代码生成完备、理念和技术先进的敏捷开发框架，同时也是一套分布式、跨平台（**linux、Docker容器支持，已提供Docker教程、腾讯云容器托管教程、Azure DevOps教程**）、多终端（包括**Android、IOS、H5、小程序、微信公众号**）、前后端分离、持续集成（CI）、自动部署、监控支持的统一开发框架和开发解决方案。框架基于.NET Core 2.2、Angular、Ionic、EF Core、ABP和ASP.NET Zero，并在其基础上进行了封装和完善，并且编写了相关的工具（代码生成）、组件（云存储、支付、微信等等）、生成服务。 **注意：代码均开源免费，我方不收取任何授权费用。** ## 官方订阅号 关注“麦扣聊技术”订阅号获取： ![麦扣聊技术](./res/订阅号.jpg) * 最新文章、教程、文档 * 视频教程 * 解决方案 * 编程心得和理念 QQ群：85318032 ## 官方文档 * 地址： * 总体说明： ## 免费的代码生成服务 * 在线免费生成服务地址（基本无限制，注册即可免费使用）： * 使用指南： * 支持后台服务生成 * 支持语言字典翻译和生成 * 支持后台UI生成 * 支持自动合并（需下载客户端合并工具） 由于服务器资源以及团队精力有限，目前已暂停服务。感谢TVP李文斌同学赞助了3台服务器，目前尚无精力部署k8s集群以及部署上线。 **正在准备抽取精力整理代码并开源，敬请期待。** ## 后台UI库 * Angular版本UI库地址： * Vue版本UI库地址（预计11月发布）： ## VNext * 新版UI+Demo * 后台Vue版本UI * 具体见： 目前团队精力非常有限，仅能跟随项目情况进行更新。 ## 相关Nuget包 | 名称 | 说明 | Nuget | |----------|:-------------:|:-------------:| | Magicodes.WeChat.MiniProgram |小程序SDK |[![NuGet](https://buildstats.info/nuget/Magicodes.WeChat.MiniProgram)](https://www.nuget.org/packages/Magicodes.WeChat.MiniProgram) | | Magicodes.Sms.Aliyun |阿里云短信 | [![NuGet](https://buildstats.info/nuget/Magicodes.Sms.Aliyun)](https://www.nuget.org/packages/Magicodes.Sms.Aliyun) | | Magicodes.Storage.Core |通用存储核心库| [![NuGet](https://buildstats.info/nuget/Magicodes.Storage.Core)](https://www.nuget.org/packages/Magicodes.Storage.Core) | | Magicodes.Storage.AliyunOss.Core |阿里云OSS存储| [![NuGet](https://buildstats.info/nuget/Magicodes.Storage.AliyunOss.Core)](https://www.nuget.org/packages/Magicodes.Storage.AliyunOss.Core) | | Magicodes.Storage.Local.Core |本地存储| [![NuGet](https://buildstats.info/nuget/Magicodes.Storage.Local.Core)](https://www.nuget.org/packages/Magicodes.Storage.Local.Core) | | Magicodes.Storage.Tencent.Core |腾讯云存储| [![NuGet](https://buildstats.info/nuget/Magicodes.Storage.Tencent.Core)](https://www.nuget.org/packages/Magicodes.Storage.Tencent.Core) | | Magicodes.WeChat.SDK.Core |微信SDK | [![NuGet](https://buildstats.info/nuget/Magicodes.WeChat.SDK.Core)](https://www.nuget.org/packages/Magicodes.WeChat.SDK.Core) | | Magicodes.SwaggerUI |SwaggerUI API快速配置和分组| [![NuGet](https://buildstats.info/nuget/Magicodes.SwaggerUI)](https://www.nuget.org/packages/Magicodes.SwaggerUI) | | Magicodes.IE.Excel |Excel导入导出| [![NuGet](https://buildstats.info/nuget/Magicodes.IE.Excel)](https://www.nuget.org/packages/Magicodes.IE.Excel) | | Magicodes.IE.Core |导入导出核心库| [![NuGet](https://buildstats.info/nuget/Magicodes.IE.Core)](https://www.nuget.org/packages/Magicodes.IE.Core) | | Magicodes.IE.HTML | HTML导入导出|[![NuGet](https://buildstats.info/nuget/Magicodes.IE.HTML)](https://www.nuget.org/packages/Magicodes.IE.HTML) | | Magicodes.IE.Pdf |Pdf导入导出| [![NuGet](https://buildstats.info/nuget/Magicodes.IE.Pdf)](https://www.nuget.org/packages/Magicodes.IE.Pdf) | | Magicodes.IE.Word |Word导入导出| [![NuGet](https://buildstats.info/nuget/Magicodes.IE.Word)](https://www.nuget.org/packages/Magicodes.IE.Word) | | Magicodes.Pay.Alipay |支付宝支付库| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Alipay)](https://www.nuget.org/packages/Magicodes.Pay.Alipay) | | Magicodes.Pay.Notify |支付通用回调库| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Notify)](https://www.nuget.org/packages/Magicodes.Pay.Notify) | | Magicodes.Pay.Wxpay |微信支付库| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Wxpay)](https://www.nuget.org/packages/Magicodes.Pay.Wxpay) | | Magicodes.Pay.Alipay.Global |国际支付宝支付库 | [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Alipay.Global)](https://www.nuget.org/packages/Magicodes.Pay.Alipay.Global) | | Magicodes.Pay.Allinpay | 通联支付库 | [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Allinpay)](https://www.nuget.org/packages/Magicodes.Pay.Allinpay) | | Magicodes.Pay.Abp | ABP 支付通用封装库| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Abp)](https://www.nuget.org/packages/Magicodes.Pay.Abp) | | Magicodes.Pay.Abp.Allinpay |ABP 通联支付模块| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Abp.Allinpay)](https://www.nuget.org/packages/Magicodes.Pay.Abp.Allinpay) | | Magicodes.Pay.Abp.Wxpay | ABP 微信支付模块| [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Abp.Wxpay)](https://www.nuget.org/packages/Magicodes.Pay.Abp.Wxpay) | | Magicodes.Pay.Alipay.Global | ABP 国际支付宝模块 | [![NuGet](https://buildstats.info/nuget/Magicodes.Pay.Alipay.Global)](https://www.nuget.org/packages/Magicodes.Pay.Alipay.Global) | | Magicodes.Abp.Castle.NLog | ABP Nlog支持模块 | [![NuGet](https://buildstats.info/nuget/Magicodes.Abp.Castle.NLog)](https://www.nuget.org/packages/Magicodes.Abp.Castle.NLog) | | Magicodes.WxMiniProgram.Sdk |微信小程序SDK| [![NuGet](https://buildstats.info/nuget/Magicodes.WxMiniProgram.Sdk)](https://www.nuget.org/packages/Magicodes.WxMiniProgram.Sdk) | | Magicodes.WxMiniProgram.Sdk.Abp |微信小程序SDK Abp模块| [![NuGet](https://buildstats.info/nuget/Magicodes.WxMiniProgram.Sdk.Abp)](https://www.nuget.org/packages/Magicodes.WxMiniProgram.Sdk.Abp) | 相关源代码地址： - - ## Docker镜像说明 Dockerfile已修改，基础镜像默认使用：ccr.ccs.tencentyun.com/magicodes/aspnetcore-runtime:2.2 该镜像GitHub地址：https://github.com/xin-lai/aspnetcore-docker 推荐理由： * 使用国内公共镜像服务（腾讯云），拉取更快 * 默认包含时区设置、debian软件包加速以及libgdiplus等库的安装 * 如使用PDF组件，注意安装相关字体，具体参考Magicodes.IE.Pdf库的说明 ## Demo 敬请期待新版UI。由于近期太忙，上线时间会推后。 ## 开发组件、套件、解决方案、理念 目前框架中包含以下开发组件、套件、解决方案、理念： * 通用功能权限 * 数据权限（框架中尚未提供Demo） * 多租户 * 版本 * 组织机构 * 多语言 * 审计日志（操作审计和数据审计） * 缓存管理（支持内存和Redis） * 健康检查 * 服务地址：http://localhost:5000/healthz * UI地址：http://localhost:5000/healthchecks-ui ![健康检查](./res/healthcheck.png) * 日志（Log4net、**NLog**（https://github.com/xin-lai/Abp.Castle.NLog）） * 设置管理器 * **短信服务（Magicodes.Sms【https://github.com/xin-lai/Magicodes.Sms】）** * **支付、统一支付回调（使用Magicodes.Pay【https://github.com/xin-lai/Magicodes.Pay】，支持微信、支付宝、国际支付宝支付和分账、通联支付等，已添加ABP模块封装）** * **微信SDK（Magicodes.WeChat.SDK【https://github.com/xin-lai/Magicodes.WeChat.SDK】）** * **微信模块，已完成公众号的配置，并且提供了公众号API Token获取和更新机制的封装，支持分布式架构** * **小程序SDK（Magicodes.WxMiniProgram.Sdk【https://github.com/xin-lai/Magicodes.WxMiniProgram.Sdk】，逐步弃用【https://github.com/xin-lai/Magicodes.WeChat.SDK】）** * **微信扫码登录（Magicodes.WeChat.SDK【https://github.com/xin-lai/Magicodes.WeChat.SDK】）** * 通用异常处理 * **领域驱动** * **依赖注入** * **接口权限以及授权** * **在线接口文档，支持配置文件快速配置，支持API分组和隐藏（Magicodes.SwaggerUI+Swagger UI【https://github.com/xin-lai/Magicodes.SwaggerUI】）** * 数据验证 * 调度任务（Quartz） * 后台任务（Hangfire） * 数据筛选器（租户筛选器、软删除、是否激活） * **跨平台以及Docker支持（目前基于.NET Core 2.2），支持Visual Studio Tools for Docker** * 通知系统 * **支持通过配置文件配置Kestrel服务器（比如启用HTTPS，以便更好地支持Docker）** * **支持HTTPS重定向** * **支持HTTP严格传输安全协议(HSTS)** * 在浏览器将会阻止通过 HTTP 发送的任何通信的域的配置存储。 在浏览器强制通过 HTTPS 进行的所有通信。 * 在浏览器可防止用户使用不受信任或无效的证书。 在浏览器禁用允许用户暂时信任此证书的提示。 * **即时消息（SignalR）支持，并且支持Redis集群** * ORM和数据迁移(Entity Framework Core) * **通用导入导出（Magicodes.IE【https://github.com/xin-lai/Magicodes.IE】），支持导出导出Excel、Pdf、HTML、Word以及数据验证和错误检查** * **通用存储（Magicodes.Storage，支持本地存储,阿里云存储,腾讯云存储【https://github.com/xin-lai/Magicodes.Storage】）** * 全国行政区域抓取和初始化（Magicodes.Districts【https://github.com/xin-lai/Magicodes.Districts】） * **移动端统一开发解决方案和模板（Angular+Ionic）** * 前后端分离 * **后台前端解决方案和UI（Angular、primeng、bootstrap）** * **简单CMS** * **移动端通用接口（登陆注册找回密码等）** * 邮件服务 * **移动端多语言支持** * **交易流水以及多国货币支持** * **大量后台UI组件（除了常用组件，还支持Tree Table、图片展示、文件批量上传、枚举下拉、关联项下拉、审计）** * 单元测试（后台服务、移动端服务） * **代码生成（后台服务、后台UI功能、多语言定义、权限定义、移动端服务）** * **一键部署（后台服务、前台服务、后台前端）** * **接口调用代码生成（nswag，后台前端和移动端前端）** * **支持Dapper，作为ORM辅助库** * 应用服务基类 * 增删改查 * 导入 * 生成导入模板 * 下载导入错误的标注文件 * 验证导入数据 * 导出 * 批量删除 * 恢复数据 * 支持自定义异常转换器，见：AdminErrorInfoConverter ## 推荐开发环境 ![推荐开发环境](./documents/Magicodes.Admin推荐开发环境.png) 已升级到到.NET Core 2.2，请先下载SDK： ## 文档官网&官方博客 - 文档官网：https://docs.xin-lai.com/ - 博客：http://www.cnblogs.com/codelove/ ## 相关QQ群 编程交流群<85318032> 产品交流群<897857351>