Skip to content

To-Do.md

Latest commit

 

History

History
41 lines (30 loc) · 3.6 KB

To-Do.md

File metadata and controls

41 lines (30 loc) · 3.6 KB
Raw

To-Do — AdGuard VPN Plugin (DMS)

Revisão técnica completa em 2026-06-11 (base: v1.3.4, branch main limpa). Prioridades: P0 = bug real / corrigir já · P1 = lógica/UX importante · P2 = melhoria · P3 = docs/infra/polimento.

P2 — Melhorias

  • Confirmação/feedback de favoritos — toast leve ou animação na estrela ao favoritar.
  • Copiar diagnóstico — botão "copiar" no bloco Command output / last command.
  • Limpar 8 chaves i18n órfãs — summary.account, summary.mode_protocol_channel, summary.cli_last_sync, summary.last_command, summary.last_command_none, summary.last_command_output, section.quick_actions, locations.top_last_update definidas em en.js/locales mas não usadas. (action.favorite/action.unfavorite foram reusadas como Accessible.name da estrela em 2026-06-11.)
  • Completar traduções dos locales estendidos — 106-116 chaves em fallback EN por locale (saída do check-i18n-keys.mjs). Priorizar es_ES/fr_FR/de_DE.
  • Gerar lista de idiomas das Settings a partir de array — AdGuardVpnSettings.qml:92-191: 23 opções hardcoded; gerar via options: AdGuardVpnI18n.availableLocales.map(...) e centralizar no I18n singleton.
  • Backoff/regulagem do licenseRefresh — watchdog de 45s ok, mas considerar pular refresh de license quando popout fechado (telemetria desnecessária).
  • Banner de erro dismissível — erros de connect somem no próximo poll bem-sucedido (~8s) porque parseStatus zera lastError; manter último erro de ação num banner fechável separado do erro de status.

P3 — Documentação

  • ARCHITECTURE.md: "four layers" vs tabela com 5 linhas — o texto diz quatro camadas, a tabela lista UI/Settings/Service/Localization/Parsers (5). Alinhar (UI+Settings = camada de apresentação, ou assumir 5).
  • CHANGELOG: adicionar links de comparação — Keep a Changelog recomenda [1.3.4]: https://github.com/.../compare/v1.3.3...v1.3.4 no rodapé.
  • docs/COMMANDS.md: incluir openTunnelLog e prepareDisconnectedRuntime na tabela de operações (hoje só descritos em prosa) com seus exit codes (44/45, 42/43/44).

P3 — Infra

  • CI: instalar formatador QML de forma determinística — o loop for pkg in ... no quality.yml instala "o primeiro que der"; fixar qt6-declarative-dev-tools (Ubuntu 24.04) e falhar com mensagem clara se ausente, em vez de validação silenciosamente parcial.
  • Adicionar qmllint real ao validate-qml.sh se disponível (sintaxe + warnings de binding), não só formatador.

Verificado e OK (sem ação)

  • Paridade i18n: check-i18n-keys.mjs passa (base en.js, 22 locales; pt_BR com paridade estrita).
  • Escapes bash em template literals JS (openTunnelLog, prepareDisconnectedRuntime) corretos conforme regra do projeto.
  • Lógica multi-rota (menor métrica + filtro de interfaces virtuais + bypass toggle) consistente entre código, CHANGELOG v1.3.3 e COMMANDS.md.
  • connectToLocation passa input do usuário como argv (sem shell) — sem injeção.
  • Preflight usa adguardBinary configurado (fix v1.3.4 confirmado no código, linha 927).
  • Auto-connect no startup espera startupStatusKnown && startupConfigKnown (fix v1.3.4 confirmado, linha 606).
  • asBool trata strings "false"/"0"/"off"/"no" (fix v1.3.4 confirmado).
  • Dependências de binding do filteredLocations capturam favoriteLocationTargets via isFavoriteLocation (QML rastreia leituras de propriedade dentro de funções chamadas no binding).
  • plugin.json v1.3.4 = CHANGELOG mais recente = docs/releases/v1.3.4.md presentes.