Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Aviso de incidente.

Patrón canónico de aviso de incidente para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.

Verlo por niveles

Primero el componente, después la variación de marca y finalmente su uso dentro de una página.

Nivel 1Componente canónico
Nivel 2COCHID · variación
Nivel 3Dentro de una página
Sitio · sección
Ver y copiar el código de este render
HTML del nivel canónico
<aside class="ui-sample ui-feedback" data-incident-banner="true" data-severity="info" role="status"><strong>Mantenimiento programado</strong><p>El 27 ago de 02:00 a 02:20 CLT habrá una pausa de publicación.</p><a class="btn btn--quiet" href="#estado">Ver estado y actualizaciones</a><time>Actualizado 18:24 CLT</time></aside>

Variaciones por marca y sitio

Cada cambio visible declara su autoridad; lo que permanece canónico no se vuelve a inventar en el producto.

innovacionsantiago.cl

Compañía de Innovación de Santiago

Autoridad: CONSTITUTION.md + LOGOS-CANONICOS.md

Cambia en esta marca

  • Navegación y contenido propios del servicio
  • Acento reservado para acciones y datos

Permanece canónico

  • Mark CIS y namebrand de tres líneas
  • IBM Plex Sans, foco, espaciado y anatomía
cochid.cl

COCHID

Autoridad: core-style/DECISIONES.md M15 y LOGOS-CANONICOS.md

Cambia en esta marca

  • Cuadrado azul y namebrand de tres líneas
  • Azul COCHID en selección, capas y series

Permanece canónico

  • Estructura y semántica comunes
  • Fuentes, unidades y alternativa tabular

Comparación histórica recuperable

Compara la propuesta con cortes reales del repositorio. La ausencia de una muestra se declara y nunca se reconstruye de memoria.

Estado actual
Aviso de incidente no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
Cambio propuesto
Publicar en r19 el contrato de Aviso de incidente para Patrón canónico de aviso de incidente para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
Qué ocurre si respondes No
Aviso de incidente queda fuera de r19 y sus ejemplos siguen sólo como evidencia pendiente de reformulación.

Preparando comparación histórica…

Antes / r19

La comparación convierte una regla abstracta en una diferencia visible y verificable.

r19 · correctoContrato canónico renderizado
  • Conecta estado, timestamp y fuente al servicio real.
  • Explica impacto, recuperación y recibo cuando hay una falla.
Antes · problema observadoAnti-ejemplo no interactivo
CONFIRMADOServicio operativoSin healthcheck, timestamp ni recibo
  • No muestres CONFIRMADO o EN LÍNEA sin señal verificable.
  • No expongas secretos, tokens ni trazas con datos personales.

Responsive

La misma anatomía debe conservar lectura, foco y acciones sin cortar contenido ni crear scroll horizontal en la página.

320 pxMóvil y zoom
1280 pxEscritorio

Cobertura

DimensiónContrato
Propietario canónicoSistema de diseño CIS e Infraestructura · core/core-style
Consumidorescis-admin, cis-infra, cis-inbox, usaia y servicios internos
DependenciasAPI del servicio, recibos verificables
Estadocandidato

Evidencia de adopción

Patrón propuesto. 0 implementaciones observadas en 0 repositorios.

La observación demuestra uso existente; la aceptación canónica sigue dependiendo de esta ficha y de su propietario.

DatoResultado
ClasificaciónPatrón propuesto
Implementaciones0 implementaciones observadas
RepositoriosNingún repositorio observado
Snapshotkit/componentes/componentes-observados.json

Consumidores observados

El inventario conserva repositorio, archivo fuente y criterio de asociación. Observar una implementación no la convierte automáticamente en canónica.

Estados

Estado requerido
operativo
degradado
fallido
sin datos

Accesibilidad

  • Conserva nombre accesible, orden de lectura y foco visible.
  • Funciona a 320 px, con zoom de 200% y texto largo.
  • El color nunca es la única señal de estado o acción.
  • El contenido esencial permanece disponible sin JavaScript.

Código HTML

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<aside class="ui-sample ui-feedback" data-incident-banner="true" data-severity="info" role="status"><strong>Mantenimiento programado</strong><p>El 27 ago de 02:00 a 02:20 CLT habrá una pausa de publicación.</p><a class="btn btn--quiet" href="#estado">Ver estado y actualizaciones</a><time>Actualizado 18:24 CLT</time></aside>

Código TAILWIND

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
<aside class="ui-sample ui-feedback border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-incident-banner="true" data-severity="info" role="status"><strong>Mantenimiento programado</strong><p>El 27 ago de 02:00 a 02:20 CLT habrá una pausa de publicación.</p><a class="btn btn--quiet underline underline-offset-4" href="#estado">Ver estado y actualizaciones</a><time>Actualizado 18:24 CLT</time></aside>

Código REACT

Copia el bloque completo; después cambia contenido y destinos, no su anatomía.

Código de referencia
export interface IncidentBannerProps {
  /** Tipo de aviso: «Mantenimiento programado», «Incidente activo», «Servicio restablecido». */
  title?: string;
  /** Qué ocurre, cuándo y qué sigue disponible; vacío omite el párrafo. */
  description?: string;
  /** Destino de la página de estado o del incidente; vacío oculta el enlace. */
  href?: string;
  /** Texto del enlace; vacío oculta el enlace. */
  linkLabel?: string;
  /** Texto visible de la última actualización dentro de `<time>`, con hora y zona horaria; vacío lo oculta. */
  time?: string;
  /** Momento de la última actualización en ISO 8601 con zona horaria (atributo `dateTime`). */
  dateTime?: string;
  /** Gravedad del aviso (`data-severity`), que da el tono del borde y del título; por defecto se deduce de `title` (mantenimiento: `info`; incidente: `warning`; interrupción o caída: `error`; restablecido o resuelto: `success`; otro: `info`). */
  severity?: "info" | "warning" | "error" | "success";
  className?: string;
}

const INCIDENT_BANNER_GRAVEDAD: [string, "info" | "warning" | "error" | "success"][] = [
  ["mantenimiento", "info"],
  ["incidente", "warning"],
  ["interrupción", "error"],
  ["caída", "error"],
  ["servicio restablecido", "success"],
  ["restablecido", "success"],
  ["resuelto", "success"],
];

/**
 * Banda de aviso sobre un mantenimiento programado o un incidente en curso, con su efecto, un enlace a la página de estado y la hora de la última actualización.
 *
 * Usa `role="status"`. Di qué deja de funcionar y qué sigue disponible; `dateTime` conserva el momento exacto de la actualización. El tipo de aviso va en el título; `severity` sólo refuerza el tono. El enlace a la página de estado es una acción terciaria (`btn--quiet`).
 *
 * @example <IncidentBanner title="Mantenimiento programado" description="El 27 ago de 02:00 a 02:20 CLT habrá una pausa de publicación." href="/estado" />
 * @example <IncidentBanner title="Incidente activo" description="La generación de PDF tarda más de lo habitual. Los documentos ya publicados siguen disponibles." time="Actualizado 18:24 CLT" dateTime="2026-08-25T18:24:00-04:00" />
 */
export function IncidentBanner({
  title = "Mantenimiento programado",
  description = "El 27 ago de 02:00 a 02:20 CLT habrá una pausa de publicación.",
  href = "#estado",
  linkLabel = "Ver estado y actualizaciones",
  time = "Actualizado 18:24 CLT",
  dateTime,
  severity,
  className,
}: IncidentBannerProps) {
  const texto = title.toLowerCase();
  const gravedad = severity ?? INCIDENT_BANNER_GRAVEDAD.find(([clave]) => texto.startsWith(clave))?.[1] ?? "info";
  return (
    <aside className={["ui-feedback", className].filter(Boolean).join(" ")} data-incident-banner data-severity={gravedad} role="status">
      <strong>{title}</strong>
      {description ? <p>{description}</p> : null}
      {href && linkLabel ? <a className="btn btn--quiet" href={href}>{linkLabel}</a> : null}
      {time ? <time dateTime={dateTime}>{time}</time> : null}
    </aside>
  );
}