# man3327/scheduled-digital-vault1.0 architecture

> Architecture diagram of the GitHub repository man3327/scheduled-digital-vault1.0, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/man3327/scheduled-digital-vault1.0
- Repository: https://github.com/man3327/scheduled-digital-vault1.0

## Overview

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: [`server/src/services/vault.service.js`](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/vault.service.js) (Vault lifecycle), [`server/src/routes/vault.routes.js`](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/vault.routes.js) (Vault API routes), [`client/src/services/api.js`](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/services/api.js) (API client), [`server/src/services/authorization.service.js`](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/authorization.service.js) (Download policy)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_webapp["React application<br/>[App.jsx]"]
  node_authui["Sign in and register<br/>[AuthPage.jsx]"]
  node_vaultui["Vault workspace<br/>[Vaults.jsx]"]
  node_detailui["Vault details<br/>[VaultDetail.jsx]"]
  node_profileui["Profile<br/>[Profile.jsx]"]
  node_authcontext["Session state<br/>[AuthContext.jsx]"]
  node_clientapi["API client<br/>[api.js]"]
end

subgraph group_api["HTTP API"]
  node_http["Vault API routes<br/>[vault.routes.js]"]
  node_authroutes["Authentication routes<br/>[auth.routes.js]"]
  node_fileroutes["File routes<br/>[file.routes.js]"]
  node_memberroutes["Membership routes<br/>[member.routes.js]"]
  node_auditroutes["Audit routes<br/>[audit.routes.js]"]
  node_access["Authentication and access<br/>[vaultAccess.js]"]
end

subgraph group_domain["Vault domain"]
  node_vaultservice["Vault lifecycle<br/>[vault.service.js]"]
  node_fileservice["File handling<br/>[file.service.js]"]
  node_policy["Download policy"]
  node_audit["Audit trail<br/>[audit.service.js]"]
  node_vaultdb[("Vault records<br/>[Vault.js]")]
  node_filedb[("File records<br/>[VaultFile.js]")]
  node_memberdb[("Membership records<br/>[VaultMember.js]")]
  node_storage[("File storage<br/>[storage.js]")]
end

subgraph group_async["Release and delivery"]
  node_queues["Job queues<br/>[queues.js]"]
  node_releaseworker["Release worker<br/>[release.worker.js]"]
  node_reconcileworker["Reconciliation worker"]
  node_notifyservice["Notification delivery"]
  node_notifyworker["Notification worker"]
end

node_user(("Vault user"))
node_smtp["SMTP provider"]

node_user -->|"uses"| node_webapp
node_webapp -->|"checks session"| node_authcontext
node_authui -->|"signs in"| node_authcontext
node_authcontext -->|"requests session"| node_clientapi
node_vaultui -.->|"manages vaults"| node_clientapi
node_detailui -->|"manages files"| node_clientapi
node_profileui -.->|"loads profile"| node_clientapi
node_clientapi -->|"calls API"| node_http
node_clientapi -->|"calls auth"| node_authroutes
node_http -->|"delegates lifecycle"| node_vaultservice
node_http -->|"mounts routes"| node_memberroutes
node_http -->|"mounts routes"| node_fileroutes
node_http -->|"mounts routes"| node_auditroutes
node_http -->|"checks membership"| node_access
node_authroutes -->|"authenticates"| node_access
node_memberroutes -->|"delegates membership"| node_vaultservice
node_fileroutes -->|"handles uploads"| node_fileservice
node_fileroutes -->|"authorizes download"| node_policy
node_fileroutes -->|"streams file"| node_storage
node_vaultservice -->|"enqueues release"| node_queues
node_vaultservice -->|"recomputes uploads"| node_fileservice
node_vaultservice -->|"records actions"| node_audit
node_fileservice -->|"stores bytes"| node_storage
node_fileservice -->|"records file events"| node_audit
node_policy -->|"records decisions"| node_audit
node_policy -->|"reads vault"| node_vaultdb
node_policy -->|"reads file"| node_filedb
node_policy -->|"checks recipient"| node_memberdb
node_vaultservice -->|"updates state"| node_vaultdb
node_vaultservice -->|"manages members"| node_memberdb
node_queues -->|"dispatches jobs"| node_releaseworker
node_releaseworker -->|"releases vault"| node_vaultservice
node_releaseworker -->|"starts delivery"| node_notifyservice
node_reconcileworker -->|"repairs delivery"| node_notifyservice
node_reconcileworker -->|"repairs uploads"| node_fileservice
node_notifyworker -.->|"processes jobs"| node_notifyservice
node_notifyservice -->|"sends email"| node_smtp

click node_webapp "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/App.jsx"
click node_authui "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/AuthPage.jsx"
click node_vaultui "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/Vaults.jsx"
click node_detailui "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/VaultDetail.jsx"
click node_profileui "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/Profile.jsx"
click node_authcontext "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/context/AuthContext.jsx"
click node_clientapi "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/services/api.js"
click node_http "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/vault.routes.js"
click node_authroutes "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/auth.routes.js"
click node_fileroutes "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/file.routes.js"
click node_memberroutes "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/member.routes.js"
click node_auditroutes "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/audit.routes.js"
click node_access "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/middleware/vaultAccess.js"
click node_vaultservice "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/vault.service.js"
click node_fileservice "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/file.service.js"
click node_policy "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/authorization.service.js"
click node_audit "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/audit.service.js"
click node_vaultdb "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/Vault.js"
click node_filedb "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/VaultFile.js"
click node_memberdb "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/VaultMember.js"
click node_storage "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/config/storage.js"
click node_queues "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/queues.js"
click node_releaseworker "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/release.worker.js"
click node_reconcileworker "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/reconcile.worker.js"
click node_notifyservice "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/notification.service.js"
click node_notifyworker "https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/notification.worker.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_authui,node_vaultui,node_detailui,node_profileui,node_authcontext,node_clientapi,node_user toneBlue
class node_http,node_authroutes,node_fileroutes,node_memberroutes,node_auditroutes,node_access toneAmber
class node_vaultservice,node_fileservice,node_policy,node_audit,node_vaultdb,node_filedb,node_memberdb,node_storage toneMint
class node_queues,node_releaseworker,node_reconcileworker,node_notifyservice,node_notifyworker toneRose
class node_smtp toneIndigo
```

## Components

### Web client

- [React application](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Sign in and register](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/AuthPage.jsx): `client/src/pages/AuthPage.jsx`
- [Vault workspace](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/Vaults.jsx): `client/src/pages/Vaults.jsx`
- [Vault details](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/VaultDetail.jsx): `client/src/pages/VaultDetail.jsx`
- [Profile](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/pages/Profile.jsx): `client/src/pages/Profile.jsx`
- [Session state](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [API client](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/client/src/services/api.js): `client/src/services/api.js`

### HTTP API

- [Vault API routes](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/vault.routes.js): `server/src/routes/vault.routes.js`
- [Authentication routes](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [File routes](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/file.routes.js): `server/src/routes/file.routes.js`
- [Membership routes](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/member.routes.js): `server/src/routes/member.routes.js`
- [Audit routes](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/routes/audit.routes.js): `server/src/routes/audit.routes.js`
- [Authentication and access](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/middleware/vaultAccess.js): `server/src/middleware/vaultAccess.js`

### Vault domain

- [Vault lifecycle](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/vault.service.js): `server/src/services/vault.service.js`
- [File handling](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/file.service.js): `server/src/services/file.service.js`
- [Download policy](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/authorization.service.js): `server/src/services/authorization.service.js`
- [Audit trail](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/audit.service.js): `server/src/services/audit.service.js`
- [Vault records](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/Vault.js): `server/src/models/Vault.js`
- [File records](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/VaultFile.js): `server/src/models/VaultFile.js`
- [Membership records](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/models/VaultMember.js): `server/src/models/VaultMember.js`
- [File storage](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/config/storage.js): `server/src/config/storage.js`

### Release and delivery

- [Job queues](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/queues.js): `server/src/jobs/queues.js`
- [Release worker](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/release.worker.js): `server/src/jobs/release.worker.js`
- [Reconciliation worker](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/reconcile.worker.js): `server/src/jobs/reconcile.worker.js`
- [Notification delivery](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/services/notification.service.js): `server/src/services/notification.service.js`
- [Notification worker](https://github.com/man3327/scheduled-digital-vault1.0/blob/main/server/src/jobs/notification.worker.js): `server/src/jobs/notification.worker.js`

### Other components

- **Vault user**
- **SMTP provider**

## Connections

- Vault user → React application: uses (evidence: `README.md`)
- React application → Session state: checks session (evidence: `client/src/App.jsx`)
- Sign in and register → Session state: signs in (evidence: `client/src/context/AuthContext.jsx`)
- Session state → API client: requests session (evidence: `client/src/context/AuthContext.jsx`)
- Vault workspace → API client: manages vaults
- Vault details → API client: manages files (evidence: `client/src/pages/VaultDetail.jsx`)
- Profile → API client: loads profile
- API client → Vault API routes: calls API (evidence: `README.md`)
- API client → Authentication routes: calls auth (evidence: `README.md`)
- Vault API routes → Vault lifecycle: delegates lifecycle (evidence: `server/src/routes/vault.routes.js`)
- Vault API routes → Membership routes: mounts routes (evidence: `server/src/routes/vault.routes.js`)
- Vault API routes → File routes: mounts routes (evidence: `server/src/routes/vault.routes.js`)
- Vault API routes → Audit routes: mounts routes (evidence: `server/src/routes/vault.routes.js`)
- Vault API routes → Authentication and access: checks membership (evidence: `server/src/routes/vault.routes.js`)
- Authentication routes → Authentication and access: authenticates (evidence: `server/src/routes/auth.routes.js`)
- Membership routes → Vault lifecycle: delegates membership (evidence: `server/src/routes/member.routes.js`)
- File routes → File handling: handles uploads (evidence: `server/src/routes/file.routes.js`)
- File routes → Download policy: authorizes download (evidence: `server/src/routes/file.routes.js`)
- File routes → File storage: streams file (evidence: `server/src/routes/file.routes.js`)
- Vault lifecycle → Job queues: enqueues release (evidence: `server/src/services/vault.service.js`)
- Vault lifecycle → File handling: recomputes uploads (evidence: `server/src/services/vault.service.js`)
- Vault lifecycle → Audit trail: records actions (evidence: `server/src/services/vault.service.js`)
- File handling → File storage: stores bytes (evidence: `server/src/services/file.service.js`)
- File handling → Audit trail: records file events (evidence: `server/src/services/file.service.js`)
- Download policy → Audit trail: records decisions (evidence: `server/src/services/authorization.service.js`)
- Download policy → Vault records: reads vault (evidence: `server/src/services/authorization.service.js`)
- Download policy → File records: reads file (evidence: `server/src/services/authorization.service.js`)
- Download policy → Membership records: checks recipient (evidence: `server/src/services/authorization.service.js`)
- Vault lifecycle → Vault records: updates state (evidence: `server/src/services/vault.service.js`)
- Vault lifecycle → Membership records: manages members (evidence: `server/src/services/vault.service.js`)
- Job queues → Release worker: dispatches jobs (evidence: `server/src/jobs/release.worker.js`)
- Release worker → Vault lifecycle: releases vault (evidence: `server/src/jobs/release.worker.js`)
- Release worker → Notification delivery: starts delivery
- Reconciliation worker → Notification delivery: repairs delivery (evidence: `server/src/jobs/reconcile.worker.js`)
- Reconciliation worker → File handling: repairs uploads (evidence: `server/src/jobs/reconcile.worker.js`)
- Notification worker → Notification delivery: processes jobs
- Notification delivery → SMTP provider: sends email (evidence: `README.md`)
