| name | rcj-diagramas-poster |
| description | Use when creating or reviewing explanatory visuals for RoboCupJunior deliverables — poster figures, system architecture diagrams, dataflow/FSM diagrams, iteration figures, photo overlays, SVG drawings for the A1 poster or TDP. Triggers - "armá/dibujá el diagrama", "la figura del póster", "explicá el sistema con un dibujo", "diagrama de bloques/flujo", "hacé el SVG", a figure that must be legible at poster distance, or any visual meant to score Photos & Graphics / Method / Data rubric points. |
Diagramas explicativos y figuras de póster (RCJ)
Principio central
Un diagrama responde UNA pregunta. El póster es una FAMILIA de figuras
coordinadas, no una mega-figura que lo dice todo. Cada figura se diseña para su
distancia de lectura (titular a 3 m, cuerpo a 1,5 m) con matemática de
impresión hecha ANTES de dibujar — y no se entrega sin haberla VISTO
renderizada.
REQUIRED BACKGROUND: estructura/zonas del póster → rcj-judging-package y
docs/competencia/POSTER.md (paleta y tipografías en su Zona Pie). Puertas de
rúbrica → rcj-deliverables-judge. Texto que acompaña → rcj-doc-voz-estudiante.
Proceso
- Pregunta y zona. Escribir la pregunta que la figura responde en una
frase. Leer el plan de zonas de
POSTER.md: ¿dónde vive esta figura y qué
contenido ya cubren las OTRAS zonas? Prohibido duplicar una zona vecina
dentro de la figura.
- Elegir el tipo (tabla abajo). Si la pregunta pide dos tipos, son dos
figuras.
- Presupuesto visual: ≤7 unidades. Una unidad = caja, flecha con
etiqueta, panel, glifo. ¿Necesita más? → partir en familia con zoom
(sistema → placa → módulo), cada una con su pregunta.
- Matemática de impresión ANTES de dibujar.
mm_por_px = ancho_impreso_mm / ancho_viewBox_px. Regla del póster
(POSTER.md): cuerpo ≥24 pt (≈8,5 mm), títulos ≥48 pt (≈17 mm).
Ejemplo real: figura de 420 mm con viewBox 1800 → 0,233 mm/px ⇒ texto
mínimo 36 px, títulos 72 px. Nada por debajo del mínimo — si no
entra, sobran unidades (volver al paso 3).
- Dibujar el SVG con las reglas de abajo.
- Renderizar y MIRAR (obligatorio). En Windows sin Inkscape:
& "C:\Program Files (x86)\Microsoft\Edge\Application\msedge.exe" --headless --disable-gpu --screenshot=out.png --window-size=ANCHO,ALTO "file:///ruta.svg"
(probado en la máquina del equipo 2026-06-12). Abrir el PNG y chequear:
solapes, texto cortado, contraste, y la prueba del pulgar — achicado a
miniatura, ¿se entiende la historia? (simula los 3 m).
- Entrega disciplinada. Drafts a
docs/competencia/assets/drafts/ y
AVISAR siempre qué archivos se crearon — el equipo decide qué se commitea.
Antes de imprimir: cifras re-medidas, texto a curvas (Inkscape: Path >
Object to Path), export PNG 300 dpi.
Tipos de diagrama (elegir por pregunta)
| Pregunta | Tipo | Nota |
|---|
| ¿Cómo está organizado el sistema? | Bloques por RESPONSABILIDAD | Función, no cableado: el esquemático va en el repo, no en el póster |
| ¿Qué viaja entre módulos? | Dataflow con flechas etiquetadas | Etiqueta = dato + tamaño @ frecuencia (ej. "31 B @ 100 Hz") |
| ¿Cómo se comporta? | FSM (estados + transiciones) | UN comportamiento estrella, no todos |
| ¿Cómo mejoró con el testing? | Figura de iteración v1→v2→v3 con datos | Puerta Excellent "testing→evaluation→modification" |
| ¿Cómo es de verdad? | FOTO real + overlay de etiquetas | La rúbrica pide fotos etiquetadas Y citadas |
| ¿Qué dicen los números? | Gráfico de datos | Eje, unidad, fecha de medición |
Reglas del SVG
- Paleta del póster (POSTER.md): azul=TOP, naranja=CENTRAL, verde=DOWN,
gris=neutro (+ rojo SOLO para emergencia/seguridad). El color ES información.
- 1-2 familias tipográficas máximo (las de la Zona Pie).
- Más de un tipo de flecha ⇒ leyenda dentro de la figura.
- Caption obligatoria: "Fig.N — [el TAKEAWAY, no 'diagrama del sistema']"
- crédito ("Original diagram by the team — CC BY 4.0") + fuente citada si
hay material externo.
- Honestidad visual: objetivos de diseño no medidos llevan asterisco
("*design target"); cifras vivas (tests, errores) se miden ESE día y se
fechan en la figura.
- Evitar texto rotado salvo necesidad (es lo primero que se rompe entre
renderers).
Errores comunes (todos observados en línea base)
| Error | Realidad |
|---|
| Texto de 13 px "porque entra" | A 420 mm son ~10 pt impresos — viola el ≥24 pt del propio póster. La matemática va ANTES de dibujar |
| Mega-figura de 12+ unidades | Compite con las otras zonas del póster y nadie la lee en 30 s. Familia de figuras |
| Entregar el SVG sin renderizar | Los anchos de texto y rotaciones se estiman mal a ciegas. Render + mirar, siempre |
| Cifra de tests/datos de memoria | Se desincroniza con los demás entregables = munición de juez. Medir y fechar |
Dropear archivos en assets/ sin avisar | Drafts a assets/drafts/ + avisar; el equipo decide qué entra al repo |
| Dibujar el cableado (pines, UARTs) | Eso es el esquemático. El póster explica FUNCIÓN; el detalle eléctrico se linkea al repo |
