USMLE Daily Tracker - Anki Sync

Sincronize automaticamente suas estatísticas diárias do Anki com o dashboard USMLE Daily Study Tracker.

Features • Instalação • Uso • Estatísticas • Troubleshooting

---

✨ Features

Feature	Descrição
🔄 Sync Automático	Sincroniza estatísticas automaticamente após cada sync do AnkiWeb
🔐 Autenticação Segura	Login com email/senha, credenciais salvas localmente
👥 Multi-usuário	Dados isolados por usuário
📊 16 Métricas	Coleta estatísticas detalhadas de cada sessão
⚡ Sync Manual	Opção para sincronizar manualmente via menu
🔔 Notificação Visual	Toast notification confirma cada sync bem-sucedido

---

📋 Requisitos

• Anki Desktop: Versão 2.1.50 ou superior
• Conta USMLE Tracker: Criar conta aqui

---

📥 Instalação

Opção 1: Download Direto (Recomendado)

1. Baixe o arquivo .ankiaddon da última release
2. Dê duplo-clique no arquivo baixado
3. Confirme a instalação no Anki
4. Reinicie o Anki

Opção 2: Instalação Manual

1. Baixe o código fonte
2. Extraia para a pasta de add-ons do Anki:

Sistema	Caminho
Windows	%APPDATA%\Anki2\addons21\usmle_tracker_sync\
macOS	~/Library/Application Support/Anki2/addons21/usmle_tracker_sync/
Linux	~/.local/share/Anki2/addons21/usmle_tracker_sync/

3. Reinicie o Anki

---

🚀 Uso

Primeiro Acesso

1. Abra o Anki
2. Vá em Tools → USMLE Tracker → Login
3. Entre com seu email e senha do USMLE Tracker
4. Pronto! Seus dados serão sincronizados automaticamente

Menu de Opções

Tools → USMLE Tracker
├── Login              # Fazer login na conta
├── Logout             # Sair da conta
└── Sincronizar agora  # Sync manual

Fluxo de Sincronização

┌─────────────┐     ┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   Revisar   │ ──► │  Sync Anki  │ ──► │  Coleta     │ ──► │  Dashboard  │
│   Cards     │     │   (Web)     │     │  Stats      │     │   Atualiza  │
└─────────────┘     └─────────────┘     └─────────────┘     └─────────────┘

---

📊 Estatísticas Coletadas

Contagens de Revisão

Métrica	Descrição
total_reviews	Total de revisões do dia
unique_cards	Número de cards distintos revisados

Distribuição de Facilidade

Métrica	Descrição
again_count	Botão "Again" (ease=1)
hard_count	Botão "Hard" (ease=2)
good_count	Botão "Good" (ease=3)
easy_count	Botão "Easy" (ease=4)

Tipos de Card

Métrica	Descrição
new_cards	Cards novos estudados
review_cards	Cards graduados revisados
relearn_cards	Cards em reaprendizado

Métricas de Tempo

Métrica	Descrição
total_time_sec	Tempo total de estudo (segundos)
avg_time_sec	Tempo médio por revisão

Métricas de Performance

Métrica	Descrição
retention_rate	Taxa de retenção (% não-Again)
mature_reviews	Revisões de cards maduros (intervalo ≥ 21 dias)
young_reviews	Revisões de cards jovens (0 < intervalo < 21)
avg_ease_factor	Fator de facilidade médio

---

🔧 Troubleshooting

Add-on não aparece no menu

• ✅ Verifique se a pasta contém __init__.py
• ✅ Reinicie o Anki completamente (não apenas sync)
• ✅ Verifique Tools → Add-ons para erros

Falha no login

• ✅ Verifique email e senha
• ✅ Certifique-se de ter uma conta em usmle-signup
• ✅ Verifique sua conexão com a internet

Stats não sincronizam

• ✅ Certifique-se de estar logado
• ✅ Verifique se você tem revisões hoje
• ✅ Tente sync manual: Tools → USMLE Tracker → Sincronizar agora

Erros de rede

• ✅ Verifique conexão com internet
• ✅ Tente novamente mais tarde
• ✅ Verifique o console de debug do Anki (Help → Debug Console)

---

🔒 Privacidade & Segurança

Aspecto	Implementação
Processamento	Todas estatísticas calculadas localmente
Transmissão	Dados enviados via HTTPS
Isolamento	Cada usuário só acessa seus próprios dados
Leitura	Add-on nunca modifica sua coleção Anki
Credenciais	Salvas localmente, nunca compartilhadas

---

🔗 Links Úteis

Link	Descrição
📊 Dashboard	Visualize suas estatísticas
📝 Criar Conta	Registre-se gratuitamente
🐛 Reportar Bug	Encontrou um problema?
💾 Releases	Downloads

---

📄 Licença

Este projeto está licenciado sob a MIT License.

---

📝 Changelog

v1.1.0 (2025)

• 🔔 Notificação toast - Mensagem visual confirma cada sync bem-sucedido
• 🎨 Animação de fade in/out suave
• 📊 Toast mostra quantidade de reviews e taxa de retenção

v1.0.0 (2024)

• 🎉 Release inicial
• ✅ Autenticação segura
• ✅ Sync automático após AnkiWeb sync
• ✅ Opção de sync manual
• ✅ 16 métricas estatísticas
• ✅ Suporte multi-usuário

---

Feito com ❤️ para estudantes de medicina