封装应用层

src/Electric/Electric.Application.Contracts/Electric.Application.Contracts.csproj

@@ -4,6 +4,7 @@
     <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>disable</Nullable>
+    <GenerateDocumentationFile>True</GenerateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>

src/Electric/Electric.Application/AppService/Base/BaseAppService.cs

@@ -0,0 +1,18 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Electric.Application.AppService.Base
+{
+    /// <summary>
+    /// 应用基础服务
+    /// </summary>
+    public class BaseAppService : IBaseAppService
+    {
+        public BaseAppService()
+        {
+        }
+    }
+}

src/Electric/Electric.Application/AppService/Base/IBaseAppService.cs

@@ -0,0 +1,15 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Electric.Application.AppService.Base
+{
+    /// <summary>
+    /// 应用服务基接口
+    /// </summary>
+    public interface IBaseAppService
+    {
+    }
+}

src/Electric/Electric.Application/AppService/Identity/AccountAppService.cs

@@ -0,0 +1,24 @@
+using Electric.Application.AppService.Base;
+using Electric.Application.Contracts.AppService.Identity;
+using Electric.Application.Contracts.Dto.Identity.Accounts;
+
+namespace Electric.Application.AppService.Identity
+{
+    public class AccountAppService : BaseAppService, IAccountAppService
+    {
+        public Task<AccountDto> GetAsync()
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<List<AccountPermissionsDto>> GetPermissionsAsync()
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task UpdatePasswordAnsync(AccountUpdatePasswordDto accountUpdatePassword)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

src/Electric/Electric.Application/AppService/Identity/AuthAppService.cs

@@ -0,0 +1,87 @@
+using Electric.Application.AppService.Base;
+using Electric.Application.Auth;
+using Electric.Application.Contracts.AppService.Identity;
+using Electric.Application.Contracts.Dto.Identity.Auths;
+using Electric.Core.Exceptions;
+using Electric.Domain.Manager.Identity;
+
+using Microsoft.IdentityModel.Tokens;
+
+using System.IdentityModel.Tokens.Jwt;
+
+using System.Security.Claims;
+
+using System.Text;
+
+namespace Electric.Application.AppService.Identity
+{
+    public class AuthAppService : BaseAppService, IAuthAppService
+    {
+        /// <summary>
+        /// JWT配置
+        /// </summary>
+        private readonly JwtBearerSetting _jwtBearerSetting;
+
+        /// <summary>
+        /// 用户管理器
+        /// </summary>
+        private readonly UserManager _userManager;
+
+        /// <summary>
+        /// 注入
+        /// </summary>
+        /// <param name="jwtBearerSetting"></param>
+        /// <param name="userManager"></param>
+        public AuthAppService(JwtBearerSetting jwtBearerSetting, UserManager userManager)
+        {
+            _jwtBearerSetting = jwtBearerSetting;
+            _userManager = userManager;
+        }
+
+        /// <summary>
+        /// 登录
+        /// </summary>
+        /// <param name="authLoginDto"></param>
+        /// <returns></returns>
+        /// <exception cref="BusinessException"></exception>
+        public async Task<string> LoginAsync(AuthLoginDto authLoginDto)
+        {
+            //根据用户名、密码校验
+            var user = await _userManager.FindByNameAsync(authLoginDto.UserName);
+            if (user == null)
+            {
+                throw new BusinessException("登录失败，账号或密码错误");
+            }
+
+            var succeeded = await _userManager.CheckPasswordAsync(user, authLoginDto.Password);
+            if (succeeded)
+            {
+                //定义JWT的Payload部分
+                var claims = new[]
+                {
+                    new Claim(ClaimTypes.Name, authLoginDto.UserName),
+                    new Claim(ClaimTypes.Sid, user.Id.ToString()),
+                };
+
+                //生成token
+                var key = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(_jwtBearerSetting.SecurityKey));
+                var creds = new SigningCredentials(key, SecurityAlgorithms.HmacSha256);
+                var securityToken = new JwtSecurityToken(
+                    issuer: _jwtBearerSetting.Issuer,
+                    audience: _jwtBearerSetting.Audience,
+                    claims: claims,
+                    expires: DateTime.Now.AddDays(1),
+                    signingCredentials: creds);
+
+                var token = new JwtSecurityTokenHandler().WriteToken(securityToken);
+
+                //返回token
+                return token;
+            }
+            else
+            {
+                throw new BusinessException("登录失败，账号或密码错误");
+            }
+        }
+    }
+}

src/Electric/Electric.Application/AppService/Identity/PermissionAppService.cs

@@ -0,0 +1,29 @@
+using Electric.Application.AppService.Base;
+using Electric.Application.Contracts.AppService.Identity;
+using Electric.Application.Contracts.Dto.Identity.Permissions;
+
+namespace Electric.Application.AppService.Identity
+{
+    public class PermissionAppService : BaseAppService, IPermissionAppService
+    {
+        public Task DeleteAsync(Guid id)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<List<PermissionDto>> GetAllAsync()
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<PermissionDto> InsertAsync(PermissionCreateDto permissionCreateDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<PermissionDto> UpdateAsync(Guid id, PermissionUpdateDto permissionUpdateDto)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

src/Electric/Electric.Application/AppService/Identity/RoleAppService.cs

@@ -0,0 +1,44 @@
+using Electric.Application.AppService.Base;
+using Electric.Application.Contracts.AppService.Identity;
+using Electric.Application.Contracts.Dto.Identity.Roles;
+
+namespace Electric.Application.AppService.Identity
+{
+    public class RoleAppService : BaseAppService, IRoleAppService
+    {
+        public Task DeleteAsync(Guid id)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<List<RoleDto>> GetAllAsync()
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<RolePageResponseDto> GetPagedListAsync(RolePageRequestDto rolePageRequestDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<List<RoleGetPermissionDto>> GetPermissionsAsync(Guid id)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<RoleDto> InsertAsync(RoleCreateDto roleCreateDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task SavePermissionsAsync(Guid id, RoleSavePermissionDto roleSavePermissionDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<RoleDto> UpdateAsync(Guid id, RoleUpdateDto roleUpdateDto)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

src/Electric/Electric.Application/AppService/Identity/UserAppService.cs

@@ -0,0 +1,41 @@
+using Electric.Application.AppService.Base;
+using Electric.Application.Contracts.AppService.Identity;
+using Electric.Application.Contracts.Dto.Identity.Accounts;
+using Electric.Application.Contracts.Dto.Identity.Users;
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Electric.Application.AppService.Identity
+{
+    public class UserAppService : BaseAppService, IUserAppService
+    {
+        public Task DeleteAsync(Guid id)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<UserDto> GetAsync(Guid id)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<UserPageResponseDto> GetPagedListAsync(UserPageRequestDto userPageRequestDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<UserDto> InsertAsync(UserCreateDto userCreateDto)
+        {
+            throw new NotImplementedException();
+        }
+
+        public Task<UserDto> UpdateAsync(Guid id, UserUpdateDto userUpdateDto)
+        {
+            throw new NotImplementedException();
+        }
+    }
+}

src/Electric/Electric.Application/Auth/JwtBearerSetting.cs

@@ -0,0 +1,96 @@
+using Microsoft.AspNetCore.Authentication.JwtBearer;
+using Microsoft.IdentityModel.Tokens;
+
+namespace Electric.Application.Auth
+{
+    /// <summary>
+    /// JWT配置
+    /// </summary>
+    public class JwtBearerSetting
+    {
+        /// <summary>
+        /// 身份验证方案
+        /// </summary>
+        public string AuthenticateScheme { get; }
+
+        /// <summary>
+        /// 验证发行者
+        /// </summary>
+        public bool ValidateIssuer { get; }
+
+        /// <summary>
+        /// 发行者
+        /// </summary>
+        public string Issuer { get; }
+
+        /// <summary>
+        /// 验证接受者
+        /// </summary>
+        public bool ValidateAudience { get; }
+
+        /// <summary>
+        /// 接收者
+        /// </summary>
+        public string Audience { get; }
+
+        /// <summary>
+        /// 验证安全密钥
+        /// </summary>
+        public bool ValidateIssuerSigningKey { get; }
+
+        /// <summary>
+        /// 安全密钥
+        /// </summary>
+        public string SecurityKey { get; }
+
+        /// <summary>
+        /// 是否验证失效时间
+        /// </summary>
+        public bool ValidateLifetime { get; }
+
+        /// <summary>
+        /// 偏差秒数：防止客户端与服务器时间偏差
+        /// </summary>
+        public int ClockSkew { get; }
+
+        /// <summary>
+        /// 构造函数
+        /// </summary>
+        /// <param name="issuer"></param>
+        /// <param name="audience"></param>
+        /// <param name="securityKey"></param>
+        /// <param name="authenticateScheme">默认值：Bearer</param>
+        /// <param name="validateIssuer">默认值：true</param>
+        /// <param name="validateAudience">默认值：true</param>
+        /// <param name="validateIssuerSigningKey">默认值：true</param>
+        /// <param name="validateLifetime">默认值：true</param>
+        /// <param name="clockSkew">默认值：5秒</param>
+        public JwtBearerSetting(string issuer, string audience, string securityKey, string authenticateScheme = JwtBearerDefaults.AuthenticationScheme,
+            bool validateIssuer = true, bool validateAudience = true, bool validateIssuerSigningKey = true, bool validateLifetime = true, int clockSkew = 5)
+        {
+            Issuer = issuer;
+            Audience = audience;
+            SecurityKey = securityKey;
+            AuthenticateScheme = authenticateScheme;
+            ValidateIssuer = validateIssuer;
+            ValidateAudience = validateAudience;
+            ValidateIssuerSigningKey = validateIssuerSigningKey;
+            ValidateLifetime = validateLifetime;
+            ClockSkew = clockSkew;
+        }
+
+        public JwtBearerSetting(Func<JwtBearerSetting> options)
+        {
+            var x = options.Invoke();
+            Issuer = x.Issuer;
+            Audience = x.Audience;
+            SecurityKey = x.SecurityKey;
+            AuthenticateScheme = x.AuthenticateScheme;
+            ValidateIssuer = x.ValidateIssuer;
+            ValidateAudience = x.ValidateAudience;
+            ValidateIssuerSigningKey = x.ValidateIssuerSigningKey;
+            ValidateLifetime = x.ValidateLifetime;
+            ClockSkew = x.ClockSkew;
+        }
+    }
+}

src/Electric/Electric.Application/DependencyInjection/ServicerCollectionExtensions.cs

@@ -0,0 +1,89 @@
+using AutoMapper;
+
+using Electric.Application.AppService.Base;
+using Electric.Application.Auth;
+using Electric.Application.Session;
+
+using Microsoft.AspNetCore.Http;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.IdentityModel.Tokens;
+
+using System.Text;
+
+namespace Electric.Application.DependencyInjection
+{
+    public static class ServiceCollectionExtensions
+    {
+        /// <summary>
+        /// 应用注入
+        /// </summary>
+        /// <param name="services"></param>
+        public static void AddApplication(this IServiceCollection services)
+        {
+            //Dto映射
+            IConfigurationProvider config = new MapperConfiguration(cfg =>
+            {
+                cfg.AddProfile<MappingProfile>();
+            });
+            services.AddSingleton(config);
+
+            //Session注入
+            services.AddTransient<IEleSession, EleSession>();
+            services.AddTransient<IHttpContextAccessor, HttpContextAccessor>();
+
+            //AppService注入
+            var assemblies = AppDomain.CurrentDomain.GetAssemblies();
+            foreach (var assembly in assemblies)
+            {
+                //获取继承IBaseAppService的类
+                List<Type> types = assembly.GetTypes()
+                .Where(t => t.IsClass && t.GetInterfaces().Contains(typeof(IBaseAppService)))
+                .ToList();
+
+                types.ForEach(impl =>
+                {
+                    //获取该类所继承的所有接口
+                    Type[] interfaces = impl.GetInterfaces();
+                    interfaces.ToList().ForEach(i =>
+                    {
+                        services.AddScoped(i, impl);
+                    });
+                });
+            }
+        }
+
+        /// <summary>
+        /// 添加JWT中间件
+        /// </summary>
+        /// <param name="services"></param>
+        /// <param name="jwtBearerSetting"></param>
+        public static void AddJWT(this IServiceCollection services, JwtBearerSetting jwtBearerSetting)
+        {
+            services.AddAuthentication(options =>
+            {
+                options.DefaultAuthenticateScheme = jwtBearerSetting.AuthenticateScheme;
+                options.DefaultChallengeScheme = jwtBearerSetting.AuthenticateScheme;
+                options.DefaultScheme = jwtBearerSetting.AuthenticateScheme;
+            }).AddJwtBearer(options =>
+            {
+                options.TokenValidationParameters = new TokenValidationParameters
+                {
+                    ValidateIssuer = jwtBearerSetting.ValidateIssuer,//是否验证Issuer
+                    ValidIssuer = jwtBearerSetting.Issuer,//Issuer
+
+                    ValidateAudience = jwtBearerSetting.ValidateAudience,//是否验证Audience
+                    ValidAudience = jwtBearerSetting.Audience,//Audience
+
+                    ValidateIssuerSigningKey = jwtBearerSetting.ValidateIssuerSigningKey,//是否验证SecurityKey
+                    IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(jwtBearerSetting.SecurityKey)),//拿到SecurityKey
+
+                    ValidateLifetime = jwtBearerSetting.ValidateLifetime,//是否验证失效时间
+                    ClockSkew = TimeSpan.FromSeconds(jwtBearerSetting.ClockSkew)//偏差秒数：防止客户端与服务器时间偏差
+                };
+            });
+
+            //注入JWT配置
+            services.AddSingleton(jwtBearerSetting);
+        }
+    }
+}

src/Electric/Electric.Application/Electric.Application.csproj

@@ -6,4 +6,14 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
+  <ItemGroup>
+    <PackageReference Include="AutoMapper" Version="13.0.1" />
+    <PackageReference Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="8.0.4" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Electric.Application.Contracts\Electric.Application.Contracts.csproj" />
+    <ProjectReference Include="..\Electric.Domain\Electric.Domain.csproj" />
+  </ItemGroup>
+
 </Project>

src/Electric/Electric.Application/Helpers/AppSettingsHelper.cs

@@ -0,0 +1,106 @@
+using Microsoft.Extensions.Configuration;
+
+namespace Electric.Application.Helpers
+{
+    /// <summary>
+    /// appsettings.json帮助类
+    /// </summary>
+    public class AppSettingsHelper
+    {
+        #region 注入参数
+
+        /// <summary>
+        /// 配置文件
+        /// </summary>
+        private static IConfiguration? _config;
+
+        #endregion 注入参数
+
+        #region 构造函数
+
+        /// <summary>
+        /// 构造函数
+        /// </summary>
+        public AppSettingsHelper()
+        {
+            _config = new ConfigurationBuilder()
+                    .AddJsonFile("appsettings.json", true, reloadOnChange: true)
+                    .Build();
+        }
+
+        #endregion 构造函数
+
+        #region 静态方法
+
+        /// <summary>
+        /// 读取指定节点信息
+        /// </summary>
+        /// <param name="sessions">节点名称</param>
+        /// <returns></returns>
+        public static string ReadString(params string[] sessions)
+        {
+            try
+            {
+                if (_config != null && sessions.Any())
+                {
+                    string? str = _config[string.Join(":", sessions)];
+                    if (!string.IsNullOrEmpty(str))
+                    {
+                        return str;
+                    }
+                }
+            }
+            catch
+            {
+                return string.Empty;
+            }
+            return string.Empty;
+        }
+
+        /// <summary>
+        /// 读取实体信息
+        /// </summary>
+        /// <param name="sessions">节点名称</param>
+        /// <returns></returns>
+        public static T ReadObject<T>(params string[] sessions) where T : class, new()
+        {
+            T data = new();
+            try
+            {
+                if (_config != null && sessions.Any())
+                {
+                    _config.Bind(string.Join(":", sessions), data);
+                }
+            }
+            catch
+            {
+                return data;
+            }
+            return data;
+        }
+
+        /// <summary>
+        /// 读取实体集合信息
+        /// </summary>
+        /// <param name="sessions">节点名称</param>
+        /// <returns></returns>
+        public static List<T> ReadList<T>(params string[] sessions) where T : class
+        {
+            List<T> list = new();
+            try
+            {
+                if (_config != null && sessions.Any())
+                {
+                    _config.Bind(string.Join(":", sessions), list);
+                }
+            }
+            catch
+            {
+                return list;
+            }
+            return list;
+        }
+
+        #endregion 静态方法
+    }
+}

src/Electric/Electric.Application/MappingProfile.cs

@@ -0,0 +1,28 @@
+using AutoMapper;
+
+using Electric.Application.Contracts.Dto.Identity.Accounts;
+using Electric.Application.Contracts.Dto.Identity.Permissions;
+using Electric.Application.Contracts.Dto.Identity.Roles;
+using Electric.Application.Contracts.Dto.Identity.Users;
+using Electric.Domain.Entities.Identity;
+
+namespace Electric.Application
+{
+    public class MappingProfile : Profile
+    {
+        public MappingProfile()
+        {
+            //用户
+            CreateMap<EleUser, UserDto>();
+
+            //角色
+            CreateMap<EleRole, RoleDto>();
+
+            //权限
+            CreateMap<ElePermission, PermissionDto>();
+            CreateMap<ElePermission, AccountPermissionsDto>();
+            CreateMap<EleRolePermission, RoleSavePermissionDto>();
+            CreateMap<ElePermission, RoleGetPermissionDto>();
+        }
+    }
+}

src/Electric/Electric.Application/Session/EleSession.cs

@@ -0,0 +1,39 @@
+using Microsoft.AspNetCore.Http;
+
+using System.Security.Claims;
+
+namespace Electric.Application.Session
+{
+    public class EleSession : IEleSession
+    {
+        private readonly IHttpContextAccessor _httpContextAccessor;
+
+        public EleSession(IHttpContextAccessor httpContextAccessor)
+        {
+            _httpContextAccessor = httpContextAccessor;
+        }
+
+        /// <summary>
+        /// 登录用户名
+        /// </summary>
+        public string UserName
+        {
+            get
+            {
+                return _httpContextAccessor.HttpContext?.User.Identity?.Name ?? string.Empty;
+            }
+        }
+
+        /// <summary>
+        /// 登录Id
+        /// </summary>
+        public Guid UserId
+        {
+            get
+            {
+                var id = _httpContextAccessor.HttpContext?.User.FindFirstValue(ClaimTypes.Sid) ?? string.Empty;
+                return Guid.Parse(id);
+            }
+        }
+    }
+}

src/Electric/Electric.Application/Session/IEleSession.cs

@@ -0,0 +1,24 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace Electric.Application.Session
+{
+    /// <summary>
+    /// 自定义会话
+    /// </summary>
+    public interface IEleSession
+    {
+        /// <summary>
+        /// 用户名
+        /// </summary>
+        public string UserName { get; }
+
+        /// <summary>
+        /// 用户登录Id
+        /// </summary>
+        public Guid UserId { get; }
+    }
+}

src/Electric/Electric.Core/Electric.Core.csproj

@@ -6,4 +6,8 @@
     <Nullable>enable</Nullable>
   </PropertyGroup>
 
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
+  </ItemGroup>
+
 </Project>

src/Electric/Electric.Core/Exceptions/BusinessException.cs

@@ -0,0 +1,28 @@
+using Microsoft.Extensions.Logging;
+
+namespace Electric.Core.Exceptions
+{
+    [Serializable]
+    public class BusinessException : Exception, IBusinessException
+    {
+        public string? Details { get; set; }
+
+        public LogLevel LogLevel { get; set; } = LogLevel.Warning;
+
+        public BusinessException()
+        {
+        }
+
+        public BusinessException(string? message = null)
+           : base(message)
+        {
+        }
+
+        public BusinessException(string? message = null, string? details = null, Exception? innerException = null, LogLevel logLevel = LogLevel.Warning)
+            : base(message, innerException)
+        {
+            Details = details;
+            LogLevel = logLevel;
+        }
+    }
+}

src/Electric/Electric.Core/Exceptions/IBusinessException.cs

@@ -0,0 +1,9 @@
+namespace Electric.Core.Exceptions
+{
+    /// <summary>
+    /// 自定义业务异常接口
+    /// </summary>
+    public interface IBusinessException
+    {
+    }
+}

src/Electric/Electric.Domain/Electric.Domain.csproj

@@ -4,6 +4,7 @@
     <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>disable</Nullable>
+    <GenerateDocumentationFile>True</GenerateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>

src/Electric/Electric.Domain/Entities/Commons/AuditedAggregateRoot.cs

@@ -15,7 +15,7 @@
         /// 最后修改者
         /// </summary>
 
-        public TKey? LastModifierId { get; set; }
+        public TKey LastModifierId { get; set; }
 
         protected AuditedAggregateRoot()
         {

src/Electric/Electric.Domain/Entities/Identity/EleUser.cs

@@ -9,6 +9,9 @@ using System.Security.Claims;
 
 namespace Electric.Domain.Entities.Identity
 {
+    /// <summary>
+    /// 用户
+    /// </summary>
     public class EleUser : AuditedAggregateRoot<Guid>
     {
         /// <summary>
@@ -116,10 +119,22 @@ namespace Electric.Domain.Entities.Identity
         /// </summary>
         public List<EleUserToken> Tokens { get; protected set; }
 
+        /// <summary>
+        /// 无参构造函数
+        /// </summary>
         protected EleUser()
         {
         }
 
+        /// <summary>
+        /// 构造函数二
+        /// </summary>
+        /// <param name="id"></param>
+        /// <param name="userName">用户名</param>
+        /// <param name="email">邮箱</param>
+        /// <param name="fullName">全名</param>
+        /// <param name="remark">备注</param>
+
         public EleUser(Guid id, string userName, string email = null, string fullName = null, string remark = null) : base(id)
         {
             Check.NotNull(userName, nameof(userName));
@@ -141,6 +156,10 @@ namespace Electric.Domain.Entities.Identity
             Tokens = new List<EleUserToken>();
         }
 
+        /// <summary>
+        /// 添加角色
+        /// </summary>
+        /// <param name="roleId"></param>
         public void AddRole(Guid roleId)
         {
             Check.NotNull(roleId, nameof(roleId));
@@ -165,11 +184,19 @@ namespace Electric.Domain.Entities.Identity
             Roles.RemoveAll(r => r.RoleId == roleId);
         }
 
+        /// <summary>
+        /// 移除角色
+        /// </summary>
         public void RemoveAllRoles()
         {
             Roles = new List<EleUserRole>();
         }
 
+        /// <summary>
+        /// 是否拥有某个角色
+        /// </summary>
+        /// <param name="roleId"></param>
+        /// <returns></returns>
         public bool IsInRole(Guid roleId)
         {
             Check.NotNull(roleId, nameof(roleId));
@@ -177,6 +204,10 @@ namespace Electric.Domain.Entities.Identity
             return Roles.Any(r => r.RoleId == roleId);
         }
 
+        /// <summary>
+        /// 设置用户名
+        /// </summary>
+        /// <param name="userName"></param>
         public void SetUserName(string userName)
         {
             Check.NotNull(userName, nameof(userName));
@@ -185,12 +216,20 @@ namespace Electric.Domain.Entities.Identity
             NormalizedUserName = userName.ToUpperInvariant();
         }
 
+        /// <summary>
+        /// 设置邮箱
+        /// </summary>
+        /// <param name="email"></param>
         public void SetEmail(string email)
         {
             Email = email;
             NormalizedEmail = email?.ToUpperInvariant();
         }
 
+        /// <summary>
+        /// 设置密码
+        /// </summary>
+        /// <param name="passwordHash"></param>
         public void SetPasswordHash(string passwordHash)
         {
             Check.NotNull(passwordHash, nameof(passwordHash));
@@ -198,6 +237,11 @@ namespace Electric.Domain.Entities.Identity
             PasswordHash = passwordHash;
         }
 
+        /// <summary>
+        /// 添加声明
+        /// </summary>
+        /// <param name="claim"></param>
+
         public void AddClaim(Claim claim)
         {
             Check.NotNull(claim, nameof(claim));
@@ -208,6 +252,10 @@ namespace Electric.Domain.Entities.Identity
             }
         }
 
+        /// <summary>
+        /// 移除声明
+        /// </summary>
+        /// <param name="claim"></param>
         public void RemoveClaim(Claim claim)
         {
             Check.NotNull(claim, nameof(claim));
@@ -215,6 +263,10 @@ namespace Electric.Domain.Entities.Identity
             Claims.RemoveAll(x => x.UserId == Id && x.ClaimType == claim.Type);
         }
 
+        /// <summary>
+        /// 添加登录信息
+        /// </summary>
+        /// <param name="login"></param>
         public void AddLogin(UserLoginInfo login)
         {
             Check.NotNull(login, nameof(login));
@@ -222,6 +274,12 @@ namespace Electric.Domain.Entities.Identity
             Logins.Add(new EleUserLogin(login, Id));
         }
 
+        /// <summary>
+        /// 一处登录信息
+        /// </summary>
+        /// <param name="loginProvider"></param>
+        /// <param name="providerKey"></param>
+
         public void RemoveLogin(string loginProvider, string providerKey)
         {
             Check.NotNull(loginProvider, nameof(loginProvider));
@@ -231,13 +289,23 @@ namespace Electric.Domain.Entities.Identity
                 userLogin.LoginProvider == loginProvider && userLogin.ProviderKey == providerKey);
         }
 
+        /// <summary>
+        /// 检索令牌
+        /// </summary>
+        /// <param name="loginProvider"></param>
+        /// <param name="name"></param>
+        /// <returns></returns>
         public EleUserToken FindToken(string loginProvider, string name)
         {
-#pragma warning disable CS8603 // 可能返回 null 引用。
             return Tokens.FirstOrDefault(t => t.LoginProvider == loginProvider && t.Name == name);
-#pragma warning restore CS8603 // 可能返回 null 引用。
         }
 
+        /// <summary>
+        /// 设置令牌
+        /// </summary>
+        /// <param name="loginProvider"></param>
+        /// <param name="name"></param>
+        /// <param name="value"></param>
         public void SetToken(string loginProvider, string name, string value)
         {
             var token = FindToken(loginProvider, name);
@@ -251,6 +319,11 @@ namespace Electric.Domain.Entities.Identity
             }
         }
 
+        /// <summary>
+        /// 移除令牌
+        /// </summary>
+        /// <param name="loginProvider"></param>
+        /// <param name="name"></param>
         public void RemoveToken(string loginProvider, string name)
         {
             Tokens.RemoveAll(t => t.LoginProvider == loginProvider && t.Name == name);

src/Electric/Electric.Domain/Entities/Identity/EleUserRole.cs

@@ -17,9 +17,17 @@ namespace Electric.Domain.Entities.Identity
         /// </summary>
         public Guid RoleId { get; protected set; }
 
+        /// <summary>
+        /// 无参构造函数
+        /// </summary>
         protected EleUserRole()
         { }
 
+        /// <summary>
+        /// 有参构造函数
+        /// </summary>
+        /// <param name="userId"></param>
+        /// <param name="roleId"></param>
         public EleUserRole(Guid userId, Guid roleId)
         {
             UserId = userId;

src/Electric/Electric.Domain/Manager/Identity/UserManager.cs

@@ -4,18 +4,27 @@ using Microsoft.AspNetCore.Identity;
 using Microsoft.Extensions.Logging;
 using Microsoft.Extensions.Options;
 
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
 namespace Electric.Domain.Manager.Identity
 {
+    /// <summary>
+    /// 用户管理器
+    /// </summary>
     public class UserManager : UserManager<EleUser>, IDomainService
     {
         private UserStore _userStore;
 
+        /// <summary>
+        /// 用户管理器
+        /// </summary>
+        /// <param name="store"></param>
+        /// <param name="optionsAccessor"></param>
+        /// <param name="passwordHasher"></param>
+        /// <param name="userValidators"></param>
+        /// <param name="passwordValidators"></param>
+        /// <param name="keyNormalizer"></param>
+        /// <param name="errors"></param>
+        /// <param name="services"></param>
+        /// <param name="logger"></param>
         public UserManager(UserStore store,
             IOptions<IdentityOptions> optionsAccessor,
             IPasswordHasher<EleUser> passwordHasher,

src/Electric/Electric.Domain/Manager/Identity/UserStore.cs

@@ -87,10 +87,8 @@ namespace Electric.Domain.Manager.Identity
         /// <param name="normalizedUserName"></param>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
-#pragma warning disable CS8613 // 返回类型中引用类型的为 Null 性与隐式实现的成员不匹配。
 
         public async Task<EleUser> FindByNameAsync(string normalizedUserName, CancellationToken cancellationToken)
-#pragma warning restore CS8613 // 返回类型中引用类型的为 Null 性与隐式实现的成员不匹配。
         {
             cancellationToken.ThrowIfCancellationRequested();
 
@@ -105,10 +103,8 @@ namespace Electric.Domain.Manager.Identity
         /// <param name="user"></param>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
-#pragma warning disable CS8613 // 返回类型中引用类型的为 Null 性与隐式实现的成员不匹配。
 
         public Task<string> GetNormalizedUserNameAsync(EleUser user, CancellationToken cancellationToken)
-#pragma warning restore CS8613 // 返回类型中引用类型的为 Null 性与隐式实现的成员不匹配。
         {
             cancellationToken.ThrowIfCancellationRequested();
 
@@ -226,9 +222,7 @@ namespace Electric.Domain.Manager.Identity
 
             Check.NotNull(user, nameof(user));
 
-#pragma warning disable CS8604 // 引用类型参数可能为 null。
             user.SetUserName(userName);
-#pragma warning restore CS8604 // 引用类型参数可能为 null。
 
             return Task.CompletedTask;
         }

src/Electric/Electric.WebAPI/Electric.WebAPI.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>net8.0</TargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
     <InvariantGlobalization>true</InvariantGlobalization>
+    <GenerateDocumentationFile>True</GenerateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -12,6 +13,7 @@
   </ItemGroup>
 
   <ItemGroup>
+    <ProjectReference Include="..\Electric.Application\Electric.Application.csproj" />
     <ProjectReference Include="..\Electric.Domain\Electric.Domain.csproj" />
   </ItemGroup>
 

src/Electric/Electric.WebAPI/Program.cs

@@ -1,4 +1,7 @@
 using Electric.Domain.DependencyInjection;
+using Electric.Application.DependencyInjection;
+using Electric.Application.Helpers;
+using Electric.Application.Auth;
 
 var builder = WebApplication.CreateBuilder(args);
 
@@ -9,8 +12,24 @@ builder.Services.AddControllers();
 builder.Services.AddEndpointsApiExplorer();
 
 builder.Services.AddDomain();
+
+builder.Services.AddSingleton(new AppSettingsHelper());
+
+#region JWT×¢Èë
+
+var jwtBearer = new JwtBearerSetting(
+AppSettingsHelper.ReadString("JWTSettings:ValidIssuer"),
+AppSettingsHelper.ReadString("JWTSettings:ValidAudience"),
+AppSettingsHelper.ReadString("JWTSettings:IssuerSigningKey"));
+
+builder.Services.AddJWT(jwtBearer);
+
+#endregion JWT×¢Èë
+
 builder.Services.AddSwaggerGen();
 
+builder.Services.AddApplication();
+
 var app = builder.Build();
 
 // Configure the HTTP request pipeline.

src/Electric/Electric.WebAPI/appsettings.json

@@ -5,5 +5,17 @@
       "Microsoft.AspNetCore": "Warning"
     }
   },
+  "JWTSettings": {
+    "ValidateIssuerSigningKey": true, // 是否验证密钥，bool 类型，默认true
+    "IssuerSigningKey": "fdfsdfsdfsfdsfsdfsddddsdfsfsfsdfsd", // 密钥，string 类型，必须是复杂密钥，长度大于16，.NET8+ 长度需大于 32
+    "ValidateIssuer": true, // 是否验证签发方，bool 类型，默认true
+    "ValidIssuer": "http://localhost:5032", // 签发方，string 类型
+    "ValidateAudience": true, // 是否验证签收方，bool 类型，默认true
+    "ValidAudience": "http://localhost:5032", // 签收方，string 类型
+    "ValidateLifetime": true, // 是否验证过期时间，bool 类型，默认true，建议true
+    "ExpiredTime": 1440, // 过期时间，long 类型，单位分钟，默认20分钟，当前为一天
+    "ClockSkew": 5, // 过期时间容错值，long 类型，单位秒，默认 5秒
+    "Algorithm": "HS256" // 加密算法，string 类型，默认 HS256
+  },
   "AllowedHosts": "*"
 }