# Plantilla: Documentar Nuevo Producto

Copiar esta plantilla a `productos/{nombre-producto}/` y completar cada sección.

---

## README.md

```markdown
# Producto: {Nombre del Producto}

**Demo:** demo-{nombre}
**Proyecto de referencia:** [{Nombre}]({URL})
**Categoría:** {Tipo de negocio}

## Descripción

Breve descripción del producto y a qué tipo de negocio apunta.

## Identidad visual

| Aspecto | Valor |
|---------|-------|
| Tipografía principal | {fuente} |
| Tipografía secundaria | {fuente} |
| Skin | skin-{nombre} (auto) |
| Page headers | classic / modern |
| Kerning (si aplica) | {valor} |

## Módulos incluidos

| Módulo | Propósito en este producto |
|--------|---------------------------|
| {modulo1} | {por qué es esencial para este rubro} |
| {modulo2} | {idem} |

## Módulos opcionales recomendados

| Módulo | Caso de uso |
|--------|-------------|
| {modulo} | {cuándo tendría sentido activarlo} |

## Archivos clave del demo

| Tipo | Ubicación |
|------|-----------|
| Header | layout/front/headers/demo-{nombre}.blade.php |
| Footer | layout/front/footers/demo-{nombre}.blade.php |
| Welcome | modules/cd-base/frontend/demos/demo-{nombre}/welcome.blade.php |
| About | modules/cd-base/frontend/demos/demo-{nombre}/about.blade.php |
| Contact | modules/cd-base/frontend/demos/demo-{nombre}/contact.blade.php |
| CSS Demo | public/template/css/demos/demo-{nombre}.css |
| CSS Skin | public/template/css/skins/skin-{nombre}.css |

## Provision template

Archivo: database/seeders/project-data/provision-template-{producto}.json

## Documentación detallada

1. identidad.md -- Brandbook, tipografía, colores, skin
2. modulos-integrados.md -- Módulos activos, adaptación visual, page-headers
3. checklist.md -- Validación completa del producto
```

---

## identidad.md

- Proyecto de referencia y su brandbook
- Tipografías (primary, secondary, tertiary)
- Variables CSS / colores del skin
- Kerning y estilos especiales
- Componentes con estilo propio del demo
- Scoping CSS (`html.demo-{nombre}`)

---

## modulos-integrados.md

- Lista de módulos activos con `navigation.header` y `navigation.footer`
- Page-header type por módulo (classic, modern)
- Adaptaciones visuales en `dynamic-header.blade.php`
- Vistas base del demo (welcome, about, contact): qué secciones incluyen
- Secciones del welcome que dependen de módulos (ej: últimos posts del blog, servicios destacados)

---

## checklist.md

```markdown
## Checklist de validación

### Identidad visual
- [ ] Header renderiza correctamente (logo, navegación, CTA)
- [ ] Footer renderiza correctamente (contacto, links, copyright)
- [ ] Tipografía coincide con el proyecto de referencia
- [ ] Colores del skin aplicados correctamente
- [ ] CSS scoping bajo html.demo-{nombre}

### Vistas base
- [ ] Welcome (home) con todas las secciones
- [ ] About con contenido y estilo del demo
- [ ] Contact con formulario y datos de contacto

### Módulos incluidos
- [ ] Cada módulo activo tiene page-header adaptado al demo
- [ ] Navegación header muestra solo módulos con header: true
- [ ] Navegación footer muestra solo módulos con footer: true
- [ ] Rutas de cada módulo responden correctamente
- [ ] Vista index de cada módulo renderiza con estilo del demo
- [ ] Vista show (detalle) de cada módulo renderiza correctamente

### Provisión
- [ ] Provision template creado y probado
- [ ] Seeders de módulos incluidos generan contenido correctamente
- [ ] Assets de referencia disponibles

### Multi-tenant
- [ ] Al cambiar DB a este proyecto, todo el sistema se adapta
- [ ] Caché se limpia y regenera correctamente
```

---

## Pasos técnicos para crear un producto nuevo

1. Verificar que el demo existe con sus 5 componentes (header, footer, vistas base, CSS, skin)
2. Si no existe, crearlo siguiendo [../guias/crear-demo.md](../guias/crear-demo.md)
3. Definir módulos incluidos y verificar que cada uno tiene `dynamic-header.blade.php` con variante para el demo
4. Si falta adaptación de algún módulo al demo, crearla
5. Crear provision template copiando `provision-template.json` y preconfigurandolo
6. Crear proyecto de referencia usando el provision template
7. Validar con el checklist
8. Documentar en `productos/{nombre}/`