STUDIO 0.3.0 / AMBIENTE LINUX OBRIGATÓRIO

Desenvolver módulos nativos

Por que um módulo nativo precisa do Core

Um manifesto titan.* descreve um módulo integrado ao host: controladores, rotas, serviços, permissões agrupadas, navegação, esquema de dados e dependências. Seu ponto de entrada frequentemente registra serviços em vez de ser uma função independente.

Módulos como o MDM usam sessão, autorização, conexão PDO, migrações e canais WebSocket do Titan. Executar php service.php fora desse contexto não equivale a executar o plugin. O Studio usa o núcleo licenciado para fornecer esse contexto localmente.

Estrutura recomendada do workspace

Abra a árvore que contém os módulos e preserve os diretórios irmãos necessários às dependências:

plugins/native/
  mdm/
    manifest.json
    service.php
    index.php
    compat/
  downloads/
    manifest.json
    ...

O resolvedor lê dependencies pelo ID do manifesto. Se titan.mdm requer titan.downloads, a pasta desse segundo módulo precisa estar disponível no catálogo local. Não é necessário instalar todos os plugins na extensão.

Fluxo de trabalho

  1. Abra o manifest.json do módulo que deseja melhorar.
  2. Execute Carregar módulo nativo no Titan local. Abrir preview faz esse encaminhamento automaticamente para módulos nativos.
  3. A extensão prepara o Core, resolve o grafo de dependências e copia os fontes necessários para a árvore de desenvolvimento.
  4. A primeira rota declarada do módulo abre no painel. Use a navegação do próprio Titan para percorrer as demais telas autorizadas.
  5. Edite os arquivos originais no workspace e salve. O Studio sincroniza as cópias e atualiza o painel.
  6. Consulte os logs de PHP e do worker para investigar falhas. As migrações e consultas usam apenas o banco local.
  7. Execute os testes do repositório e revise o diff antes de planejar a atualização do ambiente de homologação.

O que é copiado

A cópia preserva o código do módulo e seus recursos. Diretórios como .git, node_modules, uploads e dados de usuários não são usados como carga inicial. Segredos em arquivos .env, chaves .secret, logs e dumps SQL não acompanham essa cópia.

Links simbólicos dentro do módulo são recusados para evitar que uma seleção local atravesse para diretórios não previstos. Se o seu projeto depende deles, organize os fontes dentro da raiz do módulo ou prepare explicitamente uma árvore de desenvolvimento sem links para dados operacionais.

O carregamento tem limites de quantidade e tamanho de arquivos. Um projeto que exceda os limites deve reduzir artefatos gerados ou dependências desnecessárias em sua árvore, não remover verificações de confinamento.

Contratos existentes

O Studio não reescreve IDs de módulo, permissões, rotas ou APIs móveis. Os adaptadores de compatibilidade são usados na cópia local. Se um manifesto antigo não tiver nome de exibição, o Studio infere esse nome apenas para o host de desenvolvimento.

Dependência ausente e dependência circular interrompem o carregamento. Um módulo pode abrir uma tela e ainda depender de outro serviço para uma ação específica. Revise libraries, serviceProvider, controladores e os contratos efetivamente usados pelo código.

Banco vazio não é ambiente homologado

O host começa sem dispositivos, pedidos, documentos ou contas reais. Algumas telas exibem estados vazios; isso é diferente de uma demonstração HTML com dados inventados. O controlador real está rodando, mas consulta uma base local nova.

Integrações com ERP, dispositivos Android, emissão de documentos e assinaturas precisam de fixtures ou serviços de homologação próprios. Não aponte os testes para dispositivos ou dados operacionais para preencher a interface.

Testar uma atualização existente

Crie uma branch no repositório, registre o comportamento anterior, desenvolva a alteração e execute os testes de contrato. Quando precisar testar migrações, use um conjunto sanitizado de dados de desenvolvimento preparado por um procedimento explícito, fora do VSIX.

A extensão não faz deploy, não reinicia workers operacionais e não publica o módulo automaticamente. O FEX Builder para plugins externos não deve ser usado para converter silenciosamente o formato de um manifesto nativo.