mirror of
https://github.com/cursos-uai/sap_tfi_2026.git
synced 2026-07-31 20:48:30 -03:00
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)
This commit is contained in:
@@ -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
|
### 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:
|
**Formatos recomendados para abrir los diagramas**:
|
||||||
- Abrí los PDFs directamente.
|
|
||||||
- Para regenerar: instalá PlantUML (`apt-get install plantuml` o descargá el jar).
|
- **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.
|
||||||
- Para modificar: editá los `.puml` y regenerá.
|
- **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
|
### 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
|
## 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.
|
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.
|
||||||
|
|||||||
Reference in New Issue
Block a user