Ir al contenido

Conceptos

Las páginas de concepto están orientadas a la comprensión: explican el porqué detrás de Aurora, no el cómo usarlo. Léelas cuando quieras formar un modelo mental sólido.

Si quieres hacer algo, usa las guías. Si necesitas datos exactos, usa la referencia.

  • Estrategias de autenticación — los tres modos OAUTH_STRATEGY, el patrón BFF y cómo fluyen los tokens entre un hub y sus satélites.
  • Ports entre bounded contexts — cómo la carpeta @bridges desacopla los bounded contexts mediante ports, tokens, adapters y un composition root global.
  • Scaffolding de un módulo — qué genera la CLI para un módulo de backend y cómo el lockfile vigila las ediciones a mano.
  • Renderers de celdas — cómo la data-table despacha por tipo de propiedad y cómo sobreescribir el render por columna.
  • Composables: atoms y presets — por qué la lógica del brain se parte en atoms de responsabilidad única y presets opinados conectados a TanStack Table.
  • Composición vs herencia — por qué el brain extiende en horizontal componiendo funciones en vez de por jerarquías de clases.
  • Detail mode — cómo front.detailMode elige entre una página de detalle ruteada y un CRUD lista-con-modal.
  • Embed mode — cómo front.embedSupport permite embeber un módulo hijo dentro del detalle de su padre.
  • Ancho de campos — cómo el grid de 12 columnas, los defaults por tipo, widget.span y el pase de auto-expand deciden el ancho de cada campo.
  • Preservation regions — cómo te apropias de un trozo de un archivo generado y por qué ese trozo sobrevive a la regeneración.
  • Columnas pinned (TanStack) — por qué fijar una columna la reordena en vez de moverla, y cómo la data-table escribe pinning y orden a la vez.
  • Sistema de business rules — un catálogo de invariantes de dominio junto a los YAML, usado como memoria institucional y detector de incoherencias.
  • Anatomía de una business rule — los campos, la gramática de IDs, estado/severidad, la tabla de casos y el ciclo de vida de una regla.
  • Arquitectura del sistema de business rules — las piezas técnicas (índice, scripts, slash commands, skill, hooks, CI, extensión OpenSpec) y cómo se relacionan.
  • Modos de desarrollo — Framework mode vs Solution mode y el comando /dev-mode que cambia entre ellos.
  • Los cuatro artefactos de gobernanza — Harness Rules, el hook architecture-checkpoint y las skills de project-structure de backend/frontend: qué te bloquea, qué te aconseja y quién es responsable de qué.