Criando Módulos na IDE
Passo a passo para criar um módulo completo para a Vupi.us API.
1. Criar um novo projeto
- Acesse
/dashboard/ide - Clique em "Novo Projeto"
- Preencha o Nome do projeto (ex: "Gerenciador de Tarefas")
- Preencha o Nome do módulo em PascalCase (ex:
Task) - Marque "Gerar estrutura padrão" para criar o scaffold completo
- Clique em "Criar Projeto"
O nome deve ser único, PascalCase, sem espaços. Nomes reservados (Auth, Usuario, Kernel, etc.) são bloqueados.
2. Estrutura gerada
Ao marcar "Gerar estrutura padrão", a IDE cria:
Task/
├── Controllers/TaskController.php — Endpoints da API (CRUD)
├── Services/TaskService.php — Lógica de negócio
├── Repositories/TaskRepository.php — Acesso a dados (PDO)
├── Entities/Task.php — Entidade de domínio
├── DTOs/CreateTaskDTO.php — Data Transfer Object
├── DTOs/UpdateTaskDTO.php
├── Middlewares/TaskMiddleware.php — Middleware próprio
├── Validators/TaskValidator.php — Validação de dados
├── Exceptions/TaskException.php — Exceções de domínio
├── Helpers/TaskHelper.php — Funções utilitárias
├── Config/config.php — Configurações do módulo
├── Database/
│ ├── connection.php — Seleção de banco
│ ├── Migrations/... — Criação de tabelas
│ └── Seeders/TaskSeeder.php — Dados iniciais
├── Routes/web.php — Definição de rotas
├── composer.json — Dependências externas do módulo
└── README.md — DocumentaçãoCada módulo tem seu próprio composer.json. Declare dependências externas (PHPMailer, Guzzle, Stripe SDK, etc.) na seção require. Ao publicar, o sistema instala automaticamente apenas os pacotes novos, detecta conflitos de versão antes de qualquer mudança e recarrega o PHP-FPM graciosamente.
3. Dependency Health — verificação antes do deploy
O painel lateral da IDE exibe automaticamente o status das dependências do módulo:
| Status | Significado | Ação |
|---|---|---|
| 🟢 OK | Tudo instalado e compatível | Pode publicar |
| 🟡 Warning | Lib não instalada ainda | Será instalada no deploy |
| 🔴 Critical | Conflito de versão | Ajuste a constraint no composer.json |
4. Publicar o módulo
O módulo já existe em src/Modules/ desde a criação. Cada arquivo salvo é sincronizado automaticamente para o disco. Quando estiver pronto para disponibilizar as rotas:
4. Ativar o módulo
No painel lateral da IDE, clique em "Ativar". O sistema executa automaticamente:
- Analisa o código (erros bloqueiam a ativação)
- Verifica conflitos de dependências — bloqueia se houver incompatibilidade
- Instala dependências novas via
composer require - Executa as migrations automaticamente
- Executa os seeders automaticamente
- Ativa as rotas — ficam disponíveis imediatamente na API
5. Desativar o módulo
Módulos são criados desativados por padrão. Para desativar um módulo ativo, clique em "Desativar" no painel lateral. As rotas somem mas os dados e arquivos são preservados.