README

Ferramentas de desenvolvimento para o sistema modular CodeIgniter 4. Inclui marketplace de módulos, gerenciador de configurações, automação de ciclo de vida e geradores de código.

📋 Características

• ✅ Module Marketplace - Interface web para gerenciar módulos.
• ✅ Settings Manager - Gerenciador centralizado de configurações para todos os módulos.
• ✅ Lifecycle Automation - Execução automática de hooks (install, uninstall).
• ✅ Home Modularization - Converter o projeto base em um sistema modular com auto-ativação.
• ✅ Hot-namespace Registration - Registro imediato de namespaces para execução de migrações sem restart.
• ✅ CLI Generators - Criação rápida de módulos, controladores, migrações e seeders.

🚀 Comandos CLI

O pacote adiciona diversos comandos ao php spark para agilizar o desenvolvimento:

Gerenciamento de Módulos

• module:init-core: Inicializa os módulos base (Dashboard e gerenciador de módulos).
• module:init <Name>: Cria um novo módulo com estrutura completa (CRUD, Migration, View).
• module:modularize-home: Transforma o controlador Home.php e a view welcome_message.php em um módulo modular funcional com auto-ativação.
• module:list: Lista todos os módulos instalados e seus respectivos status.

Ciclo de Vida e Instalação

• module:install <Name>: Instala um módulo do repositório local ou via URL.
• module:enable/disable <Name>: Ativa ou desativa um módulo sem removê-lo.
• module:publish <Name>: Prepara e publica os assets de um módulo para a pasta pública.
• module:assets <Name>: Gerencia a sincronização de arquivos estáticos.

🚀 Novidades na v1.4.0

Automação Inteligente de Views

O mecanismo de modularização da Home agora utiliza expressões regulares avançadas para injetar snippets de autenticação (Login/Logout/Dashboard) sem quebrar o layout original, preservando a navegação existente.

Ciclo de Vida Completo

O comando module:modularize-home agora realiza a ativação automática do módulo, gerenciando as rotas da aplicação central instantaneamente.

🚀 Instalação

composer require rahpt/ci4-module-tools

Configuração

app/Config/ModuleTools.php:

<?php

namespace Config;

use Rahpt\Ci4ModuleTools\Config\ModuleTools as BaseModuleTools;

class ModuleTools extends BaseModuleTools
{
    // Path do repositório local de módulos
    public string $localRepository = APPPATH . 'Modules';
    
    // Modo debug para log de desenvolvimento
    public bool $debugMode = true;
}

📖 Histórico de Versões

[1.5.1] - 2026-02-26

• Fix: Correção crítica no redirecionamento para novos usuários sem UID gerado.
• Melhoria: Geração automática de UID no momento do primeiro acesso ao Dashboard.

[1.5.0] - 2026-02-26

• Novo: Lógica de desambiguação inteligente no gerador de Dashboard (/dashboard -> /ID/panel para não-admins).
• Melhoria: Documentação técnica expandida nos módulos gerados sobre fluxo de acesso.

[1.4.0] - 2026-02-22

• Novo: Auto-ativação do módulo Home no comando module:modularize-home.
• Melhoria: Novo sistema de injeção de views baseado em regex para maior compatibilidade.
• Otimização: Refatoração interna do registro de status de módulos.

[1.3.0] - 2026-02-22

• Novo: Comando module:modularize-home para conversão de projetos base.
• Novo: Comando module:init-core para setup inicial de Dashboard e Gerenciador.
• Melhoria: Integração profunda com CodeIgniter Shield.

[1.2.0] - 2026-02-18

• Novo: Implementado Settings Manager para gerenciamento centralizado.
• Melhoria: Suporte a Hooks de Automação: install() e uninstall().

📄 Licença

MIT License

👏 Créditos

Desenvolvido por Rahpt

Versão: 1.5.1
Última Atualização: 2026-02-26