Skip to content

feat(3d): composição 3D completa do PC (issue #2) - #17

Merged
JoaoBoscoDuarte merged 41 commits into
mainfrom
integracao/3d-issue-2
Nov 18, 2026
Merged

JoaoBoscoDuarte merged 41 commits into
mainfrom
integracao/3d-issue-2

Conversation

@JoaoBoscoDuarte

Copy link
Copy Markdown
Collaborator

O que é

PR único da issue #2. Reúne os seis PRs de 3D, mesclados em integracao/3d-issue-2 com merge commit (autoria preservada):

PR Autor O que traz
#8 João Arruda peças procedurais a partir da ficha, build explodida, cabos, conflito na geometria, passo a passo com encaixe, ficha com origem por campo
#9 Nicole painel da build ao lado da cena, detalhe da peça, trocar com prévia (/trocar, /cena/previa)
#12 Nicole vistas Frente/Lateral/Topo, folgas e régua (folgas.py)
#13 Nicole cena no celular: qualidade Auto/Alta/Leve, toque e gestos de dois dedos
#14 Nicole fluxo de ar: ventoinhas com sentido, revisor fluxo_de_ar, setas e partículas
#16 João Bosco barra de progresso e dicas no passo a passo, luz e sombras (qualidade Alta), acabamento dos metais, aviso quando não há WebGL

Resumo completo, checklist da issue e limites: docs/RESUMO-ISSUE-2-3D.md.

Como testar

cd backend && uv run pytest -q
cd frontend && pnpm typecheck && pnpm test && pnpm build
cd frontend && pnpm e2e    # API em :8000 e front em :3000

Resultado local: 159 testes de backend (2 pulados), 110 de frontend, build ok. No navegador, 59 de 62 passam. Os 3 que falham ("um dedo rola a página" e as duas medições de taxa de quadros) também falham em feat/fluxo-ar sem as mudanças do #16; o ambiente de teste não tem GPU. Migration nova: supabase/migrations/002_specs_origem.sql.

Antes de mesclar

Pendência de segurança do #8, apontada em revisão e ainda sem correção no código:

  • backend/app/ficha.py:130: o domínio do fabricante aceita qualquer host que tenha a marca num rótulo (ex.: lian-li.qualquercoisa.com).
  • _texto_da_pagina não bloqueia IP privado ou loopback (SSRF).
  • POST /componentes/{id}/ficha não tem restrição, gasta Serper e LLM e altera o catálogo de todos.

Limites conhecidos

Sem modelos GLTF e sem medição em celular real ou Safari. Os limites de cada PR estão nos corpos deles.

Closes #2

joaoliveirarruda and others added 30 commits November 11, 2026 19:46
Troca as caixas da cena por modelos procedurais (gabinete, placa-mãe, CPU,
cooler a ar, memória, GPU, SSD M.2 e fonte) gerados a partir da ficha, com
origem de cada medida (norma, ficha ou estimado), encaixe por âncoras, pinos
e barramentos visíveis e cabos roteados entre os conectores.

Método em docs/PECAS-3D.md; próxima etapa em docs/SPEC-VISTA-3D-COMPLETA.md.
…das peças

Backend: campos opcionais de ficha no seed, origem por campo na rota da cena,
extração da ficha do fabricante com faixa plausível e regra de largura da fonte.
Frontend: geradores do water cooler (bloco e radiador) e dos discos SATA,
formas perfil e curva, subpeças móveis, fusão de malhas por lote e detalhe
de GPU, placa-mãe e gabinete com as âncoras de cabos, baias e fans.
…ncaixe e cabos completos

Cena: fonte na orientação real, water cooler em duas caixas com mangueiras,
discos SATA nas baias, cabos de fans, painel e SATA com plugues, deslocamento
de instalação por peça, região e medida dos conflitos (geometria ou limite da
ficha), estado puro do passo a passo e descrição textual.
Interface: controle Explodir build, conflitos clicáveis com a medida na cena,
encaixes animados, origem dos dados da peça aberta, uso por teclado e layout
em 390 px. Teste no navegador com Playwright, incluindo taxa de quadros.
- ficha: domínio do fabricante por rótulo exato do host, resposta malformada
  da busca não quebra, formato cruzado com a interface, redirecionamento só
  para o mesmo host em https
- cena: troca de build remonta a cena, geometrias e materiais liberados,
  medida do conflito soma as duas paredes, botão do passo a passo com rótulo fixo
- cooler usa heatpipes da ficha; GPU respeita fan_mm
- README e método atualizados
POST /builds/{id}/trocar substitui exatamente a peça escolhida por outra do
mesmo tipo, inclusive armazenamento, mantendo a quantidade. Peça travada ou
marcada como já tenho devolve 409. Inclui o design da frente 1 da issue #2.
POST /builds/{id}/cena/previa devolve a cena da build com a candidata no
lugar, com os conflitos e a diferença de preço, sem tocar na build. A revisão
da prévia pula a passada de LLM e roda dentro de tracing.sem_rastro(). A
montagem da resposta da cena virou _dados_cena, usada pelas duas rotas.
Cena3D aceita aberta/onAberta, destaque/onDestaque e previa, todas opcionais.
A peça destacada brilha no tom do tema e o conflito mantém a prioridade. Na
prévia aparece o selo 'Prévia: não aplicada', a câmera vai até o conflito da
candidata (focoDaPrevia) e o Esc fica com o painel.
A aba 3D ganha o painel 'Peças da build': a lista acende a peça na cena ao
passar o mouse ou focar pelo teclado, e a cena devolve o destaque. Clicar
numa linha abre a peça com o resumo da ficha, a faixa e as ofertas de preço
(os mesmos componentes da aba Compra) e o motivo da escolha. Remover pede
confirmação. Os testes de navegador passaram a compartilhar e2e/apoio.ts.
Trocar lista as candidatas do mesmo tipo (com as incompatíveis e o motivo).
Clicar numa delas mostra a build com ela no lugar, com o selo de prévia, a
medida do conflito e a diferença de preço e de conflitos; só Aplicar troca
grava. Esc e Cancelar descartam, e a prévia cai sozinha quando a build muda.
A última candidata pedida vence mesmo que uma resposta anterior chegue depois.

Refs #2
- trocar para uma peça que já está na build devolve 409 e ela some da
  lista de candidatas (dois discos iguais duplicavam o item)
- voltar à lista ou fechar a peça durante a prévia descarta a prévia
- Esc com a prévia carregando não fecha a peça aberta por baixo
- a prévia sai da build explodida e do passo a passo para mostrar o conflito
- Aplicar troca fica desabilitado enquanto outra candidata carrega
- diferença de conflitos compara ids peça por peça (rtx-4070 x rtx-4070s)
…isão

backend/app/folgas.py calcula GPU x gabinete, cooler x gabinete, memória x
cooler e fonte x largura, com os estados cabe, justa, ajuste e não cabe. Os
limites viram constantes compartilhadas com a revisão, e o limite útil da GPU
passa a respeitar radiador_posicao: com o radiador no topo a revisão não
avisa mais que ele disputa espaço com a GPU. A cena e a prévia devolvem as
folgas. Inclui o design da frente 2 da issue #2.
Barra 'Vista: Livre, Frente, Lateral, Topo'. A câmera anda até a vista e
encaixa exata no fim; arrastar com o mouse interrompe a animação e volta a
Livre. Com uma folga ativa, a cena vai para a vista da medida e desenha a
régua (peça, sobra ou excesso e limite, com rótulos em mm). A descrição
textual cita a vista e a régua.
O painel ganha a seção Folgas (GPU, cooler, memória e fonte) com o estado de
cada uma. Clicar liga a régua na cena e leva a câmera à vista da medida;
clicar de novo ou Esc desliga e volta à vista de antes. A régua some ao abrir
peça, entrar na prévia ou trocar de build, e usa sempre o número da cena
atual. Na prévia, as folgas que mudam aparecem na diferença.

Refs #2
- a região vermelha de um conflito com folga medida usa o excesso da ficha,
  o mesmo número da régua; se a ficha diz que cabe, não diz que passa
- zoom ou arraste logo depois de escolher uma vista não puxa mais a câmera
  de volta
- escolher uma vista depois de clicar num conflito volta a mover a câmera
- spec: cooler, memória e fonte na vista de cima
…as dele e painel liga o fluxo com a build explodida
@JoaoBoscoDuarte
JoaoBoscoDuarte merged commit 6820afb into main Nov 18, 2026
4 checks passed
@JoaoBoscoDuarte

JoaoBoscoDuarte commented Nov 18, 2026 •

Copy link
Copy Markdown
Collaborator Author

Mesclado na main. Pendências: #25 (segurança da ficha) e #18 (3D).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Composição 3D do PC

3 participants