BearPlan.Core
1.0.2
dotnet add package BearPlan.Core --version 1.0.2
NuGet\Install-Package BearPlan.Core -Version 1.0.2
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="BearPlan.Core" Version="1.0.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="BearPlan.Core" Version="1.0.2" />
<PackageReference Include="BearPlan.Core" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add BearPlan.Core --version 1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: BearPlan.Core, 1.0.2"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package BearPlan.Core@1.0.2
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=BearPlan.Core&version=1.0.2
#tool nuget:?package=BearPlan.Core&version=1.0.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
BearPlan.Core
BearPlan 的通用框架核心库 —— 抽离权限、缓存、日志、ORM 等通用能力，业务无关、开箱即用，可作为任意 .NET 项目的底层基座。
定位
BearPlan.Core 承载与具体业务无关的框架级基础设施，不依赖任何业务实体或服务接口。任何 .NET / C# 应用程序都可以复用。它作为 BearPlan 项目体系的核心层，同时设计为可被任意项目以子模块或 NuGet 包的形式引入。
包含内容
| 模块 | 说明 |
|---|---|
App / Internal |
全局应用入口，统一的服务定位器（GetService / GetOptions 等） |
Attributes |
通用特性：缓存、事务、权限、响应格式化、多库路由标记、Redis 订阅等 |
Aop |
AOP 拦截器（缓存拦截） |
Caches |
缓存抽象与实现：ICache、Redis、分布式缓存、Redis 消息队列 |
ConfigOptions |
强类型配置选项：JWT、Redis、CORS、数据库连接、Serilog、Swagger、中间件开关等 |
ClassLibrary |
通用算法与工具：一致性哈希、MurmurHash、JSON 转换器、同步集合 |
Consts |
通用常量 |
DI |
依赖注入基础设施：拦截器、过滤器、Autofac 辅助、DI 标记接口 |
Enums |
通用枚举：架构、缓存类型、列类型、部门、字典、性别、菜单、触发器、版本等 |
Exception |
通用异常：BusException、BadRequestException |
Extensions |
扩展方法：字符串、日期、集合、枚举、表达式、字节流、DataTable 等 |
Fonts |
验证码生成所需的字体资源 |
Global |
全局常量与配置：AppSettings、AuthConstants、MimeTypes、Mapper |
Helper |
工具类：文件、日期、加密（BCrypt/RSA）、HTTP、IP、日志、树、Excel、雪花 ID 等 |
IdGenerator |
雪花 ID 生成器 |
Mapping |
对象映射配置（Mapster） |
Middleware |
纯中间件：CORS、IP 限流、真实 IP、MiniProfiler、Swagger 授权、404 等 |
Model |
通用模型契约：审计实体接口、分页参数、操作结果 |
MultiLanguage |
多语言契约（ILocalizationService、Localizer 资源访问器） |
Pager |
分页相关模型 |
Serilog |
Serilog 日志输出扩展 |
技术栈
- 运行时：.NET 10
- ORM 适配：SqlSugarCore
- 缓存：StackExchange.Redis
- 日志：Serilog（含 Async / Elasticsearch Sink）
- DI：Autofac（含 DynamicProxy AOP）
- 对象映射：Mapster
- 图像：SixLabors.ImageSharp
- 调度：Quartz
- 其它：Newtonsoft.Json、NodaTime、MiniProfiler、Swashbuckle
使用方式
作为 Git Submodule 引入
git submodule add https://gitee.com/BearPlan/BearPlan.NET.Core.git BearPlan.Core
然后在主解决方案中引用 BearPlan.Core/BearPlan.Core.csproj。
作为 NuGet 包引入
<PackageReference Include="BearPlan.Core" Version="1.0.0" />
开发约束
- 本库不得引用任何业务项目（Entity / IBusiness / Repository / 业务实现），保持业务中立。
- 不得依赖具体业务实体或服务接口，确保可独立编译发布。
- 新增内容须判断是否真正通用：与业务强相关的代码应留在业务项目，不进入本库。
关联项目
- BearPlan 主项目：https://gitee.com/ByteXiong/BearPlan —— 基于 BearPlan.Core 构建的全栈脚手架。
- 开发文档：https://bear.js.org/
联系方式
| 作者微信 |
|---|
| <img src="wx.jpg" alt="微信图片" width="200" /> |
| 备注：框架 |
开源协议
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net10.0
- Asp.Versioning.Mvc.ApiExplorer (>= 10.0.0)
- AspNetCoreRateLimit (>= 5.0.0)
- Autofac.Extensions.DependencyInjection (>= 11.0.2)
- Autofac.Extras.DynamicProxy (>= 8.0.1)
- BCrypt.Net-Next (>= 4.2.0)
- IP2Region.Net (>= 3.0.2)
- Mapster (>= 10.0.11)
- Microsoft.Extensions.Caching.StackExchangeRedis (>= 10.0.10)
- MiniProfiler.AspNetCore (>= 4.5.4)
- MiniProfiler.AspNetCore.Mvc (>= 4.5.4)
- Newtonsoft.Json (>= 13.0.4)
- NodaTime (>= 3.3.3)
- Quartz (>= 3.18.2)
- Serilog.AspNetCore (>= 10.0.0)
- Serilog.Sinks.Async (>= 2.1.0)
- Serilog.Sinks.Elasticsearch (>= 10.0.0)
- SixLabors.Fonts (>= 2.1.3)
- SixLabors.ImageSharp (>= 3.1.12)
- SixLabors.ImageSharp.Drawing (>= 2.1.7)
- SqlSugarCore (>= 5.1.4.216)
- Swashbuckle.AspNetCore (>= 10.2.3)
- Swashbuckle.AspNetCore.Filters (>= 10.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.