ADR-0011 · Editor 3D com preview no navegador e malha de fabricação em Python

Status: proposto (20/10/2026) — aceitar após os spikes S-1, S-2 e S-4.

Contexto

O Editor 3D precisa de interação fluida no celular (≥ 30 FPS) e de uma malha de fabricação exata, estanque e em escala para a fábrica e para exportação STL/3MF paga. O arquivo de fabricação não pode ser gerado no cliente, senão sai sem débito de crédito.

Decisão

• Preview no navegador com React Three Fiber + drei, deformando uma malha-base por numeração em um Web Worker.
• Malha de fabricação em novo serviço apps/geometry (Python, FastAPI, trimesh, manifold3d), interno, chamado pelo order-lifecycle via fila BullMQ.
• Contrato de geometria (packages/insole-contract, JSON Schema versionado) gera tipos TS (zod) e Python (pydantic).

Consequências

• ➕ Ecossistema Python maduro para malha e verificação.
• ➕ Arquivo de fabricação protegido no servidor.
• ➖ Duas implementações de geometria → risco de divergência; mitigado por testes de ouro no CI (tolerância 0,5 mm).
• ➖ Nova stack para manter e implantar no Coolify.
• 🔭 Alternativa reavaliável: kernel único TS/WASM (manifold-3d) nos dois lados.