Contratos e Interfaces

A Importância das Interfaces (SOLID)

No Domain-System, aplicamos estritamente a "Letra I" do SOLID (Interface Segregation Principle). Classes não dependem umas das outras, elas dependem de Contratos (Interfaces).

Se o sistema espera que você extraia arquivos ZIP, ele não depende da biblioteca nativa do ZIP, ele pede um ExtractorInterface. Isso significa que amanhã você pode trocar o método de extração sem quebrar o sistema inteiro.

PluginInterface

Todo plugin DEVE assinar este contrato indiretamente (ao estender a classe abstrata AbstractPlugin). Ele dita as regras do ciclo de vida:

interface PluginInterface
{
    public function register(): void;
    public function boot(): void;
    public function osBoot(OsRuntimeInterface $runtime): void;
    public function activate(): void;
    public function deactivate(): void;
    public function uninstall(): void;
}

Explicação dos Métodos:

ManualModuleInterface (Auto-Descoberta de Manuais v2.7.0)

Qualquer plugin que possua um arquivo manual/module.php retornando uma instância de ManualModuleInterface é descoberto automaticamente pelo PluginManualScanner e injetado no menu Manual de Instruções (/admin/manual) do Cockpit:

interface ManualModuleInterface
{
    public function getId(): string;
    public function getTitle(): string;
    public function getSubtitle(): string;
    public function getBadge(): string;
    public function getAccentColor(): string;
    public function getAdminUrl(): ?string;
    public function getChecklistItems(): array;
    public function renderContent(string $baseUrl = ''): string;
}

Isso permite que plugins (como Academy LMS, FlexTheme, Pages e SEO) entreguem seus próprios tutoriais interativos e checklists de Homologação (QA) sem nenhum acoplamento com o código-fonte do Kernel!

SchemaDoctorInterface & JsonStoreInterface (Núcleo Agnóstico a Banco e SO)

No Domain-System v2.7.0, o núcleo do sistema opera de forma agnóstica em relação a banco de dados e ambiente:

🤖 Guia de Contratos para Modelos de IA

Consulte o Guia de Contratos para IA (e as diretrizes em .github/copilot-instructions.md, .cursorrules e .clinerules) para orientar ferramentas de IA a gerarem extensões aderentes a estes contratos.