diff --git a/README.md b/README.md index b4721f4..653e2f1 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ Proyecto intermodular de 2.º DAM, IES La Mar. | `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 | +| `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 diff --git a/docs/actas/2026-11-04-constitucion.md b/docs/actas/2026-11-04-constitucion.md new file mode 100644 index 0000000..ac31c69 --- /dev/null +++ b/docs/actas/2026-11-04-constitucion.md @@ -0,0 +1,39 @@ +# Acta de constitución del equipo + +- **Fecha:** 2026-11-04 +- **Proyecto:** Plano3D, reconstrucción automática de piezas 3D a partir de planos técnicos 2D +- **Módulo:** Proyecto intermodular, 2.º DAM, IES La Mar + +## Miembros + +| Nombre | Usuario | Área principal | +| --- | --- | --- | +| Joel | joel.2627 | Aplicación: interfaz, visor 3D, historial e instalador | +| Lizzette | maria.2627 | Motor de procesado: lectura, vistas, reconstrucción, verificación y exportación | + +Las tareas comunes (documentación, catálogo de pruebas, bitácora y preparación de la defensa) se reparten en las reuniones semanales y quedan asignadas en el tablero. + +## Objetivo del proyecto + +Desarrollar una aplicación de escritorio que reconstruya automáticamente piezas mecánicas 3D a partir de planos de tres vistas (DXF, DWG y PDF vectorial), exporte el resultado a STEP y STL, y verifique el plano: escala, cotas, coherencia entre vistas y ambigüedades. El alcance y la justificación están en la propuesta del proyecto y en [decisiones.md](../decisiones.md). + +## Calendario + +| Hito | Fecha prevista | +| --- | --- | +| H0: viabilidad del motor | 2026-12-18 | +| H1: versión candidata | 2027-03-19 | +| H2: versión final | 2027-04-30 | +| Entrega final | 2027-05-14 (aproximada) | + +## Herramientas + +- Repositorio, tablero, incidencias y revisiones: Gitea del instituto (`joel.2627/plano3d`). +- Entorno: Python 3.12 gestionado con uv. +- Documentación del proceso: carpeta `docs/` del repositorio. + +## Acuerdos + +1. Se aprueba el [contrato de equipo](../contrato-equipo.md), que recoge las normas de funcionamiento. +2. El contrato entre motor y aplicación es `motor/api.py`; cualquier cambio en él se acuerda entre los dos. +3. Las reuniones de seguimiento son semanales y cada una genera un acta en esta carpeta. diff --git a/docs/bitacora.md b/docs/bitacora.md index e969db2..e0656a2 100644 --- a/docs/bitacora.md +++ b/docs/bitacora.md @@ -10,7 +10,7 @@ Una entrada por semana. Cada persona escribe lo suyo. - Próxima semana: - Horas (clase / autónomas): -### (compañera) +### Lizzette - Hecho: - Problemas: - Próxima semana: diff --git a/docs/contrato-equipo.md b/docs/contrato-equipo.md new file mode 100644 index 0000000..a42133b --- /dev/null +++ b/docs/contrato-equipo.md @@ -0,0 +1,41 @@ +# Contrato de equipo + +Normas que acordamos para trabajar juntos en Plano3D. Se revisan en cualquier reunión si alguna deja de funcionar; los cambios se anotan en el acta correspondiente. + +## Compromisos + +- Cumplir las fechas de las tareas asignadas o avisar en cuanto se vea que no se van a cumplir, para reorganizar el trabajo a tiempo. +- Dedicar al proyecto las horas de clase del módulo y el trabajo autónomo necesario para llegar a cada hito. +- Mantener al día la bitácora semanal y el estado de las tareas en el tablero. +- Entender todo el código del proyecto, no solo la parte propia: la defensa es individual. + +## Comunicación + +- Reunión de seguimiento una vez por semana, con acta en `docs/actas/`. +- Las dudas del día a día se resuelven por el canal de mensajería del equipo; lo que se decida y afecte al proyecto se anota en `docs/decisiones.md`. +- Las cuestiones sobre una tarea concreta se comentan en su incidencia de Gitea, para que quede constancia. + +## Forma de trabajo + +- Una rama por tarea y ningún cambio directo en `main`, según [CONTRIBUTING.md](../CONTRIBUTING.md). +- Todo cambio entra mediante *pull request* revisado por la otra persona. +- Las revisiones se hacen en un máximo de dos días laborables desde que se piden. +- Antes de pedir revisión, las pruebas automáticas deben pasar. + +## Toma de decisiones + +- Las decisiones de alcance, diseño o reparto se toman de común acuerdo. +- Si no hay acuerdo, se exponen las dos opciones con sus argumentos y se consulta al profesorado. + +## Roles rotatorios + +En cada reunión una persona modera y otra redacta el acta, alternándose cada semana. + +## Si algo no se cumple + +1. Se habla en la siguiente reunión y se acuerda cómo recuperar el retraso o reasignar la tarea. +2. Si el problema se repite, se comunica al profesorado. + +## Uso de herramientas de IA + +Cualquier uso relevante de herramientas de IA se registra en [uso-ia.md](uso-ia.md). Cada persona revisa y entiende lo que entrega, se haya ayudado o no de estas herramientas. diff --git a/docs/decisiones.md b/docs/decisiones.md index 85f87b1..c1a3787 100644 --- a/docs/decisiones.md +++ b/docs/decisiones.md @@ -4,7 +4,7 @@ Cada decisión de alcance o de diseño, con su motivo. La más reciente, arriba. | Fecha | Decisión | Motivo | | --- | --- | --- | -| 2026-10-22 | Reparto: Joel, aplicación (interfaz y visor 3D); compañera, motor de procesado. Contrato común en `motor/api.py` | Partes separables que pueden avanzar en paralelo con un motor simulado | +| 2026-10-22 | Reparto: Joel, aplicación (interfaz y visor 3D); Lizzette, motor de procesado. Contrato común en `motor/api.py` | Partes separables que pueden avanzar en paralelo con un motor simulado | | 2026-10-22 | Repositorio en la plataforma Gitea del instituto, con ramas por tarea y PR revisados | Requisito del módulo; trazabilidad de la contribución individual | | 2026-10-14 | Hitos H0 (fin de SA2) y H1 (fin de SA3), con plan B de piezas planas | Gestionar el riesgo técnico de la reconstrucción | | 2026-10-14 | Aplicación de escritorio, no web | Cálculo pesado con OpenCASCADE; privacidad de los planos; sin servidor ni costes |