Ridge Arquitectura de tiempo de ejecución

Esta página asigna el tiempo de ejecución compartido por Ridge DB y Ridge Admin. Se deriva de la actual ridged, ridge_pgwire, ridge_sql, ridge, y ridge-admin implementaciones en lugar de una plantilla de base de datos genérica.

Abre el interactivo Archify diagrama

El mapa interactivo proporciona componentes con capacidad de búsqueda, seguimiento de ruta dirigido, vistas guiadas para la ruta de consulta principal, acceso remoto SSH, durabilidad y seguridad, dark/light temas, navegación por teclado y SVG o exportación de trama.

Mapa del sistema

Browser
  │ HTTP on loopback
  ▼
Ridge Admin security gate
  │ authenticated API + workspace
  ▼
Ridge Admin services ──► four-connection pgwire pool
                              │
                              ├── local pgwire ─────────────────────┐
                              │                                     │
                              └── verified SSH direct-tcpip ────────┤
                                                                    ▼
                                                       ridged pgwire runtime
                                                                    │
                                                                    ▼
                                                       Ridge SQL session
                                                                    │
                                                                    ▼
                                                       Ridge core / MVCC
                                                                    │
                                                                    ▼
                                                       B+Trees + WAL + rows

El camino principal es intencionalmente estrecho. El navegador nunca recibe un socket de base de datos o SSH credencial. Tanto el perfil local como el remoto convergen en el mismo pgwire, SQL, transacciones y contratos de almacenamiento.

Componentes de tiempo de ejecución

Flujo de consulta principal

1. Ridge Admin vincula su servidor HTTP a 127.0.0.1 y le da al navegador una token de fragmento único.
2. El navegador intercambia el fragmento por un HTTP-solo cookie de sesión y recibe un token CSRF por sesión.
3. El despachador HTTP valida el tamaño de la solicitud, la ruta, el método, el host, el origen, sesión, CSRF y tipo de contenido antes de invocar un servicio.
4. Un espacio de trabajo SQL alquila una conexión propia del grupo de cuatro conexiones.
5. Los perfiles locales se conectan a ridged en loopback. Los perfiles remotos ponen el mismo protocolo de cliente a través de un canal SSH direct-tcpip verificado sin abrir un oyente de reenvío.
6. Un fragmento de reactor ridged valida el protocolo de inicio, TLS/authentication marcos, declaraciones preparadas, estado del portal, presión de salida y metadatos de cancelación.
7. El coordinador de almacenamiento enruta la solicitud limitada a un Ridge SQL sesión.
8. Ridge SQL analiza y planifica una declaración admitida, aplica result/work límites, y se ejecuta a través del Ridge núcleo.
9. Ridge se aplica el núcleo MVCC visibilidad, bloqueo, restricciones, índices, WAL publicación, B+Tree cambios, sumas de verificación y fsync según sea necesario.
10. Los resultados regresan a través de pgwire. Ridge Admin convierte el protocolo acotado frames to JSON or CSV and returns them to the browser.

Una escritura interrumpida nunca se reproduce automáticamente. Ridge Admin marca un resultado ambiguo como incierto y requiere verificación del operador.

Modelo de concurrencia

El ridged persistente requiere al menos dos trabajadores de semilla. Divide parte del conjunto de trabajadores en fragmentos de reactor que no se bloquean y mantiene la capacidad para el trabajo de almacenamiento. Cada fragmento posee su oyente, losa de conexión, estado del protocolo, planes preparados, contrapresión de salida, token de cancelación y un lector de instantáneas de solo lectura. Los canales delimitados conectan fragmentos al coordinador de almacenamiento.

El coordinador preserva la propiedad de las transacciones, la agrupación de confirmaciones, el drenaje de cierres y el enrutamiento de cancelaciones. Las lecturas pueden utilizar instantáneas independientes; las escrituras duraderas aún pasan Ridge Reglas de detección y publicación de conflictos.

Ridge Admin utiliza spawn estructurado para conexiones HTTP limitadas y un administrador SSH propio. El estado del servidor es propietario del grupo, los arrendamientos del espacio de trabajo, la cancelación de consultas activas, el estado de reconexión y la limpieza determinista.

Dependencias externas

Ridge no depende de un PostgreSQL servidor. PostgreSQL la compatibilidad se limita al subconjunto de cables del lado del cliente documentado.

Límites de seguridad

Navegador a Ridge Admin

• El oyente es sólo de bucle invertido.
• El secreto de lanzamiento se lleva en el URL fragmento, no un parámetro de consulta.
• El intercambio único produce una cookie de sesión SameSite exclusiva de HTTP.
• Las mutaciones requieren un origen de bucle invertido exacto y un token CSRF por sesión.
• Las combinaciones de host, tipo de contenido, tamaño header/body y route/method son validado antes del envío.
• CSP, sin tienda, nosniffy el comportamiento restrictivo de referencia reduce el navegador. exposición.

Ridge Admin a la base de datos

• El backend posee todos los sockets, transacciones, secretos y limpieza.
• Los perfiles no conservan las contraseñas de la base de datos, las contraseñas SSH ni la clave. frases de contraseña.
• Las credenciales retenidas para cancelación o reconexión están limitadas y puesto a cero desde la memoria del proceso.
• Un espacio de trabajo permanece anclado a su estado de transacción y conexión.
• Las desconexiones no provocan la repetición de la consulta.

SSH límite

• La verificación estricta de host conocido es la opción predeterminada; aceptar-nuevo explícito es un política de primer contacto, no una omisión de host cambiado.
• Nativo direct-tcpip Los canales llegan al loopback remoto. ridged punto final.
• No se abre ningún escucha de reenvío TCP local.
• La cancelación de consultas utiliza un canal SSH verificado por separado.

ridged límite

• El servicio se vincula únicamente a 127.0.0.1.
• TLS y la autenticación de contraseña están configuradas por el operador; un texto claro El desafío de contraseña se acepta solo dentro de TLS.
• El servidor actual expone un database/user configurado más un límite rol de solo lectura, no un PostgreSQL catálogo de roles.
• Mensajes, declaraciones preparadas, portales, colas, buffers de resultados y Los recuentos de conexiones tienen límites verificados.
• Las formas de protocolo y SQL no compatibles fallan explícitamente.

Límite de almacenamiento

• Las raíces de la base de datos y de la copia de seguridad son absolutas y están controladas por el operador.
• Los nombres y los caminos rechazan el cruce; restaurar rechaza un objetivo existente.
• WAL los marcos y los archivos de copia de seguridad se suman.
• El reconocimiento de confirmación sigue el límite de durabilidad documentado.
• La recuperación reproduce el estado comprometido de forma idempotente y reconstruye los resultados derivados. índices y cabezas.
• La edición directa de archivos omite las invariantes y no es compatible.

Contención de fallas

No objetivos arquitectónicos

Este mapa no implica un multiusuario remoto. Ridge Admin servicio, generales PostgreSQL administración, replicación, agrupación en clústeres, fragmentación, escucha de bases de datos públicas, SCRAM, identidades de certificados, completo PostgreSQL catálogos o sin restricciones driver/ORM compatibilidad.

Procedencia del diagrama

El artefacto interactivo se produjo con Archify 2.12 en modo Arquitectura utilizando la presentación estática clásica y la puerta de composición Showcase. Su fuente escrita es seed/docs/diagrams/ridge-runtime.architecture.json.

El mapa está respaldado por evidencia mediante la inspección del repositorio, pero intencionalmente no incorpora rutas de repositorios privados como evidencia de fuente en la que se puede hacer clic. Los archivos fuente enumerados anteriormente siguen siendo los anclajes de la revisión.