PROMPT + RUNBOOK — PLATAFORMA DE ESTUDOS PARA CONCURSOS COM PARETO RECURSIVO
Versão 1.0 | Português-BR | Modelo reutilizável e independente de fornecedor de IA

COMO USAR

1. Importe este arquivo em uma IA capaz de pesquisar fontes e desenvolver aplicações, ou cole seu conteúdo em uma conversa/projeto.
2. Substitua apenas o bloco ENTRADA: informações do concurso e os cargos desejados. As datas, a banca, os pesos e as regras devem ser extraídos do edital pela IA.
3. Envie a instrução: “Execute este prompt e seu runbook até entregar a plataforma funcional e a URL publicada. Use a ENTRADA preenchida como referência.”
4. Se a IA não puder pesquisar, forneça os PDFs oficiais. Se ela não puder executar código ou publicar, peça os arquivos completos, os comandos de execução e a orientação de hospedagem; uma URL só pode ser declarada pronta depois de publicada e verificada.
5. Para trabalhar em etapas, use os comandos de continuidade ao final. Preserve os arquivos e o registro do projeto entre as etapas.

Este documento contém uma especificação operacional para reproduzir o painel criado, com as adaptações necessárias para trocar de concurso e cargo. Não é o código-fonte da aplicação. Não transforma um concurso em outro apenas trocando o nome: os dados oficiais, os conteúdos e as regras precisam ser reconstruídos conforme o novo edital.

======================================================================
INÍCIO DO PROMPT PRINCIPAL
======================================================================

Você é uma equipe de desenvolvimento de produto educacional, preparação para concursos, pesquisa documental, elaboração de questões, design de interfaces e engenharia de software.

Sua missão é CONSTRUIR E ENTREGAR uma plataforma completa de estudos para o concurso informado, usando Pareto Recursivo em três camadas para organizar o esforço e uma meta de preparação de 90% da pontuação. Execute o runbook deste documento. Entregue um dashboard funcional, com conteúdo real, persistência de progresso, testes pertinentes e publicação quando houver recursos para isso.

O objetivo é ajudar o aluno a estudar e identificar suas lacunas. Não prometa aprovação, classificação ou previsão exata das questões. Separe dados oficiais, evidência histórica medida e sugestões pedagógicas inferidas.

ENTRADA — SUBSTITUIR ESTES DOIS CAMPOS

CONCURSO:
  nome: "[NOME DO CONCURSO / ÓRGÃO / ANO]"
  fonte_inicial: "[URL DA NOTÍCIA, PORTAL OFICIAL OU EDITAL]"
  edital_e_anexos: "[PDFs/URLs, SE JÁ DISPONÍVEIS; SENÃO, LOCALIZE NAS FONTES OFICIAIS]"

CARGOS:
  selecao: "[NOME DO CARGO, LISTA DE CARGOS OU TODOS_DO_EDITAL]"

FIM DA ENTRADA

PADRÕES INICIAIS — NÃO PRECISAM SER PREENCHIDOS PARA COMEÇAR

- Idioma: Português-BR.
- Meta de preparação: 90% da pontuação máxima, respeitando critérios por etapa.
- Horas iniciais: 3 horas por dia; editáveis no painel.
- Dias iniciais: segunda a sábado; editáveis no painel.
- Início: data atual no fuso do aluno; editável.
- Fuso do aluno: usar informação disponível ou permitir seleção no painel. Identificar separadamente o fuso dos prazos oficiais.
- Data da prova, banca, duração e regras: extrair das publicações oficiais; não presumir.
- Tecnologias e hospedagem: usar as disponíveis no ambiente, preservando os requisitos funcionais.
- Aparência: dashboard de trabalho, com navegação lateral azul-escura, superfícies claras, azul nas ações e detalhes em verde-lima; adaptar identidade quando houver pedido específico.
- Progresso: real e inicialmente vazio. Não preencher indicadores com resultados fictícios.
- Acesso inicial: privado quando a plataforma suportar; preservar a privacidade do progresso individual.

Se faltarem apenas preferências, prossiga com os padrões e permita ajustá-las. Se faltar informação oficial que altere o conteúdo ou a nota, pesquise; se continuar indisponível, registre [VERIFICAR] e não invente. Uma preferência não deve bloquear o início do trabalho. Uma regra desconhecida não deve ser tratada como confirmada.

CONDIÇÕES QUE DEVEM SER RESPEITADAS DURANTE TODO O TRABALHO

1. A notícia é ponto de partida. A fonte de verdade é o edital oficial com anexos e retificações aplicáveis.
2. Cadastre somente cargos que existam no edital. Se houver um único cargo, o seletor terá um único cargo e explicará isso.
3. Extraia a regra de pontuação. Percentual de acertos não é necessariamente percentual da nota.
4. Configure mínimos, descontos por erro, proibição de zerar áreas, rubricas e demais critérios do concurso específico.
5. Respeite o corte normativo definido no edital. Texto compilado atual pode conter alterações posteriores ao corte.
6. Não invente frequência histórica, estilo da banca, probabilidades de cobrança, links, fontes, materiais ou gabaritos.
7. Identifique questões autorais como autorais. Questões oficiais precisam de origem verificável e identificação da prova.
8. Preserve todos os itens do programa. Prioridade baixa significa estudar depois, e não apagar o conteúdo.
9. O plano deve caber na disponibilidade declarada. Se faltar tempo, mostrar cobertura possível, itens restantes e o ajuste necessário.
10. Cada botão deve realizar a ação que anuncia. Não entregar apenas uma landing page, telas demonstrativas ou listas sem conteúdo.
11. Use armazenamento persistente para os dados de estudo. Armazenamento do navegador não deve ser a única fonte do progresso.
12. Preserve respostas e textos na tela se a gravação falhar. Só anuncie “salvo” depois de confirmação do servidor.
13. Se uma função não existir ou não puder ser verificada, informe exatamente a limitação. Não confunda autoavaliação com correção por IA.
14. Não exponha senhas, tokens, chaves, dados pessoais de outros usuários ou identificadores internos na interface.
15. Não encerre na fase de planejamento quando tiver capacidade para desenvolver, testar e publicar. Se houver bloqueio real, entregue o trabalho concluído e a dependência concreta que falta.

======================================================================
RUNBOOK — EXECUTAR NA ORDEM, PARA CADA CONCURSO E CARGO
======================================================================

ETAPA 1 — PESQUISAR E CONSOLIDAR O EDITAL

Ações:

- Abrir a fonte inicial e localizar o portal oficial do órgão e da organizadora.
- Obter o edital completo, anexos, retificações e comunicados relevantes.
- Confirmar ano e situação do concurso: inscrições abertas, encerradas, prova futura, prova realizada, suspensão ou novo cronograma.
- Listar os cargos oficiais, respectivos códigos, requisitos e diferenças de programa.
- Extrair, por cargo: banca; disciplinas; itens e subitens; quantidade de questões; alternativas ou certo/errado; pesos; pontuação máxima; descontos; critérios eliminatórios; duração; etapas; redação/discursiva; rubrica; número de linhas; condições de correção; requisitos e prazos relevantes.
- Identificar prazo de inscrição, pagamento, convocação/local, prova e recursos, com data, hora e fuso oficial quando publicados.
- Identificar a regra de atualização legislativa: data de corte, alterações, anexos, revogações e vigência.
- Registrar cada fato com URL, documento, item/página, data da consulta e status de verificação.
- Se o edital já estiver passado, apresentar o concurso como histórico e solicitar/identificar o alvo futuro antes de criar uma contagem regressiva falsa.
- Se ainda não houver data, criar ciclo de pré-edital com data de prova “não divulgada”, em vez de inventar um calendário final.

Entregáveis desta etapa:

- Configuração estruturada do concurso e de cada cargo.
- Programa integral, preservando a hierarquia do edital.
- Lista de fontes oficiais e pendências [VERIFICAR].
- Resumo das regras que alteram o cálculo da nota e o cronograma.

Critério de aceite:

Não há cargo fictício, data presumida apresentada como oficial nem regra herdada de outro concurso. Se houver conflito entre notícia e documento oficial, apresentar o conflito e usar a publicação oficial aplicável.

ETAPA 2 — DEFINIR A META DE 90% E O MODELO DE PONTUAÇÃO

Ações:

- Implementar uma função de pontuação independente da interface.
- Para itens com pesos diferentes: somar os pontos efetivamente obtidos; não multiplicar acertos por um único peso.
- Se houver desconto por erro, reproduzir a fórmula oficial.
- Tratar respostas em branco e inválidas conforme o edital.
- Calcular cortes por etapa e por disciplina, além da nota total.
- Para discursiva/redação: separar a nota objetiva da nota de autoavaliação ou da avaliação humana.
- Não somar etapas de escalas diferentes sem a fórmula de combinação prevista no edital.
- Apresentar “meta de preparação” separada de “corte eliminatório” e de eventual posição/classificação.

Exemplo de fórmula para um concurso com pesos por disciplina:

  nota_objetiva = soma, por questão respondida, dos pontos de acerto
                  menos os descontos oficiais por erro, quando existirem.

  meta_objetiva = 0,90 × pontuação_máxima_objetiva.

  habilitado = satisfaz os mínimos da objetiva e todas as regras de área/etapa.

Adapte essa fórmula se houver normalização, médias ponderadas, títulos ou outras etapas. Não criar uma fórmula genérica incompatível com o edital.

Critério de aceite:

Um resultado com muitos acertos, mas abaixo do corte ponderado, aparece corretamente. Um resultado que viole regra de área não aparece como habilitado apenas por ter nota total alta.

ETAPA 3 — APLICAR O PARETO RECURSIVO EM TRÊS CAMADAS

CAMADA 1 — MACRO: EDITAL COMPLETO

Para cada cargo, mostrar tabela com:

  disciplina | quantidade de questões | % das questões | % dos pontos
  prioridade | % sugerido do tempo | fonte/justificativa.

Calcular a concentração real de pontos. Verificar se poucas disciplinas concentram a maior parte da nota. Não forçar a regra literal “20% produz 80%” quando os dados não a sustentam.

Classificar em prioritária, complementar e residual. Manter todas no programa. Reservar tempo para etapas discursivas quando existirem, em função do peso e da dificuldade do aluno.

CAMADA 2 — MESO: TÓPICOS DE CADA DISCIPLINA

Para todos os tópicos do programa, mostrar:

  tópico | frequência histórica medida ou [VERIFICAR]
  prioridade quente/morna/fria | ordem de estudo | evidência/justificativa.

Procedimento para frequência histórica:

- Procurar provas e gabaritos oficiais do mesmo órgão, cargo ou banca, com programa e nível comparáveis.
- Registrar provas, ano, banca, cargo, quantidade de questões analisadas e critérios de classificação temática.
- Distinguir “percentual das questões do corpus” de “percentual das provas em que o tópico apareceu”; não misturar denominadores.
- Registrar questões anuladas ou de gabarito alterado.
- Não transferir automaticamente a distribuição de uma banca antiga para uma banca nova.
- Com corpus pequeno ou pouco comparável, apresentar a incerteza.
- Sem corpus auditável, escrever [VERIFICAR]. Nesse caso, “quente” significa prioridade pedagógica inferida, e não alta frequência comprovada.

CAMADA 3 — MICRO: SUBTÓPICOS E REGRAS

Quebrar tópicos quentes e mornos em regras ou habilidades concretas. Mostrar:

  subtópico | frequência/evidência | dificuldade | tempo estimado
  custo-benefício | incluir/agendar | pré-requisito | fonte.

Dar preferência a regras reutilizáveis, pré-requisitos e lacunas que podem ser corrigidas em pouco tempo, preservando os demais itens.

Ranking pessoal sugerido, depois de um diagnóstico:

  prioridade_de_reforço = peso_da_área × lacuna_observada ÷ custo_de_aprendizado.

Definir e mostrar o que cada termo significa. Informar número de tentativas e usar “sem diagnóstico” quando não houver dados suficientes. Esse ranking não é uma probabilidade de cair na prova.

RÉGUA DE CORTE

- Explicar o que estudar primeiro, depois e por último.
- Distinguir baixo retorno estimado de baixa frequência comprovada.
- Explicitar o custo de adiar um tema.
- Não retirar áreas que possam causar eliminação nem anunciar cobertura integral quando ela não existe.

PERFIL DA BANCA

Descrever características apenas quando sustentadas por provas verificadas. Sem material comparável, sinalizar a pendência. Não preencher essa seção com generalizações inventadas.

Critério de aceite:

O painel permite distinguir visualmente dados oficiais, estatísticas medidas e estimativas pedagógicas.

ETAPA 4 — PRODUZIR O CONTEÚDO DIDÁTICO REAL

Construir um mapa de cobertura: cada item do edital deve estar ligado a uma ou mais aulas, materiais, questões e flashcards. Quando faltar um tipo de recurso, registrar a lacuna em vez de marcar o item como completo.

AULAS

- Organizar por disciplina, tópico e subtópico.
- Escrever explicações reais, e não apenas “leia a lei” ou “estude português”.
- Incluir pelo menos três partes úteis: conceito/regra; aplicação ou exemplo; recordação/prática.
- Incluir erros comuns, exceções pertinentes, fonte e tempo-base estimado.
- Para normas, informar diploma, dispositivos relevantes, alterações e corte temporal.
- Para cálculos, conferir os resultados independentemente.
- Usar identificadores estáveis, que não dependam da posição de um item em uma lista.

QUESTÕES

- Elaborar questões autorais no formato da prova: cinco alternativas somente quando esse for o formato oficial; adaptar a quatro alternativas ou certo/errado quando necessário.
- Cada questão deve conter área/tópico, enunciado, alternativas quando cabíveis, resposta, explicação e fonte de estudo.
- As alternativas devem ser distintas e existir exatamente uma resposta correta quando o formato exigir isso.
- Evitar ambiguidade, pistas involuntárias, duplicatas e gabaritos excessivamente previsíveis.
- Justificar o gabarito; explicar a regra e o erro relevante.
- Não chamar questões autorais de “questões oficiais da banca”.
- Questões oficiais precisam de identificação e origem verificável. Respeitar condições de uso e não copiar bancos comerciais sem autorização.
- Garantir quantidade mínima por área para montar uma prova completa sem repetir a mesma questão dentro da rodada.
- Preferir um banco que permita várias rodadas com baixa repetição. Se o banco for limitado, mostrar que os simulados reutilizam itens e que isso pode inflar resultados.

FLASHCARDS

- Uma pergunta ou regra principal por card.
- Frente que exija recordar; verso curto, preciso e com fonte.
- Preferir contrastes, prazos, requisitos, exceções e conceitos confundidos.
- Permitir classificação da lembrança e agendamento da próxima revisão.

MATERIAIS

- Biblioteca pesquisável/filtrável por disciplina e cargo.
- Fontes oficiais, normas, documentos, guias técnicos e recursos gratuitos verificáveis.
- Links úteis, com descrição do que estudar e alertas de atualização quando necessários.
- Programa completo visível, além das aulas agrupadas.

Volume de referência do projeto original: 75 aulas, 130 questões autorais, 130 flashcards e 47 materiais/fontes. Esses números são uma referência de escopo, não uma quantidade fixa que serve para todo edital. O novo volume deve resultar da cobertura e das necessidades reais de treino.

Critério de aceite:

Os itens essenciais têm conteúdo para aprender, praticar e revisar. A IA não preenche quantidades com repetições ou texto genérico.

ETAPA 5 — GERAR O CRONOGRAMA DIÁRIO E OS CHECKLISTS

Entradas:

- Cargo e versão do edital.
- Data atual/início e data confirmada da prova.
- Horas por dia, dias disponíveis e fuso.
- Prioridades, pré-requisitos, carga estimada e progresso já registrado.

Ações:

- Gerar todos os dias do intervalo, incluindo descanso, véspera e dia da prova.
- Nomear subtópicos exatos. Evitar atividades vagas como “estudar direito”.
- Cada atividade contém data, cargo, subtópico, tipo, minutos e estado de conclusão.
- Alternar áreas prioritárias e complementares, preservando cobertura de áreas residuais.
- Nos blocos de estudo objetivo, usar como ponto de partida 30% teoria, 50% questões e 20% revisão.
- Ajustar os percentuais quando as etapas ou o diagnóstico justificarem, mostrando a regra usada.
- Se houver redação, reservar blocos explícitos. No modelo original, 25% do tempo diário foi reservado à redação, e os 75% restantes seguiram a divisão 30/50/20.
- Inserir revisões D+1, D+7 e D+14; a revisão de flashcards também respeita o desempenho de lembrança.
- Quando uma revisão cair em descanso, reagendar para o próximo dia disponível ou mantê-la como opcional, com regra explícita.
- Inserir simulados e a revisão dos erros. Uma prova longa pode exigir sessão própria ou modo de estudo em etapas; não esconder o tempo necessário.
- Reduzir a carga na véspera e incluir conferência de documentos/local/horário.
- Mostrar prazos de inscrição, pagamento e convocação mesmo quando caírem em dia de descanso.
- Somar os minutos corretamente e não criar tarefas com duração negativa ou cronogramas impossíveis.
- Mostrar aulas/tópicos efetivamente agendados versus total do programa e diferença entre tempo-base e carga disponível.
- Se a carga for insuficiente, explicar a limitação e permitir aumentar horas/dias, sem afirmar que todo o edital foi coberto.
- Alterar a disponibilidade deve preservar conclusões e histórico. Novos IDs precisam ser estáveis para evitar perda ou duplicação de progresso.
- Se a prova mudar, registrar a fonte e a mudança; recalcular datas e informar o impacto.

Distinção importante:

No projeto original, o cronograma base segue a sequência curricular e a disponibilidade. O desempenho alimenta um ranking de reforço, mas não reprograma automaticamente todo o calendário. Replanejamento adaptativo integral é uma melhoria opcional, que só deve ser anunciada se estiver implementada e testada.

Critério de aceite:

O plano cabe na carga informada, identifica suas lacunas de cobertura e não perde registros ao ser reorganizado.

ETAPA 6 — IMPLEMENTAR AS TELAS E OS FLUXOS DO DASHBOARD

1. VISÃO GERAL

- Cargo ativo e dados essenciais da prova.
- Dias restantes quando existir data futura confirmada.
- Último resultado de simulado ponderado, com estado “sem simulado” quando necessário.
- Cobertura real de aulas e atividades concluídas.
- Flashcards novos/vencidos.
- Foco do dia e checklist com ações para abrir o conteúdo correspondente.
- Peso das áreas na nota, próximos dias e atalhos de treino.
- Rotina editável e cronômetro de concentração de 25 minutos, com iniciar/pausar/reiniciar.
- Não usar números fictícios para deixar os cards preenchidos.

2. PLANO DIÁRIO

- Calendário até a prova, fases do ciclo, descanso e atividades por dia.
- Checklist por subtópico, minutos e tipo.
- Concluir/desfazer, abrir aula/questões/revisões e exportar o plano em CSV.
- Indicadores reais de atividades concluídas e cobertura agendada.

3. CONTEÚDOS

- Busca por tema/regra e filtro por disciplina/cargo.
- Cards de aula com prioridade e tempo-base.
- Leitura em painel ou modal, com seções, exemplos, erros comuns e fonte.
- Marcar/desmarcar aula estudada.
- Atalho para questões relacionadas à disciplina ou ao tópico.

4. QUESTÕES

- Busca/filtros, enunciado e formato compatível com a prova.
- Selecionar resposta, responder e salvar, revelar comentário e seguir/pular.
- Histórico de tentativas e desempenho por área.
- Percentual de acertos em treino separado da nota ponderada de simulado.
- Manter a questão respondida na tela até o aluno ler a correção, mesmo que ela deixe de pertencer ao filtro de erros.

5. FLASHCARDS

- Fila de novos/vencidos e opção de explorar todos.
- Revelar o verso somente após tentativa de recordação.
- “Não lembrei”, “Com esforço” e “Lembrei”, ou rótulos equivalentes.
- Intervalos definidos, data da próxima revisão e estado persistido.
- Regra de referência: erro volta em cerca de 10 minutos; lembrança correta começa em 1 dia, depois 7 e 14 ou mais; dificuldade recebe intervalo menor. Documentar o algoritmo, sem chamá-lo de outro algoritmo conhecido se não for sua implementação.
- Exportação TSV compatível com importação no Anki: frente, verso e tag/disciplina. Essa exportação não é sincronização automática com o Anki.

6. SIMULADOS

- Montagem com quantidade e distribuição oficial de itens por área.
- Mesmos pesos e critérios eliminatórios do edital.
- Rodadas com variação e controle de repetição.
- Duração oficial, cronômetro, navegação entre questões e marcação para revisar.
- Cartão de respostas, respostas em branco e rascunho persistido.
- Retomada com estado consistente. Definir se o relógio continua correndo fora da tela ou se há um modo de estudo com pausas; não misturar esse modo com simulação oficial.
- Confirmação para finalizar, resumo por área, nota ponderada, cortes e comentários.
- Histórico de simulados e ligação com o caderno de erros.
- Se houver redação, incluir tema e texto, mantendo a avaliação separada.

7. REDAÇÃO/DISCURSIVA — SOMENTE SE O EDITAL EXIGIR

- Gênero, número de linhas/limites e rubrica reais.
- Temas autorais para treino, claramente identificados como exercícios.
- Editor, contagem auxiliar de palavras/quebras de linha, salvar, reabrir e baixar TXT.
- Explicar que quebras de linha no editor não equivalem automaticamente às linhas manuscritas oficiais.
- Rubrica de autoavaliação, nota parcial e histórico.
- Orientações de planejamento, argumentação, revisão e transcrição.
- Autoavaliação não equivale à nota oficial. Correção humana é uma opção de validação.
- Correção assistida por IA não fazia parte do projeto original. Só incluir se solicitada, viável e identificada como função adicional, com fonte/rubrica e limites claros.

8. CADERNO DE ERROS

- Erros de treino e de simulados.
- Anotação “por que errei?” e regra a recordar.
- Repetição de questões e ligação com aula/cards pertinentes.
- Usar o resultado cronologicamente mais recente; uma tentativa antiga não deve sobrescrever um erro de simulado mais novo.

9. PARETO RECURSIVO

- Tabelas macro, meso e micro.
- Pesos, prioridades, justificativas, dificuldade, tempo e custo-benefício.
- Frequências verificadas ou [VERIFICAR].
- Ranking pessoal de reforço e régua de corte, com limites metodológicos claros.

10. MATERIAIS E EDITAL

- Edital, retificações, portal da banca e prazos.
- Requisitos do cargo e fases relevantes.
- Biblioteca filtrável com fontes e materiais.
- Checklist do programa integral e aviso de corte normativo.

11. MEU PLANO / CONFIGURAÇÕES

- Cargo ativo, horas por dia, dias da semana, início e fuso.
- Reorganização do cronograma preservando o histórico.
- Meta e critérios oficiais visíveis.
- Exportação do progresso em JSON.
- Não anunciar importação/restauração de backup se só houver exportação. Restauração exige validação e implementação próprias.

NAVEGAÇÃO ENTRE CARGOS

- O seletor deve alterar programa, pesos, simulados, materiais e plano realmente associados ao cargo.
- Compartilhar aulas comuns por referências, preservando progresso por concurso/cargo conforme a regra escolhida e documentada.
- Nunca reaproveitar silenciosamente a nota, critérios ou desempenho de outro cargo como se fossem do cargo atual.

DESIGN E ACESSIBILIDADE

- Primeira tela deve permitir estudar imediatamente; evitar uma página publicitária antes do dashboard.
- Navegação lateral no desktop e menu adequado ao celular.
- Tipografia legível, 16 px ou mais no texto de leitura, 14 px para controles habituais e 12 px no mínimo para metadados.
- Contraste suficiente, estados de foco, rótulos, teclado e botões utilizáveis por toque.
- Funcionamento com ampliação de texto, sem sobreposição de caracteres nem rolagem horizontal indevida.
- Favicon próprio, título e descrição do projeto.
- Sem imagens decorativas desnecessárias; gráficos e indicadores devem representar dados reais.
- Estados de carregamento, vazio, erro e confirmação de gravação.

Critério de aceite:

Todos os fluxos principais funcionam; a navegação não é uma coleção de botões inertes. Não há cards preenchidos com desempenho fictício.

ETAPA 7 — ARQUITETURA, CONFIGURAÇÃO E MODELOS DE DADOS

A arquitetura deve separar:

  configuração oficial do concurso/cargo;
  fontes e conteúdo didático;
  algoritmos de nota, cronograma e revisão;
  dados persistentes do aluno;
  interface e hospedagem.

Não espalhar datas, pesos, nomes de disciplinas, número de alternativas, limites da redação ou cargos pelo código. Guardar essas regras em configuração declarativa e versionada.

Modelo conceitual de configuração:

  Concurso:
    id, nome, órgão, ano, banca, situação, fonteInicial, editalUrl,
    retificações, verificadoEm, dataCorteNormativo, cargos, eventos.

  Cargo:
    id, concursoId, código, nome, requisitos, prova, programa, etapas.

  Prova/etapa:
    id, cargoId, data, fusoOficial, duraçãoMinutos, formato,
    quantidadeAlternativas, pontuaçãoMáxima, regrasPontuação,
    critériosEliminatórios, rubricaDiscursiva quando aplicável.

  Disciplina:
    id, nome, quantidadeQuestões, pontosPorAcerto,
    descontoPorErro quando aplicável, pontosMáximos, mínimo,
    prioridadeSugerida, percentualTempo e tópicos.

A configuração inicial pode ficar em JSON/TypeScript ou no banco, conforme o ambiente. O importante é permitir mudar o concurso sem reescrever a lógica.

Modelos mínimos de conteúdo:

  Aula:
    id, disciplinas/cargos associados, título, tópico/subtópicos,
    prioridade, minutosEstimados, seções[{título, conteúdo}],
    errosComuns, fontes, versão e data de verificação.

  Questão:
    id, cargos/disciplinas associados, tópico/subtópico, formato,
    enunciado, alternativas quando aplicáveis, resposta,
    explicação, origem[autoral/oficial], fonte e versão.

  Flashcard:
    id, cargos/disciplinas associados, tópico, frente, verso,
    fontes e versão.

  Material:
    id, título, tipo, URL/arquivo, disciplinas/cargos,
    orientação de leitura, fonte e verificadoEm.

  Item de programa:
    id, textoOficial, paiId quando houver, cargoId,
    aulas/questões/cards/fontes associados e lacunas.

Modelos mínimos do aluno:

  Preferências:
    usuário, concurso, cargo, horas/dia, dias/semana, início, fuso.

  Atividade:
    id estável, data, tipo, subtópico, minutos, estado, vínculos.

  Tentativa:
    usuário, concurso, cargo, questãoId, versãoQuestão,
    resposta, resultado, data e origem[treino/simulado].

  Revisão:
    usuário, concurso, cargo, cardId, intervalo,
    repetições, classificação, próximoVencimento e data.

  Simulado:
    usuário, concurso, cargo, versãoRegras, IDs/versões das questões,
    respostas, início, duração, rascunho, estado, notas e resultados por área.

  Redação:
    usuário, concurso, cargo, tema, texto, versãoRubrica,
    avaliações, tipoAvaliação[auto/humana/IA, se implementada] e data.

  Anotação de erro:
    usuário, concurso, cargo, questãoId, texto e atualização.

PERSISTÊNCIA E AUTENTICAÇÃO

- Usar banco persistente, com registros isolados por usuário e concurso/cargo.
- Autenticação e autorização devem ser validadas no servidor.
- Em ambiente com identidade confiável fornecida pela plataforma, usar o mecanismo documentado. Em outros ambientes, usar sessões/autenticação próprias adequadas ao provedor.
- Não copiar a confiança em headers de uma plataforma para um servidor público que permita forjar esses headers.
- Validar IDs, tipos, limites, respostas, pertencimento ao cargo e regras de nota no backend.
- Não aceitar do navegador um gabarito ou uma nota como fonte de verdade.
- Usar consultas preparadas e migrações versionadas; evitar alterações de schema no fluxo normal de cada requisição.
- Operações com múltiplos registros relacionados devem manter consistência; usar transação/batch quando suportado.
- Impedir que uma gravação tardia de rascunho reabra um simulado já finalizado.
- Guardar versões das regras/questões usadas no simulado para que uma atualização não altere silenciosamente o histórico.
- LocalStorage pode guardar preferências visuais ou rascunhos temporários auxiliares, mas não substituir o banco do progresso.
- Dados devem sobreviver a recarga, nova sessão e troca de dispositivo conforme o modelo de acesso.

Referência técnica do projeto original:

- React + TypeScript, com estrutura de aplicação compatível com Next/Vinext.
- Componentes acessíveis, CSS/Tailwind e ícones Lucide.
- Conteúdo estruturado em JSON.
- Backend HTTP com validação de ações.
- Banco Cloudflare D1 e migrações Drizzle.
- Identidade e publicação fornecidas pelo ambiente ChatGPT Sites.
- Tabela de registros por usuário/chave, com valor serializado e data de atualização.

Essa é uma referência do que foi usado, não uma dependência obrigatória. Outra IA pode usar outra stack e hospedagem. Para a versão genérica, ampliar o isolamento dos registros para concurso e cargo e retirar as regras fixas do DETRAN.

Critério de aceite:

Trocar a configuração do concurso/cargo modifica a aplicação sem depender de substituir strings dispersas no código. Nenhum usuário consegue ler ou alterar o progresso de outro.

ETAPA 8 — IMPLEMENTAR EM INCREMENTOS E ORGANIZAR O TRABALHO

Sequência recomendada:

1. Preparar o projeto e registrar as fontes oficiais.
2. Criar configuração, modelos e algoritmos de nota.
3. Montar um primeiro dashboard reconhecível com conteúdo do concurso e estados vazios honestos.
4. Desenvolver armazenamento, autenticação e fluxos de gravação.
5. Produzir/importar o conteúdo por disciplinas e integrar os bancos.
6. Implementar plano diário, aulas, questões, cards e caderno de erros.
7. Implementar simulados e redação quando prevista.
8. Integrar Pareto, materiais, exportações e configurações.
9. Executar validações e corrigir falhas.
10. Publicar a versão completa e verificar a entrega.

Se houver agentes paralelos, delegar tarefas independentes:

- pesquisa do edital;
- pesquisa de corpus e materiais;
- elaboração didática por disciplinas;
- auditoria de fontes, números e gabaritos.

Um responsável deve integrar os resultados, manter a configuração única e operar a publicação. Não permitir que cada agente crie um site diferente. Cada entrega de conteúdo deve seguir o mesmo schema e usar IDs únicos.

Manter um registro de execução com etapas concluídas, pendências, fontes, decisões, limitações de validação e instruções para continuar. Se faltar contexto ou uma sessão terminar, retomar a partir desse registro em vez de reiniciar o projeto.

Não presumir que capacidades especiais de uma IA existem em outra: agentes, leitura de PDF, execução, navegador, identidade e hospedagem devem ser conferidos no ambiente. Quando uma capacidade faltar, usar um caminho viável e informar o que exige ação externa.

ETAPA 9 — VALIDAR O CONTEÚDO, OS ALGORITMOS E OS FLUXOS

VALIDAÇÃO DOS DADOS

- Todos os cargos reais e seus programas estão associados corretamente.
- IDs de conteúdo são únicos; referências existem.
- Todos os itens do programa têm cobertura ou lacuna explicitamente registrada.
- Quantidades, pesos, pontuação máxima, linhas e rubricas correspondem ao edital.
- Questões têm alternativas distintas, gabarito válido e comentário útil.
- Fontes existem e as normas usadas correspondem ao corte temporal.
- Totais e gabaritos numéricos foram conferidos independentemente.

TESTES DE NOTA

- Todas corretas produzem a nota máxima oficial.
- Todas em branco seguem a regra oficial.
- Erros com pesos diferentes alteram a nota corretamente.
- Desconto por erro é aplicado quando existir.
- Mínimos por área e por etapa são respeitados.
- Regra de não zerar área, se existir, prevalece mesmo com total alto.
- Meta de 90% usa a escala correta.

TESTES DO PLANO

- Datas inicial e final, fusos e quantidade de dias estão corretos.
- Dia da prova não aparece como um dia comum de estudo.
- Não há duração negativa nem excesso oculto da carga disponível.
- Há descanso, véspera e revisões conforme a regra definida.
- Prazos oficiais continuam visíveis em dias sem estudo.
- A carga reduzida mostra a cobertura real, sem prometer estudar tudo.
- Mudar horas/dias preserva registros concluídos.
- Prova sem data, prova adiada ou data passada são tratados explicitamente.
- Ao alternar cargo, o plano usa a configuração correta.

TESTES DE SIMULADO

- Cada rodada tem a quantidade correta de questões por área.
- Não há duplicata dentro da rodada.
- O banco insuficiente gera erro claro, não uma prova truncada apresentada como completa.
- Navegação, marcação, respostas em branco e finalização funcionam.
- Rascunho pode ser retomado; timer segue a regra anunciada.
- A finalização não é sobrescrita por gravação atrasada.
- Comentários e caderno de erros usam as questões e as versões corretas.

TESTES DE PERSISTÊNCIA E INTERFACE

- Login/acesso conforme o provedor.
- Concluir atividade/aula, salvar resposta/card, recarregar e recuperar o estado.
- Alterar dispositivo/sessão e recuperar dados quando essa capacidade for anunciada.
- Salvar, reabrir e editar redação e anotação.
- Classificar card e verificar vencimento.
- Corrigir uma questão do caderno de erros sem perder sua explicação na tela.
- Desempenho dos treinos atualiza após uma nova tentativa.
- Falha de gravação gera aviso e preserva o trabalho visível.
- Exportações CSV, TSV, JSON e TXT possuem conteúdo válido.
- Celular e desktop, teclado, foco, menus, filtros, modais e texto ampliado.
- Usuário/cargo/concurso não acessam dados indevidos de outro contexto.

VALIDAÇÃO TÉCNICA

- Executar checagem de tipos e build ou equivalentes da stack.
- Inspecionar migrações antes de aplicar.
- Testar os fluxos principais no ambiente disponível.
- Registrar cada teste com resultado e limitações.
- Não afirmar que houve teste visual, de múltiplos dispositivos ou ponta a ponta se apenas a compilação e as funções foram validadas.

Critério de aceite:

Sem falhas conhecidas nos cálculos e fluxos essenciais. Limitações restantes são declaradas e não encobertas por indicadores de sucesso.

ETAPA 10 — PUBLICAR E ENTREGAR

Ações:

- Configurar produção, banco, autenticação, migrações e variáveis do ambiente.
- Manter segredos no mecanismo seguro do provedor; não colocar tokens no cliente nem no repositório.
- Publicar exatamente a versão verificada do código e dos dados.
- Aguardar confirmação de sucesso da hospedagem.
- Abrir/verificar a aplicação publicada e um fluxo de gravação quando o ambiente permitir.
- Se o ambiente impedir essa verificação, informar a limitação e não inventar o resultado.
- Não apresentar endereço local ou URL estimada como site publicado.
- Não criar rotinas de atualização, notificações ou compartilhamento público apenas por serem possíveis. Essas capacidades são adicionais e exigem escopo definido.

Entregar ao usuário:

1. URL real do site e instruções de acesso.
2. Quantidade real de aulas, questões, cards e materiais.
3. Cargos atendidos, regras principais e data da prova quando confirmada.
4. Orientação inicial: ajustar disponibilidade em Meu plano, estudar a atividade do dia e iniciar treino/simulado.
5. Resumo do que foi verificado e limitações relevantes.
6. Código/configuração e instruções de execução quando forem parte do ambiente de entrega ou necessários para outro desenvolvedor continuar.

Critério de aceite final:

A pessoa consegue escolher um cargo real, configurar sua rotina, estudar conteúdo, responder, revisar, simular, salvar e continuar depois. A URL está publicada quando essa entrega tiver sido possível.

======================================================================
CONTINUIDADE — COMANDOS PARA USAR COM A MESMA OU OUTRA IA
======================================================================

INICIAR

“Execute o prompt e o runbook completos deste arquivo. Preencha a configuração a partir da ENTRADA, pesquise as fontes oficiais e avance até entregar a plataforma funcional. Não pare na descrição do projeto. Informe pendências reais e prossiga no que não depende delas.”

RETOMAR

“Leia o registro de execução, a configuração, os modelos, os dados e o código já produzidos. Identifique o que falta para cumprir os critérios de aceite. Continue a implementação sem reiniciar nem descartar progresso.”

CONFERIR EDITAL

“Audite a configuração contra edital, anexos e retificações. Verifique cargos, programa, datas, pesos, pontuação, critérios eliminatórios e corte normativo. Liste divergências com fonte e corrija os dados afetados antes de gerar novos conteúdos.”

PRODUZIR CONTEÚDO

“Elabore conteúdo real para [DISCIPLINA/CARGO] seguindo o schema do projeto. Cubra os itens ainda descobertos do programa. Entregue aulas com explicação e exemplo, questões autorais comentadas, flashcards e fontes verificáveis. Não invente frequência histórica nem modifique a configuração oficial.”

AUDITAR QUESTÕES

“Revise o banco de [DISCIPLINA]. Confira gabaritos, cálculos, ambiguidade, alternativas duplicadas, corte legislativo e fontes. Corrija apenas erros demonstrados e preserve os IDs; registre mudanças de versão que afetem simulados anteriores.”

VALIDAR E PUBLICAR

“Execute os testes da etapa 9 e corrija falhas essenciais. Publique a versão verificada e aguarde confirmação. Entregue a URL real, instruções de acesso e as limitações de validação que permanecerem.”

ADAPTAR PARA OUTRO CONCURSO

“Crie uma nova configuração a partir da nova ENTRADA. Preserve os dados do concurso anterior em seu contexto próprio. Reextraia programa, cargos, datas, regras, etapas e normas; reutilize conteúdo apenas quando a correspondência for verificada. Não carregue pesos, cortes, cronograma ou progresso indevidamente do concurso antigo.”

FIM DO PROMPT PRINCIPAL

======================================================================
REFERÊNCIA — O QUE FOI EFETIVAMENTE CONSTRUÍDO NO DETRAN 90
======================================================================

Caso usado como origem deste runbook: DETRAN-SP 2026, Agente Estadual de Trânsito, Instituto Avalia. O edital informado possui um único emprego, não uma lista de cargos para selecionar.

Fonte oficial de referência:
https://arquivos-site.avalia.org.br/publicacoes/e04f1c98-b6e8-4bbc-aba5-3b47579d8f9f.pdf

Escopo efetivamente implementado:

- Dashboard com navegação entre 11 seções e seletor do único cargo oficial.
- 75 aulas, cada uma com pelo menos três seções explicativas, erros comuns e fonte.
- 130 questões autorais comentadas, com cinco alternativas.
- 130 flashcards com fila de revisão e exportação TSV para Anki.
- 47 materiais/fontes e programa completo em oito disciplinas, com 99 itens principais.
- Plano diário até a prova de 01/11/2026; edição de horas, dias e início; checklists, revisões, redação, descanso, véspera e prazos.
- Busca/filtros, leitura de aulas, conclusão/desfazer e atalhos de prática.
- Simulados de 60 questões com pesos diferentes, timer de cinco horas, navegação, marcações, rascunho, histórico, resultados por área e comentários.
- Caderno de erros com anotações e novas tentativas.
- Editor de redação, temas autorais, rubrica de autoavaliação, histórico e download do texto.
- Pareto macro, meso e micro; ranking de reforço; frequências sem corpus auditável sinalizadas com [VERIFICAR].
- Progresso vinculado à conta e persistido em banco; tentativas, tarefas, aulas, cards, simulados, redações e anotações.
- Exportação do plano em CSV, cards em TSV, progresso em JSON e redação em TXT.
- Rotina com cronômetro de concentração.
- Interface responsiva, identidade própria, favicon, título e descrição.
- Publicação privada em ChatGPT Sites.

Regras específicas do caso — NÃO COPIAR PARA OUTRO EDITAL:

  Português:          10 questões × 0,10 = 1,0 ponto.
  Matemática:          5 questões × 0,20 = 1,0 ponto.
  Informática:         5 questões × 0,20 = 1,0 ponto.
  Constitucional:      5 questões × 0,10 = 0,5 ponto.
  Administrativo:      5 questões × 0,10 = 0,5 ponto.
  CTB:                17 questões × 0,20 = 3,4 pontos.
  CONTRAN:             8 questões × 0,20 = 1,6 ponto.
  Legislação estadual: 5 questões × 0,20 = 1,0 ponto.

  Objetiva: 10 pontos; redação: 10 pontos; meta: 18/20.
  Corte objetivo: 6/10 e nenhuma área zerada.
  Redação: 20–30 linhas, corte 6/10 e rubrica 3 + 2 + 2 + 3.
  Corte normativo considerado: 08/09/2026.

Verificações efetivamente realizadas no desenvolvimento original:

- Checagem de tipos e build concluídos.
- Validação dos schemas, IDs e alternativas; presença das oito áreas.
- Conferência de cálculos e conteúdos pelos responsáveis por cada conjunto de disciplinas.
- Testes de montagem de 60 questões sem duplicatas na rodada.
- Testes de nota máxima, respostas em branco e eliminação por área zerada.
- Teste demonstrando que 54/60 acertos podem produzir 8,8 ou 9,4 pontos conforme o peso dos erros.
- Teste do calendário de 33 datas, incluindo a prova, e inclusão das 75 aulas no plano padrão.
- Testes de soma dos minutos e ausência de tarefas negativas para diferentes disponibilidades.
- Geração/inspeção da migração e execução em banco local.
- Publicação com confirmação de sucesso da hospedagem.

Limitações do que foi construído, para não superestimar a referência:

- Conteúdo autoral, não um corpus de questões históricas oficiais medido.
- Prioridade pedagógica não equivale a probabilidade estatística de cobrança.
- O banco limitado reutiliza itens entre rodadas de simulado.
- Redação tem autoavaliação; não possui correção automática por IA.
- O ranking de reforço usa o desempenho, mas o cronograma base não se replaneja integralmente com os erros.
- A exportação JSON existe; importação/restauração de backup não foi implementada.
- A configuração original contém regras e datas específicas do DETRAN. A generalização por configuração declarativa é um requisito deste runbook reutilizável.
- Não houve validação visual de ponta a ponta no navegador nem teste real entre dispositivos na execução original. A confirmação de publicação não equivale a afirmar que esses testes foram realizados.

Melhorias opcionais, não necessárias para reproduzir o escopo original:

- Replanejamento automático por desempenho e atraso.
- Importação de edital e pipeline revisável de retificações.
- Corpus histórico auditado e análises empíricas por subtópico.
- Banco maior com menor repetição entre simulados.
- Importação/restauração de backups.
- Correção assistida por IA e tutoria conversacional.
- Notificações, modo offline e sincronização com ferramentas externas.

Não apresentar essas melhorias como concluídas sem implementá-las. A qualidade da plataforma depende da confiabilidade do edital, do conteúdo e do funcionamento dos fluxos, e não de promessas sobre aprovação.

FIM DO ARQUIVO