前后端分离中台框架 Admin.Core 学习-介绍与配置说明

正经小大哥

中台框架后端项目 Admin.Core 的介绍与配置说明

中台admin是前后端分离权限管理系统，Admin.Core为后端项目，基于.NET 7.0开发。
支持多租户、数据权限、动态 Api、任务调度、OSS 文件上传、滑块拼图验证、多数据库，分布式缓存、分布式事务等

• 项目地址
  
  
  
  • Github https://github.com/zhontai/Admin.Core
    
  
  
• 技术栈
  
  
  
  • dotnet7
    
  • FreeSql
    
  • Autofac
    
  • CAP
    
  • Mapster
    
  
  
• 特点
  
  
  
  • 快速启动，上手简单
    
  • 系统模块化
    
  • Swagger的模块化封装
    
  • 读写分离
    
  • 分库分表
    
  • 分布式事务 TCC/ SAGA
    
  • 动态API
    
  • 系统权限封装基本满足大部分项目
    
  • 多租户实现
    
  
  
• 开发环境
  
  
  
  • Vs2022
    
  • dotnet7
    
  
  
• 项目结构
  
  
  
  • hosts
    
    
    
    • ZhonTai.Host:默认启动项目,添加对 ZhonTai.Admin.Dev，模块的引用，并将程序集配置到 assemblyNames
      
    
    
  • platform
    
    
    
    • ZhonTai.Admin 核心服务
      
    • ZhonTai.ApiUI 接口文档封装，分模块加载
      
    • zhonTai.Common 通用库封装
      
    • ZhonTai.DynamicApi 动态WebApi库
      
    • ZhonTai.Admin.Dev 代码生成器添加
      
    
    
  • tests
    
    
    
    • ZhonTai.Tests 测试库
      
    
    
  • modules
    
    
    
    • XX.XX 我准备放自己的模块
      
    
    
  
  

框架的使用

1. 从GitHub 克隆/下载项目

• 后端：git clone https://github.com/zhontai/Admin.Core.git
  
• 前端：git clone https://github.com/zhontai/admin.ui.plus.git
  

2. 后端项目的启动

使用新下的VS2022打开后，默认启动项目 ZhonTai.Host ，直接Ctrl+F5运行即可
系统将会根据实体生成数据库及表，并根据 Configs/dbconfig.json 配置将 initData/*.json 的数据生成到本地Sqlite中
(ps:第一次搞dotnet7的项目，vs2019+自己下SDK折腾半天搞不了一点，需要vs2022 17.4+)

• 官方文档：https://zhontai.net/backend/new-project.html
  

3. 配置文件说明

• launchSettings.json
  
  
  
  • 默认本地启动配置
    
    
    
    • 配置项
      
      
      
      • 运行环境
        
        
        
        • ASPNETCORE_ENVIRONMENT:Development
          
        
        
      • 启动端口
        
        
        
        • 默认：8000
          
        • 优先级低于appconfig.urls的配置
          
        
        
      
      
    
    
  
  
• appsettings.{Env}.json
  
  
  
  • 默认的应用配置文件
    
  • 配置项
    
    
    
    • 日志等级
      
      
      
      • 默认：Information
        
      
      
    • 跨域
      
      
      
      • 默认：*
        
      
      
    • CAP配置
      
      
      
      • 默认：未启用
        
      
      
    • 滑动验证码
      
      
      
      • 默认：300s有效期
        
      • 是否开启在appconfig.json配置varifyCode.enable
        
      
      
    
    
  
  
• Configs*.{Env}.json
  
  
  
  • 自定义的应用配置文件
    
  • dbconfig.json
    
    
    
    • 数据库配置
      
    • 绑定模型
      
      
      
      • 单例：DbConfig
        
      
      
    • 配置项
      
      
      
      • 支持类型：type
        
        
        
        • 默认：Sqlite
          MySql = 0, SqlServer = 1, PostgreSQL = 2,Oracle = 3, Sqlite = 4, OdbcOracle = 5,OdbcSqlServer = 6, OdbcMySql = 7,OdbcPostgreSQL = 8, Odbc = 9, OdbcDameng =10, MsAccess = 11, Dameng = 12,OdbcKingbaseES = 13, ShenTong = 14,KingbaseES = 15, Firebird = 16
          
        
        
      • 连接字符串：connectionString
        
        
        
        • 默认：admindb.db
          
        
        
      • 同步结构
        
        
        
        • syncStructure：true
          
          
          
          • 默认启用
            
          • 分布式部署需要注意关闭
            
          
          
        • 监听同步结构脚本 syncStructureSql：false
          

        将会输出codeFirst执行的脚本
        将 assemblyNames 配置的所有实体执行结构移 db.CodeFirst.SyncStructure 
        1.创建临时表
        2.插入历史数据，修改字段名称情况注意
        3.删除旧表，重命名临时表为新表
        生产上该自己执行脚本的还是自己执行
        

        
        
      • 同步数据
        
        
        
        • syncData：true
          
        • sysUpdateData:false
          
          
          
          • 同步更新数据
            
          • 确定要修改表数据是最新数据再开启，除localdb测试就不要使用
            
          
          
        • syncDataIncludeTables：[]
          
          
          
          • 同步数据包含表，指定表同步，不填同步所有表
            
          
          
        • syncDataExcludeTables：[]
          
          
          
          • 同步数据排除表，指定表不同步
            
          
          
        • syncDataUser
          
          
          
          • 同步数据操作用户
            
          
          
        • syncDataPath
          
          
          
          • 不配置默认为  项目目录/InitData/Admin
            
          • 默认会将文件夹下的所有 表名.json 添加到数库中，默认新增所有数据
            
          • 如果是租户数据，格式为 表.tenant.json
            
          
          
        • syncDataCurd：false
          
          
          
          • 监听同步数据Curd操作
            
          • 
            
          
          

        设置是否将syncDataPath文件夹下的 表名.json 加/修改到数据库中
        

        
        
      • 生成数据
        
        
        
        • generateData：true
          默认开启但无效，需要将禁用创建数据库及禁用步：createDb:false && syncData:false
          
        • 加了视图菜单就可以使用这个功能来创建生成默认数据
          
        
        
      
      
    
    
  
  
• cacheconfig.json
  
  
  
  • 缓存配置，未绑定模型，redis缓存，限流参数配置
    
  • 配置项
    
    
    
    • 支持类型
      
      
      
      • 默认：Memory
        
      • Memory = 0,Redis = 1
        
      
      
    • 限流缓存类型
      
      
      
      • 默认：Memory
        
      • Memory = 0,Redis = 1
        
      
      
    • Redis配置
      
      
      
      • 127.0.0.1:6379
        
      
      
    
    
  
  
• appconfig.json
  
  
  
  • 应用配置
    
  • 绑定模型
    
    
    
    • 单例: AppConfig
      
    
    
  • 配置项
    
    
    
    • appType 应用程序类型
      
      
      
      • 默认：Controllers
        
      • Controllers ControllersWithViews MVC
        
      
      
    • urls 启动地址
      
      
      
      • http://*:8000
        
      
      
    • corUrls 跨域
      
      
      
      • []
        
      
      
    • assemblyNames 程序集名称
      
      
      
      • ZhonTai.Admin
        
      • Mapster自动注册程序集
        
      
      
    • tenantc租户
      
      
      
      • true
        
      
      
    • distributeKey 分布式事务唯一标识
      
      
      
      • 为空则不生成分布式事务表
        
      
      
    • validate 验证开关
      
      
      
      • 登录,接口权限,数据权限验证
        
      
      
    • swagger Swagger文档s
      
      
      
      • http://localhost:8000/admin/swagger
        
      
      
    • apiUI 接口文档地址
      
      
      
      • http://localhost:8000/admin/index.html
        
      
      
    • MiniProfiler 性能分析器
      
      
      
      • false
        
      
      
    • identityServer 统一认证授权服务器
      
      
      
      • false
        
      
      
    • aop 面向切面编程s
      
      
      
      • 开启事务
        
      
      
    • log 数据库日志
      
      
      
      • 操作日志
        
      
      
    • rateLimit 限流开关
      
      
      
      • false
        
      
      
    • varifyCode 登录验证码
      
      
      
      • true
        
      
      
    • defaultPassword 默认密码
      
      
      
      • 111111
        
      
      
    • dynamicApi 动态api
      
      
      
      • 结果格式化
        
      
      
    • passwordHasher 标准标识密码哈希
      
      
      
      • 启用后相同密码加密后各不相同
        
      
      
    • maxRequestBodySize 最大请求大小
      
      
      
      • 104857600
        
      
      
    • healthChecks 健康检查
      
      
      
      • enable:true 启用
        
      • path:/admin/health
        
      
      
    
    
  
  
• jwtconfig.json
  
  
  
  • JWT配置
    
  • 绑定模型
    
    
    
    • 单例：JwtConfig
      
    
    
  • 配置项
    
    
    
    • issuer 发行者
      
    • audience 订阅者
      
    • securityKey 密钥
      
    • expires 有效期(分钟) 120
      
    • refreshExpires 刷新有效期(分钟) 1440
      
    
    
  
  
• ossconfig.json
  
  
  
  • 本地上传配置
    
  • 绑定模型
    
    
    
    • IOptions
      
    
    
  • OSS配置
    
    
    
    • Minio
      
    • 阿里云
      
    • 腾讯云
      
    • 七牛
      
    • 华为云
      
    
    
  
  
• uploadconfig.json
  
  
  
  • 上传配置
    
  • 绑定模型
    
    
    
    • IOptions
      
    
    
  
  
• ratelimitconfig.json
  
  
  
  • 限流配置
    
  • 绑定模型
    
    
    
    • IOptions
      
    
    
  • 支持类型
    
    
    
    • IP限流
      
      
      
      • 默认未启用
        
      • 需要在appconfig.json中配置rateLimit:true生效
        
      • 使用Redis实现限流
        
      • 需要在cacheconfig.json中配置typeRateLimit
        
      
      
    
    
  
  
• InitData\模块*.{tenant}.json
  
  
  
  • 默认初始化数据
    
  
  

写在最后

文章的起因是想找个不错的框架用来搞个自己用的系统，找了几个dotnet+vue的框架，zhontai的这个是看到上手最容易，前后台的代码也没有封装得太深，二开也很方便，看着用着都挺舒服的。
唯一的不足就是文档了，一点资料都找不到，就只能一点点看代码，然后边看边记录，以备后用，又想着既然都写了，那就再整理一下了，顺便分享出来咯，希望能够对后面使用框架的有所帮助。

来源:https://www.cnblogs.com/morang/archive/2023/08/20/admin_core_book_01.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！