cis-modelo · modelo/reglas.py · 27 reglas · 7 ámbitos

Reglas del sistema

El grupo tiene 27 reglas declaradas en cis-modelo/modelo/reglas.py, identificadas H01 a H27. Cada una trae cuatro cosas: un id para citarla en un informe o un ticket, un enunciado que dice qué exige en una frase, una fuente que dice dónde está escrita (ninguna regla se inventa en el archivo) y un comprueba que dice cómo se mide, para que el chequeo sea repetible.

Esta página transcribe las 27 tal como están en el código, agrupadas por ámbito: estructura, dominios, seguridad, estilo, código, contratos y prosa. Tres de ellas todavía no tienen chequeo que las mida y se marcan como pendientes de instrumentar.

El principio: violación citable, no opinión

Hasta que existió este archivo, una inconsistencia del ecosistema se reportaba como opinión: «esto está mal». Con las reglas pasa a ser una afirmación verificable: «viola la regla H13, y la evidencia es esta medición». La diferencia importa porque una opinión se discute y una violación se cierra. Quien no esté de acuerdo con una violación no argumenta: repite la medición que la columna comprueba describe y refuta con datos, o confirma.

Por eso cada violación que emite el corredor sale con cuatro campos, calcados del dataclass Violacion de modelo/chequeos.py: la regla que se incumple, el objeto que la incumple, lo medido y la evidencia (el comando o cruce del que salió la medición). El ejemplo de abajo es una violación real de la corrida del 2026-08-20, montada con los badges del kit.

<div style="border:1px solid var(--line);background:var(--paper-raised);padding:16px 18px">
  <span class="badge badge--err">H13 · alta</span>
  <span style="font:12px var(--font-mono)">portal.innovacionsantiago.cl</span>
  <div><b>Medido:</b> el registro declara v6 y el sitio carga v9.</div>
  <div><b>Evidencia:</b> consumers.yaml contra el &lt;link&gt; del HTML servido.</div>
</div>

Cómo leer las tablas

La severidad es de la violación, no de la regla: dice cuánto duele incumplirla. En estas tablas se pinta con los badges reales del kit (base/components.css): alta con badge--err, media con badge--warn y baja con el badge neutro.

Una regla sin chequeo que la mida es decorativa: se puede declarar y nadie sabría si se cumple. Las tres que están en ese estado (H03, H04 y H07, automatica=False en el código) se marcan abajo como pendientes de instrumentar y el informe las lista aparte, no como cumplidas. Publicar una regla que ningún chequeo verifica da una sensación de control que no existe.

<span class="badge badge--err">alta</span>
<span class="badge badge--warn">media</span>
<span class="badge">baja</span>
<span class="badge badge--warn">pendiente de instrumentar</span>

Estructura · 6 reglas

Qué puede ser marca, producto, vista, auxiliar o infraestructura, y qué privilegios trae cada clase. Fuente principal: core/core-style/ESTRUCTURA.md, dictada el 2026-08-09.

Dominios · 3 reglas

Bajo qué dominio nace lo nuevo y cuándo se justifica un dominio raíz propio.

Seguridad · 2 reglas

Cómo entra el tráfico público y qué no se le muestra al anónimo ni a los buscadores.

Estilo · 5 reglas

Las que le tocan directo a este hub: versión fijada del kit, tipografía de la casa, logos canónicos y la prohibición del borde de acento.

Así se ve un consumidor que cumple H12 y H13 a la vez: las seis hojas del kit con versión y digest explícitos en la URL, iguales a lo que declara su fila en consumers.yaml. Esta misma página carga exactamente ese bloque.

<link rel=stylesheet href=".../v9/<digest>/fonts/css/ibm-plex-sans.css">
<link rel=stylesheet href=".../v9/<digest>/fonts/css/jetbrains-mono.css">
<link rel=stylesheet href=".../v9/<digest>/base/tokens.css">
<link rel=stylesheet href=".../v9/<digest>/base/chrome.css">
<link rel=stylesheet href=".../v9/<digest>/base/components.css">
<link rel=stylesheet href=".../v9/<digest>/brands/cis/tokens.css">

Código · 5 reglas

Framework, librerías compartidas, auth, correo y desde dónde corre producción. H27 lleva número tardío porque se agregó después, pero su ámbito es código.

Contratos · 5 reglas

Acoplamientos declarados antes de mergear, topología completa, runbooks y responsables con nombre.

Prosa · 1 regla

La norma editorial de la casa aplica a todo documento en español del grupo, incluida esta página. El detalle está en la página Escritura del hub.

Cómo correr los chequeos

El corredor vive en cis-modelo/modelo/chequeos.py y se ejecuta como módulo desde la raíz del repo. Hoy instrumenta H13, H17 y H27 contra los barridos de data/ (barrido-repos.json, estilo-medido.json); las demás automáticas describen su medición en la columna comprueba y van entrando al corredor a medida que se instrumentan. Emite JSON con las violaciones ordenadas por severidad, el total y el conteo por regla. La salida de abajo es de la corrida real del 2026-08-20: 13 violaciones, todas H13.

$ cd /srv/projects/cis/cis-modelo
$ python3 -m modelo.chequeos
{
 "violaciones": [
  {
   "regla": "H13",
   "objeto": "innovacionsantiago.cl",
   "medido": "el registro declara v6 y el sitio carga ninguna",
   "evidencia": "consumers.yaml contra el <link> del HTML servido",
   "severidad": "alta"
  },
  ... 12 más ...
 ],
 "total": 13,
 "por_regla": {"H13": 13}
}

Para refutar una violación no se discute: se repite el comando que aparece en su campo evidencia. Si la medición da otra cosa, la violación cae; si da lo mismo, se cierra arreglando el objeto, no la regla.

Dónde se ven las violaciones vivas

El estado vigente se publica en cis/docs/ecosistema/STATUS-LIVE.md, sección Versionado · producción contra repositorio. Ahí queda el barrido de cis-modelo con fecha: repos barridos, sucios, con trabajo sin empujar, y el veredicto H27 (al 2026-08-20: 101 repos, H27 limpio, todo lo desplegado es ancestro de su repo). STATUS-LIVE.md es el documento generado y vivo; STATUS.md es un snapshot histórico y no sirve para citar estado actual.

Cuando una regla sale limpia, el barrido también lo dice con fecha y universo medido, para que «no hay violaciones» sea una medición y no una ausencia de datos. Así se ve el veredicto vigente de H27:

<span class="badge badge--ok">H27 limpio · 101 repos · 2026-08-20</span>

REGLA DE ORO · Si vas a citar una violación en un ticket o un informe, cita el id (por ejemplo H13), el objeto y la evidencia. Un reporte sin esos tres campos vuelve a ser una opinión.