Especifica estruturas de dados, renderização, permissões, controles de moderação, trilha de auditoria, testes e operações para rascunho e publicação. Define limites de adoção e evidências observáveis de falha enquanto mantém limites específicos do ambiente configuráveis.
Status do pacote: contexto de referência pronto para revisão humana. O contrato e os cenários de teste estão completos, mas não se afirma que uma implementação adotante os tenha aprovado.
Decisão
Para Rascunho e publicação, adote um registro de conteúdo versionado e uma máquina de estados de moderação. Implemente o comportamento por meio de um caminho de escrita autoritativo, interfaces tipadas, estado explícito e tratamento idempotente de efeitos colaterais. Este pacote é um contrato de referência: a equipe adotante deve escolher limites numéricos, provedores, jurisdições e responsáveis operacionais com base em evidências do seu próprio ambiente.
Escopo
- Os atores de Rascunho e publicação, entradas, saídas, estados, versões de política ou esquema e resultados visíveis externamente descritos por este bloco de implementação.
- Interfaces primárias e alternativas, trabalhos em segundo plano, caches, integrações, caminhos de suporte e evidências que podem exercer o mesmo limite.
- Configuração específica de adoção, implantação, recuperação e responsabilidades de verificação necessárias para aplicar a referência com segurança.
Fora deste bloco
- Escolher um fornecedor universal, framework, jurisdição, limite numérico, período de retenção ou objetivo de nível de serviço para todos os adotantes.
- Afirmar que os cenários empacotados foram executados contra uma implementação a jusante ou que esta referência concede certificação legal, de segurança ou acessibilidade.
Contrato
- Armazenar a entrada original separadamente da saída normalizada ou renderizada e identificar o transformador e a versão da política usada.
- Sanitizar para o contexto real de saída; análise, conversão Markdown e rótulos MIME não tornam conteúdo ativo confiável.
- Autorizar ações de criar, editar, publicar, moderar, apelar e excluir independentemente e reter a trilha de decisão material.
- Representar estados pendentes, permitidos, restritos, rejeitados, apelados e removidos explicitamente em vez de sobrecarregar flags de visibilidade.
- Validar entradas uma vez na fronteira e preservar a representação normalizada usada pela lógica a jusante.
- Persistir a transição de negócio antes ou atomicamente com um registro de outbox; consumidores deduplicam por identidade durável da operação.
- Modelar estados de rascunho, revisão, agendado, publicado, substituído, arquivado e removido com transições autorizadas e evidência imutável de publicação.
- A publicação vincula uma revisão exata, público, localidade, resultado da política e tempo; edições posteriores criam um novo rascunho e não podem mutar silenciosamente a revisão já publicada.
Orientação de implementação
- Envie primeiro mudanças aditivas de armazenamento e interface, preencha observavelmente, depois retire caminhos antigos após evidência de compatibilidade.
- Modele entradas, saídas, atores, estados, invariantes, efeitos colaterais e evidências de Rascunho e publicação antes de selecionar detalhes de framework ou fornecedor.
- Armazene a versão aplicável do contrato ou política de Rascunho e publicação com estado material para que migrações, reprodução e decisões de suporte permaneçam atribuíveis.
- Introduza o caminho por trás de implantação controlada, compare resultados esperados e observados, e mantenha uma rota de recuperação testada até que a evidência de adoção esteja completa.
Tratamento de falhas e salvaguardas
- Conteúdo inseguro ou não classificável permanece indisponível por padrão e entra em um caminho limitado de revisão ou rejeição.
- Estado inválido ou contraditório de Rascunho e publicação é rejeitado ou colocado em quarentena; a implementação nunca supõe um valor que amplie autoridade ou duplique um efeito.
- Retentativas são limitadas e usam identidade durável; após esgotamento, o trabalho alcança um estado terminal inspecionável com um responsável accountable.
Verificação e operações
- Injete falha de dependência antes e depois da persistência e prove que a retentativa converge para um resultado externamente visível único.
- Monitore sucesso, negação, falha de validação, falha de dependência, esgotamento de retentativas e recuperação de Rascunho e publicação por versão do contrato sem dimensões sensíveis do payload.
- Reexecute fixtures positivos e negativos pareados após mudanças de política, esquema, dependência, migração ou limite e preserve a evidência resultante.
Suposições de adoção
- Nomes e valores no exemplo são um fixture concreto, não padrões universais; adotantes os substituem por meio de evidência documentada e propriedade.
- O sistema adotante pode fornecer identidade autenticada, versões duráveis de operação ou registro, telemetria limitada e um caminho controlado para mudanças.
Os exemplos com aparência executável neste pacote são fixtures e contratos de aceitação. Execute o validador da coleção para verificar estrutura e metadados, depois traduza e execute os cenários no repositório alvo antes de registrar evidência de implementação.