SteelXR/.lovable/plan.md

Objetivo

Adicionar um botão "Escala" com presets de redução (1:2, 1:4, 1:8, 1:10, 1:20, 1:33, 1:50, 1:100, 1:200) e ampliação (2:1, 4:1, 10:1), disponível tanto no Viewer 2D quanto no XR. Ao mudar a escala, o app ajusta automaticamente as ferramentas que dependem de tamanho real (medições, sensibilidade do ajuste fino, snap, hover auto-detect), mantendo todos os números exibidos em mm reais da peça.

Conceito chave

• "1:N" significa: o modelo é renderizado N vezes menor que o real (renderScale = 1/N).
• "N:1" significa: renderizado N vezes maior (renderScale = N).
• Os dados do modelo continuam em mm reais. Só o scale aplicado ao <group> muda.
• Medições, sensibilidades, indicadores e relatório PDF continuam exibindo mm REAIS — o app multiplica/divide pelo fator quando necessário.

Mudanças

1. Store (useModelStore.ts)

Adicionar:

scaleRatio: { label: '1:1', factor: 1 }   // factor = renderScale
setScaleRatio: (r) => void

Lista de presets exportada (label + factor).

fineTuning.scale continua existindo para o gesto two-hand do XR; o novo scaleRatio é aplicado por cima (multiplicado) no grupo do modelo.

2. Cálculo de medições (addMeasurePoint)

Pontos A/B vêm em coordenadas world já escaladas. Para reportar mm reais:

distanceMM_real = distanciaWorld_mm / scaleRatio.factor

Atualizar a função addMeasurePoint para dividir pela escala atual antes de salvar distanceMM. Tooltips e PDF continuam usando o valor salvo (sem mudança).

3. Ajuste fino (FineTuningControls + XRHud joystick)

POSITION_STEP deve representar 1 mm real. Aplicar:

worldStep = POSITION_STEP * scaleRatio.factor

Isso garante que clicar "+" desloca visualmente proporcional à escala (em escala 1:100, mexer "1 mm real" desloca 0,01 mm na cena — coerente).

Mesmo tratamento para o joystick no XR (incremento por frame multiplicado por scaleRatio.factor).

4. Auto-detect (hover hole/edge) e snap

Os limiares de detecção de furo/aresta e raio de snap são em metros world. Multiplicar pelo scaleRatio.factor para que continuem capturando os mesmos elementos físicos da peça.

5. ModelViewer

No <group> do modelo, multiplicar o scale final:

finalScale = fineTuning.scale * scaleRatio.factor

6. UI — novo componente ScaleSelector

Botão com ícone de régua + label atual ("1:1", "1:50"…). Ao clicar abre um Popover/Sheet com grid:

Reduzir                          Ampliar
[1:1*] [1:2] [1:4] [1:8]         [2:1]
[1:10] [1:20] [1:33] [1:50]      [4:1]
[1:100] [1:200]                  [10:1]

Toast ao trocar: "Escala 1:50 — medições e controles ajustados para mm reais".

Inserir o componente em:

• ViewerControls (canto dos controles flutuantes do Viewer 2D)
• XRHud (linha de ferramentas, próximo ao toggle "Escala ON/OFF" two-hand)

7. MeasurementsList & FineTuningControls

Adicionar pequeno badge "Escala atual: 1:50" no topo dos painéis de Medições e Ajuste Fino para o usuário lembrar que os valores exibidos são mm reais.

O que NÃO muda

• Gesto two-hand de escala (allowScale) continua funcionando para ajuste livre — mas se o usuário usar o preset, o gesto reseta para 1.0 e o preset assume.
• Relatório PDF: registra a escala atual no cabeçalho.
• Grid e checklist: sem alteração.

Arquivos tocados

• src/stores/useModelStore.ts — novo estado + ajuste em addMeasurePoint
• src/components/ScaleSelector.tsx — novo (popover com presets)
• src/components/ViewerControls.tsx — incluir <ScaleSelector />
• src/components/XRHud.tsx — incluir <ScaleSelector /> + multiplicar passos do joystick
• src/components/FineTuningControls.tsx — multiplicar passos pela escala + badge
• src/components/MeasurementsList.tsx — badge da escala
• src/components/three/ModelViewer.tsx — aplicar scaleRatio.factor no group + ajustar threshold de snap/hover
• src/lib/generateReport.ts — incluir escala no cabeçalho do PDF

Validação

• Carregar viga demo, medir uma aresta conhecida em 1:1 → trocar para 1:10 → remedir mesma aresta → valor em mm deve permanecer igual.
• Em 1:50, clicar "+" no ajuste fino X uma vez → modelo desloca visualmente pouquíssimo (esperado), mas valor exibido sobe 1 mm.
• No XR, joystick em 1:100 não "voa" o modelo a metros de distância.