Validação Automatizada
Em andamento
Esta documentação ainda está sendo expandida e refinada. Recursos, capturas de tela e descrições podem mudar até o lançamento público do Talescape. Se algo estiver confuso ou você precisar de ajuda, pergunte no Discord oficial do Talescape. Temos prazer em esclarecer ou atualizar as páginas quando necessário.
O Sistema de Verificações do Editor ajuda você a verificar se sua história está completa, consistente e pronta para lançamento. Ele escaneia automaticamente sua história em busca de problemas comuns (desde ativos ausentes até metadados incompletos) e fornece um feedback detalhado sobre o que corrigir.
Essas mesmas verificações também são usadas durante a revisão automatizada que roda antes da publicação. Executá-las dentro do editor permite resolver problemas cedo e evitar rejeição durante a publicação.
1. Executando Verificações
Você pode acionar verificações de duas maneiras:
| Escopo | Descrição |
|---|---|
| Verificação Global (Visão Geral) | Executa todas as validações disponíveis para toda a sua história. Acessível pelo painel Verificações na barra lateral. |
| Verificação Local (Por Elemento) | Executa validações para o elemento que você está editando no momento, como um capítulo, cena ou diálogo específico. |
Os resultados são exibidos imediatamente e agrupados por categoria (ex.: Marketplace, Capítulos, Cenas, Personagens). Você pode executar as verificações novamente a qualquer momento clicando em Executar Verificações.
2. Níveis de Severidade
Cada problema recebe um nível de severidade para indicar sua importância:
| Severidade | Descrição | Ação |
|---|---|---|
| Info | Observações ou sugestões informativas. | Nenhuma ação necessária, mas pode ajudar na qualidade. |
| Warning | Problemas potenciais que podem causar transtornos dependendo do contexto. | Revise e corrija se for relevante. |
| Failure | Erros críticos que impedem sua história de ser publicada. | Devem ser corrigidos antes de criar uma publicação. |
As falhas são claramente destacadas. Uma história com qualquer falha não pode ser publicada até que sejam resolvidas.
3. Verificações Típicas
O sistema cobre validações técnicas e estruturais, tais como:
| Categoria | Exemplos de Verificações |
|---|---|
| Marketplace | Comprimento da descrição, capturas de tela e requisitos de tags. |
| Capítulos | Todo capítulo tem uma cena inicial e pelo menos uma saída. |
| Cenas | Cada cena tem um fundo e é usada em algum lugar da história. |
| Diálogos | Sem ramos inacessíveis ou alvos ausentes. |
| Mídia | Todos os ativos referenciados existem e correspondem aos formatos exigidos. |
| Itens / Criação | Receitas e referências de itens são válidas. |
Cada verificação mostra seu resultado, carimbo de data/hora e mensagem detalhada para que você saiba exatamente o que ajustar.
4. Verificações Locais Durante a Edição
Você também pode executar verificações locais diretamente dentro de editores como Cenas, Diálogos ou Capítulos.
Essas verificações focadas validam apenas o conteúdo em que você está trabalhando no momento, perfeito para uma validação rápida antes de continuar o desenvolvimento.
Exemplo: Ao editar uma cena, as verificações locais confirmam que ela tem um fundo, saídas válidas e é usada em algum lugar da história.
5. Integração com a Publicação
O mesmo sistema de validação é usado durante a fase de Revisão Automatizada do fluxo de publicação. Se você já corrigiu todos os problemas mostrados no Sistema de Verificações do Editor, sua história passará automaticamente pela etapa de revisão automatizada.
Isso garante uma transição suave do desenvolvimento para a publicação.
6. Boas Práticas
- Execute verificações completas da história regularmente, especialmente antes do envio.
- Corrija todas as Falhas e revise os Avisos para evitar surpresas durante a revisão.
- Use verificações locais com frequência durante a edição para detectar problemas cedo.
- Verifique os carimbos de data/hora para saber quando cada verificação foi realizada por último.
O Sistema de Verificações do Editor atua como seu portão de qualidade interno, garantindo que toda história lançada no Talescape seja estável, completa e pronta para os Dreamers explorarem.