How mukilanmuthuvalathan/vault-object-storage works
Vault is a distributed object store with an operator dashboard. A client submits an object operation to the HTTP gateway; the gateway routes it to the vault engine, which handles versioned metadata and storage, then returns the result. The engine coordinates Raft metadata, artifact transport, and background health and repair work. The README also describes placement, nearest-replica reads, erasure coding, rebalancing, tombstones, and integrity scans; those domain stages are represented at the engine boundary because their implementation files are not in the supplied tree. Links reflect shown calls or documented relationships.
Main entry points: vault-engine.js Object workflows · server.js HTTP server · storage-client.js Storage transport · gcs-mirror.js GCS mirror
Components 14
Operator experience
- Dashboard
public/app.js
HTTP gateway
- HTTP server
src/server.js - API key auth
src/gateway/auth.js - Rate limiter
src/gateway/rate-limiter.js
Vault engine
- Object workflows
src/core/vault-engine.js - Per-key locks
src/core/lock-manager.js - Raft metadata
src/control/raft-metadata.js - Storage transport
src/storage/storage-client.js - Storage nodes
src/storage/storage-node-server.js
Cluster operations
- Health monitor
src/background/health-monitor.js - Repair scheduler
src/background/repair-scheduler.js - GCS mirror
src/integrations/gcs-mirror.js
Other components
- Client / operator
- Google Cloud Storage
Connections 13
- Client / operator → HTTP server: submits requests
README.md - Client / operator → Dashboard: uses dashboard
README.md - HTTP server → Dashboard: serves static files
src/server.js - HTTP server → Object workflows: routes object operations
src/server.js - HTTP server → API key auth: checks credentials
src/server.js - HTTP server → GCS mirror: mirrors writes
src/server.js - Object workflows → Per-key locks: serializes key writes
src/core/vault-engine.js - Object workflows → Raft metadata: commits catalog
src/core/vault-engine.js - Object workflows → Storage transport: transfers artifacts
src/core/vault-engine.js - Storage transport → Storage nodes: sends artifact requests
src/storage/storage-client.js - Object workflows → Health monitor: configures integrity scans
src/core/vault-engine.js - Object workflows → Repair scheduler: schedules repairs
src/core/vault-engine.js - GCS mirror → Google Cloud Storage: uploads objects
src/integrations/gcs-mirror.js