How man3327/scheduled-digital-vault1.0 works
Scheduled Digital Vault is a web application for preparing private file vaults, inviting recipients, scheduling a release instant, and granting downloads only when policy permits. The user journey runs through the React client and authenticated API: create a vault, upload and verify files, invite/accept members, schedule or cancel, then access audited downloads and delivery status. Background workers perform release, notification, and reconciliation work; the server’s authorization service independently checks every download against time and membership. Source excerpts show key routes and policy; some subsystem links are documented by the README or indexed references rather than inspected implementation.
Main entry points: vault.service.js Vault lifecycle · vault.routes.js Vault API routes · api.js API client · authorization.service.js Download policy
Components 28
Web client
- React application
client/src/App.jsx - Sign in and register
client/src/pages/AuthPage.jsx - Vault workspace
client/src/pages/Vaults.jsx - Vault details
client/src/pages/VaultDetail.jsx - Profile
client/src/pages/Profile.jsx - Session state
client/src/context/AuthContext.jsx - API client
client/src/services/api.js
HTTP API
- Vault API routes
server/src/routes/vault.routes.js - Authentication routes
server/src/routes/auth.routes.js - File routes
server/src/routes/file.routes.js - Membership routes
server/src/routes/member.routes.js - Audit routes
server/src/routes/audit.routes.js - Authentication and access
server/src/middleware/vaultAccess.js
Vault domain
- Vault lifecycle
server/src/services/vault.service.js - File handling
server/src/services/file.service.js - Download policy
server/src/services/authorization.service.js - Audit trail
server/src/services/audit.service.js - Vault records
server/src/models/Vault.js - File records
server/src/models/VaultFile.js - Membership records
server/src/models/VaultMember.js - File storage
server/src/config/storage.js
Release and delivery
- Job queues
server/src/jobs/queues.js - Release worker
server/src/jobs/release.worker.js - Reconciliation worker
server/src/jobs/reconcile.worker.js - Notification delivery
server/src/services/notification.service.js - Notification worker
server/src/jobs/notification.worker.js
Other components
- Vault user
- SMTP provider
Connections 37
- Vault user → React application: uses
README.md - React application → Session state: checks session
client/src/App.jsx - Sign in and register → Session state: signs in
client/src/context/AuthContext.jsx - Session state → API client: requests session
client/src/context/AuthContext.jsx - Vault workspace → API client: manages vaults
- Vault details → API client: manages files
client/src/pages/VaultDetail.jsx - Profile → API client: loads profile
- API client → Vault API routes: calls API
README.md - API client → Authentication routes: calls auth
README.md - Vault API routes → Vault lifecycle: delegates lifecycle
server/src/routes/vault.routes.js - Vault API routes → Membership routes: mounts routes
server/src/routes/vault.routes.js - Vault API routes → File routes: mounts routes
server/src/routes/vault.routes.js - Vault API routes → Audit routes: mounts routes
server/src/routes/vault.routes.js - Vault API routes → Authentication and access: checks membership
server/src/routes/vault.routes.js - Authentication routes → Authentication and access: authenticates
server/src/routes/auth.routes.js - Membership routes → Vault lifecycle: delegates membership
server/src/routes/member.routes.js - File routes → File handling: handles uploads
server/src/routes/file.routes.js - File routes → Download policy: authorizes download
server/src/routes/file.routes.js - File routes → File storage: streams file
server/src/routes/file.routes.js - Vault lifecycle → Job queues: enqueues release
server/src/services/vault.service.js - Vault lifecycle → File handling: recomputes uploads
server/src/services/vault.service.js - Vault lifecycle → Audit trail: records actions
server/src/services/vault.service.js - File handling → File storage: stores bytes
server/src/services/file.service.js - File handling → Audit trail: records file events
server/src/services/file.service.js - Download policy → Audit trail: records decisions
server/src/services/authorization.service.js - Download policy → Vault records: reads vault
server/src/services/authorization.service.js - Download policy → File records: reads file
server/src/services/authorization.service.js - Download policy → Membership records: checks recipient
server/src/services/authorization.service.js - Vault lifecycle → Vault records: updates state
server/src/services/vault.service.js - Vault lifecycle → Membership records: manages members
server/src/services/vault.service.js - Job queues → Release worker: dispatches jobs
server/src/jobs/release.worker.js - Release worker → Vault lifecycle: releases vault
server/src/jobs/release.worker.js - Release worker → Notification delivery: starts delivery
- Reconciliation worker → Notification delivery: repairs delivery
server/src/jobs/reconcile.worker.js - Reconciliation worker → File handling: repairs uploads
server/src/jobs/reconcile.worker.js - Notification worker → Notification delivery: processes jobs
- Notification delivery → SMTP provider: sends email
README.md