using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

namespace IBKRTrader.Core.Modularity;

/// <summary>
/// Vertrag für ein IBKRTrader-Modul. Module referenzieren nur den Core, niemals einander.
/// Ein Modul kapselt einen eigenständigen Funktionsbereich (z. B. eine Trading-Strategie)
/// mit eigenen Services, Jobs, DB-Objekten sowie eigenen UI-Ansichten.
///
/// Vorbild: PolytraderSharp <c>IPolyTraderModule</c>.
/// </summary>
public interface IModule
{
    /// <summary>Eindeutiger Anzeigename des Moduls, z. B. "CongressTrading".</summary>
    string Name { get; }

    /// <summary>DB-Präfix für die Objekte des Moduls (z. B. "ct_"), damit sich Module nicht überschneiden.</summary>
    string DbPrefix { get; }

    /// <summary>
    /// Registriert Services/Jobs des Moduls im DI-Container. Wird beim App-Start aufgerufen,
    /// bevor der Host gebaut wird.
    /// </summary>
    void RegisterServices(IServiceCollection services, IConfiguration configuration);

    /// <summary>
    /// Registriert die UI-Ansichten des Moduls bei der Shell (Launcher). Die Shell öffnet jede Ansicht
    /// auf Wunsch in einem eigenen Fenster; Module liefern eigene Forms, die Shell bleibt modul-agnostisch.
    /// </summary>
    void RegisterUi(IModuleUiHost host, IServiceProvider services);

    /// <summary>
    /// Optionale Vorab-Prüfung, ob das Modul aktiviert werden kann. Gibt <c>null</c> zurück, wenn
    /// aktivierbar, sonst einen kurzen Grund (z. B. „IBKR-Gateway nicht konfiguriert").
    /// </summary>
    string? GetActivationBlocker(IConfiguration configuration) => null;

    /// <summary>Wird nach der Core-Initialisierung gestartet (kein Anlaufen gegen leeren State).</summary>
    Task StartAsync(CancellationToken cancellationToken);

    Task StopAsync(CancellationToken cancellationToken);
}