# Sistema de diseño de [nombre de tu negocio]

Guardá este archivo en tu carpeta de trabajo con el nombre exacto `sistema-de-diseno.md`. Reemplazá cada texto entre corchetes por tu decisión y borrá las líneas de guía (las que empiezan con "Guía:"). Mientras más concreto seas, menos tiene que adivinar el programa. Un ejemplo completo es el sistema de diseño de Varanda, marca ficticia creada para el curso (`sistema-de-diseno-varanda.md`, lección 3.2): tiene las mismas diez secciones que esta plantilla, más tres: componentes de la tienda, página A4 para imprimir y gráficos (13 en total), y los ejemplos entre corchetes salen de ahí. Cada vez que le pidas al programa un informe, una propuesta, una planilla o una presentación, tiene que seguirlo y entregar un `.html` que vos guardás como PDF desde el navegador (imprimir > Guardar como PDF).

## 1. Para qué sirve

Guía: una o dos oraciones. Qué documentos cubre (informes, propuestas, planillas, respuestas a clientes, láminas) y quién los va a leer.

- [Ejemplo: Cubre todo documento que sale de Varanda: informes, propuestas, planillas, respuestas a clientes y láminas. Lo leen personas con poco tiempo: tiene que entenderse en dos minutos, verse cálido y ordenado, y tener la misma cara que la tienda.]

## 2. Colores

Guía: entre 6 y 10 colores, cada uno con un nombre, su código hexadecimal (el # seguido de seis caracteres) y para qué se usa. Cada color puede llevar una variable (por ejemplo `--mi-marca-principal`) para que el HTML la reutilice. Indicá una proporción de uso aproximada (por ejemplo 60% neutros, 25% color principal, 10% destaque, 5% alerta).

| Nombre | Variable | Código | Cuándo se usa |
| --- | --- | --- | --- |
| [Color principal oscuro] | [--mi-principal-900] | [#______] | [Fondos invertidos y pie] |
| [Color principal] | [--mi-principal-700] | [#______] | [Logo, títulos de marca, encabezados de tabla] |
| [Color de apoyo] | [--mi-apoyo-500] | [#______] | [Datos positivos, resaltados secundarios] |
| [Color de apoyo suave] | [--mi-apoyo-50] | [#______] | [Secciones suaves y filas alternas] |
| [Color de destaque] | [--mi-destaque-500] | [#______] | [Un solo dato clave por página; el texto encima es siempre el texto principal] |
| [Color de alerta] | [--mi-alerta-600] | [#______] | [Solo descuentos y errores] |
| [Texto principal] | [--mi-texto] | [#______] | [Párrafos y títulos] |
| [Texto secundario] | [--mi-gris-600] | [#______] | [Notas y textos de apoyo] |
| [Bordes] | [--mi-gris-300] | [#______] | [Bordes y divisores] |
| [Blanco] | [--mi-blanco] | [#FFFFFF] | [Fondo de papel y tarjetas] |

Proporción de uso: [__% neutros, __% color principal, __% destaque, __% alerta].

### Pares de texto y fondo permitidos

Guía: para cada par de texto y fondo, comprobá que el contraste sea de al menos 4,5 a 1 (podés pedirle al programa que lo calcule con la fórmula de contraste de WCAG 2.1 y que lo anote acá). Anotá también los pares prohibidos.

| Texto | Fondo | Contraste | Cumple 4,5 a 1 |
| --- | --- | --- | --- |
| [Texto principal #______] | [Blanco #FFFFFF] | [___ a 1] | [Sí / No] |
| [Blanco #FFFFFF] | [Color principal #______] | [___ a 1] | [Sí / No] |
| [Texto principal #______] | [Color de destaque #______] | [___ a 1] | [Sí / No] |

Pares prohibidos: [Ejemplo: Blanco sobre el color de destaque; el color de alerta como texto sobre su versión suave].

## 3. Tipografías

Guía: dos como máximo, una para títulos y otra para texto, cifras e interfaz. Elegí tipografías gratuitas de Google Fonts y agregá una de respaldo por si no cargan.

- Títulos: [Nombre de la tipografía], pesos [600 y 700], respaldo [system-ui, sans-serif].
- Texto, interfaz y cifras: [Nombre de la tipografía], pesos [400 a 700], respaldo [system-ui, sans-serif]. Cifras en columnas con números de ancho fijo (`font-variant-numeric: tabular-nums`).
- Nunca una tercera tipografía. El HTML carga las dos fuentes y espera a que estén listas antes de imprimir.

## 4. Tamaños, espaciado, radios y títulos

Guía: tamaños en píxeles (px) y una unidad base de espacio. Distinguí la escala para papel A4 de la escala para pantalla.

- Papel A4: título de portada [__ px]; título de sección [__ px], en el color principal; subtítulo [__ px]; texto [14 px]; tablas y notas [12 px]. Nunca más de tres niveles de título.
- Espaciado con base de [4 px]: [4, 8, 12, 16, 24, 32, 48]. Márgenes laterales [__ px]; entre título y texto [__ px]; entre secciones [__ px].
- Radios: [__ px] (badges), [__ px] (botones, campos, recuadros y tablas), [__ px] (tarjetas).
- Sombras: [Ejemplo: en papel no hay sombras; un borde de 1 px en el color de bordes].
- Párrafos de [70] caracteres por línea como máximo.

## 5. Tablas

Guía: encabezado, filas, alineación de números, cuántas columnas como máximo y cómo se marca un dato clave.

- [Ejemplo: Encabezado en el color principal con texto blanco, en negrita. Filas alternas en blanco y color de apoyo suave, bordes de 1 px.]
- [Ejemplo: Números a la derecha, con punto de miles y coma decimal (R$ 1.234,56). Texto a la izquierda. Moneda en el título de la columna o en el valor; aclarar si el flete está incluido.]
- [Ejemplo: Máximo 5 columnas. Fila de totales en negrita, con una línea de 2 px en el color principal arriba.]
- [Ejemplo: Dato clave en un recuadro con fondo suave y borde izquierdo de 4 px en el color de destaque. Uno por página.]

## 6. Gráficos

Guía: tipos permitidos, colores por cantidad de series y qué lleva siempre (título, unidades, fuente).

- [Ejemplo: Solo barras y líneas. Nunca torta ni efectos 3D.]
- [Ejemplo: Una serie: color principal. Dos: color principal y destaque. Tres: se suma el color de apoyo. Nunca más de tres.]
- [Ejemplo: El color de alerta solo para un valor negativo o un error.]
- [Ejemplo: Título, unidades y fuente del dato debajo (12 px). Valores sobre las barras.]

## 7. Portada y formato de página

Guía: qué lleva la portada de un PDF en A4, cómo se arman las páginas interiores y cómo se arma una lámina.

- **PDF en A4.** [Ejemplo: Portada con una placa del color principal de ancho completo y el logo en negativo. Debajo: etiqueta, título, destinatario y fecha en palabras. Páginas interiores: logo chico arriba; abajo, nombre del documento y número de página. El HTML usa `@page { size: A4 }` y `print-color-adjust: exact` para que se impriman los fondos. Para el esqueleto completo, copiá la sección 12 "Página A4 para imprimir" de `sistema-de-diseno-varanda.md`.]
- **Láminas 16:9.** [Ejemplo: Lámina de 297 × 167 mm, un mensaje por lámina, titular de 8 palabras como máximo, cifra clave en tamaño grande. Fondo blanco; color principal con texto blanco para portada y cierre.]

## 8. Logo

Guía: cómo se dibuja tu logo, cuándo se usa la versión positiva y la negativa, tamaño mínimo y qué está prohibido. Si no tenés archivo, pedile al programa que lo dibuje como SVG con tus colores y pegalo acá.

- [Ejemplo: El símbolo es un arco con el sol asomando; el logotipo es "varanda" en la tipografía de títulos, siempre en minúsculas.]
- Versión positiva (sobre fondo claro): [archivo o código SVG].
- Versión negativa (sobre fondo del color principal): [archivo o código SVG].
- Tamaño mínimo: [__ px] de ancho el logo horizontal, [__ px] el símbolo solo. Área de resguardo: [__].

## 9. Tono de voz

Guía: cómo hablás en los documentos (tratamiento, largo de las oraciones, palabras que sí y que no, formato de fechas y montos).

- [Ejemplo: Voseo ("revisá", "tenés", "contanos"). Cercana y concreta. Oraciones cortas que hablan del uso.]
- [Ejemplo: Cifras en lugar de adjetivos. Sin signos de exclamación.]
- [Ejemplo: Fechas en palabras. Montos con "R$", coma decimal y punto de miles.]

## 10. Nunca

Guía: la lista de cosas que no querés ver jamás.

- [Ejemplo: Nunca emojis ni íconos decorativos.]
- [Ejemplo: Nunca el color de alerta para algo que no sea descuento o error.]
- [Ejemplo: Nunca texto sobre un fondo de color con contraste menor que 4,5 a 1.]
- [Ejemplo: Nunca una tercera tipografía ni gráficos de torta.]
- [Ejemplo: Nunca un dato inventado: si falta una cifra, se escribe "dato pendiente".]
