Skip to content

Composição 3D do PC #2

Closed
Closed

Description

@romhenri

Como funciona hoje

  • 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).

Activity

  1. nicolecostt commented on Nov 14, 2026

    @nicolecostt
    Collaborator

    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.

    Frente PR O que entrega
    1. Cena e painéis #9 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.
    2. Vistas e folgas #12 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).
    3. Celular #13 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.
    4. Fluxo de ar #14 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.

    Resultado local na ponta da pilha (#14):

    • 159 testes de backend;
    • 109 de frontend;
    • 62 no navegador, incluindo a emulação de celular.

    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

  2. added 2 commits that reference this issue on Nov 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

No labels
No labels

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions