TDD — Aplicar estrutura de debug

Status

Implementado

Contexto

Cria ou ajusta a estrutura de documentos em /platform para fins de debug. Acessível via Home → Ajuda → Debug.

Contratos

Backend: platformDebugApplyHttp (POST)

• Payload: estrutura JSON a ser aplicada
• Autenticação: Bearer token obrigatório

Frontend: ApplyPlatformDebugStructureUseCase

Interface de Usuário (UI)

Painel de debug (popup Ajuda, desbloqueado). Layout em duas colunas em telas largas; empilhado em mobile.

Componentes relacionados a Aplicar estrutura:

• Atalho 0 — botão numérico "0" na grade de atalhos 0–9; tooltip: "Aplicar estrutura padrão da base (platform)"
• Após execução, dispara automaticamente o snapshot (Atualizar) e o resultado aparece na área "Debug out"

Observação: Não há botão dedicado "Aplicar estrutura" na UI; apenas o atalho 0. Os atalhos 2–9 são reservados para uso futuro.

Fluxo

1. Usuário clica no atalho 0 no DebugHelpPopup
2. Frontend envia payload para platformDebugApplyHttp
3. Backend aplica alterações no Firestore
4. Em seguida, carrega snapshot e exibe na saída

Código de referência

• frontend/lib/application/use_cases/apply_platform_debug_structure.dart
• backend/functions/src/interfaces/http/platform-debug-apply-http-controller.ts