Esclareça a tarefa e a decisão
Este guia transforma o guia de implementação drupal em um fluxo de trabalho operacional revisável. Ele conecta decisões de domínio, propriedade, evidências e aceitação para que o resultado continue funcionando na produção.
Use revisões Drupal, moderação de conteúdo e permissões para geração separada, revisão especializada e publicação.
Processo prático
- 1
Tipos de origem de inventário, identificadores, campos, localidades, proprietários e estados de publicação.
- 2
Escolha o padrão de entrega entre volume, latência, controle editorial e tolerância a falhas.
- 3
Mapeie o registro de origem para um registro de versão de idioma separado com ligação durável.
- 4
Adicione autenticação, idempotência, nova tentativa, invalidação de cache, registro em log e controles de acesso.
- 5
Publicação de testes, alterações de origem, resultados indisponíveis, reversão, operação do teclado e monitoramento antes do lançamento.
Exemplo ou ferramenta
Um tipo de conteúdo moderado mostra campos, funções, revisões, entrega e reversão. Na ferramenta, registre também a linha de base, o proprietário, a decisão, as evidências, a questão em aberto e a data de aprovação. Use uma página ou transação real para que a equipe veja dependências, exceções e o trabalho de manutenção que segue o lançamento.
| Ponto de decisão | Registro | Critério de aceitação |
|---|---|---|
| Linha de base | Estado atual observado | Fonte e data registrada |
| Decisão | Opção selecionada e justificativa | Risco e público considerados |
| Evidência | Teste, documente ou meça | Revisável e específico da versão |
| Aprovação | Nome, função e data | Todos os critérios obrigatórios atendidos |
Crie um modelo de conteúdo que preserve a proveniência
Crie um tipo de conteúdo de linguagem acessível ou uma entidade estruturada com uma referência de entidade à fonte oficial. Inclua ID de revisão de origem, localidade, modo de idioma, ID de resultado, estado de revisão, versão do glossário, nível de risco, aprovadores e acionador da próxima revisão. Use parágrafos ou campos estruturados para títulos, listas, links, avisos, downloads e informações de contato. Um único campo rich text irrestrito dificulta a validação, a reutilização e a renderização segura em nível de campo.
Escolha deliberadamente entre a relação de tradução de Drupal e uma entidade relacionada separada. A tradução padrão funciona quando a estrutura do campo e o ciclo de vida editorial permanecem equivalentes. Uma entidade separada é mais segura quando a versão acessível combina, reordena ou explica os campos de origem e precisa de moderação diferente. Em ambos os casos, mantenha a revisão de origem imutável para a transformação e exiba o status obsoleto quando a origem atual não corresponder mais a ela.
| Escolha de design | Usar quando | Salvaguarda necessária |
|---|---|---|
| Tradução de conteúdo | Estrutura e ciclo de vida permanecem equivalentes | Tradução de revisão afetada e moderação testada |
| Entidade relacionada | Estrutura, propriedade ou revisão são diferentes | Referência explícita de fonte e navegação recíproca |
| Mapeamento de parágrafo | A fonte contém blocos estruturados reutilizáveis | Geração de blocos ou sinalizadores de pacotes não suportados |
Criação separada, revisão especializada e publicação
Configure estados de moderação de conteúdo, como solicitado, geração, rascunho, revisão de assunto, revisão de idioma, aprovado, publicado, obsoleto e com falha. Defina transições para funções dedicadas e verifique-as com permissões Drupal e manipuladores de acesso. A conta de integração API pode criar e atualizar um rascunho, mas não pode aprovar ou publicar. Um revisor de assunto não pode aprovar a sua própria geração de alto risco, a menos que a política de risco documentada o permita.
Habilite revisões e garanta que cada transformação, resolução de comentários, transição de status e rebase de origem crie uma revisão com autor e carimbo de data/hora. Crie uma visualização de revisão que mostre a origem e o rascunho, as diferenças, os avisos, os links e o resultado renderizado. Se a fonte mudar, marque o rascunho ativo e a versão publicada de forma adequada e bloqueie a publicação até que um revisor resolva a incompatibilidade.
- 1
Configure campos de entidade, validação, revisões e relacionamento de origem.
- 2
Crie estados de moderação e transições específicas de funções.
- 3
Gere um rascunho por meio de um trabalhador de fila restrita.
- 4
Conclua as revisões de assunto e idioma em uma revisão identificada.
- 5
Publique, indexe e retenha a trilha de auditoria da origem ao lançamento.
Entregue com capacidade de cache e acessibilidade Drupal intactas
Anexe tags de cache para a entidade de origem, relacionamento de revisão de origem, entidade de idioma, parágrafos e mídia referenciados, configuração de glossário e renderizador. Use contextos de cache para localidade e qualquer variação de acesso legítima, mas não faça com que as páginas públicas aprovadas dependam do estado de geração específico do usuário. Invalide as páginas afetadas por meio de alterações de entidade ou conclusão de fila e mantenha a última revisão aprovada visível enquanto uma substituição é revisada.
Renderize a navegação de idioma como links comuns por meio de roteamento Drupal e geração de URL com reconhecimento de idioma. Adicione links de fontes recíprocas, metadados em idiomas alternativos, trilhas de navegação e entradas de mapa do site. Verifique a hierarquia de títulos, finalidade do link, ordem de foco, mensagens de status e associação de erros de formulário no tema final. Limpe a saída API por meio de campos estruturados permitidos e do sistema de renderização de Drupal. Nunca marque o HTML gerado como seguro apenas porque veio de um servidor confiável.
As tags de cache cobrem a origem, a versão do idioma, os componentes, a mídia, o glossário e o renderizador.
O processamento da fila não pode publicar conteúdo ou limpar prematuramente o último resultado aprovado.
Rotas de linguagem e links de origem funcionam sem JavaScript.
Formatos de texto e matrizes de renderização evitam marcações inseguras.
A pesquisa indexa apenas a revisão aprovada e remove rotas descontinuadas.
Comprove permissões, revisões e reversão
Os testes funcionais e de kernel devem abranger validação de campo, controle de acesso, transições de moderação, criação de revisão, detecção de fonte obsoleta, novas tentativas de fila, invalidação de cache, acesso de rota e renderização de todos os componentes suportados. Teste cron Drupal e executores de filas externas, incluindo trabalhadores sobrepostos e trabalhos repetidos. Os testes de navegador devem exercitar o fluxo de trabalho editorial completo com cada função e uso de front-end somente com teclado.
Lançamento com gerenciamento de configuração, ganchos de atualização, rotação de credenciais, painéis de fila, reprodução de trabalhos com falha, minimização de logs, backup de banco de dados e um runbook de reversão. Importe a configuração para um ambiente semelhante ao de produção e confirme se os pacotes, traduções, permissões e visualizações existentes permanecem intactos. A aceitação inclui a restauração de uma revisão aprovada anteriormente, a reconstrução de caches e índices e a confirmação de que URLs públicos e registros de auditoria permanecem corretos.
Funções, evidências e aprovação
Mantenha a geração separada da publicação. Uma resposta bem-sucedida é um rascunho, não uma aprovação. Armazene o identificador de origem e a versão, as configurações de transformação, o identificador de resultado, o estado de revisão, o aprovador e o horário de publicação. Quando a fonte for alterada, marque a versão do idioma para revisão em vez de substituir silenciosamente o conteúdo aprovado. Isso torna possível a reversão e a auditoria em todas as plataformas.
Operações e manutenção
O trabalho não termina na publicação. Vincule a versão ou configuração do idioma à sua origem, monitore medidas de qualidade e serviço e defina gatilhos de revisão concretos. Os gatilhos incluem alterações na fonte, alterações legais, novas necessidades do público, dúvidas recorrentes de suporte, alterações técnicas e incidentes. Um proprietário nomeado avalia o gatilho, abre uma nova revisão quando necessário e registra a aprovação renovada.
Lista de verificação para publicação
A integração usa identificadores de origem duráveis.
As credenciais são armazenadas no servidor e rotacionadas.
O comportamento de tempo limite, nova tentativa e limite de taxa são definidos.
Solicitações repetidas são idempotentes.
O conteúdo gerado entra em estado de revisão.
As alterações na origem invalidam ou reabrem a versão.
A navegação por idioma funciona por teclado e tecnologia assistiva.
O monitoramento cobre falhas, filas, latência e conteúdo obsoleto.