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:
- register() / osRegister(): O lugar certo para negociar capacidades com o Gatekeeper e registrar Rotas, Listeners de Eventos e Menus no painel.
- boot() / osBoot(): Executado após todos os plugins terminarem de se registrar. O
osBoot(OsRuntimeInterface $runtime)é o padrão arquitetural (v2.7.0) para acesso seguro ao Kernel. - activate(): Rodado apenas uma vez quando você liga o Plugin no Painel (Ideal para Migrations e criação de tabelas).
- deactivate() / uninstall(): Usados para limpar os rastros que o plugin deixou quando for desativado ou deletado.
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:
SchemaDoctorInterface: Injetado noMonitorControllere noStateSnapshotManagerpara diagnosticar e auto-reparar (healAll()) migrações de plugins com SQL ANSI puro.JsonStoreInterface(AtomicJsonStore): Persistência atômica comflock(LOCK_EX)+ arquivo temporário +rename()atômico para protegerconfig/*.jsonetemp/*.jsoncontra Race Conditions.LessonFileScaffolderInterface: Contrato da Fábrica Automática do Academy LMS que cria subpastas de módulos (createFolder) e fabrica automaticamente arquivos fÃsicos.phpno tema ativo (ex:pages/estrutura-de-dados.php→/cursos/estrutura-de-dados).
🤖 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.