dec-0016

Vista generada de dec-0016: quic-zig all-in como implementación principal detrás de una interfaz TransportServer mínima sustituible; el sidecar Rust wtransport queda degradado a referencia de interop, no camino de diseño.

ImplementadoSin versión del tren todavía· generada desde docs/decisions/dec-0016-quic-zig-all-in-como-implementacion-principal.md
track/docsdec-0124track/docs:DC10

Vista generada desde docs/decisions/dec-0016-quic-zig-all-in-como-implementacion-principal.md. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere. El estado aquí es el del model: si discrepa con otra página, manda el model.

CampoValor
EstadoLOCKED (migrado de un rNN por gate-3: el fichero no declara estado)
Referencia legadar22-L5
Ficherodocs/decisions/dec-0016-quic-zig-all-in-como-implementacion-principal.md

Enmienda a: r21

Por qué importa (del frontmatter del ADR):

Citado en CLAUDE.md (submodule quic-zig BUILD-CRITICAL), docs/references/quic-zig/ es submodule crítico del data plane

Nodos del roadmap que lo citan en refs: ninguno.

Páginas de la documentación que lo citan: ninguna todavía.

Texto del ADR

Leído de docs/decisions/dec-0016-quic-zig-all-in-como-implementacion-principal.md, el fichero canónico.

quic-zig all-in como implementación principal detrás de una interfaz TransportServer mínima sustituible; el sidecar Rust wtransport queda degradado a referencia de interop, no camino de diseño.

quic-zig all-in como implementación principal detrás de una interfaz TransportServer mínima sustituible; el sidecar Rust wtransport queda degradado a referencia de interop, no camino de diseño.

Por qué pasa gate-3

  • Hard-to-reverse: Aunque hay interfaz mínima, cambiar implementación de quic-zig a otra requiere profundizar conocimiento quic-zig para debug/parches, repo de referencia clonado es dependency
  • Surprising sin contexto: Sin el ADR, no se sabría que quic-zig es la implementación principal y wtransport solo referencia - la prioridad no es obvia del código
  • Trade-off real: Trade-off T2 explícito: 'quic-zig joven (no battle-tested) → riesgo de cronograma'. Alternativa Rust-central fue rechazada por all-in Zig, wtransport degradado por madurez

Procedencia

Split de docs/decisions/r22-pivot-zig-first-owned-data-plane-2026-06-20.md (lock r22-L5) durante PASO 7 (2026-07-16). Ver el fichero padre para el contexto completo del pack original.