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.
- Mapeie no manifesto nativo cada URL preservada ao controlador do plugin. Mantenha os aliases públicos nas regras que já os atendem.
- 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.
- 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.
- 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.
- 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.