Mànmàn 慢慢 — Flashcards de Mandarim

App de flashcards pra turma de mandarim do Enrico — Leo, Henrique, David e Fraga.

慢慢 (mànmàn) = "devagar, com calma" — como em 慢慢来 (mànmàn lái, "vai com calma"). Um pouquinho todo dia é assim que se aprende mandarim.

🔗 App: https://leoborja.github.io/manman/

Instalar no celular

• iPhone: abrir o link no Safari → botão Compartilhar → Adicionar à Tela de Início
• Android: abrir no Chrome → menu ⋮ → Instalar app

Vira um app de verdade: ícone 慢, tela cheia, funciona offline. Atualiza sozinho — toda vez que abre com internet, busca a versão mais nova (se parecer teimoso, feche o app no multitarefa e abra de novo).

Sem internet: abra uma vez com internet e deixe aberto uns segundos — o app baixa sozinho os ~4 MB de áudio. Depois disso ele abre, estuda e toca todas as gravações em modo avião, e o que você responder fica guardado e sobe pro banco assim que a conexão voltar (sem precisar fechar o app). Sinal ruim também vale: se o banco não responder em 4 segundos, o app abre com as cartas salvas em vez de ficar em branco — e busca de novo sozinho quando a conexão volta, ou quando você volta pro app depois de 5 minutos fora (o iPhone deixa o app aberto na memória, e sem isso o deck reorganizado no banco não chegava). Instalar na Tela de Início não é só conforto: no iPhone, site que não está lá perde os dados salvos depois de uns 7 dias sem uso.

Primeiro acesso

Escolha seu nome (Leo / Henrique / David / Fraga). O progresso é individual e sincroniza entre aparelhos — estudou no ônibus, continua no computador.

Depois disso, quem guarda esse estado é o botão redondo do topo, com a sua inicial: ele abre o perfil, onde se troca de nome e se escolhe claro ou escuro. São as duas coisas que se ajustam uma vez e esquecem, então dividem uma folha só em vez de ocupar dois botões fixos no cabeçalho.

As três telas — Estudar, Cartas, Progresso — ficam num controle segmentado logo abaixo do cabeçalho e acima dos chips, que é a ordem em que a escolha acontece: primeiro em que tela estou, depois o que ela filtra. Um controle só, e não três botões soltos: são três estados da mesma escolha e só um vale por vez. Só texto, sem ícone e sem duas linhas — assim a barra ocupa 40px em vez de 62 e a carta começa mais alto.

学 Estudar — como funciona

A fila é contínua: primeiro as revisões vencidas, depois as palavras novas, e quando acaba o agendado o app emenda direto na prática livre (deck inteiro embaralhado, infinito). Você só abre e estuda.

Toque no cartão pra revelar, depois marque:

Botão	Efeito
Errei	volta ainda nesta sessão (e sempre reagenda, até na prática)
Difícil	intervalo cresce pouco
Acertei	1 dia → 3 dias → e vai multiplicando (repetição espaçada)

Na fase de prática, "Difícil/Acertei" mostram "prática" e não mexem no cronograma — só o "Errei" vale, porque esquecer é informação real. Mas toda carta avaliada conta no contador do dia, nas duas fases: até 20/08 a prática só registrava os erros, o que fazia acertar valer zero pra meta e pro streak.

Meta diária e streak

Meta de 30 revisões/dia — é piso, não teto: passou de 30, o contador mostra o excedente (+7) e você segue o quanto quiser. O 🔥 no cabeçalho fica apagado até bater a meta e acende quando fecha o dia.

O streak conta dias fechados. A regra antiga era "≥1 revisão", barata demais (um dia de 2 revisões contava igual a um de 39). A meta vale a partir de 20/08, que é o primeiro dia com o contador correto — até 19/08 a prática livre só registrava erros, então aqueles números estão subestimados e não podem ser julgados por meta nenhuma. Antes dessa data vale a regra antiga. Está no META_DESDE do app.js.

A meta começou em 20 e subiu pra 30 no mesmo dia da correção do contador: os 20 tinham sido calibrados em números que ignoravam a prática livre.

Filtro — três eixos que se somam

São três: 🏷️ tema (Números, Pronomes, Família…), 📖 origem (de onde a carta veio, de fonte: o capítulo do livro — Cap. 1, Cap. 2… —, os Extras da aula ou o Duolingo) e ❌ erro (as que você mais erra, por faixa).

Eles somam. Dá pra pedir "Família e Comida e só as que eu erro" numa sessão só — o resultado é a interseção dos eixos ligados. Dentro do mesmo eixo os chips se somam: marcar Família e Comida é pedir as duas, que é a leitura natural de marcar dois temas. Eixo sem nenhum chip marcado não filtra nada, e é assim que "Todos" volta a ser todos.

Até 30/08 os três se excluíam: escolher a aula desligava o tema. A troca é o que permite "as frases da aula de ontem" e "as palavras de família que eu mais erro" — que são justamente as perguntas que a gente faz na véspera da prova.

Em 13/09 o 📅 aula virou 📖 origem. A turma estuda pelos capítulos do New Practical Chinese Reader 1, e a data da aula não dizia de que capítulo a palavra era — nem separava o que veio do livro do que entrou pelo Duolingo. A data_aula continua gravada no JSON e no banco, só não vira mais chip. Capítulo novo não precisa de código: "fonte": "cap3" já aparece como "Cap. 3", na ordem certa. Quem tinha datas marcadas no 📅 volta sem filtro de origem, em vez de ficar com um corte que nenhum chip mostra.

Os ícones dizem duas coisas diferentes. O "ligado" neutro (contorno escuro) é qual fila de chips está na tela — navegação, porque só cabe uma fileira e duas empilhadas comeriam o celular. O ponto vermelho é quais eixos estão de fato cortando o deck. Sem o ponto, marcar "Família" e ir olhar o 📖 esconderia que o 🏷️ continua valendo, e a sessão sairia menor do que os chips na tela explicam.

O estado inteiro aparece de uma vez só num lugar: a linha do "O que estudar", que lê Família + Comida · ≥1 erro. E marcar um chip não fecha mais a folha — quem pode escolher vários precisa da lista aberta pra isso; quem fecha é o toque no fundo, com a sessão já remontada atrás.

Tudo salvo por usuário. Quem já usava o app tinha os três campos preenchidos (eles se excluíam, então só um valia): a migração traz só o eixo que estava em uso, senão a interseção dos três abriria uma sessão vazia pra quem só apertou atualizar.

💬 Frases

Uma frase é uma carta: mesmos campos, mesmo SRS, mesma sincronização, e conta na mesma meta de 30. O que separa as duas é a fila — palavra e frase nunca se misturam numa sessão, porque frase chega em bloco (uma aula inteira de uma vez) e afogaria o vocabulário em cartas novas.

Por isso "Palavras / Frases" não é um quarto ícone ao lado de 🏷️📅❌. Aqueles três são eixos de fatiar a mesma lista, e se somam entre si; este escolhe qual lista é, e é exclusivo. Fica um nível acima deles, dentro do "O que estudar", e assim "as frases da aula de 06/08" e "as frases que eu mais erro" continuam existindo. Enquanto o deck não tiver frase nenhuma a linha inteira some — botão que abre sessão vazia é pior que botão nenhum.

Três dos seis modos ficam de fora, e sozinhos. Desenho e os dois quizzes de tom pedem palavra de um caractere: a grade 田字格 é uma só e o tom é de uma sílaba. Eles já se excluíam antes de existir frase, então não foi preciso ensinar nada a eles — só sumiram do seletor, em vez de abrir uma sessão vazia e explicar depois. Sobra o que a frase sabe responder: virar a carta, o teclado e o 🧩 ordenar.

A carta passou a medir a própria altura. As duas faces são absolutas — é o que permite empilhar frente e verso pra virada — então o cartão nunca cresceu com o conteúdo: cada modo declarava um número fixo. Com palavra isso nunca apareceu (好 cabe em qualquer altura); com frase, sim: nove caracteres com traçado quebram em três fileiras, o pinyin vira duas linhas e a nota é um parágrafo, e como a face é centralizada o que não cabia vazava pelos dois lados. Agora a altura sai da soma do conteúdo, medida nas duas faces ao mesmo tempo — virar não pode mudar o tamanho da carta no meio da animação, senão a página pula embaixo do dedo justo quando a pessoa foi ler a resposta. Frase curta continua no mínimo do modo; quem precisa, cresce.

O áudio da frase é voz sintética, e aqui isso é bom. O defeito conhecido da voz sintética é o 3º tom isolado — só a descida, sem a subida. Numa frase inteira não existe sílaba isolada, então o problema que tirou a voz sintética das palavras não aparece. Até 01/09 as frases iam no TTS do próprio aparelho por esse mesmo argumento; o que mudou é que o TTS do celular soa mecânico na PROSÓDIA — ritmo e entonação, não tom — e isso a ElevenLabs faz bem. As 65 frases agora têm MP3 gerado; as palavras seguem com gravação de gente.

🧩 Ordenar as palavras

A frase ensina uma coisa que a palavra não ensina: ordem. 不 antes do verbo, o tempo antes do lugar, o 是 que só liga substantivo a substantivo. Nenhum dos outros modos cobra isso — virar a carta cobra reconhecimento, o teclado cobra o ideograma.

Você vê o português, as palavras da frase aparecem embaralhadas em pílulas, e monta tocando nelas em ordem. Tocar de novo numa que já está na frase devolve ela pro monte — o desfazer não precisa de botão próprio. O "conferir" só libera com a frase inteira montada: meia frase não é resposta errada, é resposta pela metade.

No resultado, a ordem certa vem em cima e a sua embaixo, com cada peça verde ou vermelha conforme tenha caído na mesma posição. Como no desenho e no teclado, a nota sugere um botão e quem decide é você — é revisão normal, conta na meta e mexe no agendamento.

A segmentação não é campo preenchido à mão. O pinyin já vem separado por palavra (Wǒ shì Bāxī rén) e cada sílaba de pinyin é exatamente um caractere — então contar as sílabas de cada pedaço entrega 我 | 是 | 巴西 | 人 sozinho. É a mesma escolha da pronúncia aproximada: calcular em vez de digitar, pra que frase nova não precise de campo novo nem de migração no banco. Quando a conta não fecha (儿 de 哪儿 é caractere sem sílaba própria) a frase simplesmente não aparece neste modo — exercício ausente é melhor que exercício errado. A saída manual, pra frase que insista, é o campo seg da carta: "我|是|巴西|人".

As peças são identificadas por chave e não pelo que está escrito nelas, porque frase repete palavra: 对不对 tem dois 对, e sem chave própria clicar num moveria o outro.

💬 Diálogo

Os outros modos perguntam de uma frase, solta. Conversa não é isso: o que faz 我很好，你呢 ser a resposta certa é a pergunta que veio antes — e nenhum campo da carta sabe disso. Então o roteiro mora fora do deck, em seed/dialogos.json: a lista dos ids das frases que já existem, na ordem em que são ditas, com quem diz cada uma.

A conversa anda uma fala por vez, e o que já foi dito fica na tela — é a fala anterior que faz a sua resposta ser resposta.

• Fala do outro: o app fala (o MP3 da frase) e mostra o 汉字. A tradução só aparece se você tocar em "não entendi" — a primeira pergunta é se você entendeu de ouvido e de vista.
• Sua vez: vem a dica do que dizer em português ("diga que está bem — e devolva a pergunta com 你呢"), e você escreve a frase no teclado de mandarim do aparelho. O resultado marca caractere por caractere, como no ⌨️, e a fala certa toca no fim do turno — inclusive quando você errou.

Nada de conteúdo novo entra por aqui. O diálogo só reordena frases que já estão no seed_cards.json, com áudio e tudo. Roteiro que tenha uma frase que você não tem — ou que você desligou na aba Cartas — não aparece: meia conversa não é conversa, e completar o buraco com uma frase parecida ensinaria a conversa errada.

A rodada é fechada, como o quiz de tons e o relâmpago: conta o que a máquina viu (acertou ou não a frase, e isso entra no erro por habilidade) e não mexe no agendamento. Quem manda no SRS é a ordem do SRS — reagendar 我很好 porque ela calhou de ser a terceira fala de um roteiro bagunçaria a fila de quem estuda pelas revisões.

Dos três eixos de filtro, só o 🏷️ tema vale aqui, e ele fatia pelo tema do roteiro: uma conversa no café atravessa comida e estados, e não é a soma dos temas das falas que diz do que ela é. O 📖 capítulo e o ❌ erro são de cada frase e partiriam a conversa no meio, então ficam de fora — e o contador diz isso na tela, pra ninguém ficar procurando o filtro que não pegou.

Escrever um diálogo novo

Só ids, na ordem. Nenhuma linha de código, nenhuma carta nova:

{
  "id": "dl-no-cafe",
  "titulo": "No café",
  "deck": "comida",
  "cena": "Você senta com um amigo e o garçom já vem vindo.",
  "falas": [
    { "quem": "outro", "card": "fr-beber-oque" },
    { "quem": "voce",  "card": "fr-quero-cafe", "dica": "peça um café" }
  ]
}

dica é opcional: sem ela, a dica vira a própria tradução da frase.

Modos (botão MODO)

São seis modos, e só um deles vira a carta. Nos outros quatro responder é uma ação — digitar, desenhar, marcar o tom. Mais o 🔀 Aleatório, que não é um sexto exercício: é um sorteio entre quatro deles, carta a carta.

Modo	Frente	Como se responde
🔀 Aleatório	sorteia um dos quatro a cada carta	do jeito do modo sorteado
⌨️ tradução → escrever no teclado	português	escreve o 汉字 (ou a frase) no teclado de mandarim do aparelho
🧩 tradução → ordenar as palavras (só frase)	português	toca nas palavras embaralhadas na ordem certa
💬 diálogo (só frase)	a fala do outro, falada e escrita	escreve a sua resposta no teclado, fala a fala
汉字 → pinyin + tradução	ideograma	toca na carta e ela vira, revelando tudo de uma vez
✍️ pinyin + tradução + áudio → desenhar 汉字	o som (escrito e falado) e o significado	escreve o ideograma na grade
🎯 汉字 → tom	ideograma, em silêncio	marca o tom (1º ˉ 2º ˊ 3º ˇ 4º ˋ neutro)
🎧 áudio → tom	nada na tela, só o som	marca o tom

Os dois quizzes de tom são a mesma pergunta por duas portas: o de áudio é ouvido puro, o de 汉字 é memória — a carta fica muda de propósito, e o 🔊 do canto some pra não virar botão de resposta.

🔀 Aleatório

Sorteia, a cada carta, entre ⌨️ teclado, 汉字 → pinyin + tradução, 🎯 汉字 → tom e 🎧 áudio → tom. A ideia é treinar as quatro habilidades na mesma sessão em vez de uma por dia: reconhecer, escrever o som, lembrar o tom de memória e ouvir o tom.

O desenho fica de fora. Leva dez vezes mais tempo que os outros e só serve pra 43 das 100 palavras — no meio de uma sessão rápida ele viraria pedágio. Quem quer desenhar escolhe desenhar.

A pergunta se adapta à palavra. Os dois tons só entram em palavra de um caractere, e o de áudio ainda exige tom não-neutro e voz no aparelho; o que sobra pra 你好 e 谢谢 é teclado ou virar a carta. Por isso o contador do alto mostra o deck inteiro: se um modo não dá conta de uma palavra, o sorteio pega outro que dê. O sorteio também não repete o modo da carta anterior quando há alternativa — sem isso o acaso entrega três iguais em sequência e a sessão parece travada.

Aqui o tom é revisão, não placar. Sozinhos, os quizzes de tom são rodada fechada: embaralham o deck, contam acertos e não mexem no agendamento. Dentro do aleatório eles viram carta normal — marcou o tom, a resposta sugere um botão (certo → Acertei, errado → Errei) e quem decide é você, igual ao desenho e ao teclado. É o que faz o tom contar na meta de 30 e entrar na repetição espaçada.

No seletor de modo também ficam duas chaves: "Falar ao revelar" (áudio automático) e o "⚡ Relâmpago", abaixo.

⌨️ Escrever no teclado

É assim que se escreve chinês num celular de verdade: você digita o som em letras latinas e o teclado oferece os ideogramas que se leem daquele jeito — quem escolhe é você. A carta mostra o português e a pessoa refaz esse caminho inteiro: lembrar o som, escrever o som, reconhecer o ideograma no meio dos homófonos.

O pinyin se digita sem tom e sem espaço: nihao, laoshi. ü e v valem por u (nenhum teclado de celular tem trema), Enter escolhe o primeiro candidato. Os candidatos saem do deck inteiro, não do filtro da sessão — tirados do filtro, uma aula com uma palavra só em "hao" entregaria a resposta antes de a pessoa pensar.

Na frase o resultado é outro. Comparar 我是巴西人 com 我是巴细人 em dois blocos de 38px é caçar o caractere errado no olho — exatamente o que o resultado deveria poupar. Então o texto encolhe e o erro vem marcado na posição em que aconteceu: cada caractere seu ganha verde ou vermelho contra o gabarito, e o 细 fora do lugar salta da linha. Pontuação e espaço não entram na conta — quem escreveu 我是巴西人。com o ponto do teclado chinês acertou a frase, e reprovar por isso seria cobrar datilografia.

O resultado vem em três linhas — era 力波 / não 林娜 / Lìbō — e não numa frase só: comparar dois ideogramas parecidos com eles separados por vírgula é justamente o que não funciona. O ideograma é o que se veio ler ali, então é ele que é grande; o que você escolheu vem menor e em vermelho, sem risco em cima (riscar 一 ou 二 apaga o caractere, que é feito de traço horizontal).

Quem não lembra o som fica sem candidato nenhum, então existe o "não lembro": mostra a resposta e sugere Errei. Acertar sugere Acertei, errar o candidato sugere Errei — mas, como no desenho, quem decide é você, e é uma revisão normal que conta na meta e mexe no agendamento.

✍️ Desenhar

Os outros modos perguntam se você reconhece a palavra. Este pergunta se você sabe escrever — que é outra coisa, e bem mais difícil.

A carta vira uma grade 田字格: um quadrado com uma cruz pontilhada no meio, dividindo em quatro quadrantes. É a grade em que se aprende a escrever chinês no papel, e ela está ali pra ensinar onde cada parte do caractere mora dentro do quadrado. Você escreve com o dedo, apaga o último traço no ↶ ou tudo no ✕, e toca em ✓ Validar.

A pergunta é a palavra inteira menos o ideograma: o pinyin, a tradução e o áudio, os três juntos na mesma linha. Já foram três modos separados, um por pista — mas escrever é difícil o bastante sem também ter que adivinhar de que palavra se está falando.

Três níveis, e dois deles medem outra coisa

Escrever de cabeça é o exercício certo pra quem já conhece o caractere e o exercício errado pra quem viu o 汉字 pela primeira vez na aula de ontem: a grade fica em branco, e grade em branco não ensina. Então a carta tem três chips, e trocar custa um toque — porque o nível certo é o da palavra, não o da pessoa: 人 se escreve de cabeça, 谢 não.

nível	a grade	o que ele cobra
✍️ memória	vazia	a proximidade — o desenho de sempre
👣 guiado	o ideograma apagado por baixo	você cobre inteiro e o ✓ dá a % da ordem
🚦 ao vivo	o mesmo fantasma	cada traço é conferido ao sair do dedo, e o errado não cola

Os dois fáceis não são o difícil com desconto — é outra nota. Com o ideograma na tela a proximidade para de medir: qualquer um cobre o fantasma e tira 100. O que sobra pra cobrar é justamente o que a nota de memória não enxerga, porque ela compara nuvens de pontos e nuvem de pontos não tem ordem: a ordem e o sentido dos traços — que é metade do que se aprende num 汉字 e o que o professor corrige na lousa.

No 👣 guiado o resultado pinta traço a traço: verde no que está na ordem, vermelho no que não está, e em cima do vermelho um número dizendo que traço ele era de verdade ("esse que você fez em terceiro é o quinto"). No 🚦 ao vivo não existe ✓ — o traço fora da vez pisca em vermelho e some, e o que cola vira tinta de verdade; errou duas vezes no mesmo traço, ele acende na grade com uma bolinha em cima de onde se começa. A nota é quantos traços colaram de primeira, então acertar depois de ver a dica não conta, e o rodapé diz quantas recusas houve no caminho.

A linha de corte do 🚦 ao vivo é outra: 100% é Acertei, e qualquer tropeço é Difícil. Aqui o caractere sempre sai inteiro e na ordem — o traço errado não cola —, então "Errei" não teria o que querer dizer; o que varia é quanta ajuda foi preciso. Nos outros dois níveis a nota continua com as três faixas (≥90 → Acertei, 75/70–89 → Difícil, abaixo → Errei). Como sempre, a nota sugere e quem decide é você.

Contadores separados. "Escrever de memória" (o esc do Progresso) só conta o nível de memória — no guiado o ideograma está na tela, e jogar isso no mesmo número estragaria o diagnóstico que ele existe pra dar. Os dois fáceis alimentam "a ordem dos traços", que é a habilidade que eles treinam.

A nota do ✍️ memória. Validou, o app compara o seu traço com o traçado oficial e dá uma porcentagem de proximidade. 90% ou mais conta como certo. O caractere certo aparece em cinza por baixo do seu desenho, então dá pra ver exatamente onde saiu do lugar ou o que faltou — e tocar na carta vira pro traçado animado, na ordem certa.

A nota já vem com um dos botões sugerido (≥90% → Acertei, 75–89% → Difícil, abaixo → Errei), mas quem decide é você: é uma revisão normal, conta na meta de 30 e mexe no agendamento como qualquer outra.

Como funciona por dentro: o app reamostra as medianas do caractere (o esqueleto, do makemeahanzi) e os seus traços em pontos igualmente espaçados, e mede os dois lados — quanto do caractere você cobriu e quanto do que você desenhou é caractere. Só o primeiro premiaria o rabisco que passa por tudo; só o segundo premiaria o traço caprichado que esquece metade. Antes de comparar, corrige um pouco de tamanho e de posição (até ±12% e ±7% do quadro), porque escrever com o dedo nunca cai no lugar exato — mas com trava, senão desenhar minúsculo num canto valeria 100%.

Como funciona a nota da ordem. Cada traço seu vira o traço oficial mais parecido (a mesma média harmônica de cobertura e precisão, mas de um traço só contra um traço só), e só entra na conta se também estiver no sentido certo — 一 escrito da direita pra esquerda é o mesmo desenho e o traço errado, e é erro que a nuvem de pontos nunca pegaria. Depois o app conta quantos dos seus traços estão em ordem entre si (maior subsequência crescente), sobre o maior dos dois números de traços. Contar assim é mais justo que exigir "o seu 3º é o 3º oficial": quem parte um traço em dois erra um traço, não todos os que vêm depois dele.

O tools/test_ordem.js calibra o quanto um traço do dedo tem que parecer com o oficial pra casar com ele. As duas faixas encostam — o pior traço certo dá 0.52 e o melhor traço de fora da vez dá 0.69 — e o dedo de verdade treme mais que o dedo do teste, então existe o traço certo que o app teima em recusar. Ficar preso no 3º traço de 谢 achando que o app quebrou é pior que deixar passar um traço torto, então a partir da terceira tentativa a régua afrouxa (e nessa altura o traço já está aceso na grade). Não é nota de graça: quem chegou ali já perdeu o "de primeira".

A tolerância do ✍️ memória também não é chute: o tools/test_nota.js roda a nota contra os 57 caracteres do deck deformados de três jeitos (aluno caprichado, médio e desengonçado) e contra todos os pares de caracteres trocados. Com a tolerância atual nenhum caractere errado passa dos 90% — o mais perigoso é 吗 na carta de 喝, que dá 88 porque dividem o 口 e quase toda a estrutura. A primeira tolerância que testei era três vezes mais frouxa e aprovava 38% dos caracteres errados.

Só palavras de um caractere — e só as que têm traçado. A grade é uma só, então 你好 e 谢谢 ficam de fora. E a nota compara o seu traço com o traçado oficial: carta cujo caractere ainda não está no strokes.json (palavra nova antes de o build_strokes.py rodar, ou caractere que o makemeahanzi não tem) sai da sessão em vez de entrar nela com o "✓ Validar" mudo. Os dois quizzes de tom têm a mesma restrição, por outro motivo — o tom é de uma sílaba — e o de áudio ainda tira o tom neutro, que o TTS fala com tom cheio quando isolado. O contador no alto já mostra só o que a sessão vai perguntar, e quando o filtro não sobra nada o app diz qual é a restrição em vez de mostrar uma sessão vazia.

⚡ Relâmpago

Não é um modo, é uma chave que liga por cima do modo escolhido — mas ela só tem onde valer em um, o 汉字 → pinyin + tradução. Nos outros responder já é uma ação (digitar, desenhar, marcar o tom) e não há virada pra cronometrar; no aleatório, piscar só numa carta em cada quatro não seria rodada de relâmpago nenhuma. Nesses casos a chave aparece visivelmente apagada. Ligada, o MODO mostra o raio na frente do nome.

São duas etapas por carta, cada uma com o seu relógio na barra:

Etapa	O quê	Tempo
1 · exposição	a carta aparece e some — só olhar, nada a fazer	1s (ou 2s / 3s)
2 · pergunta	a explicação entra e você diz Errei ou Acertei	3s

Quem pontua é a etapa 2. A etapa 1 é só o flash: tempo curto demais pra raciocinar, que é o ponto — a ideia é sair do pensar e entrar no reconhecer. Se já reconheceu antes de acabar, toque na carta pra adiantar a explicação; isso não dá nem tira ponto.

Deixar os 3s da pergunta acabarem sem responder conta como erro e o app registra quantas foram assim, pra você saber se é dificuldade ou se está só devagar no botão.

No fim da rodada: "Você acertou 41 de 57 — 72%". A nota é sobre o deck inteiro da rodada, não só sobre o que você respondeu — deixar o tempo acabar é resultado, não carta que não existiu.

• Tempo da exposição: 1s / 2s / 3s, escolhido ali mesmo. Padrão 1s.
• ⏸ Pausa ao lado da barra, vale nas duas etapas — pausar só a exposição deixaria a pergunta expirando sozinha bem quando você parou pra ler a explicação com calma.
• Não mexe em nada. Não grava agendamento, não conta pra meta de 30, não sobe pro Supabase. É auto-avaliação rápida pra saber se está indo bem ou mal, não pra remexer no cronograma. Sair da aba ou bloquear o celular congela o relógio — senão a rodada passava sozinha no bolso; ao voltar, a carta recomeça da exposição, que é mais justo do que cobrar a resposta de uma explicação que você não viu.
• É uma rodada fechada do deck filtrado, embaralhada, com a nota no fim. Não emenda na prática livre.
• Fora do quiz de tons: lá responder já é escolher um botão de tom, então a chave aparece apagada.
• Nessa chave o ideograma do verso vem em texto, sem o traçado animado — o traçado leva ~1s pra desenhar e apareceria pela metade.

Recursos nas cartas

• Traçado animado: o ideograma se desenha traço a traço na ordem oficial; toque nele pra repetir
• 🔊 Pronúncia: voz chinesa do próprio aparelho, na frente e no verso
• Pinyin colorido por tom: 1º vermelho · 2º laranja · 3º verde · 4º azul · neutro cinza
• Pronúncia aproximada atrás do pinyin — hǎo (rau), xièxie (xié-xié) —, ligada por padrão e com interruptor no MODO. São as letras do português que chegam mais perto do som: quem lê "hao" com olho de brasileiro fala "áo", e o h chinês é o r de "rato". É muleta pra primeira leitura, não transcrição fonética — a referência continua sendo a gravação do 🔊
• 🚫 desligar esta carta: tira da rotação (religa na aba Cartas) — individual por usuário

卡 Cartas

Consulta: busca, filtro por categoria, 🔊 por linha e o switch liga/desliga de cada carta.

A aba lista um tipo por vez, e abre em Palavras. Frase e palavra dividem a mesma tabela, mas quem entra aqui está procurando o pictograma — e 59 frases embaralhadas com 129 palavras transformam a consulta numa rolagem. O par 汉 Palavras · 💬 Frases no alto é o mesmo do escopo do estudar, então a escolha se faz do mesmo jeito nas duas telas, e some inteiro quando não há frase publicada. Tudo abaixo dele vive dentro do tipo escolhido: os temas (Identidade e Gostos só existem em frase, e não viram chip na lista de palavras), o eixo 📖, a contagem de desligadas e o contador, que voltou a dizer "129 palavras" em vez do "cartas" genérico que somava os dois. Trocar de tipo limpa a busca e o filtro, porque um filtro do outro lado quase nunca existe deste.

Agrupar por, como na Grade. A barra "Agrupar" (Sem grupo · 🏷️ Tema · 📅 Aula) separa a lista em seções com cabeçalho e contagem, sem tirar nada da tela. É independente do filtro 🏷️/📅 acima (que escolhe UM tema/aula): dá pra filtrar por uma aula e ainda ver o resultado agrupado por tema. Vale no celular e no PC; o padrão é "Sem grupo", então a lista corrida de sempre continua sendo o que abre.

A frase herda o desligado das palavras. Desligar 喝 e continuar caindo em 我要喝啤酒 na prática é a mesma carta voltando pela porta dos fundos — o interruptor prometia tirar da rotação e não tirava. Agora basta o 汉字 de uma palavra desligada aparecer dentro da frase pra ela sair do estudo junto (13 frases saem com o 喝). A conta é por substring e não pela segmentação do 🧩: a segmentação devolve null na frase que não fecha a conta de sílabas, e ali o certo é bloquear, não deixar passar. O interruptor da frase continua sendo dela — ninguém mexe no estado salvo —, mas a linha aparece apagada na aba, com o motivo escrito embaixo (🚫 fora da rotação: 喝 está desligada), e entra na contagem do chip 🚫. Sem esse aviso a frase sumiria do estudo com a chavinha verde na tela, e o usuário procuraria o bug no lugar errado.

Na lista de frases o hanzi sobe pra uma linha só dele. Na coluna de 58px que serve pra 水, uma frase como 我爸爸很喜欢喝啤酒 espremeria a tradução contra a borda no celular.

Palavras novas entram pelo seed/seed_cards.json e são publicadas pelo seed.py — aparecem pra todo mundo sem ninguém atualizar nada.

格 Grade

O deck inteiro numa tela só — pictograma em cima, pinyin embaixo, sem escolher tema antes. A aba Cartas é ótima pra achar uma carta e cega pro conjunto: ela lista um tipo, um tema, uma linha por vez. A Grade é a visão de cima, pra enxergar a olho o que a lista só sabe contar — o que já está de pé, o que você mais erra, o que nunca abriu.

Três eixos, e os três valem ao mesmo tempo: Agrupar (🏷️ tema · 📅 aula · 汉 tipo · ⬜ nada), Ordenar dentro de cada monte (🔥 erros · 🌱 domínio · 🔤 pinyin · 📋 deck) e Mostrar (💬 frases · ✅ aprendidas · 🌱 nunca vistas · 🚫 desligadas). A escolha inteira fica salva no settings, porque numa tela de consulta você monta a vista uma vez e volta nela.

Os três moram numa folha, atrás do mesmo botão de uma linha da aba Estudar — pílula com o agrupamento, texto com a ordem e o que está escondido, ▼. Em filas de chips na tela eles eram 150px de controle em 375px de largura: metade da tela gasta pra escolher como ver a outra metade, antes da primeira carta aparecer. O botão é o único lugar onde os três aparecem juntos; dentro da folha você vê um eixo por vez. O resumo diz "sem aprendidas" e não "aprendidas", porque o chip apagado esconde — dito ao contrário, ele se leria como se a tela estivesse mostrando só aquilo.

Além dos quatro chips de classe, o Mostrar tem um chip por degrau da escala de vermelho — sem tropeço · 1–2 · 3–4 · 5–7 · 8+, tirados do próprio ERRO_FAIXAS, então mexer nas faixas do filtro 🔥 reescreve os chips sozinho. Apagar os degraus claros é "quero ver só as que eu sou muito ruim", e o resumo do botão vira ≥5 tropeços quando as faixas ligadas são as mais vermelhas em sequência. Cada chip carrega o quadradinho da própria cor: ele é a legenda da escala, e por isso não existe mais uma escala desenhada num canto pra você casar com os quadradinhos na tela. A aprendida não passa pelas faixas — ela está fora da escala do vermelho, que é o que a borda verde diz, e quem manda nela é só o chip ✅; sem essa exceção, apagar "sem tropeço" pra ver as difíceis levaria as aprendidas junto com o ✅ aceso dizendo que elas estão na tela.

No Mostrar cada chip esconde uma classe de carta quando apagado, e todos nascem ligados: a Grade abre no deck inteiro, que é a razão dela existir, e tirar coisa da tela é o que você faz depois, de propósito. Esconder as aprendidas é o caso que pediu esse eixo — o que sobra é exatamente o que ainda falta. Chip apagado aparece riscado, senão um chip branco aqui se leria como "clique pra mostrar", que é o contrário do que ele está dizendo. Carta que casa com mais de um chip apagado some do mesmo jeito: some se qualquer um a pegar, que é como se lê "esconder". Com filtro ligado o contador diz "137 de 302 cartas" — sozinho, "137 cartas" pareceria o tamanho do deck —, e a categoria escondida sai da linha em vez de aparecer zerada, porque "0 aprendidas" logo abaixo do ✅ riscado se lê como "você não aprendeu nenhuma". O 💬 só existe quando há frase publicada.

O que a tela pinta é o seu estado, não o conteúdo da carta. Uma escala só, e ela é do fundo: branco = tranquila, e o vermelho vai ficando mais forte conforme você tropeça, nas mesmas quatro faixas do filtro 🔥 (1, 3, 5, 8 tropeços). A legenda desenha a escala inteira, os cinco degraus — "mais vermelho = mais tropeço" não diz onde ela começa nem quantos degraus tem.

Aprendida é fundo branco com borda verde. Ela sai da escala em vez de ocupar o degrau zero: não é "a que eu menos erro", é outra coisa, e por isso fala por uma borda e não por um tom. Sair do vermelho é justamente o que se quer ver acontecer — o contador de tropeços é histórico e não esquece, e 说 com 15 no currículo deixar de ser vermelho quando o intervalo chega nos 21 dias (o mesmo LEARNED_IVL do Progresso) é a tela dizendo que você aprendeu. Fora da rotação fala por borda tracejada e cinza, pelo mesmo motivo.

Já teve uma segunda camada aqui — a opacidade do texto dizendo o quanto você sabe, por cima do vermelho do fundo. Duas escalas no mesmo quadrado não se leem: você olhava um tom mais claro e não sabia se ele queria dizer "ainda não sei" ou "não erro". Saiu (24/09). Com uma escala e duas bordas, que são coisas de natureza diferente, a tela inteira se lê de longe. O preço é que "nunca vista" agora parece igual a "vista e tranquila" — as duas são brancas; quem separa as duas é o 🌱 Domínio na ordenação e o balão de cada carta. Tocar fala a carta e abre esse balão, com a tradução, o domínio e a contagem de tropeços.

✋ Meu arranjo

O quinto agrupamento não vem do deck: vem de você. Agrupar por tema, aula ou tipo responde perguntas que o JSON já sabe responder; a pergunta que ele não sabe é "quais destas eu confundo uma com a outra" — 我 e 找, 书 e 出. Isso não está em campo nenhum, está na sua cabeça, e a única forma de botar na tela é arrastar uma pra perto da outra.

+ novo monte cria um monte (✏️ renomeia, ✕ desfaz — as cartas voltam pro Sem monte, que é onde mora tudo que você ainda não arrumou). O botão fica antes do Sem monte: depois dele seriam 160 cartas de rolagem até um botão que ninguém acha. Dentro de um monte seu a ordem é a que você arrastou, e o eixo Ordenar não manda ali — ordenar por erro dentro do seu arranjo o desmancharia a cada revisão, que é o oposto de arrumar. Uma carta vive num monte só: arrastar move, não copia, senão "estas eu confundo" deixaria de querer dizer alguma coisa. Os filtros do Mostrar continuam valendo — a carta escondida só não aparece, o monte dela continua lá.

O arrasto é pointer event na mão, não a API de drag-and-drop do HTML, que não existe em toque. No dedo ele só começa depois de 230ms parado: sem essa espera não sobraria como rolar uma tela de 300 cartas — o dedo que desliza é rolagem, o dedo que espera é arrasto. Quando pega, vibra (12ms) e a página para de rolar sozinha (um preventDefault no touchmove, que só funciona porque o dedo ficou parado até ali — gesto de rolagem já começado é tarde). A rolagem passa a ser a do próprio arrasto, quando você chega na borda da tela. No mouse não existe esse empate, então lá quem começa o arrasto é o primeiro movimento — e não o clique parado, senão todo toque pra ouvir a carta piscaria um fantasma.

O arranjo mora só no localStorage, por usuário, e não sobe pro banco. Uma coluna nova exige DDL, que ninguém do time tem — o mesmo motivo que fez a frase morar em tags. Então ele é seu e do seu aparelho: não segue pro computador e não aparece pros outros.

🔵 Radical em azul

O último eixo da folha não pinta o seu progresso — pinta a estrutura do caractere. Marca 氵 água e todo pictograma que tem o 氵 desenha esses três traços em azul: 汁, 汉, 汤, 汽, 渴, 酒. É o que deixa ver a olho que 河 e 海 são "parentes de água", que o 女 do 妈 é o mesmo do 好 e do 姐. O seletor lista só radical rotulado presente em ≥2 cartas da tela (radical solitário não mostra relação nenhuma), com o significado em português e a contagem.

Pintar um pedaço do caractere exige desenhá-lo como SVG — a fonte pinta o glifo inteiro de uma cor só. Então a carta que tem o radical troca a fonte pelo traçado a pincel do makemeahanzi (o mesmo do modo ✍️), com os traços do radical em azul e o resto na cor do texto; a que não tem recua pro fundo, pra o olho ir direto ao conjunto que compartilha o radical. E ligar um radical apaga o vermelho do erro: são duas perguntas diferentes — o que eu erro, como o caractere é feito — e pintar as duas de uma vez é o problema das duas escalas de novo. Uma lente por vez.

Com um radical escolhido aparece o que ele faz com a tela, num segmentado de três: 🖌️ Pintar (o de cima — mostra tudo, pinta quem tem, recua o resto), 📑 Agrupar (quebra em dois montes, 氵 água em cima e sem 氵 embaixo) e 🔎 Só essas (esconde quem não tem, sobra só o grupo do radical). O Agrupar substitui o eixo Agrupar enquanto o radical estiver ligado — aninhar "tema dentro de com-氵" viraria sub-sub-grupo e poluiria a tela; a pílula do botão vira 🔵 氵 pra avisar. Já o Só essas preserva o Agrupar: "as de água, por tema" continua valendo, porque ali ele filtra, não reagrupa.

O dado é o campo matches do dictionary.txt do makemeahanzi, que diz a que componente de 1º nível cada traço pertence; o tools/build_radicals.py recorta isso pros caracteres do deck em strokes/radicals.json (5 KB). Os significados dos radicais ficam no RADICAIS do app.js, não no arquivo gerado: significado de radical é conhecimento, não recorte do deck.

O botão significado (ao lado do A−/A+) acrescenta a tradução embaixo do pinyin em cada cartão — desligado por padrão, pra o cartão continuar sendo só pictograma + som. Fica salvo por aparelho, como o tamanho.

A frase não entra na grade: ela toma a linha inteira, e intercalada com as palavras parte o bloco de pictogramas em fileiras de uma carta só. Dentro de cada grupo as frases ficam depois, empilhadas. E o pinyin aqui vai sem as cores de tom — em 76px, com fundo vermelho atrás, cinco cores de sílaba viram ruído em cima do código que a tela existe pra mostrar.

🏆 Competição

A aba Progresso é sobre você; a Competição é sobre os quatro juntos. Puxa o progress de todo mundo de uma vez (a policy de leitura é aberta e não há dado sensível — é acerto e erro de flashcard), agrega por pessoa e compara. Sem coluna nova: tudo já mora no n_good/n_hard/n_again e no hab de cada linha.

• Placar — um cartão por pessoa (🥇🥈🥉), ordenado por aprendidas, com cartas ligadas, % de acerto e a sequência 🔥. O seu fica destacado.
• Cartas novas ao longo do tempo — gráfico de linhas, uma por pessoa, do vocabulário crescendo (soma acumulada de new_cnt do review_log). O banco não guarda o acerto histórico, só o de agora — então a curva mostra o crescimento do deck de cada um, que é o que o dado permite.
• Erro por habilidade / por tema / frases × palavras — três matrizes linha × pessoa, célula = % de erro (vermelho cresce com a taxa). Quem vai bem em quê, em que assunto, e em frase vs palavra.
• Tons que cada um confunde — do tom_x, o par que cada pessoa mais troca.
• Quem estudou mais · 7 dias — a grade de revisões por dia de cada um (veio da aba Progresso, é o lugar dela: é comparação, não progresso pessoal).
• O que a turma mais erra — ranking das cartas que a turma toda mais tropeça, com quanto cada um errou.

No PC o placar e o gráfico ficam em largura cheia, e o resto se espalha em duas colunas (masonry), como o Progresso.

Só leitura, e cai fora sem quebrar nada se o banco não responder.

🔥 Progresso

Total de palavras no deck, revisões de hoje, novas disponíveis, aprendidas (agendadas pra 21+ dias), sequência de dias 🔥 e o gráfico das suas últimas 2 semanas. Toque ou passe o mouse nas barras pra ver o número. (A comparação da turma foi pra aba 🏆 Competição.) "Zerar meu progresso" apaga local + nuvem (só o seu).

🖥️ No computador

O app é o mesmo — HTML/JS num arquivo só, servido no Pages, aberto no navegador do celular ou do PC. Ele nasceu mobile-first: uma coluna de 720px no meio, e é assim que fica no telefone, que segue sendo a prioridade. Em tela larga (≥900px) entra um bloco de CSS que só alarga, nunca redesenha — nenhuma regra de celular muda, então o telefone fica byte a byte igual.

No PC ele deixa de imitar o telefone numa faixa central e vira layout de computador:

• Menu na lateral esquerda — as abas do topo viram uma barra vertical fixa, fundo claro (branco no tema claro, o tom escuro equivalente no escuro), e o conteúdo desloca pra depois dela.
• Grade vai de ponta a ponta (é a tela do "ver tudo de uma vez"); só o botão e a linha do contador ficam centrados. O A− / A+ ao lado do contador aumenta e diminui o cartão (menos/mais colunas) — vale no celular também, e cada aparelho guarda o seu tamanho (o localStorage é por navegador).
• Cartas vira uma lista em largura cheia com cada informação numa coluna — pictograma, pinyin, significado, descrição, categoria, som, interruptor —, alinhadas de linha em linha como uma tabela. A largura toda é o que tira a quebra de linha da descrição, que agora é uma coluna e não desce mais pra baixo. Frase segue a mesma organização, só com o hanzi numa coluna larga (a frase é longa) e o miolo dividido em fr em vez de px fixo, porque o pinyin de uma frase inteira não cabe num tamanho fixo.
• Progresso vira três colunas (flex), sendo a do meio só a "palavra por palavra" — a lista longa —, que assim para de empurrar o resto pra baixo; as cinco estatísticas ficam numa fileira em cima. Os .pcol são display:contents no celular, então lá os blocos empilham na ordem do DOM (revisões, habilidade, palavra, turma, deck), idêntica à de antes.
• O topo do conteúdo (logo, streak, perfil) ocupa a largura toda, à direita da barra lateral.
• Estudar fica centrado num tamanho confortável — ler um flashcard de 1000px é pior, não melhor.
• As folhas param de subir do rodapé e viram uma janela central.

Estrutura técnica

Arquivo	O quê
index.html + app.js	app inteiro — HTML/CSS/JS puro, sem build, sem dependências
config.js	URL + anon key do Supabase (pública por design; RLS protege)
seed/seed_cards.json	a fonte de verdade do deck — editado à mão; o banco é a cópia (ver o fluxo abaixo)
seed/dialogos.json	roteiros do modo 💬 diálogo — só ids de frases que já existem, na ordem falada. Não vai pro banco: é ordem, não carta
supabase/schema.sql	tabelas cards (read-only via anon; tipo = palavra/frase), progress, review_log
supabase/seed.py	upsert do seed no banco (service key)
fonts/hanzi.woff2	fonte caligráfica 楷书 (AR PL UKai CN, subset ~24KB; licença em fonts/ARPHICPL.txt)
strokes/strokes.json	traçados dos caracteres (makemeahanzi)
strokes/radicals.json	traço→componente de cada caractere, pro radical em azul da Grade (makemeahanzi)
audio/nativo/*.mp3	em uso — gravações de falantes nativos (Wikimedia/Shtooka); créditos em audio/nativo/CREDITS.md
audio/nativo/CREDITS.md	atribuição por arquivo — autor, licença e qual caractere foi gravado
tools/	build_font.py, build_strokes.py, build_radicals.py, build_audio_nativo.py, build_audio.py, test_nota.js (calibração da nota do desenho), test_ordem.js (calibração da nota da ordem dos traços)
sw.js + manifest.webmanifest	PWA que funciona sem internet: casca pela rede com prazo de 3s e cópia se não vier, áudio da cópia atualizando por trás, Supabase fora do SW (as regras estão no cabeçalho do arquivo)

Por onde o conteúdo anda

O sentido é único, e o nome do arquivo engana: apesar de se chamar "seed", o JSON não é cópia do banco — é o original.

seed/seed_cards.json  ──(supabase/seed.py)──▶  Supabase  ──(fetch)──▶  app
        ↑                                                                 │
   editado à mão                        cai de volta no JSON só se o banco falhar

Três consequências:

• Editar pelo painel do Supabase é perda de tempo. O próximo seed.py sobrescreve com o que está no JSON.
• Nem toda coluna é do JSON. O seed.py manda 11 campos (id, hanzi, pinyin, pt, deck, tags, nota, data_aula, fonte, deleted, created_by — o tipo do JSON vira a tag frase). O audio_url fica de fora de propósito — é por isso que rodar o seed não desliga as gravações nativas. Quem escreve nele é só o build_audio_nativo.py.
• Apagar não propaga. O upsert insere e atualiza, nunca remove. Tirar uma palavra do JSON deixa ela viva no banco e no app. Pra tirar uma carta de todo mundo, marque "deleted": true nela no JSON: o seed.py manda a coluna, o banco entrega sem ela e o app some com a carta — e o JSON continua dizendo que ela existiu.

Adicionar palavras novas (fluxo do Leo)

1. Editar seed/seed_cards.json — preencher fonte com a origem (cap3, extra-aula, duolingo) — é o eixo 📖 — e data_aula ("2026-08-13") com o dia da aula, quando veio de uma. Frase leva "tipo":"frase" e o pinyin separado por palavra ("Wǒ shì Bāxī rén"), que é de onde sai a segmentação do 🧩 ordenar — colar tudo junto tira a frase desse modo
2. source ~/Documents/codes/cloud_local/manman_supabase.env && python3 supabase/seed.py
3. Caractere novo? python3 tools/build_font.py, python3 tools/build_strokes.py e python3 tools/build_radicals.py
4. python3 tools/build_audio_nativo.py — baixa a gravação nativa das cartas novas e liga o audio_url (precisa das mesmas variáveis do passo 2 e do ffmpeg). Frases ele pula: o Commons nomeia os arquivos por sílaba de palavra, então procurar a frase inteira é consulta garantidamente vazia — elas vão pro passo 5
5. Frase nova? python3 tools/build_audio_frases.py — gera a voz da ElevenLabs só das frases que ainda não têm arquivo (precisa da ELEVEN_API_KEY além das variáveis do passo 2)
6. Commit + push — os MP3s precisam estar publicados, senão o audio_url aponta pra 404

Rodou o schema.sql antes da V2.3? Ele é idempotente — rodar de novo só adiciona a coluna data_aula, não apaga nada.

Rodar local: python3 -m http.server 8080 → http://localhost:8080/ (debug de datas: ?debug=1).

Trabalhando junto — leia antes do primeiro commit

Rodar local não exige nada: é HTML/JS puro, sem build e sem dependências.

git clone https://github.com/leoborja/manman.git && cd manman
python3 -m http.server 8080     # → http://localhost:8080/  (datas: ?debug=1)

Quem usa o Claude Code não precisa nem disso: o .claude/launch.json já sobe o mesmo servidor na 8777 (porta diferente da 8080 de propósito, pra não brigar com um servidor que você já tenha aberto à mão). O resto do .claude/ é local de cada máquina e está no .gitignore.

Funcionalidade (app.js, index.html) → branch + PR

git checkout -b henrique/nome-da-melhoria
# edita, commita
git push -u origin henrique/nome-da-melhoria
gh pr create --base main

Merge no PR e o GitHub Pages publica sozinho — main é o que está no ar, então ele nunca pode ficar quebrado.

• Branches curtas. O app.js muda quase todo dia; branch parada duas semanas vira merge desagradável. Entregue de pouco em pouco e rode git pull --rebase origin main com frequência.
• Não commite arquivo gerado: fonts/hanzi.woff2, strokes/strokes.json, audio/nativo/*.mp3. Quem mexe em funcionalidade não precisa gerar nenhum deles — se aparecerem no seu git status, você rodou um script à toa. São binário (ou JSON de linha única), que o git não sabe fazer merge: dois PRs que os regerem conflitam de um jeito que ninguém resolve à mão.

Conteúdo (palavras novas) → direto no main

Vai direto porque editar o JSON é só metade: em seguida tem que rodar o pipeline (seed, fonte, traçado, áudio) e publicar junto, senão o audio_url aponta pra 404. O passo a passo está em "Adicionar palavras novas" acima.

Se for mandar palavra por PR, mande só o seed_cards.json — o resto é reconstruído no main depois do merge.

Três avisos

A chave do Supabase

A SUPABASE_SERVICE_KEY fica fora do repositório — por exemplo ~/.config/manman.env — e entra por source antes dos scripts. Nunca dentro da pasta do projeto: o .gitignore cobre o que a gente previu, não o que ninguém imaginou.

Um hook de pre-commit barra commit que carregue chave do Supabase (JWT service_role, sb_secret_…, ou a anon key fora do config.js). Ele vem no repositório, mas o git não instala hook sozinho — cada clone precisa rodar uma vez:

git config core.hooksPath hooks

Falso positivo legítimo passa com git commit --no-verify.

Por que a trava: este repositório é público. Segredo publicado não se apaga — sai do arquivo mas fica no histórico e em qualquer fork ou clone que já exista. A recuperação é rotacionar a chave no Supabase, não editar o commit.

• A SUPABASE_SERVICE_KEY ignora o RLS por completo — quem a tem pode apagar o deck e sobrescrever o progresso de todo mundo, e não dá pra revogar de uma pessoa só. Ela não é necessária pra mexer no app: só o seed.py e o passo final do build_audio_nativo.py usam. A anon key do config.js é outra coisa, pública por design.
• tools/build_audio_frases.py só toca em frase. Era o build_audio.py, que sobrescrevia o audio_url de todas as cartas e por isso viveu meses com um "não rode" aqui. Foi reescrito com três travas — lista filtrada por tipo, conferência do id antes do PATCH, e pasta própria (audio/frases/) que não colide com audio/nativo/. Rodar duas vezes não faz nada de novo; só gera o que falta.
• Nada de PDF no git. O .gitignore barra *.pdf porque o livro do professor fica na pasta do projeto e o repositório é público.

Licenças dos ativos de terceiros

Todas permitem uso comercial. O que elas exigem está cumprido assim:

Ativo	Licença	O que a licença exige	Onde está cumprido
fonts/hanzi.woff2	Arphic PL	manter a licença junto (§1); avisar como e quando foi modificado (§2a); manter a modificação disponível (§2b)	fonts/ARPHICPL.txt; aviso na tabela name da fonte; repo público + link na tela Créditos
strokes/strokes.json	Arphic PL (via makemeahanzi, derivado da AR PL KaitiM GB)	idem	strokes/ARPHICPL.txt; aviso na chave _ do JSON
audio/nativo/*.mp3 (45)	CC BY 2.0 FR	atribuição	tela Créditos + audio/nativo/CREDITS.md
audio/nativo/*.mp3 (7)	CC BY-SA 3.0 US	atribuição; share-alike só em obra derivada	idem — a conversão ogg→mp3 é mudança de formato, permitida pela §3 sem virar derivada

A Arphic PL não contamina o app: a §2 exclui explicitamente as partes que não derivam da fonte ("mere aggregation ... does not bring the other work under the scope of this License"). O index.html e o app.js podem ser fechados.

Os MP3s da ElevenLabs foram apagados em 14/08: não estavam em uso e o direito comercial sobre eles depende do plano da conta.

Decisões de produto (histórico)

• Deck contém só o que a turma já aprendeu — sem limite de novas/dia
• Partículas (吗/呢) faladas sozinhas e fora do quiz de tons (isoladas, o TTS falaria tom cheio contradizendo o gabarito neutro)
• 🐢 Falar devagar (0,75×) em configurações, desligado por padrão. Um interruptor só, porque a lentidão vale nas duas fontes: no MP3 é playbackRate com preservesPitch, no TTS é o rate da voz. Time-stretch em vez de dois arquivos gravados — meio caminho pra qualquer voz futura e nenhum byte a mais no repositório. O preservesPitch não é detalhe de qualidade: sem ele, 0,75× baixa a altura da voz junto com a velocidade, e num idioma de tom isso ensina o aluno a ouvir errado. O TTS já falava a 0,8 desde sempre, então o 🐢 multiplica esse número (0,6) em vez de trocá-lo — "devagar" não pode sair mais rápido do que o app falava antes de a opção existir
• Voz: gravação de falante nativo (Wikimedia/Shtooka) nas cartas que têm; TTS do aparelho no resto. O professor apontou que o TTS não faz o 3º tom completo — só a descida, sem a subida. Teste cego com 好 confirmou: a gravação humana ganhou de todas as opções de TTS (voz, velocidade, pontuação) e da ElevenLabs
• Gravação de homófono é aceita: os arquivos do Commons são nomeados por pinyin, então 九 jiǔ recebe a gravação de 久 jiǔ. Som idêntico, que é o que importa pra tom e pronúncia — o CREDITS.md registra quais são
• Light mode padrão; fonte caligráfica porque a de imprensa não batia com a escrita à mão do professor
• Fonte trocada de LXGW WenKai (traço macio, base japonesa) para AR PL UKai CN — 楷书 de pincel, mais clássico
• Lista de modos cortada de 10 pra 5 (22/08): as quatro direções de leitura (汉字→pinyin→tradução, tradução→汉字, pinyin→汉字, só áudio) e o 🔀 aleatório eram variações do mesmo gesto — virar a carta — e as três portas do desenho eram o mesmo exercício com pista a menos. Sobrou um modo por tipo de resposta: virar, digitar, desenhar, marcar o tom. Quem tinha um modo antigo salvo cai no equivalente (as leituras → 汉字 → pinyin + tradução; os três desenhos → o desenho único)
• Perfil e navegação arrumados (23/08): a pílula com o nome e o ícone de tema viraram um botão de perfil (a inicial, redondo) com folha própria, e o "por tema / por aula" virou a cabeça da fila de chips (sticky) em vez de uma linha só dele, que gastava uma faixa inteira de altura pra dizer duas palavras
• 🔀 Aleatório (23/08) sorteando quatro modos por carta, e o tom deixando de ser placar quando está dentro dele: a rodada fechada do quiz não cabe numa fila de revisão, e manter as duas lógicas separadas dentro da mesma sessão significaria uma sessão que ora conta pra meta ora não. Virou carta avaliada como qualquer outra — o que também resolve o incômodo de o treino de tom ser o único que não entrava na repetição espaçada

Roadmap

As ideias novas (pesquisa de 14/09 com o Daily Hanzi e mais 14 apps), priorizadas e com esforço estimado, estão em docs/ideias.md.

• Ranking da turma — gráfico "A turma · últimos 14 dias" no Progresso, ordenado por total (18/08)
• Aba Progresso turbinada (heatmap, taxa de acerto, previsão)
• Reativar voz gravada — resolvido com gravação nativa do Wikimedia (14/08)
• Áudio das 30 palavras sem gravação nativa (não existem no Shtooka nem na Lingua Libre) — caem no TTS. Opções e lista em docs/ideias.md
• Filtro por aula na tela de estudo — feito em 17/08
• Treino de reconhecimento rápido — chave ⚡ Relâmpago por cima de qualquer modo, com pausa (21/08)
• Radical/decomposição nas cartas — segunda leva em docs/ideias.md
• Domínio próprio — manman.com.br já registrado (Cloud Arbitration). Ordem: DNS primeiro (4 registros A da raiz pra 185.199.108.153, .109.153, .110.153, .111.153 e CNAME do www pra leoborja.github.io), depois o domínio em Settings → Pages, depois Enforce HTTPS (sem isso o PWA não instala). Três detalhes:
  • Se o DNS for pela Cloudflare, mantenha a nuvem cinza até o GitHub emitir o certificado — com o proxy ligado ele não valida o domínio. Só depois, se quiser proxy, use SSL Full (strict): no Flexible dá loop de redirecionamento.
  • Com proxy ligado, exclua app.js, index.html e config.js do cache. O service worker busca a casca na rede primeiro (com prazo de 3s) e conta com o servidor devolver a versão nova.
  • localStorage é por origem: no domínio novo o app abre com progresso zerado, mas recupera ao escolher o nome — o aceita o que vem do Supabase quando não há estado local. Só as preferências de tela (modo, tema, filtro) voltam ao padrão. Avisar os três pra reinstalar o atalho na tela de início.