# Modelos 3D

Piezas de vTitan y de los prototipos anteriores. **El razonamiento de diseño no
vive aquí**: está en el [README principal](../README.md), en
[Movilidad y Diseño Mecánico](../README.md#movilidad-y-diseño-mecánico). Este
documento es el manifiesto: qué hay, en qué formato y para qué sirve cada uno.

```text
models/
├── vtitan/            vTitan (WRO 2026)
│   ├── blueprints/     planos acotados (WebP)
│   ├── step-files/     29 archivos .step  -> para fabricar y editar
│   └── stl-files/      47 archivos .stl   -> para imprimir y para ver en GitHub
└── klevor/            Klevor (WRO 2025)
    ├── blueprints/     27 planos
    └── stl-files/      43 archivos .stl
```

## Por qué dos formatos

| Formato | Para qué | Nota |
|---|---|---|
| **`.step`** | Fabricar y **editar**. Conserva la geometría exacta (B-rep), así que se puede reabrir y modificar en cualquier CAD | GitHub **no** lo previsualiza |
| **`.stl`** | **Imprimir** y **mirar**. Es una malla triangular, no se edita bien, pero es lo que come una impresora 3D | GitHub lo renderiza en un **visor 3D interactivo**: pincha cualquier `.stl` y podrás girarlo, desplazarlo y acercarlo en el navegador |

Por eso publicamos ambos. Si solo quieres ver una pieza, abre el `.stl` desde
GitHub. Si quieres rehacerla, usa el `.step`.

De las 29 piezas en `.step`, **17 tienen su `.stl` con el mismo nombre**. Las 12
restantes son componentes comerciales que modelamos solo para el ensamblaje
virtual y nunca se imprimen: Raspberry Pi 5, cámara, RPLiDAR C1, batería
Ovonic, rodamientos y rolineras (rodamientos pequeños).

## Convención de nombres

Todo en kebab-case ASCII y extensión en minúscula: `pinon-40-dientes-servo-cajera.stl`.
Los nombres originales de SolidWorks (mayúsculas, espacios, `ñ`) se normalizaron
porque rompen URLs, globs de shell y clones en sistemas de archivos que no son
UTF-8. Una pieza que existe en los dos formatos **usa el mismo nombre** en
ambos, que es lo que permite emparejarlas de un vistazo.

### Versiones y variantes

Los sufijos dicen dos cosas distintas, y conviene no confundirlas:

| Sufijo | Significa | Ejemplo |
|---|---|---|
| `-vN` | **Iteración** de la misma pieza. `N` crece con el rediseño y la última es la que se imprime | `monochasis-v1` a `monochasis-v3` |
| `-vN.M` | Retoque menor sobre la `vN`, sin rediseño de fondo | `monochasis-v2.1` (la `v2` aligerada) |
| Sufijo descriptivo | **Variante** que coexiste con la pieza base, no la reemplaza | `pinon-40-dientes-servo-cajera`, `ring-mv-pinon-grande`, `tapa-de-bancada-motor-rev` |

Una variante puede a su vez llevar versión (`brazo-de-tensor-v2-largo` es la
variante larga de la `v2`). Una pieza sin sufijo alguno no tuvo iteraciones.

## Piezas de vTitan, por subsistema

**Transmisión**

`engranaje-unificado-motor-rev-36-dientes`, `engranaje-unificado-motor-rev-40-dientes`,
`pinon-15-dientes-correa-dentada`, `pinon-20-dientes-correa-dentada`,
`pinon-22-dientes-correa-dentada`, `pinon-33-dientes-correa-dentada`,
`pinon-33-dientes-correa-dentada-eje-motor-pequeno`,
`pinon-50-dientes-correa-dentada-eje-motor-pequeno`,
`pinon-40-dientes-transmision`, `pinon-conico-15x8-dientes`,
`pinon-conico-20-dientes`, `pinon-90-cruceta-10-dientes`,
`pinon-90-cruceta-10-dientes-con-eje`, `rueda-dentada`, `rueda-vtitan`,
`ring-mv-v1`, `ring-mv-v2`, `ring-mv-pinon-grande`, `cubierta-de-ring`,
`buje-guia-de-cruceta`, `aro-de-fijacion-axial-de-caucho`

**Dirección**

`brazo-de-direccion`, `pinon-8-dientes-direccion`,
`pinon-20-dientes-direccion-v1`, `pinon-20-dientes-direccion-v2`,
`pinon-20-dientes-rueda-dentada-v1`, `pinon-20-dientes-rueda-dentada-v2`,
`pinon-40-dientes-direccion`, `pinon-40-dientes-direccion-arrastre`,
`pinon-40-dientes-servo`, `pinon-40-dientes-servo-cajera`

**Tensor de correa**

`brazo-de-tensor-v1`, `brazo-de-tensor-v2`, `brazo-de-tensor-v2-largo`,
`brazo-de-tensor-v3`, `rodillo-tensor-v1`, `rodillo-tensor-v2`

**Chasis y bancadas**

`monochasis-v1`, `monochasis-v2`, `monochasis-v2.1`, `monochasis-v3`,
`base-de-sistema-de-transmision-corto`, `soporte-superior`,
`tapa-de-bancada-motor-pequeno`, `tapa-de-bancada-motor-rev`,
`suplemento-de-bancada-motor-pequeno`

**Soportes de cámara**

`soporte-camara-inferior`, `soporte-camara-brazo-intermedio`,
`soporte-camara-superior`

**Componentes comerciales** (modelados solo para el ensamblaje, no se imprimen)

`raspberry-pi-5`, `camera-module-3-v8`, `rplidar-c1`, `ovonic-air-lipo-battery`,
`rodamiento-14-20-12-hk1412`, `rolinera-3-7-2`, `rolinera-6.35-9.525-3.175`

**No son del robot**

`pista-bloque-senales` y `pista-pared-magenta` son piezas de **pista**, no de
vTitan: las señales de color y un tramo de pared que imprimimos para practicar.
`prueba-rodamiento` es una impresión de prueba de ajuste.

## Trazabilidad

Las iteraciones intermedias se conservan a propósito: son la evidencia de cómo
evolucionó el diseño, y esa historia está contada en
[Evolución y justificación del diseño](../README.md#evolución-y-justificación-del-diseño).

Los nombres originales del diseñador (`-max`, `-ultimate`, `-nuevo`, `-editado`,
`-ligero`) se sustituyeron por `-vN` porque no eran ordenables: nada en
`-max` contra `-ultimate` dice cuál vino primero, y el repositorio tampoco lo
sabía, porque las piezas se publicaron todas en el mismo commit. El orden que
recoge la numeración actual es el que confirmó el diseñador.

> [!WARNING]
> **Pendiente declarado.** Falta el manifiesto de impresión: material, altura de
> capa, relleno, soportes y orientación de cama por pieza. Sin esos parámetros,
> otra persona puede abrir los `.stl` pero no reproducir exactamente nuestras
> piezas.