Prolingo — Histórias em inglês

App de histórias em inglês para estudar com diálogos: um diálogo longo, com uma pergunta a cada 4–5 falas, todas as frases e palavras com áudio em inglês.

Como funciona (sem banco de dados, sem servidor)

Peça	Onde fica	Papel
Lições	data/unitN.json (nesta pasta, no seu PC)	O "banco de dados" é a própria pasta — arquivos JSON versionados no Git
Áudios	audio/*.mp3 + audio/manifest.json	Gerados uma vez com vozes neurais grátis (edge-tts)
Progresso (XP, sequência, lições feitas)	localStorage do navegador	Fica salvo em cada aparelho
Site	Vercel (projeto prolingo, https://prolingo101.vercel.app)	Publica sozinho a cada git push

Atalhos

• ABRIR_LOCAL.bat: abre o app no seu PC (http://localhost:8101) para testar antes de publicar.
• GERAR_AUDIO.bat: gera os MP3 das frases/palavras novas (só gera o que falta).
• PUBLICAR.bat: gera os áudios, faz commit e push → a Vercel atualiza o site em ~30 s.

Formato de uma lição

{
  "id": "u5l1", "title": "At the Hotel", "titlePt": "No hotel", "emoji": "🏨",
  "steps": [
    ["nar", "Anna is at a hotel.", "A Anna está em um hotel."],
    ["anna", "Hello! My name is Anna.", "Olá! Meu nome é Anna."],
    { "q": "Onde a Anna está?", "o": ["Em um hotel.", "Em um café."], "a": 0 },
    { "q": "O que ela diz?", "lang": "en", "o": ["Hello!", "Goodbye!"], "a": 0 }
  ]
}

• Fala: [personagem, inglês, português]. O personagem (voz + emoji) é definido em cast, no topo do arquivo da unidade. nar é o narrador.
• Pergunta: q = enunciado, o = opções, a = índice da certa (o app embaralha). "lang": "en" faz as opções terem áudio.
• Nova unidade: crie data/unit6.json (e data/levels/u6-2..5.json), registre em data/units.json (com as frases do guia) e adicione palavras novas em data/glossary.json.

Níveis de dificuldade (1 a 5)

Cada história existe em 5 versões: mesmo enredo, língua cada vez mais difícil. Descrições e velocidade do áudio ficam em data/levels.json.

Nível	Onde fica	Perguntas
1 Básico (A1)	data/unitN.json	em português
2 Elementar (A2)	data/levels/uN-2.json	em português (algumas opções em inglês com "lang": "en")
3 Intermediário (B1)	data/levels/uN-3.json	em inglês, com áudio
4 Avançado (B2–C1)	data/levels/uN-4.json	em inglês: expressões idiomáticas
5 Nativo (C2)	data/levels/uN-5.json	em inglês: gírias, ironia, subentendidos

Formato de data/levels/uN-L.json: { "unit": N, "level": L, "cast": { ...personagens extras... }, "lessons": { "u1l1": [ ...falas e perguntas... ] } }. O glossário aceita só a forma base da palavra: o app acha sozinho plurais, passado, "-ing" e possessivos.

Aba Pro (inglês profissional)

Trilhas profissionais no mesmo formato (5 histórias × 5 níveis), listadas em data/units.json na chave "pro":

Trilha	Arquivo nível 1	Níveis 2–5
Enfermagem	data/pro/enf.json	data/levels/uenf-2..5.json
Serviço Social	data/pro/soc.json	data/levels/usoc-2..5.json
Medicina	data/pro/med.json	data/levels/umed-2..5.json
Psicologia	data/pro/psi.json	data/levels/upsi-2..5.json

Nova área: crie data/pro/<id>.json + data/levels/u<id>-2..5.json e registre em "pro" com as frases-chave do guia.

Círculo das 4 faces e modos de estudo

Cada lição (em cada nível) tem um círculo em 4 partes: 📖 Leitura · 🎧 Escuta · 🎤 Fala · ✍️ Escrita.

• Leitura: concluir a lição.
• Escuta: concluir com 🎧 Escuta (áudio automático) ligada do início ao fim.
• Fala (🎤): cada fala do diálogo é repetida em voz alta; o navegador transcreve (Web Speech API), o usuário vê o texto e confirma. Conta com ≥ 80% das falas aceitas.
• Escrita (✍️): a cada 2–3 falas, um exercício: lacuna de 1 palavra → 2 palavras → frase inteira (copiar, ditado ou tradução), conforme o nível (WRITE_PLAN em app.js). Conta com ≥ 80% de acertos.
• Os modos só contam no círculo se estiverem ligados desde o início. Fala e Escrita têm botão Pular.
• A tolerância a erros fica em match.js (números, contrações, grafia britânica/americana, erros de digitação).

Palavras novas

Cada história apresenta poucas palavras novas por vez (4 no nível 1, até 6 nos níveis 3–5):

1. Cartão "Palavras novas" antes de começar, com áudio e tradução.
2. Destaque roxo na primeira vez que cada uma aparece no diálogo.
3. Checagem rápida ("✨ PALAVRA NOVA – o que significa…?", 3 opções) logo depois da fala.
4. Lista "Palavras que você aprendeu" no fim. Nos exercícios de escrita, as lacunas preferem as palavras novas.

Quem escolhe: palavras do glossário que o usuário ainda não conhece (não foram ensinadas e não apareceram em 3 histórias concluídas), com prioridade para as frases do guia da unidade e as que mais se repetem. Nos níveis 3–5, palavras muito frequentes no conjunto das histórias (data/wordfreq.json, gerado por tools/frequencia.py, chamado pelo gerar_audio.py) ficam de fora. O registro fica em progress.words no navegador.

Tela inicial

• Unidades e profissões são recolhíveis; só a última estudada fica aberta.
• Na aba Pro, busca por texto (sem acento) e lista A–Z; a profissão escolhida (ou a última iniciada) fica no topo, aberta.

Nível 0 · Palavras (vocabulário)

Para quem acha o nível 1 difícil. Não é história: são 10 lições de 20 telas por unidade (e por área Pro), no ciclo de repetição: apresentar a palavra, escolher o significado, ouvir e escolher, combinar pares, montar a frase com blocos, completar, falar e escrever. Errou? A tela volta no fim da lição.

• Gerado por tools/nivel0.py a partir do nível 1 da própria unidade (palavras mais frequentes + frases do guia), em data/level0/u<id>.json. O gerar_audio.py roda o gerador antes de gerar os áudios.
• Toda frase usada num exercício é apresentada antes na mesma lição (tela "✨ Frase nova", com áudio e tradução); o gerador confere isso.
• Lições 1–5: nada de escrever frase inteira a partir do áudio: só digitar palavras ouvidas ou copiar a frase vendo. Lições 6–10: ditado e tradução de frases inteiras.
• Modos: com ✍️ Escrita, montar frases vira digitar; com 🎤 Fala, as frases são repetidas em voz alta. O círculo das 4 faces funciona igual.
• O nível 1 mostra um atalho "Achou difícil? Treine antes o vocabulário no nível 0".

Fala por partes

Falas com várias orações são capturadas uma oração por vez (splitClauses em app.js): o reconhecimento do navegador para numa pausa, e frases longas eram cortadas. Orações muito longas também são divididas em vírgulas; pedaços curtos ("Hi!") se juntam ao vizinho.

Menu lateral: Aprender, Praticar, Missões, Perfil

• ☰ Menu (fixo à esquerda em telas largas; some dentro das lições).
• Praticar (#/practice): Prática focada (pontos fracos), Fala, Escuta, Erros e Palavras. As sessões usam o mesmo motor do nível 0 (renderDrill com uma sessão montada por buildPractice), com palavras aprendidas e frases curtas das lições concluídas (níveis 0 e 1).
• Erros: o que você erra (palavras novas, exercícios de escrita, nível 0) vai para progress.mistakes; acertar de primeira no Praticar tira o item da lista.
• Missões (#/missions): meta diária de XP + 2 missões sorteadas pela data (+10 XP cada), e conquistas em 4 níveis (sequência, lições, palavras, XP, círculos completos, nível 5). O dia vira à meia-noite local.
• Perfil (#/profile): nome, avatar, cor, meta diária, estatísticas e cópia do progresso (baixar/restaurar JSON).