Admin.Core 开源项目入门指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00459/article/details/141009072

Admin.Core 开源项目入门指南

Admin.Core中台Admin前后端分离的权限管理系统。支持多租户、数据权限、动态Api、任务调度、OSS文件上传、滑块拼图验证、国内外主流数据库自由切换和动态高级查询。基于.Net跨平台开发的WebApi。集成统一认证授权、事件总线、数据验证、分布式缓存、分布式事务、Ip限流、全Api鉴权、集成测试、性能分析、健康检查、接口文档等。项目地址:https://gitcode.com/gh_mirrors/ad/Admin.Core

1. 项目目录结构及介绍

Admin.Core 是一个基于 .NET 7.0 的中台系统后端框架，专为实现快速开发和易维护设计。以下是其典型的项目结构概览：

- ZhonTai.Host                  # 主启动项目，负责运行应用
  ├── appsettings.json          # 主要配置文件，包含应用程序的基本配置
  ├── launchSettings.json       # Visual Studio调试设置
  └── program.cs               # 应用入口，配置WebHostBuilder启动服务
  
- ZhonTai.Admin.Dev              # 代码生成器，用于快速生成管理界面代码
- ZhonTai.ApiUI                 # 接口文档和UI封装，支持分模块加载
- ZhonTai.Common                # 公共库，包含一些通用工具类和方法
- ZhonTai.DynamicApi            # 动态Web API库，支持灵活创建API
- ZhonTai.Modules.*             # 实际业务模块，按功能划分，如用户管理、角色管理等
  
- tests/ZhonTai.Tests           # 测试库，用于单元测试或集成测试
  
- hosts                         # 包含不同环境或特定用途的主机配置
- modules                       # 预留位置，供开发者放置自定义模块

2. 项目的启动文件介绍

主要关注的启动文件位于 ZhonTai.Host 目录下的 program.cs。在这个文件中，通过CreateHostBuilder方法配置了整个应用的启动过程，包括服务注册（如数据库连接、依赖注入容器）、中间件配置以及应用程序上下文的初始化。关键步骤涉及以下几点：

使用IWebHostBuilder构建WebHost。
配置环境变量和应用程序的日志级别。
采用Autofac作为依赖注入容器。
整合CAP进行消息队列和事件发布订阅。
链接数据库和其他外部服务配置。

3. 项目的配置文件介绍

appsettings.json

应用程序的核心配置文件，包含了多个部分如ConnectionStrings（数据库连接字符串）、AppSettings（应用级别的设置），以及任何其他自定义配置项。例如：

{
  "ConnectionStrings": {
    "Default": "Server=...;Database=...;"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  
  ... // 其他自定义应用设置
}