feat: initialize Evergreen Health backend

2026-09-21 14:08:22 +08:00
commit 8553df5dd2
493 changed files with 75649 additions and 0 deletions
@@ -0,0 +1,47 @@
+// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
+//
+// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
+//
+// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
+
+using Elastic.Clients.Elasticsearch;
+
+namespace Admin.NET.Core;
+
+/// <summary>
+/// ES客户端容器
+/// </summary>
+public class ElasticSearchClientContainer
+{
+    private readonly Dictionary<EsClientTypeEnum, ElasticsearchClient> _clients;
+
+    /// <summary>
+    /// 初始化容器（通过字典注入所有客户端）
+    /// </summary>
+    public ElasticSearchClientContainer(Dictionary<EsClientTypeEnum, ElasticsearchClient> clients)
+    {
+        _clients = clients ?? throw new ArgumentNullException(nameof(clients));
+    }
+
+    /// <summary>
+    /// 日志专用客户端
+    /// </summary>
+    public ElasticsearchClient Logging => GetClient(EsClientTypeEnum.Logging);
+
+    /// <summary>
+    /// 业务数据同步客户端
+    /// </summary>
+    public ElasticsearchClient Business => GetClient(EsClientTypeEnum.Business);
+
+    /// <summary>
+    /// 根据类型获取客户端（内部校验，避免未注册的类型）
+    /// </summary>
+    private ElasticsearchClient GetClient(EsClientTypeEnum type)
+    {
+        if (_clients.TryGetValue(type, out var client))
+        {
+            return client;
+        }
+        throw new KeyNotFoundException($"未注册的ES客户端类型：{type}，请检查注册配置");
+    }
+}
@@ -0,0 +1,85 @@
+// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
+//
+// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
+//
+// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
+
+using Elastic.Clients.Elasticsearch;
+using Elastic.Transport;
+
+namespace Admin.NET.Core;
+
+public class ElasticSearchClientFactory
+{
+    /// <summary>
+    /// 创建 ES 客户端（通用方法）
+    /// </summary>
+    /// <typeparam name="TOptions">配置类型（支持通用或场景专用）</typeparam>
+    /// <param name="configPath">配置文件路径（如 "ElasticSearch:Logging"）</param>
+    /// <returns>ES 客户端实例（或 null  if 未启用）</returns>
+    public static ElasticsearchClient? CreateClient<TOptions>(string configPath) where TOptions : ElasticSearchOptions, new()
+    {
+        // 从配置文件读取当前场景的配置
+        var options = App.GetConfig<TOptions>(configPath);
+        if (options == null)
+            throw Oops.Oh($"未找到{configPath}配置项");
+
+        if (!options.Enabled)
+            return null;
+
+        // 验证服务地址
+        if (options.ServerUris == null || !options.ServerUris.Any())
+            throw new ArgumentException($"ES 配置 {configPath} 未设置 ServerUris");
+
+        // 构建连接池（支持集群）
+        var uris = options.ServerUris.Select(uri => new Uri(uri)).ToList();
+        var connectionPool = new StaticNodePool(uris);
+        var connectionSettings = new ElasticsearchClientSettings(connectionPool)
+            .DefaultIndex(options.DefaultIndex) // 设置默认索引
+            .DisableDirectStreaming()  // 开启请求/响应日志，方便排查问题
+            .OnRequestCompleted(response =>
+            {
+                if (response.HttpStatusCode == 401)
+                {
+                    Console.WriteLine("ES 请求被拒绝：未提供有效认证信息");
+                }
+            });
+
+        // 配置认证
+        ConfigureAuthentication(connectionSettings, options);
+
+        // 配置 HTTPS 证书指纹
+        if (!string.IsNullOrEmpty(options.Fingerprint))
+            connectionSettings.CertificateFingerprint(options.Fingerprint);
+
+        return new ElasticsearchClient(connectionSettings);
+    }
+
+    /// <summary>
+    /// 配置认证（通用逻辑）
+    /// </summary>
+    private static void ConfigureAuthentication(ElasticsearchClientSettings settings, ElasticSearchOptions options)
+    {
+        switch (options.AuthType)
+        {
+            case ElasticSearchAuthTypeEnum.Basic:
+                settings.Authentication(new BasicAuthentication(options.User, options.Password));
+                break;
+
+            case ElasticSearchAuthTypeEnum.ApiKey:
+                settings.Authentication(new ApiKey(options.ApiKey));
+                break;
+
+            case ElasticSearchAuthTypeEnum.Base64ApiKey:
+                settings.Authentication(new Base64ApiKey(options.Base64ApiKey));
+                break;
+
+            case ElasticSearchAuthTypeEnum.None:
+                // 无需认证
+                break;
+
+            default:
+                throw new ArgumentOutOfRangeException(nameof(options.AuthType));
+        }
+    }
+}
@@ -0,0 +1,41 @@
+// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。
+//
+// 本项目主要遵循 MIT 许可证和 Apache 许可证（版本 2.0）进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。
+//
+// 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动！任何基于本项目二次开发而产生的一切法律纠纷和责任，我们不承担任何责任！
+
+using Elastic.Clients.Elasticsearch;
+
+namespace Admin.NET.Core.ElasticSearch;
+
+/// <summary>
+/// ES服务注册
+/// </summary>
+public static class ElasticSearchSetup
+{
+    /// <summary>
+    /// 注册所有ES客户端（日志+业务）
+    /// </summary>
+    public static void AddElasticSearchClients(this IServiceCollection services)
+    {
+        // 1. 创建客户端字典（枚举→客户端实例）
+        var clients = new Dictionary<EsClientTypeEnum, ElasticsearchClient>();
+
+        // 2. 注册日志客户端
+        var loggingClient = ElasticSearchClientFactory.CreateClient<ElasticSearchOptions>(configPath: "ElasticSearch:Logging");
+        if (loggingClient != null)
+        {
+            clients[EsClientTypeEnum.Logging] = loggingClient;
+        }
+
+        // 3. 注册业务客户端
+        var businessClient = ElasticSearchClientFactory.CreateClient<ElasticSearchOptions>(configPath: "ElasticSearch:Business");
+        if (businessClient != null)
+        {
+            clients[EsClientTypeEnum.Business] = businessClient;
+        }
+
+        // 4. 将客户端容器注册为单例（全局唯一）
+        services.AddSingleton(new ElasticSearchClientContainer(clients));
+    }
+}