From a55f74144a41afae80d481166fec59ace849f2a8 Mon Sep 17 00:00:00 2001 From: saptfi2026-bot Date: Wed, 24 Jun 2026 14:19:36 -0300 Subject: [PATCH] docs(readme): actualizar Paso 3 (SVG recomendado) + agregar Referencia Bibliografica Cambios al README.md: 1. Paso 3 actualizado: recomienda abrir los SVG como formato principal para estudiar diagramas. Explica pros/contras de cada formato (SVG/PDF/PNG) y como regenerar los 3 con PlantUML. 2. Nueva seccion "Referencia bibliografcia" agregada antes de "Recomendaciones para el TP": - Libro de ICONIX (Rosenberg & Scott) con link al Google Drive provisto por el usuario - PPT sobre ICONIX (material complementario) - Otras referencias (Gamma GoF, Cristia UNR, docs Odoo) --- README.md | 47 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 42 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 55fd6f7..f52f4eb 100644 --- a/README.md +++ b/README.md @@ -75,12 +75,25 @@ Los 7 CU modelo están en **`docs/02_casos_uso/`**. Cada uno tiene la estructura ### Paso 3: Estudiar los diagramas -Los diagramas están en **`diagrams/plantuml/`** (código fuente) y **`diagrams/pdf/`** (versión renderizada). +Los diagramas están en **`diagrams/plantuml/`** (código fuente) y en los formatos renderizados **`diagrams/pdf/`** (PDF), **`diagrams/png/`** (PNG) y **`diagrams/svg/`** (SVG). -Para visualizar: -- Abrí los PDFs directamente. -- Para regenerar: instalá PlantUML (`apt-get install plantuml` o descargá el jar). -- Para modificar: editá los `.puml` y regenerá. +**Formatos recomendados para abrir los diagramas**: + +- **SVG** — formato vectorial recomendado para visualizar diagramas en el navegador o en visores SVG. Permite zoom sin pérdida de calidad, ideal para revisar diagramas grandes con muchos elementos. Se puede abrir directamente en cualquier navegador moderno (Chrome, Firefox, Edge, Safari) o en visores como Inkscape. +- **PDF** — formato portable para imprimir o compartir. Mantiene la calidad vectorial pero es de solo lectura. +- **PNG** — formato rasterizado para incrustar en documentos o presentaciones. + +**Para visualizar**: + +1. **Abrir el SVG**: hacé doble click en cualquier archivo de `diagrams/svg/` o arrastralo a tu navegador. Es la opción recomendada para estudiar los diagramas porque mantiene la calidad al hacer zoom y permite copiar elementos como texto. +2. **Abrir el PDF**: doble click en cualquier archivo de `diagrams/pdf/` (se abre en cualquier lector de PDF). +3. **Abrir el PNG**: doble click en cualquier archivo de `diagrams/png/` (se abre en cualquier visor de imágenes). + +**Para regenerar** (si querés modificar los `.puml`): + +- Instalá PlantUML (`apt-get install plantuml` o descargá el jar de https://plantuml.com/download). +- Ejecutá `plantuml -tsvg -tpng -tpdf diagrams/plantuml/*.puml` para regenerar los 3 formatos. +- **Recomendación**: regenerá siempre los 3 formatos después de modificar cualquier `.puml` para mantener la consistencia. ### Paso 4: Aplicar ICONIX a tu TP @@ -257,6 +270,30 @@ El diagrama del patrón Composite muestra cómo Odoo implementa la Lista de Mate --- +## Referencia bibliográfica + +Material de lectura recomendado para profundizar en la metodología ICONIX y su aplicación en este curso. + +### Libro de ICONIX (recomendado para la materia) + +- **Use Case Driven Object Modeling with UML** — Doug Rosenberg y Kendall Scott + - 📖 Acceso: https://drive.google.com/file/d/1brsFcTJIR-EBr7y7NCZHUdjSAJnQQu1U/view?usp=sharing + - Libro de referencia principal de la metodología ICONIX. Cubre en detalle cada fase: casos de uso, modelo de dominio, robustez, secuencia y clases. Lectura obligatoria para el TP. + +### Presentación sobre ICONIX (PPT) + +- **PPT sobre ICONIX** — material de clase complementario + - Útil como soporte visual para entender la metodología. Puede ser de utilidad para el alumno para preparar el TP o exponer conceptos en clase. + +### Otras referencias citadas en el repositorio + +- **Gamma, E., Helm, R., Johnson, R., & Vlissides, J.** (2003). *Design Patterns: Elements of Reusable Object-Oriented Software*. Addison-Wesley. — libro canónico de los patrones GoF. +- **Cristia, M.** (2015). *Standard for Documenting Design Patterns in Software Design*. FCEIA, Universidad Nacional de Rosario. https://www.fceia.unr.edu.ar/ingsoft/patrones-doc.pdf — estándar usado en `docs/12_patrones_diseno/composite_bom.md`. +- **Odoo S.A.** (2024). *Odoo 19.0 Documentation*. https://www.odoo.com/documentation/19.0/ — documentación oficial de Odoo. +- **Repositorio oficial de Odoo**: https://github.com/odoo/odoo (rama `19.0`) — código fuente utilizado como base para la ingeniería inversa. + +--- + ## Recomendaciones para el TP 1. **No copies directamente**. Los CU modelo son para entender la metodología, no para copiar. Cada alumno debe producir su propia versión adaptada a su contexto.