Saltar a contenido

Bóveda y archivos

Responsabilidad

El dominio Vault mapea Markdown portátil y activos a páginas, carpetas, archivos adjuntos, búsquedas, esquemas, historias, basura, exportaciones, citas y selección de múltiples saltos. Es el dominio más grande y el propietario principal de la soberanía de datos.

Ciclo de vida de la página

sequenceDiagram
    participant UI as Vault UI or editor
    participant R as vault_routes
    participant C as Vault context
    participant F as File provider
    participant I as Page and link indexes
    UI->>R: Read page by stable id
    R->>C: Resolve authorized active vault
    C->>I: Resolve id to current path
    I->>F: Read Markdown when cache is insufficient
    F-->>R: Content, metadata, and ETag
    R-->>UI: Editable representation
    UI->>R: Save with expected ETag
    R->>F: Atomic write if ETag still matches
    R->>I: Refresh page and relationship entries

La identidad de página está separada del título y la ruta. La materia frontal se normaliza en los límites de escritura mientras se conservan las claves de usuario. .gnosi sidecars cuando se expone en la materia delantera contaminaría o desestabilizaría el contenido portátil.

Índices y cachés

El índice de páginas acelera el listado, la resolución de identificadores, el acceso a la materia frontal y la búsqueda. El índice de enlaces wiki resuelve los enlaces entrantes para que los renombrados de página puedan actualizar las referencias. Los cachés de cuerpo y documentos analizados evitan las lecturas repetidas.

Iniciar primero carga instantáneas de disco válidas, luego comienza el trabajo de actualización. Un análisis parcial de proveedor de archivos está marcado parcial y no puede reemplazar una caché completa conocida. Los fallos por archivo están aislados de modo que un marcador de posición solo en línea o huérfano no elimina el resto del almacén de una respuesta.

Proveedores de archivos

La abstracción del proveedor selecciona local, OneDrive, iCloud Drive, Google Drive o comportamiento con conocimiento de Nextcloud. Path; el adaptador añade detección de marcadores de posición, hidratación, disponibilidad y asignación de rutas.

Native OneDrive operation delega la hidratación en una GUI-sesión open acción cuando el LaunchAgent no puede materializar un archivo en línea. Las implementaciones Docker pueden utilizar un punto final de calentamiento del host porque el contenedor lee cruzar otro límite.

Adjuntos y propiedades valoradas por archivos

Los escritos eligen un objetivo permitido bajo el almacén activo, normalizan los nombres, evitan colisiones y devuelven metadatos portátiles. Los enlaces de archivos se re-raoted en el momento de lectura del host actual. Las operaciones de carga y eliminación validan la contención; una ruta proporcionada por el cliente nunca es suficiente autorización.

Papelera y operaciones destructivas

La eliminación ordinaria es recuperable: las páginas y los activos relacionados se mueven a través del modelo de basura Vault. Purga es distinta y elimina el contenido más metadatos derivados y relaciones inversas. La eliminación del registro de Vault elimina la fila de registro lógica por defecto; la eliminación de carpetas físicas requiere una señal explícita separada y comprobaciones de contención más fuertes.

Variantes de la moneda

  • Los Etags rancios rechazan sobrescrituras.
  • Registro y creación de notas diarias utilizan recheques de carrera-seguros.
  • Página, registro, índice de enlaces y actualizaciones de sidecar siguen siendo consistentes después de un renombrar o borrar.
  • Las rutas absolutas recibidas de un cliente se resuelven bajo raíces aprobadas.
  • Los enlaces de Symlinks y la trayectoria transversal no pueden escapar del límite de bóveda seleccionado.
  • Los viajes de ida y vuelta de Markdown preservan contenido sensible a la fuga y sintaxis wikilink.

Interfaz

VaultDashboard Posee historial de navegación y selecciona superficies de página, tabla, dibujo, galería, tablero, calendario, línea de tiempo, fuente o lector. VaultShell proporciona el marco; los componentes especializados implementan editores y vistas. La interfaz de cachés de estado de interacción, pero trata el contenido de página de backend y Etags como autoritative.

Enfoque de verificación

Ejecute Etag condition, contención de rutas, E/S seguro, carrera de registro, renombrar, basura/purga, numeración de adjuntos, relación, actualización de índices y flujos representativos de Playwright Vault. Los incidentes de proveedores de nube también requieren un marcador de posición real porque las pruebas de fijación locales no pueden reproducir el comportamiento del proveedor de archivos.