TeamAAS-2.5/TeamAAS.Base/TeamAAS.Database/Interfaces/IDatabaseManager.cs

using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using TeamAAS.Database.Models;

namespace TeamAAS.Database.Interfaces
{
    /// <summary>
    /// 数据库管理器接口。
    /// 负责多数据库实例的生命周期管理、配置持久化以及提供者发现。
    /// </summary>
    public interface IDatabaseManager : IDisposable
    {
        /// <summary>
        /// 创建数据库实例
        /// </summary>
        /// <param name="id">唯一标识</param>
        /// <param name="config">数据库配置</param>
        /// <returns>是否创建成功</returns>
        bool CreateDatabase(Guid id, DatabaseConfig config);

        /// <summary>
        /// 异步创建数据库实例
        /// </summary>
        Task<bool> CreateDatabaseAsync(Guid id, DatabaseConfig config);

        /// <summary>
        /// 获取指定数据库实例
        /// </summary>
        IDatabase GetDatabase(Guid id);

        /// <summary>
        /// 尝试获取数据库实例
        /// </summary>
        bool TryGetDatabase(Guid id, out IDatabase database);

        /// <summary>
        /// 是否包含指定数据库
        /// </summary>
        bool ContainsDatabase(Guid id);

        /// <summary>
        /// 获取所有数据库实例
        /// </summary>
        IReadOnlyCollection<IDatabase> GetAllDatabases();

        /// <summary>
        /// 移除数据库实例
        /// </summary>
        bool RemoveDatabase(Guid id);

        /// <summary>
        /// 异步移除数据库实例
        /// </summary>
        Task<bool> RemoveDatabaseAsync(Guid id);

        /// <summary>
        /// 移除所有数据库
        /// </summary>
        void RemoveAllDatabases();

        /// <summary>
        /// 初始化所有数据库（根据配置创建实例）
        /// </summary>
        /// <param name="configs">数据库配置数组</param>
        /// <returns>是否成功</returns>
        (bool IsSucceed, string Message) InitializeAllDatabases(DatabaseConfig[] configs);

        /// <summary>
        /// 异步初始化
        /// </summary>
        Task<(bool IsSucceed, string Message)> InitializeAllDatabasesAsync(DatabaseConfig[] configs);

        /// <summary>
        /// 获取所有数据库配置
        /// </summary>
        IReadOnlyList<DatabaseConfig> GetAllDatabaseConfigs();

        /// <summary>
        /// 保存配置到指定路径
        /// </summary>
        bool SaveConfig(string path = null);

        /// <summary>
        /// 获取可用的数据库提供者列表（反射发现）
        /// </summary>
        List<DatabaseProviderInfo> GetAvailableProviders();
    }
}