STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO
Núcleo e host local
O que acompanha o VSIX
Após validar a licença, a extensão baixa um snapshot privado de código do Titan Core, dos recursos visuais compartilhados, das bibliotecas usadas pela base e do worker WebSocket. O snapshot não contém os diretórios de plugins nativos, uploads, banco operacional, sessões reais nem a configuração de conexão da instalação original.
Um inventário com hashes identifica os arquivos do snapshot. As ferramentas de desenvolvimento usam esse código para montar uma árvore de execução própria. Os fontes originais do núcleo e dos módulos não são alterados para iniciar esse host.
Iniciar uma base vazia
Execute Titan Architect: Iniciar núcleo Titan local. A extensão:
- Prepara um diretório privado na área de armazenamento da extensão.
- Materializa o núcleo e a interface, com perfil
core-only. - Configura uma conexão exclusivamente para o banco
titan_studioem um socket Unix privado. - Inicializa um datadir MySQL próprio quando ainda não existe uma inicialização concluída.
- Cria uma identidade local de desenvolvimento. Não importa contas reais.
- Inicia um servidor PHP em loopback e um worker WebSocket próprio, em portas livres.
- Abre um painel com o Titan real dentro do VS Code.
MySQL é iniciado com --no-defaults e --skip-networking. Ele não lê a configuração de uma instância operacional nem abre uma porta TCP de banco. Os arquivos e o socket pertencem apenas a essa instância de desenvolvimento.
Sessão de desenvolvimento
A abertura do painel usa um link de entrada assinado, de uso único. Ele permite configurar a conta somente enquanto o primeiro acesso está pendente. Depois disso, abrir o host exige o login normal com a senha definida pelo desenvolvedor. Depois da entrada, o núcleo usa seus mecanismos normais de sessão, permissões e CSRF sobre o banco privado.
Esse mecanismo não é um bypass de autenticação para uma instalação existente. O router exige a marca de propriedade do Studio e a configuração específica do seu próprio host. O link de entrada não deve ser compartilhado; seus valores são removidos dos logs de processo exibidos pela extensão.
HTTP e WebSocket
A entrega de páginas, arquivos estáticos e cookies usa HTTP local. As operações que o Titan já executa por WebSocket continuam usando o worker real. Não há fallback HTTP silencioso para simular sucesso quando o WebSocket falha.
Em Remote SSH/WSL, o Studio pede ao VS Code os endereços encaminhados das portas. O endereço WebSocket é configurado para a mesma sessão de desenvolvimento. Se houver restrições de encaminhamento, confira o painel Portas e os logs; não desative autenticação ou proteção de origem para contornar o erro.
Carregar um módulo
O host começa sem plugins. Ao selecionar um módulo nativo, o Studio resolve suas dependências a partir dos manifestos disponíveis ao lado dele no workspace. Só essa seleção e suas dependências são copiadas para a árvore local.
Arquivos de compatibilidade e recursos visuais do módulo são materializados para preservar os caminhos esperados pelo código existente. Manifestos antigos sem nome de exibição recebem um nome na cópia local; o arquivo original não é reescrito.
Os controladores e suas migrações executam sobre o banco de desenvolvimento. Uma migração local não demonstra que uma migração operacional seja segura. Testes de atualização com dados representativos e rollback continuam necessários antes da publicação real.
Persistência e encerramento
Parar host local encerra apenas os processos que o Studio iniciou. Os dados de desenvolvimento são preservados para a próxima sessão. Fechar somente a aba do host não equivale a parar o banco e o worker; use o comando de parada quando terminar.
Desativar a extensão também solicita encerramento dos processos que ela gerencia. Se o editor ou o sistema encerrar abruptamente, pode sobrar um processo local. O Studio recusa iniciar outra instância sobre um socket já existente; veja o guia de recuperação antes de remover arquivos.
E-mail e integrações
O adaptador de e-mail do host registra mensagens em uma caixa local privada e não envia SMTP. Ele não confirma uma entrega externa que não aconteceu. Fluxos de negócio que mostram status de envio devem ser interpretados nesse contexto de desenvolvimento.
A extensão não fornece credenciais operacionais aos módulos. Se o código de um plugin lê caminhos absolutos, acessa serviços externos ou possui defaults específicos da sua empresa, revise e adapte essa configuração para homologação. O host local não é uma sandbox de kernel nem um simulador universal de ERP, dispositivos ou serviços de terceiros.