Prepare os dados do seu grupo antes que eles tenham que se mover.

1. Decida o que o pacote deve permitir que você faça.

Escreva o resultado pretendido antes de selecionar um botão de exportação. Uma cópia legível para um membro que está saindo, uma mudança para outro aplicativo e uma recuperação completa do serviço existente precisam de material diferente. Uma exportação pode servir bem ao primeiro propósito e falhar nos outros dois.

O BookStack deixa essa distinção explícita: suas ferramentas de exportação e importação de conteúdo não se destinam a backup e restauração. Uma cópia legível em HTML ou PDF é útil, mas não deve substituir silenciosamente o conjunto de recuperação da aplicação. Exportação e importação de conteúdo do BookStack.

Para um grupo de oficina hipotético, o objetivo inicial é modesto: outro mantenedor autorizado consegue ler o manual de operação e importar uma seção representativa, incluindo seus diagramas, para uma instância de teste separada.

2. Registre o formato e as lacunas.

Crie uma matriz que descreva o que você precisa preservar e como vai provar isso. Não coloque “completo” em uma célula antes de verificar o destino.

O BookStack documenta um formato ZIP portátil contendo dados de conteúdo, anexos e imagens que podem ser reimportados para o BookStack. Isso não estabelece compatibilidade com outra wiki nem preservação de todas as configurações de nível de serviço. Formatos de exportação do BookStack.

3. Dê ao pacote um ponto de partida humano.

Adicione um breve leia-me com a aplicação de origem e versão, data e fuso horário da exportação, escopo selecionado, papel do exportador, lista de arquivos e destino esperado. Use nomes de pasta descritivos como readable-content, attachments e import-package. Mantenha as credenciais em outro lugar; escreva apenas o procedimento de recuperação aprovado para mantenedores autorizados.

O manual hipotético contém uma lista de verificação inicial, uma página de cuidados com a máquina, um diagrama e uma planilha vinculada. Seu manifesto registra esses quatro itens, seus caminhos relativos e a relação entre a página e seu anexo. Registre também uma página restrita como deliberadamente excluída, para que uma ausência não seja mais tarde confundida com perda acidental.

Uma soma de verificação pode ajudar a identificar um arquivo inalterado durante a transferência. Ela não prova que a exportação foi completa, com permissões corretas ou legível.

4. Inspecione uma amostra representativa.

Abra a cópia legível sem depender de uma sessão ativa na aplicação original. Siga um link, inspecione uma imagem incorporada e abra o anexo vinculado. Procure referências que ainda apontam de volta para o serviço de origem. Registre quais links são intencionalmente externos e quais quebrariam após uma migração.

Para calendários, escolha uma amostra que inclua um evento recorrente, uma exceção e um evento com fuso horário relevante. O Nextcloud documenta exportação de calendário e compatibilidade com iCalendar .ics importação. Isso estabelece um caminho de troca suportado, não prova que seu destino preserva cada recurso escolhido. Importação e exportação de calendário do Nextcloud.

Consulte a documentação da sua versão instalada antes de seguir os rótulos da interface; o manual contínuo vinculado pode descrever uma versão diferente.

5. Importe para um destino separado e controlado.

Use um destino de teste vazio ou uma coleção de teste explicitamente aprovada. Mantenha o serviço em funcionamento e seus dados originais intactos. Desative notificações de saída e contenha conexões externas antes de iniciar a aplicação importada; o propósito é avaliar os dados, não reenviar eventos históricos aos membros.

Peça que o segundo mantenedor siga o leia-me sem depender de instruções não documentadas do exportador. Compare os itens esperados com o resultado importado. Verifique o diagrama, o link da planilha, a estrutura da página e as permissões de membro pretendidas. Registre qualquer mapeamento de papel que exija trabalho manual. Se um formato não tiver um recurso necessário, decida se deve reconstruí-lo, escolher outro método de exportação ou manter um arquivo legível junto ao novo serviço.

6. Torne a falha informativa.

Se faltarem arquivos, compare o escopo da exportação e as permissões do exportador antes de produzir repetidamente arquivos maiores. Se os links quebrarem, determine se eles referenciam o serviço antigo ou um arquivo ausente do pacote. Se a importação criar duplicatas inesperadas, pare e inspecione suas regras de correspondência antes de importar o mesmo pacote novamente.

Para o exemplo da oficina, aceitação significa que o segundo mantenedor consegue ler e editar as páginas selecionadas, recuperar cada arquivo incluído e demonstrar que um membro comum não consegue acessar o material excluído. Registre cada resultado e seu revisor. “A importação terminou” é apenas uma observação. Mantenha diferenças não resolvidas listadas junto ao pacote para que o grupo possa tomar uma decisão deliberada sobre elas.

7. Mantenha exportações e recuperação em suas próprias raias.

Armazene um pacote aceito em um local controlado independente do serviço de origem e acorde quando atualizá-lo. Revise novamente após mudanças em formatos importantes, permissões ou versões de aplicação. Arquivos de exportação podem conter conteúdo privado mesmo quando o destino é apenas temporário, então atribua acesso e uma decisão de retenção a eles também.

Mantenha o conjunto de recuperação da aplicação separadamente: a documentação de recuperação do BookStack, por exemplo, exige banco de dados e material de arquivo além de uma exportação de documento legível. Requisitos de backup e restauração do BookStack.

Continue com o simulação de restauração para recuperação de serviço, o planilha de armazenamento para espaço de trabalho de exportação e o inventário de serviços para dependências. A portabilidade é algo a demonstrar com seu pacote, não presumir a partir de uma extensão de arquivo.