Kit de compatibilidade

Use rotas.json como modelo de inventário ao mover uma tela ou uma API para um plugin. O exemplo usa Chamados. Registre as URLs, os aliases, métodos, tópicos WebSocket, permissões e versões do esquema da sua instalação antes de mover o código.

  1. Mapeie no manifesto nativo cada URL preservada ao controlador do plugin. Mantenha os aliases públicos nas regras que já os atendem.
  2. Aplique no controlador as verificações existentes de autenticação, escopo, permissão e CSRF. Use as permissões já concedidas. Chamados combina acesso, ação autorizada e escopo do chamado.
  3. Preserve os nomes dos tópicos WebSocket e o formato dos pedidos, respostas e eventos. Use o SDK para chamar serviços dos módulos responsáveis e garanta idempotência nas operações que já aceitam repetição.
  4. Mantenha as tabelas existentes e as chaves do ledger. Faça migrações aditivas em etapas para que a versão anterior ainda possa executar durante o rollback.
  5. Compare os resultados da versão anterior com a versão candidata em banco descartável. Teste consultas e gravações como usuário autorizado, respostas de acesso negado, reconexão e URLs antigas. Preserve os arquivos de configuração, uploads e APKs na publicação.

O inventário é um modelo de verificação. O runtime registra rotas pelo manifesto do plugin. Os tipos de integração, contratos e comandos de validação estão no guia do SDK.

Compare duas versões no CI

Mantenha no repositório um inventário por versão. Compare o candidato com a versão em operação antes de publicar.

python3 titanArchitect-sdk/tools/comparar-contratos.py   compatibilidade/rotas-anterior.json   compatibilidade/rotas-candidato.json --json
Resultado Código de saída
Contrato preservado, com possíveis adições 0
Mudança crítica para revisar 1
Inventário inválido ou inacessível 2

O comparador verifica caminhos e aliases, métodos removidos, canais WebSocket, permissões, CSRF e versões de migração. Ele aceita mudanças no caminho físico do controlador quando o contrato público continua igual. Um avanço de esquema aparece como adição. Ainda é necessário validar a migração com dados representativos e conferir as respostas HTTP e WebSocket em homologação.