using IBKRTrader.Core.Workers;
using Microsoft.Extensions.DependencyInjection;

namespace IBKRTrader.Core.Modules;

/// <summary>
/// Vertrag für ein eigenständiges Trading-Modul.
///
/// Architektur-Regel: Der Core kennt konkrete Module NICHT. Module hängen sich
/// ausschließlich über diesen Vertrag und den DI-Container ein
/// (Abhängigkeit nur Modul → Core, niemals umgekehrt).
///
/// Lebenszyklus:
///   1. <see cref="RegisterServices"/>  – vor dem Bauen des DI-Containers
///   2. <see cref="InitializeAsync"/>   – beim App-Start (Migrationen etc.)
///   3. <see cref="GetWorkers"/>        – Worker werden der WorkerEngine übergeben
///   4. <see cref="CreateWindow"/>      – Launcher öffnet das Modul-Fenster
/// </summary>
public interface IModule
{
    /// <summary>Eindeutiges Modul-Kürzel, zugleich DB-Tabellen-Präfix (z. B. "CT").</summary>
    string Key { get; }

    /// <summary>Anzeigename im Launcher (z. B. "Congress Trading").</summary>
    string DisplayName { get; }

    /// <summary>Kurzbeschreibung der Strategie für den Launcher.</summary>
    string Description { get; }

    /// <summary>Modul-Version.</summary>
    string Version { get; }

    /// <summary>Registriert alle Modul-Services im DI-Container (vor dem Build).</summary>
    void RegisterServices(IServiceCollection services);

    /// <summary>Führt Modul-Migrationen und einmalige Initialisierung aus (beim Start).</summary>
    Task InitializeAsync(IServiceProvider provider);

    /// <summary>Liefert die Worker/Services des Moduls für die WorkerEngine.</summary>
    IEnumerable<IWorker> GetWorkers(IServiceProvider provider);

    /// <summary>Erzeugt das eigenständige Fenster des Moduls (vom Launcher geöffnet).</summary>
    Form CreateWindow(IServiceProvider provider);
}