# Plano3D

Aplicación de escritorio que reconstruye automáticamente una pieza mecánica 3D (STEP/STL) a partir de su plano técnico 2D con alzado, planta y perfil (DXF, DWG o PDF vectorial), y verifica el plano: escala, cotas, coherencia entre vistas y ambigüedades.

Proyecto intermodular de 2.º DAM, IES La Mar.

## Estructura

| Carpeta | Contenido | Responsable |
| --- | --- | --- |
| `motor/` | Procesado: lectura del plano, vistas, reconstrucción, verificación, exportación | Motor |
| `motor/api.py` | **Contrato** entre motor y aplicación: lo único que la aplicación importa | Los dos |
| `app/` | Aplicación: interfaz Qt, visor 3D, historial, instalador | Aplicación |
| `pruebas/` | Pruebas automáticas (`pytest`) y catálogo de piezas con su resultado esperado | Los dos |
| `prototipo/` | Prueba técnica inicial (no se modifica; solo de referencia) | Los dos |
| `docs/` | Guía técnica, registro de decisiones, bitácora, actas y declaración de uso de IA | Los dos |

## Puesta en marcha

Requisitos: [uv](https://docs.astral.sh/uv/) y Git. CadQuery necesita Python 3.12 o 3.13; uv lo descarga solo.

```bash
uv sync
uv run pytest
```

## Formas de trabajo

Ver [CONTRIBUTING.md](CONTRIBUTING.md): ramas, *pull requests*, revisiones e *issues*.

## Licencia

MIT. Ver [LICENSE](LICENSE).