Saltearse al contenido

Internals (RFCs)

El diseño de NamiDB vive en 18 (y subiendo) documentos Request-For-Comments. Cada uno captura el por qué de una decisión mayor del motor — el contexto, las alternativas consideradas y la justificación.

Para una orientación de alto nivel, empieza con RFC-001 — Storage engine y RFC-002 — Formato SST.

Storage engine

RFCTema
001Storage engine
002Formato SST
003Lecturas con range en el read-path
018Cache de CSR adjacency
019Cache de NodeView
020Caches de edge SST

Lenguaje de queries

RFCTema
004Subset de Cypher
008IR del plan lógico
009Cláusulas de escritura

Optimizador

RFCTema
010Optimizador basado en costos
011Predicate pushdown
012Hash join
013Predicate pushdown en Parquet
014Hash semi-join
015Projection pushdown
016Join reorder

Ejecutor

RFCTema
017Factorización

Fan-out de lectura (en vuelo)

RFCTema
021Remoción del mutex del read-path (en vuelo en main)

Cómo funcionan los RFCs

Para cualquier cambio más grande que un refactor de pocas líneas, el contribuidor escribe un RFC, abre un PR Draft con sólo el RFC y recibe feedback antes de escribir código. Ver Proceso de RFCs para el workflow completo.

La fuente canónica es docs/rfc/ en el repo del motor. Las páginas de esta sección son espejos con una nav amigable para docs.