Saltar al contenido
Índice de Kit UI
Kit UI Componentes

Exportación.

Patrón canónico de exportación 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
Exportación regionalDisponible
Formato
CSV UTF-8
Filas
48.214
Vence
en 24 h
Descargar 8,2 MB
Nivel 3Dentro de una página
Sitio · sección
Exportación regionalDisponible
Formato
CSV UTF-8
Filas
48.214
Vence
en 24 h
Descargar 8,2 MB
Ver y copiar el código de este render
HTML del nivel canónico
<section class="ui-sample ui-service" data-export-job="true"><header><strong>Exportación regional</strong><span class="badge badge--ok">Disponible</span></header><dl><div><dt>Formato</dt><dd>CSV UTF-8</dd></div><div><dt>Filas</dt><dd>48.214</dd></div><div><dt>Vence</dt><dd>en 24 h</dd></div></dl><a class="btn btn--primary" href="#descargar">Descargar 8,2 MB</a></section>

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
Exportación regionalDisponible
Formato
CSV UTF-8
Filas
48.214
Vence
en 24 h
Descargar 8,2 MB

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
Exportación regionalPreparando
Formato
CSV UTF-8
Filas
48.214
Estimado
3 min
Avisarme cuando esté lista

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
Exportación no tiene una implementación vigente demostrada; sus ejemplos son material candidato.
Cambio propuesto
Publicar en r19 el contrato de Exportación para Patrón canónico de exportación para cis-admin, cis-infra, cis-inbox, usaia y servicios internos.
Qué ocurre si respondes No
Exportación 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
Exportación regionalDisponible
Formato
CSV UTF-8
Filas
48.214
Vence
en 24 h
Descargar 8,2 MB
  • 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
Exportación regionalDisponible
Formato
CSV UTF-8
Filas
48.214
Vence
en 24 h
Descargar 8,2 MB
1280 pxEscritorio
Exportación regionalPreparando
Formato
CSV UTF-8
Filas
48.214
Estimado
3 min
Avisarme cuando esté lista

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
<section class="ui-sample ui-service" data-export-job="true"><header><strong>Exportación regional</strong><span class="badge badge--ok">Disponible</span></header><dl><div><dt>Formato</dt><dd>CSV UTF-8</dd></div><div><dt>Filas</dt><dd>48.214</dd></div><div><dt>Vence</dt><dd>en 24 h</dd></div></dl><a class="btn btn--primary" href="#descargar">Descargar 8,2 MB</a></section>

Código TAILWIND

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

Código de referencia
<section class="ui-sample ui-service border border-slate-300 bg-white p-4 text-slate-950 grid gap-3" data-export-job="true"><header class="flex flex-wrap items-center justify-between gap-3"><strong>Exportación regional</strong><span class="badge badge--ok">Disponible</span></header><dl class="grid gap-2"><div><dt>Formato</dt><dd>CSV UTF-8</dd></div><div><dt>Filas</dt><dd>48.214</dd></div><div><dt>Vence</dt><dd>en 24 h</dd></div></dl><a class="btn btn--primary underline underline-offset-4" href="#descargar">Descargar 8,2 MB</a></section>

Código REACT

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

Código de referencia
export interface ExportJobItem {
  /** Nombre del dato (`<dt>`): formato, filas, vencimiento. */
  label: string;
  value: string;
}

export interface ExportJobProps {
  /** Qué se exporta. */
  title?: string;
  /** Estado visible de la exportación («Preparando», «Disponible»); se muestra como etiqueta y vacío la oculta. */
  status?: string;
  /** Tono de la etiqueta de estado; por defecto se deduce del texto (disponible o lista: `ok`; parcial: `warn`; vencida o falló: `err`; preparando u otro: `neutral`). */
  statusTone?: "ok" | "warn" | "err" | "neutral";
  /** Datos del archivo como pares etiqueta y valor: formato, filas, vencimiento del enlace. */
  items?: ExportJobItem[];
  /** Destino de la descarga o del aviso; vacío oculta el enlace. */
  href?: string;
  /** Texto del enlace: la descarga con su peso cuando está lista, o pedir aviso mientras se prepara. */
  linkLabel?: string;
  /** Aspecto del enlace: `primary` para la descarga lista (por defecto), `secondary` para pedir aviso, `quiet` para un enlace terciario. */
  linkVariant?: "primary" | "secondary" | "quiet";
  className?: string;
}

const EXPORT_JOB_ITEMS: ExportJobItem[] = [
  { label: "Formato", value: "CSV UTF-8" },
  { label: "Filas", value: "48.214" },
  { label: "Vence", value: "en 24 h" },
];

const EXPORT_JOB_TONOS: [string, "ok" | "warn" | "err" | "neutral"][] = [
  ["disponible", "ok"],
  ["lista", "ok"],
  ["parcial", "warn"],
  ["vencid", "err"],
  ["falló", "err"],
];

function claseEstado(status: string, tone?: "ok" | "warn" | "err" | "neutral") {
  const texto = status.toLowerCase();
  const tono = tone ?? EXPORT_JOB_TONOS.find(([clave]) => texto.startsWith(clave))?.[1] ?? "neutral";
  return tono === "neutral" ? "badge" : `badge badge--${tono}`;
}

/**
 * Estado de una exportación de datos con formato, cantidad de filas, vencimiento y enlace de descarga; se usa cuando el archivo se genera en segundo plano.
 *
 * Mientras se prepara, el enlace ofrece avisar cuando esté lista (`linkVariant="secondary"`); disponible, descarga el archivo e indica su peso, como acción principal. El estado va en texto dentro de una etiqueta con tono (`badge`), no sólo en color.
 *
 * @example <ExportJob title="Exportación regional" status="Disponible" href="/exportaciones/184.csv" linkLabel="Descargar 8,2 MB" />
 * @example <ExportJob status="Preparando" items={[{ label: "Formato", value: "CSV UTF-8" }, { label: "Filas", value: "48.214" }, { label: "Estimado", value: "3 min" }]} href="/exportaciones/184/aviso" linkLabel="Avisarme cuando esté lista" linkVariant="secondary" />
 */
export function ExportJob({
  title = "Exportación regional",
  status = "Disponible",
  statusTone,
  items = EXPORT_JOB_ITEMS,
  href = "#descargar",
  linkLabel = "Descargar 8,2 MB",
  linkVariant = "primary",
  className,
}: ExportJobProps) {
  return (
    <section className={["ui-service", className].filter(Boolean).join(" ")} data-export-job>
      <header>
        <strong>{title}</strong>
        {status ? <span className={claseEstado(status, statusTone)}>{status}</span> : null}
      </header>
      {items.length ? (
        <dl>
          {items.map((item, i) => (
            <div key={`${item.label}-${i}`}>
              <dt>{item.label}</dt>
              <dd>{item.value}</dd>
            </div>
          ))}
        </dl>
      ) : null}
      {href && linkLabel ? <a className={`btn btn--${linkVariant}`} href={href}>{linkLabel}</a> : null}
    </section>
  );
}