STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Testes, diagnóstico e logs

Diagnóstico do ambiente

Diagnosticar ambiente chama doctor all da CLI embarcada. Ele identifica versões e ferramentas ausentes. O host nativo também requer MySQL Server e extensões PHP específicas. Em Remote SSH/WSL, execute o diagnóstico nesse mesmo host.

Uma ferramenta ausente não deve ser substituída por uma resposta de sucesso. Corrija o PATH ou os caminhos nas configurações de usuário e repita o comando.

Testes do projeto

Executar testes do projeto chama test da CLI no projeto selecionado. Os scripts declarados por ele são executados; esse comando não é apenas uma checagem de sintaxe. Use-o somente em um workspace confiável.

No projeto PHP gerado, instale as dependências com Composer e execute composer test. No TypeScript, instale dependências adicionais quando necessárias e execute npm test; o modelo gerado compila a entrada antes do teste.

O Studio não inventa uma suíte para um módulo existente. Se um módulo usa um runner próprio, execute os testes do repositório pelo terminal do VS Code. Preserve testes de caracterização, contrato e compatibilidade móvel durante uma atualização.

Validação e testes são diferentes

A validação FEX verifica manifesto, arquivos selecionados e sintaxe, sem executar a entrada do plugin. Ela não comprova autorização operacional, ausência de vulnerabilidades ou desempenho.

Manifestos nativos têm formato e ciclo de vida próprios. Não transforme silenciosamente seu objeto de permissões agrupadas no array de um plugin externo. Use o host de desenvolvimento e os validadores do repositório para esse caso.

Logs

Abra Titan Architect: Mostrar logs ou selecione Titan Architect Studio no painel Saída. O canal reúne inicialização de processos, compilação, validação, mensagens de backend, falhas e chamadas às fixtures.

Os runners encaminham mensagens de execução com limite de tamanho. O host real mantém os logs próprios do PHP, MySQL e Workerman no diretório de desenvolvimento. Links de entrada do Studio são removidos da saída de processo encaminhada ao editor.

Não imprima tokens ou credenciais nos logs do seu próprio plugin. A extensão não consegue tornar segura uma mensagem que o código deliberadamente registra.

Critérios antes de atualizar um módulo

Confira o diff e execute os cenários válidos e os de acesso negado. Teste perda de conexão WebSocket sem repetir gravações automaticamente. Quando houver migração, preserve dados de teste, exercite rollback e confirme resultados de negócio. Faça a homologação com contas e dispositivos autorizados; a extensão não emite uma aprovação de produção.