plano3d/README.md

# 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, contrato de equipo, 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).
Estructura inicial del proyecto Contrato entre motor y aplicación en motor/api.py, motor simulado con CUBE01, pruebas del contrato, prototipo de la prueba técnica, documentación de trabajo y plantillas de Gitea. 2026-10-22 16:53:05 +00:00			`# 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 \|
Añade el acta de constitución y el contrato de equipo Completa también los datos del equipo en la bitácora y en el registro de decisiones. 2026-11-04 15:37:23 +00:00			\| `docs/` \| Guía técnica, contrato de equipo, registro de decisiones, bitácora, actas y declaración de uso de IA \| Los dos \|
Estructura inicial del proyecto Contrato entre motor y aplicación en motor/api.py, motor simulado con CUBE01, pruebas del contrato, prototipo de la prueba técnica, documentación de trabajo y plantillas de Gitea. 2026-10-22 16:53:05 +00:00
			`## 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).`