Como importar dados de flashcards em JSON para o Deckbase

Quando usar este fluxo de trabalho

Desenvolvedores e usuários avançados que migram de ferramentas personalizadas, APIs ou geradores programáticos de cards e precisam de controle em nível de esquema sobre a importação.

Trate isto como um processo operacional de migração, não apenas como um upload de arquivo único. O objetivo não é só ter uma importação bem-sucedida, mas também melhorar a consistência das revisões e reduzir o esforço de manutenção dos cartões nas semanas após a troca.

Checklist antes da importação

• O arquivo JSON usa um array de objetos com chaves consistentes para frente e verso.
• As strings são UTF-8 válidas e não contêm caracteres de controle sem escape.
• Campos opcionais, como tags e notas, usam chaves previsíveis em todos os objetos.

Se um item da checklist falhar, corrija-o antes da importação. Limpar os dados na origem é mais rápido do que corrigir centenas de cartões após a migração.

Fluxo de migração passo a passo

1. 1
   Valide a estrutura JSON com um linter e confirme que todo objeto tem as chaves obrigatórias de frente e verso.
2. 2
   Defina o mapeamento: quais chaves viram frente, verso, tags e notas do card.
3. 3
   Faça uma importação de teste pequena com 10 objetos e inspecione a renderização dos cards.
4. 4
   Corrija problemas de codificação ou objetos aninhados que foram achatados incorretamente.
5. 5
   Importe o conjunto completo de dados e verifique se o total de cards corresponde às linhas esperadas.

Erros comuns e correções

Use um deck piloto pequeno após cada correção. Se a qualidade do piloto se mantiver, aplique o mesmo padrão de correção ao lote completo.

Verificações de qualidade em exemplos de saída

• Frente: O que é JSON Schema? | Verso: Um vocabulário que define a estrutura válida para documentos JSON.
• Frente: Qual é a diferença entre array e objeto em JSON? | Verso: Array é uma lista ordenada; objeto é uma coleção de pares chave-valor não ordenada.
• Frente: Por que validar o JSON antes de importar? | Verso: A validação antecipada evita cards malformados e falhas de importação em escala.

Durante o controle de qualidade, verifique cada cartão de exemplo quanto à clareza, à atomicidade e à precisão da resposta. Evite importar cartões que testem apenas a redação sem testar a compreensão.

Um teste prático: se você consegue responder com precisão em menos de 10 segundos durante a revisão, o cartão geralmente está bem delimitado. Se não, divida-o ou reescreva-o.

Perguntas frequentes

Guias relacionados

Dica: para fluxos de trabalho avançados, mantenha sua exportação original como backup e registre cada tentativa de migração pelo nome do lote e pela data.