You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
API: GET /builds/{id}/cena devolve as peças com a ficha técnica, os conflitos físicos da revisão e os passos do tutorial.
Cena paramétrica (frontend/src/lib/cena.ts): cada peça vira uma caixa em milímetros a partir da ficha (gabinete, placa-mãe pelo form factor, CPU, cooler, memória, placa de vídeo pelo comprimento, fonte, SSD). Não há modelo 3D por produto.
Render (frontend/src/components/Cena3D.tsx): React Three Fiber com drei; câmera orbital com o mouse.
Conflitos: a peça em conflito (ex.: placa de vídeo maior que o gabinete, radiador frontal contra a placa) pulsa em vermelho; legenda e lista de conflitos abaixo da cena.
Passo a passo: as peças entram uma por vez, na ordem de montagem, com o texto de cada passo.
Hover mostra o nome da peça.
O que pode melhorar
Visual
Formas mais fiéis: placa de vídeo com ventoinhas e backplate, cooler torre e water cooler com radiador, fonte, slots e portas da placa-mãe.
Modelos GLTF genéricos por tipo de peça, escalados pela ficha.
Materiais, iluminação e sombras melhores; vidro lateral do gabinete.
Interações com as peças
Clicar na peça abre os detalhes: ficha, preço, ofertas e por que foi escolhida.
Trocar ou remover a peça direto da cena.
Lista e cena sincronizadas: passar o mouse numa linha destaca a peça, e vice-versa.
Vista explodida para ver cada peça separada.
Medidas e conflitos
Mostrar folgas ("placa de vídeo 285 mm, cabe 340 mm, sobram 55 mm") e uma régua.
Conflito apontando o ponto exato da colisão, não só a peça inteira.
Câmera com foco automático na peça em conflito.
Câmera e tutorial
Vistas prontas: frente, lateral, topo.
No passo a passo, a câmera acompanha a peça do passo; dicas (pasta térmica, cabos) e barra de progresso.
Além do encaixe
Fluxo de ar (ventoinhas e direção do ar) e passagem de cabos, junto com o revisor de espaço físico.
Desempenho e acesso
Qualidade menor e gestos de toque no celular.
Descrição em texto da montagem para leitor de tela.
Testes de layout com mais combinações (ITX, gabinete pequeno, water cooler 360).
As frentes estão em PRs empilhadas, uma sobre a outra: #8 → #9 → #12 → #13 → #14. A #8 traz a base: peças procedurais, vista explodida, conflito na geometria, cabos, passo a passo e descrição em texto. Precisam entrar nessa ordem, e cada PR passa a apontar para a base da anterior quando ela entrar.
Painel "Peças da build" ao lado da cena, com hover sincronizado nos dois sentidos. O detalhe da peça mostra a ficha, a faixa e as ofertas de preço e por que ela foi escolhida. Remover pede confirmação. Trocar mostra uma prévia: a build com a candidata no lugar, o selo "Prévia: não aplicada" e a diferença de preço e de conflitos. Só "Aplicar troca" grava.
Vistas prontas: Livre, Frente, Lateral e Topo. A seção "Folgas" mede GPU × gabinete, cooler × tampa, memória × cooler e fonte × largura do gabinete, com os estados cabe, justa, ajuste e não cabe. Clicar numa folga desenha a régua na cena. A régua e a revisão usam os mesmos limites (backend/app/folgas.py).
Qualidade Auto, Alta ou Leve. O modo Leve usa menos pixels e tira os detalhes finos; Auto começa em Leve no celular e desce para Leve se a cena cair abaixo de 30 q/s. No toque, o primeiro toque numa peça mostra o nome e o segundo abre. 1 dedo rola a página; 2 dedos giram e aproximam a cena.
Ventoinhas com sentido: a frente é entrada; a traseira e o topo são saída. Contam as do gabinete, o pacote de ventoinhas e o radiador. O botão "Fluxo de ar" mostra setas e o ar passando pela GPU e pelo cooler. O revisor de fluxo de ar avisa quando falta entrada, quando a pressão é negativa, quando há poucas ventoinhas para o calor e quando o radiador na frente aquece a GPU (backend/app/fluxo.py).
Cada frente foi revisada com um teste que falhava antes da correção e passa depois. A CI está verde em todas.
Activity
nicolecostt commentedon Nov 14, 2026
Resumo das 4 frentes
As frentes estão em PRs empilhadas, uma sobre a outra: #8 → #9 → #12 → #13 → #14. A #8 traz a base: peças procedurais, vista explodida, conflito na geometria, cabos, passo a passo e descrição em texto. Precisam entrar nessa ordem, e cada PR passa a apontar para a base da anterior quando ela entrar.
backend/app/folgas.py).backend/app/fluxo.py).Cada frente foi revisada com um teste que falhava antes da correção e passa depois. A CI está verde em todas.
Resultado local na ponta da pilha (#14):
A taxa de quadros ficou em 60 q/s no Apple M4. Não medi em celular de verdade.
Itens da issue
Visual
Interações com as peças
Medidas e conflitos
Câmera e tutorial
Além do encaixe
Desempenho e acesso
O que fica em aberto
docs: summary of the issue #2 3D composition work
Merge pull request #17 from TailUFPB/integracao/3d-issue-2