## Cómo movemos tus modelos: de STL a GLB, a la web y a Oasis

Resumen simple de nuestra cadena: limpiamos STL/OBJ, convertimos a GLB optimizado, generamos miniaturas, servimos por web estática y anunciamos en el PUB Oasis para replicación. Todo ligero, auditable y resistente.

Ver pipeline Probar visor 3D Esquema de red FAQ

- STL/OBJ → GLB
- Thumbnails
- Catálogo JSON
- Nginx estático
- Oasis / SSB

### Pipeline básico (alto nivel)

    [1] Ingesta            [2] Limpieza           [3] Conversión          [4] Thumbs
    STL / OBJ / STEP  -->  escala/ejes/normales  -->  GLB optimizado  -->  JPG/WEBP 512px

    [5] Catálogo           [6] Web estática       [7] Anuncio Oasis
    JSON (metadatos)  -->  Nginx / CDN            -->  PUB: hash + URL/refs

#### 1) Ingesta & limpieza

- Validamos licencia y autoría.
- Normalizamos unidades (mm) y ejes (Y-up → Z-up si procede).
- Recalculamos normales, soldamos vértices duplicados.

#### 2) Conversión a GLB

Usamos herramientas reproducibles (ej. Blender CLI / gltfpack) para un GLB ligero y web-friendly.

    # Ejemplo (alto nivel)
    blender -b -P scripts/stl2glb.py -- --in model.stl --out model.glb
    gltfpack -i model.glb -o model.glb -cc -tc   # compresión + tangentes

#### 3) Miniaturas

- Render rápido con cámara fija → `/sub/thumbs/*.webp`.
- Nombres consistentes: `nombre.glb` ↔ `nombre.webp`.

#### 4) Catálogo & publicación

- Metadatos en `catalog.json` (autor, tema, material, complejidad, tags).
- Web estática servida por Nginx.
- Mensaje en Oasis/SSB con hash de contenido y referencias públicas.

### Demo visor 3D — `snh_base.glb`

Previsualización rápida con <model-viewer>. Mueve, rota y haz zoom sin plugins.

Descargar GLB Ver galería

### Topología mínima de despliegue

    Navegador ──HTTPS──► Nginx (RP)
                            │
                            ├──► / (estático: HTML/CSS/GLB/WEBP)
                            └──► /app (si hay backend/API)

    Gossip (SSB) ──TCP/7724──► PUB Oasis

La web es estática para rapidez y resiliencia. Oasis se usa para anunciar y replicar referencias de modelos/contenidos.

### Conceptos claros

- GLB: formato web binario (gltf) con mejor carga que STL/OBJ.
- Offline-first: puedes navegar la web estática sin depender del PUB.
- PUB Oasis: nodo público para descubrimiento/replicación (no SPOF).
- Auditable: herramientas CLI, ficheros estáticos y hashes verificables.

### FAQ

¿Por qué convertís a GLB?

Porque reduce peso, empaqueta materiales y es el estándar de facto para la web (cargas rápidas y consistentes).

¿Qué se replica exactamente en Oasis?

Metadatos y referencias (hash/URL) de los modelos, para que otros nodos puedan descubrirlos/verificarlos.

¿Se puede usar sin JavaScript?

La web funciona; sin JS no verás el visor interactivo, pero podrás descargar GLB/WEBP desde la galería.

Revisar pipeline Probar visor Más modelos