Migrar do admin legado para o Studio
Planeje a migração do editor separadamente da migração de Fresh para o novo Blocks.
O antigo admin da deco.cx e o Site Editor do Studio são superfícies diferentes de edição. O arquivo do admin legado preserva as telas anteriores; os guias atuais descrevem a implementação do Studio.
Fresh e o antigo admin da deco.cx foram descontinuados. Use Blocks 7.x publicado para o runtime e o Site Editor do Studio para a edição atual.
Escolher a migração necessária
| Mudança | O que altera | Por onde começar |
|---|---|---|
| Adotar o Site Editor do Studio | A superfície de edição e publicação | Conectar um site |
| Migrar Fresh para TanStack | Runtime, componentes React, build e deploy | Migração do framework |
| Adotar Blocks next | O novo contrato de framework, atualmente em preview | Quickstart de preview e compatibilidade com o Studio |
Uma mudança não conclui automaticamente as outras. Mantenha a migração do runtime e a do editor revisáveis de forma independente, mesmo quando forem entregues juntas.
Preparar um site existente
- Identifique repositório, branch de produção, URL de preview em execução e pessoas autorizadas a publicar.
- Faça um inventário de páginas, sections salvas, apps de provedores, arquivos, matchers, SEO, redirects e funcionalidades de banco de dados ou blog.
- Importe o repositório no Studio, habilite a edição de conteúdo e configure o servidor de preview. Siga Conectar um site.
- Associe o armazenamento de arquivos ao projeto. Arquivos gerenciados existentes precisam da associação correta entre site e armazenamento; acesso ao repositório não migra essa associação.
- Verifique rotas representativas: home, produto, categoria, campanha, blog e páginas próprias.
- Faça uma pequena alteração de rascunho, confira conteúdo compartilhado e variantes e exercite a publicação sob a política do projeto antes de transferir o trabalho diário da equipe.
Comparar as capacidades antes da transição
| Fluxo antigo | Fluxo do Studio ou dependência |
|---|---|
| Páginas e sections reutilizáveis | Páginas e Sections |
| Staging, Publish now, Releases | Publicação por branches e solicitação de revisão; use o histórico do repositório para reverter trabalho publicado |
| Assets | Navegador de arquivos e seletor de imagens, com armazenamento configurado |
| SEO e redirects | SEO e Redirects, com as integrações do runtime |
| Segmentos e experimentos | Variantes por matchers; confira separadamente a medição dos experimentos |
| Instalação de apps | Instale e registre a dependência no código; depois configure seus blocos |
| Blog | Coleções de blog, com suporte a status e agendamento dependente da versão |
| Domínios e redirects de apex | Use o fluxo do provedor de hospedagem; instruções do antigo admin gerenciado estão arquivadas |
Na migração de um blog Fresh descontinuado, a linha histórica deco-cx/apps adicionou status de publicação em 0.161.0 e agendamento em 0.162.0. Esses limites descrevem compatibilidade arquivada, não um setup suportado para sites novos. Migre o runtime do blog e seu conteúdo para a integração 7.x publicada e valide publicação e agendamento antes da troca.
Lacunas a resolver no seu site
O antigo assistente de configuração de Records não é uma coleção genérica de banco de dados no navegador de conteúdo do Studio revisado. Preserve banco, credenciais e código da aplicação; defina com sua equipe o fluxo de gerenciamento suportado antes de contar com uma interface equivalente. A tela de Records arquivada é documentação histórica.
O guia antigo de GTM configura uma section Analytics pelo admin anterior. Em um site atual, instale e registre a integração de analytics suportada pelo framework, confira os eventos no serviço receptor e só então transfira a operação para o Studio. Esta migração não descreve um assistente substituto sem verificação.
Confirme permissões, propriedade do armazenamento, disparos de deploy, política de revisão e rollback com os responsáveis pelo projeto. Renderizar um preview corretamente não conclui a transição.
Usar documentação arquivada
A referência Fresh preserva imports, convenções e diagnóstico específicos do runtime. Os guias legados mantêm capturas e ofertas antigas para contexto histórico. Seus rótulos não definem limites ou disponibilidade dos planos atuais.
Mantenha links antigos associados à página específica preservada ou a uma substituição verificada. O arquivo ajuda equipes existentes a interpretar suas instalações enquanto o trabalho diário passa ao editor atual.
Referências da implementação: Studio content collections, site import.