Um CMS pode guardar o HTML servido ao leitor em uma coleção e o Markdown usado para editar em outra. A separação facilita atender leitores e autores, mas cria uma invariável: os dois registros representam o mesmo artigo e devem acompanhar a mesma revisão. Se um deles for atualizado sem o outro, a página pública e o editor passam a contar histórias diferentes.
Modele a publicação como uma operação
A atualização recebe título, resumo, Markdown, tags e status. O servidor valida os dados, converte Markdown em HTML e grava a saída pública junto da fonte editorial. Essa sequência parece simples enquanto não há falha entre as escritas. Se o HTML for atualizado e a gravação da fonte falhar, o leitor vê a versão nova, mas a próxima edição parte de conteúdo antigo. No sentido inverso, a fonte nova pode existir enquanto a página serve HTML anterior.
Quando os dois documentos estão no mesmo banco e a operação exige consistência, use transação ou operação atômica apropriada ao banco. Em Firestore, transações podem ler e escrever documentos como uma unidade sujeita às regras de concorrência. Se a arquitetura divide a operação entre serviços diferentes, uma transação local não cobre todos eles; use um estado intermediário e uma rotina de recuperação definida.
Diferencie conteúdo salvo de conteúdo publicado
Editar um rascunho não deveria torná-lo público por acidente. A mudança de status faz parte do contrato de gravação e precisa ser validada como evento separado da edição, se a interface permitir salvar sem publicar. Uma data futura também exige uma regra: o leitor público deve excluir o artigo até que a data seja atingida, mesmo que o documento já esteja marcado como publicado.
Mantenha publishedAt e updatedAt com significados diferentes. A data de publicação indica quando o conteúdo entrou no ar; a data de atualização registra uma revisão posterior. Se toda edição sobrescreve a data original, a cronologia do blog e os dados estruturados ficam enganosos. Para publicação agendada, não redefina publishedAt quando um editor apenas corrige uma vírgula.
Use um identificador estável
Associar a fonte Markdown ao ID do documento público simplifica a atualização e evita depender de um slug que pode mudar. O slug continua útil para a URL. Se ele mudar, atualize o valor nos dois registros e decida se a URL antiga recebe redirecionamento. Uma verificação de duplicidade precisa levar em conta concorrência: duas solicitações podem consultar o mesmo slug antes que uma delas grave.
Guarde uma revisão ou hash da fonte para identificar divergência. Ao abrir o editor, compare a revisão esperada com a atual antes de sobrescrever. Isso evita que duas sessões editem simultaneamente e a última apague silenciosamente o trabalho da primeira. Um conflito pode pedir recarga ou oferecer uma comparação antes de salvar.
Recupere operações incompletas
Mesmo uma chamada bem desenhada pode sofrer timeout depois que o banco confirma a gravação. O cliente não sabe se deve repetir. Use um identificador de operação ou uma estratégia idempotente para que uma repetição da mesma edição não crie outro documento nem cause efeitos duplicados. Armazene dados suficientes para retomar uma etapa sem reaplicar efeitos já concluídos.
Registre o ID do post, a revisão, a etapa da gravação e a falha sem colocar o corpo completo do artigo ou credenciais nos logs. Um job de reconciliação pode procurar documentos cuja revisão pública difere da fonte e reparar o par. A reconciliação precisa ser segura para executar mais de uma vez.
Firestore: transações e escritas em lote · Next.js: revalidatePath