# Plantillas — catálogo

Descripción detallada de cada plantilla usada en `bizkaia.eus`. Para cada una: propósito, bloques obligatorios, bloques opcionales y ejemplo de uso.

Las páginas deben construirse con **componentes reutilizables** (header, footer, breadcrumb, hero temático, listados, etc.), no con HTML repetido. Ver [GLOSARIO.md](./GLOSARIO.md) para términos.

---

## `home`

**Propósito.** Punto de entrada único al portal. Orienta a cualquier ciudadano a encontrar lo que busca en ≤ 2 clics.

**Bloques obligatorios:**
- Hero con vídeo institucional + buscador global.
- Accesos directos a trámites frecuentes ("Mis impuestos", "Dependencia", "Empleo público").
- Rejilla de los 13 temas.
- Banda de gobierno abierto + transparencia (acceso resumido).
- Actualidad (últimas 3-4 notas de Bizkaimedia).
- Bloque de emergencias resumido (permanente, pero discreto).
- Accesos autenticados (Mi Carpeta, Área profesional, Área entidades).

**Bloques opcionales:**
- Destacado estacional (campaña fiscal, inicio de curso, convocatoria abierta).
- Evento/agenda destacado.

**Ejemplo:** `/es`

---

## `tema`

**Propósito.** Punto de entrada ciudadano a un área temática. Responde a "¿qué puedo hacer en X?".

**Bloques obligatorios:**
- Breadcrumb (Inicio › Temas › {Tema}).
- Hero temático (imagen + titular + entradilla + buscador del tema).
- Rejilla de **subtemas**.
- Fichas de servicio destacadas (las 3-6 más consultadas).
- Actualidad temática (notas relacionadas, agregadas desde Bizkaimedia).
- Agenda temática.
- Bloque de derivación a `¿Necesitas ayuda?`.
- Departamento(s) responsable(s) como metadato al pie.

**Bloques opcionales:**
- Vídeo explicativo.
- Destacados en lectura fácil.
- Preguntas frecuentes destacadas.
- Enlaces a áreas autenticadas relacionadas (profesional, entidades).

**Ejemplo:** `/es/servicios-sociales`

---

## `subtema`

**Propósito.** Agrupa fichas de servicio dentro de un tema. "Todo lo relacionado con dependencia y mayores".

**Bloques obligatorios:**
- Breadcrumb.
- Hero del subtema (titular + entradilla).
- Listado de fichas de servicio del subtema.
- Sección de recursos relacionados (guías, centros, contactos).

**Bloques opcionales:**
- Normativa aplicable (enlaces al repositorio).
- Preguntas frecuentes del subtema.
- Actualidad específica.

**Ejemplo:** `/es/servicios-sociales/dependencia-y-mayores`

---

## `ficha-servicio` ← pieza clave

**Propósito.** Unifica lo que hoy está separado entre web pública y sede electrónica. Una sola página con **toda** la información y acceso al trámite.

**Bloques obligatorios:**
1. **Cabecera** — breadcrumb + título + resumen + estado (abierto/cerrado por fechas).
2. **Qué es** — descripción ciudadana, 2-4 párrafos.
3. **Para quién** — personas destinatarias, criterios de elegibilidad.
4. **Requisitos** — lista estructurada.
5. **Pasos del trámite** — secuencia visual (1, 2, 3…).
6. **Documentación necesaria** — lista descargable con enlaces a modelos.
7. **Plazos** — fechas de presentación, de resolución, de recurso.
8. **Acceso al trámite** — CTA potente al formulario autenticado (o al canal presencial si aplica).
9. **Preguntas frecuentes** — FAQ específica.
10. **Normativa aplicable** — enlaces a `/es/normativa/{slug}`.
11. **Departamento responsable** — metadato enlazado a `/es/gobierno/{dep}`.
12. **Contacto** — bloque con teléfono, email, cita previa.

**Bloques opcionales:**
- Notas de prensa relacionadas (banda pull desde Bizkaimedia).
- Centros/oficinas donde se presta el servicio (enlace a `centro`).
- Guía en lectura fácil.
- Versión en euskera / accesible.
- Bloque "Servicios relacionados".

**Principios de diseño:**
- El acceso al formulario debe ser el CTA más visible.
- Todo lo que hoy te obligaba a ir de la web a la sede debe estar **aquí**.
- Nunca enlaces "saltar a la sede para tramitar" — el trámite vive en esta ficha.

**Ejemplo:** `/es/servicios-sociales/dependencia-y-mayores/valoracion-de-la-dependencia`

---

## `departamento`

**Propósito.** Relato institucional de un departamento foral. Quién, qué hace, cómo lo organiza.

**Bloques obligatorios:**
- Breadcrumb (Inicio › Gobierno › {Departamento}).
- Hero institucional (titular + diputada/o foral + entradilla).
- Misión y competencias (bloque o enlace a subpágina).
- Temas vinculados (enlaces al área temática que lidera o codirige).
- Datos clave (indicadores, presupuesto, resultados).
- Equipo directivo.
- Estructura orgánica.
- Planes estratégicos vigentes.
- Notas de prensa del departamento (agregadas desde Bizkaimedia).
- Contacto institucional.

**Bloques opcionales:**
- Subvenciones convocadas.
- Participación ciudadana / órganos consultivos.
- Proyectos de innovación.
- Evaluación y rendición de cuentas.

**Ejemplo:** `/es/gobierno/accion-social`

---

## `proceso-participativo`

**Propósito.** Hogar canónico de un proceso participativo abierto o cerrado. Sirve para explicar qué se debate, cómo participar y qué retorno público se ofrece.

**Bloques obligatorios:**
- Cabecera con estado (`abierto`, `próximo`, `cerrado`), fechas y departamento responsable.
- Qué se decide / para qué se abre el proceso.
- Cómo participar (canales, plazos, requisitos si los hay).
- Documentos base y materiales de contexto.
- Cronología del proceso (apertura, sesiones, cierre, devolución).
- Resultado o retorno público cuando el proceso finaliza.

**Bloques opcionales:**
- Vídeo explicativo.
- Formulario o CTA a plataforma externa.
- Enlaces a normativa o planes relacionados.
- Noticias enlazadas desde Bizkaimedia.

**Ejemplo:** `/es/participacion/procesos/{slug}`

---

## `consejo`

**Propósito.** Ficha de un órgano o foro estable de participación.

**Bloques obligatorios:**
- Cabecera con nombre, ámbito y departamento vinculado.
- Finalidad del órgano.
- Composición y perfiles participantes.
- Funcionamiento (periodicidad, presidencia, secretaría, cómo se accede).
- Agenda, actas y documentación.
- Relación con procesos, planes o normativa que alimenta.

**Bloques opcionales:**
- Histórico de mandatos o renovaciones.
- Preguntas frecuentes.
- Canal de contacto o solicitud de incorporación.

**Ejemplo:** `/es/participacion/consejos/{slug}`

---

## `plan`

**Propósito.** Ficha de un plan estratégico o sectorial.

**Bloques obligatorios:**
- Cabecera + vigencia (años).
- Objetivos.
- Ejes estratégicos.
- Indicadores de seguimiento.
- Documentos descargables (plan completo, resúmenes).
- Evaluación / rendición de cuentas.

**Bloques opcionales:**
- Vídeo de presentación.
- Participación ciudadana asociada.
- Normativa vinculada.

---

## `ficha-norma`

**Propósito.** Hogar canónico de una norma foral. Cualquier otra página referencia esta ficha, no copia su contenido.

**Bloques obligatorios:**
- Identificación: número, denominación, fecha de aprobación.
- **Texto consolidado vigente** (integrado, no PDF descolgado).
- Histórico de modificaciones (cada una enlazada al BOB que la publicó).
- Departamento responsable.
- Servicios que regula (fichas de servicio que la aplican).

**Bloques opcionales:**
- Versión en lectura fácil.
- Preguntas frecuentes sobre la norma.
- Consulta pública asociada (si está en elaboración).

---

## `nota-prensa`

**Propósito.** Pieza de comunicación institucional. Misma pieza, presentaciones distintas según contexto.

**Bloques obligatorios:**
- Titular ciudadano (accesible, sin jerga).
- Entradilla ciudadana.
- Cuerpo institucional (declaraciones, datos).
- Datos clave estructurados (cifras, fechas, personas).
- Material gráfico descargable (imágenes, vídeo si aplica).
- Enlaces relacionados (fichas de servicio, planes, normas).
- Contacto de prensa.

**Contextos de renderizado:**
- **Bizkaimedia** (`/es/bizkaimedia/notas/{slug}`) — hogar canónico, vista completa.
- **Actualidad ciudadana** (`/es/actualidad`) — listado masivo.
- **Banda contextual** en fichas / departamentos — resumen clicable.

---

## `transparencia-seccion`

**Propósito.** Sección de transparencia, propia o agregada.

**Bloques obligatorios:**
- Introducción + marco normativo aplicable.
- Datos abiertos en formato tabla/lista + descargables.
- Actualización (fecha y frecuencia).
- Fuente (departamento que la genera — metadato).

**Bloques opcionales:**
- Visualizaciones interactivas.
- Histórico.
- Solicitud de información adicional.

---

## `centro`

**Propósito.** Ficha de un centro o servicio físico (residencia, oficina tributaria, centro cultural).

**Bloques obligatorios:**
- Nombre + tipo de centro.
- Mapa con dirección.
- Horarios.
- Accesibilidad (plazas adaptadas, transporte público, rampas, etc.).
- Titularidad (foral, concertada, municipal).
- Contacto.

**Bloques opcionales:**
- Galería de imágenes.
- Servicios específicos del centro.
- Vacantes / plazas.

---

## `pagina-institucional`

**Propósito.** Páginas de texto descriptivo (misión, competencias, "qué es X").

**Bloques obligatorios:**
- Cabecera + breadcrumb.
- Cuerpo estructurado con encabezados jerárquicos.

**Bloques opcionales:**
- Documentos descargables.
- Contacto relacionado.

---

## `area-autenticada`

**Propósito.** Espacio personal autenticado para ciudadanía, profesionales o entidades. No explica políticas públicas: muestra estado personal, expedientes, documentos y acciones pendientes.

**Bloques obligatorios:**
- Banda superior de sesión (persona usuaria, último acceso, ayuda, cerrar sesión).
- Breadcrumb simplificado.
- Layout con sidebar persistente a la izquierda y área de trabajo a la derecha.
- Navegación interna de la sección (`Mi Carpeta`, `Mis trámites`, `Notificaciones`, etc.).
- Resumen o listado principal según la página.
- Bloque de ayuda o soporte contextual.

**Bloques opcionales:**
- Estados vacíos.
- Alertas de plazos.
- Banner "¿Cómo me identifico?" cuando no hay sesión o hay error de acceso.
- Modo representación (actúo en nombre de otra persona o entidad).

**Ejemplo:** `/es/mi-carpeta`

---

## `listado`

**Propósito.** Índices y agregadores. Listado de temas, de departamentos, de normas, de planes, etc.

**Bloques obligatorios:**
- Cabecera explicativa.
- Filtros (cuando hay ≥ 10 elementos).
- Rejilla o lista de elementos.
- Paginación si procede.

**Bloques opcionales:**
- Buscador interno.
- Ordenación.

---

## `emergencias`

**Propósito.** Plantilla específica para el tema Emergencias. La urgencia justifica romper la jerarquía visual habitual.

**Bloques obligatorios:**
- **Teléfonos de emergencia destacados arriba** (grande, contrastado).
- Protocolos activos (alertas vigentes).
- Consejos por tipo de emergencia (incendios, inundaciones, ola de calor).
- Información de contacto de cuerpos de emergencia.

**Bloques opcionales:**
- Mapa de alertas.
- Suscripción a avisos.
- Histórico de alertas.