From dd7e1248fc6aaf58de032b99c030a3c5e38dab2e Mon Sep 17 00:00:00 2001 From: "gpt-engineer-app[bot]" <159125892+gpt-engineer-app[bot]@users.noreply.github.com> Date: Thu, 14 May 2026 16:55:34 +0000 Subject: [PATCH] Changes Co-authored-by: Reifonas <211114984+Reifonas@users.noreply.github.com> --- .lovable/plan.md | 94 ++++++++++++++++++++++-------------------------- 1 file changed, 42 insertions(+), 52 deletions(-) diff --git a/.lovable/plan.md b/.lovable/plan.md index 649cb92..59127ba 100644 --- a/.lovable/plan.md +++ b/.lovable/plan.md @@ -1,62 +1,52 @@ -## Resposta curta +# Navegador de pasta na nuvem (FileBrowser) -Sim, é totalmente possível — hoje o app só carrega 1 modelo por vez (`model: ModelInfo | null` no store), mas a arquitetura (Three.js + R3F) suporta naturalmente múltiplas peças em uma mesma cena. Precisa migrar de "modelo único" para "lista de modelos", cada um com seu próprio transform (posição/rotação/escala) e seleção ativa. +Hoje o `CloudLoader` exige a URL exata do arquivo (ex.: `…/demo.ifc`). Vou estender para também aceitar uma **URL de pasta** (ex.: `https://store.tracksteel.com.br/modelos/`). Ao clicar em **Abrir pasta**, o app lista os arquivos `.ifc / .obj / .stl / .glb` daquela pasta, o usuário seleciona um e clica em **Carregar**. -## O que muda +## Como vai funcionar (UX) -### 1. Store (`useModelStore.ts`) -- Substituir `model: ModelInfo | null` por `models: SceneModel[]` (até 5 simultâneos para manter 72 FPS no Quest 3). -- Cada `SceneModel` tem: `id`, `fileName`, `url`, `fineTuning` próprio, `visible`, `color` (cor de identificação), `locked`. -- Adicionar `activeModelId: string | null` — o "modelo selecionado" recebe os controles de fine-tuning, escala e medição. -- Ações: `addModel`, `removeModel`, `duplicateModel`, `setActiveModel`, `updateModelTransform`, `toggleVisibility`. -- Compatibilidade: `model` (singular) continua exposto como getter derivado do `activeModelId` para não quebrar telas legadas. +1. No diálogo "Carregar modelo da nuvem" passa a haver dois modos, lado a lado: + - **Arquivo** (comportamento atual) — cola URL do arquivo, clica Carregar. + - **Pasta** (novo) — cola URL da pasta, clica **Abrir pasta**. +2. Ao abrir uma pasta: + - Mostra breadcrumb do caminho atual (clicável para subir). + - Lista subpastas (📁) e arquivos 3D suportados (📄 com extensão e tamanho). + - Esconde por padrão arquivos não suportados; um toggle "Mostrar todos" libera os demais. + - Clicar numa subpasta navega para dentro dela; clicar num arquivo o seleciona. +3. Botão **Carregar selecionado** dispara o mesmo fluxo já existente (`smartFetch` + conversão IFC/OBJ/STL → GLB + `addModel`). +4. Funciona em append: respeita o limite de 5 peças simultâneas e o toast de erro já existente. -### 2. Cena 3D (`ModelViewer.tsx`) -- Renderizar `models.map(m => )`. -- Cada `` aplica seu próprio transform (já existe a lógica, só vira por-instância). -- Outline/halo sutil no modelo ativo para feedback visual. -- Click em um modelo → torna-o ativo (raycaster identifica qual instância foi clicada). +## Detecção e API (FileBrowser) -### 3. UI Desktop (`Viewer.tsx`) -- Novo painel **"Cena"** lateral listando os modelos carregados: - - Nome do arquivo, cor, ícones de visibilidade (olho), trava (cadeado), duplicar, remover. - - Item destacado = ativo. Click seleciona. -- Botão **"+ Adicionar modelo"** abre o mesmo fluxo de upload/cloud já existente, mas em modo "append" em vez de "replace". -- `FineTuningControls`, `ScaleSelector` passam a operar sobre o modelo ativo. +FileBrowser expõe `GET /api/resources/{caminho}?auth=` que devolve JSON com `items: [{ name, isDir, size, extension, ... }]`. Vou: -### 4. UI XR/AR (`XRHud.tsx`) -- Painel flutuante com a lista de peças (mesmos botões compactos). -- Botão "Adicionar" abre o `CloudLoader` já existente em modo append. -- Gestos do controle: o grab (já implementado em `XRGrabbable`) move só o modelo ativo / o que foi pinçado diretamente. +- Reaproveitar `tryFileBrowserToken(origin)` (NoAuth) já implementado. +- A partir da URL colada, derivar `origin` + `path` (path da pasta, com `/` final). +- Chamar `/api/resources{path}?auth=` e renderizar `items`. +- Para baixar o arquivo escolhido, montar `…/api/raw{path}/{name}?auth=` (mesma lógica do `smartFetch`). +- Filtro de extensões: `glb, obj, stl, ifc` (via `getSupportedExtension`). +- Mensagens de erro claras quando: não é FileBrowser, CORS bloqueia, token NoAuth indisponível, pasta vazia. -### 5. Funcionalidades dependentes -- **Medições**: passam a ter `modelId` opcional (de qual peça partiu o ponto). Continuam globais na cena — útil para medir GAP entre peças. -- **Checklist**: por enquanto continua global (uma inspeção por sessão). Pode-se evoluir depois para checklist por peça. -- **Screenshot/PDF**: capturam a cena inteira (todas as peças visíveis), sem mudança. -- **Compare mode**: opera sobre a cena toda, sem mudança. +## Escopo desta entrega + +Suporte só a **FileBrowser** (que é o caso atual `store.tracksteel.com.br`). Dropbox/OneDrive/Drive ficam de fora — exigiriam OAuth e um connector próprio (posso fazer numa próxima rodada se quiser). + +## Arquivos + +- **Editar** `src/components/CloudLoader.tsx` + - Adicionar tabs "Arquivo / Pasta" no `DialogContent`. + - Adicionar estado `mode`, `folderUrl`, `currentPath`, `items`, `selectedItem`, `browsing`. + - Manter `handleLoad(rawUrl)` atual para o modo Arquivo. +- **Criar** `src/lib/filebrowser.ts` + - `getFileBrowserToken(origin)` (move/extrai a função existente). + - `listFolder(folderUrl): Promise<{ origin, path, token, items }>`. + - `buildRawUrl(origin, path, name, token)`. + - `SUPPORTED_EXT = ['glb','obj','stl','ifc']`. +- **Criar** `src/components/FolderBrowser.tsx` + - Componente puro de UI: recebe `items`, `currentPath`, callbacks `onNavigate`, `onSelect`, `onLoad`. Mostra breadcrumb, lista, botão Carregar selecionado. +- **Sem mudanças** em `useModelStore`, `convertIFC`, `convertToGLB` — fluxo de download/conversão é o mesmo. ## Limitações conhecidas -- **Performance**: GLB grandes somados podem derrubar FPS no Quest 3. Vou impor limite de **5 modelos simultâneos** com aviso. -- **Conversão IFC**: cada arquivo passa pelo conversor cliente (`convertIFC.ts`) já existente — sem mudança. -- **Colisão física**: as peças podem se sobrepor visualmente (não há detecção de colisão). Para "empilhar" o usuário posiciona manualmente via grab/fine-tuning. Snap entre peças seria uma evolução futura. -- **Anotações em tela**: ficam vinculadas a coordenadas de mundo, não ao modelo — se você mover o modelo depois, a anotação não acompanha (limitação aceitável v1). - -## Fora do escopo desta v1 - -- Snap automático/encaixe entre peças (próxima iteração) -- Detecção de colisão / física -- Agrupar peças (parent/child) -- Checklist independente por peça -- Persistência da cena multi-modelo (salvar/carregar layout) - -## Arquivos afetados - -- `src/stores/useModelStore.ts` — refactor central -- `src/components/three/ModelViewer.tsx` — render por instância -- `src/pages/Viewer.tsx` — painel de cena + botão "Adicionar" -- `src/components/XRHud.tsx` — lista de peças no AR -- `src/components/FineTuningControls.tsx` — opera no ativo -- `src/components/ScaleSelector.tsx` — opera no ativo -- `src/components/three/XRGrabbable.tsx` — grab por instância -- novo `src/components/SceneModelList.tsx` — componente reutilizável da lista +- Funciona somente em FileBrowser com NoAuth ou já autenticado pelo navegador. +- Servidor precisa permitir CORS para o domínio do app (já é o caso de `store.tracksteel.com.br`). +- Listagens muito grandes (>500 arquivos) podem ficar lentas; sem paginação nesta versão.