# man3327/scheduled-digital-vault architecture

> Architecture diagram of the GitHub repository man3327/scheduled-digital-vault, 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-vault
- Repository: https://github.com/man3327/scheduled-digital-vault

## Overview

This repository is a Node.js authentication API. A client sends registration, login, logout, or current-user requests through the Express app and auth routes; handlers call the auth service, which validates credentials or manages tokens and persists users in MongoDB. The API also provides a health endpoint and shared request, security, validation, and error middleware. The README is empty; the graph reflects the source index and excerpts, so it omits undocumented runtime relationships.

Main entry points: [`server/src/app.js`](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/app.js) (Express app), [`server/src/routes/auth.routes.js`](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/routes/auth.routes.js) (Auth routes), [`server/src/services/auth.service.js`](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/services/auth.service.js) (Auth service), [`server/src/config/database.js`](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/config/database.js) (Database connection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["Server startup<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_routes["Auth routes<br/>[auth.routes.js]"]
  node_health["Health endpoint<br/>[app.js]"]
end

subgraph group_auth["Authentication"]
  node_controller["Auth handlers<br/>[auth.controller.js]"]
  node_authservice["Auth service<br/>[auth.service.js]"]
  node_validation["Request validation<br/>[validate.js]"]
  node_authschema["Auth schemas<br/>[auth.schema.js]"]
  node_authmiddleware["Authentication middleware<br/>[authenticate.js]"]
  node_ratelimit["Auth rate limit<br/>[rateLimit.js]"]
end

subgraph group_persistence["Persistence and security"]
  node_user["User model<br/>[User.js]"]
  node_mongodb[("MongoDB")]
  node_cookies["Session cookies<br/>[cookies.js]"]
  node_database["Database connection<br/>[database.js]"]
end

subgraph group_shared["Shared infrastructure"]
  node_csrf["CSRF guard<br/>[csrf.js]"]
  node_requestid["Request IDs<br/>[requestId.js]"]
  node_errors["Error handling<br/>[errorHandler.js]"]
  node_errorutils["App errors<br/>[errors.js]"]
  node_config["Environment config<br/>[env.js]"]
  node_logger["Structured logger<br/>[logger.js]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_app
node_server -->|"connects"| node_database
node_server -->|"starts"| node_app
node_app -->|"installs"| node_requestid
node_app -->|"installs"| node_csrf
node_app -->|"mounts"| node_routes
node_app -->|"installs"| node_errors
node_app -->|"serves"| node_health
node_health -->|"checks state"| node_mongodb
node_routes -->|"applies"| node_ratelimit
node_routes -->|"applies"| node_validation
node_routes -->|"validates with"| node_authschema
node_routes -->|"protects routes"| node_authmiddleware
node_routes -->|"dispatches"| node_controller
node_controller -->|"calls"| node_authservice
node_controller -->|"sets and clears"| node_cookies
node_authmiddleware -->|"authenticates with"| node_authservice
node_authmiddleware -->|"reads token"| node_cookies
node_authservice -->|"reads and updates"| node_user
node_user -.->|"persists records"| node_mongodb
node_database -->|"connects"| node_mongodb
node_authservice -->|"reads settings"| node_config
node_cookies -->|"reads settings"| node_config
node_database -->|"reads settings"| node_config
node_authservice -->|"throws errors"| node_errorutils
node_errors -->|"formats"| node_errorutils
node_errors -->|"logs failures"| node_logger
node_database -->|"logs connection"| node_logger
node_server -->|"logs lifecycle"| node_logger

click node_server "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/server.js"
click node_app "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/app.js"
click node_routes "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/routes/auth.routes.js"
click node_health "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/app.js"
click node_controller "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/controllers/auth.controller.js"
click node_authservice "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/services/auth.service.js"
click node_validation "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/validate.js"
click node_authschema "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/validators/auth.schema.js"
click node_authmiddleware "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/authenticate.js"
click node_ratelimit "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/rateLimit.js"
click node_user "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/models/User.js"
click node_cookies "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/cookies.js"
click node_csrf "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/csrf.js"
click node_requestid "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/requestId.js"
click node_errors "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/errorHandler.js"
click node_errorutils "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/errors.js"
click node_config "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/config/env.js"
click node_database "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/config/database.js"
click node_logger "https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/logger.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_server,node_app,node_routes,node_health,node_client toneBlue
class node_controller,node_authservice,node_validation,node_authschema,node_authmiddleware,node_ratelimit toneAmber
class node_user,node_mongodb,node_cookies,node_database toneMint
class node_csrf,node_requestid,node_errors,node_errorutils,node_config,node_logger toneRose
```

## Components

### API runtime

- [Server startup](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/server.js): `server/src/server.js`
- [Express app](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/app.js): `server/src/app.js`
- [Auth routes](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/routes/auth.routes.js): `server/src/routes/auth.routes.js`
- [Health endpoint](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/app.js): `server/src/app.js`

### Authentication

- [Auth handlers](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/controllers/auth.controller.js): `server/src/controllers/auth.controller.js`
- [Auth service](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/services/auth.service.js): `server/src/services/auth.service.js`
- [Request validation](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/validate.js): `server/src/middleware/validate.js`
- [Auth schemas](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/validators/auth.schema.js): `server/src/validators/auth.schema.js`
- [Authentication middleware](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/authenticate.js): `server/src/middleware/authenticate.js`
- [Auth rate limit](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/rateLimit.js): `server/src/middleware/rateLimit.js`

### Persistence and security

- [User model](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/models/User.js): `server/src/models/User.js`
- **MongoDB**
- [Session cookies](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/cookies.js): `server/src/utils/cookies.js`
- [Database connection](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/config/database.js): `server/src/config/database.js`

### Shared infrastructure

- [CSRF guard](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/csrf.js): `server/src/middleware/csrf.js`
- [Request IDs](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/requestId.js): `server/src/middleware/requestId.js`
- [Error handling](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/middleware/errorHandler.js): `server/src/middleware/errorHandler.js`
- [App errors](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/errors.js): `server/src/utils/errors.js`
- [Environment config](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/config/env.js): `server/src/config/env.js`
- [Structured logger](https://github.com/man3327/scheduled-digital-vault/blob/main/server/src/utils/logger.js): `server/src/utils/logger.js`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `server/src/app.js`)
- Server startup → Database connection: connects (evidence: `server/src/server.js`)
- Server startup → Express app: starts (evidence: `server/src/server.js`)
- Express app → Request IDs: installs (evidence: `server/src/app.js`)
- Express app → CSRF guard: installs (evidence: `server/src/app.js`)
- Express app → Auth routes: mounts (evidence: `server/src/app.js`)
- Express app → Error handling: installs (evidence: `server/src/app.js`)
- Express app → Health endpoint: serves (evidence: `server/src/app.js`)
- Health endpoint → MongoDB: checks state (evidence: `server/src/app.js`)
- Auth routes → Auth rate limit: applies (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Request validation: applies (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Auth schemas: validates with (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Authentication middleware: protects routes (evidence: `server/src/routes/auth.routes.js`)
- Auth routes → Auth handlers: dispatches (evidence: `server/src/routes/auth.routes.js`)
- Auth handlers → Auth service: calls (evidence: `server/src/controllers/auth.controller.js`)
- Auth handlers → Session cookies: sets and clears (evidence: `server/src/controllers/auth.controller.js`)
- Authentication middleware → Auth service: authenticates with (evidence: `server/src/middleware/authenticate.js`)
- Authentication middleware → Session cookies: reads token (evidence: `server/src/middleware/authenticate.js`)
- Auth service → User model: reads and updates (evidence: `server/src/services/auth.service.js`)
- User model → MongoDB: persists records
- Database connection → MongoDB: connects (evidence: `server/src/config/database.js`)
- Auth service → Environment config: reads settings (evidence: `server/src/services/auth.service.js`)
- Session cookies → Environment config: reads settings (evidence: `server/src/utils/cookies.js`)
- Database connection → Environment config: reads settings (evidence: `server/src/config/database.js`)
- Auth service → App errors: throws errors (evidence: `server/src/services/auth.service.js`)
- Error handling → App errors: formats (evidence: `server/src/middleware/errorHandler.js`)
- Error handling → Structured logger: logs failures (evidence: `server/src/middleware/errorHandler.js`)
- Database connection → Structured logger: logs connection (evidence: `server/src/config/database.js`)
- Server startup → Structured logger: logs lifecycle (evidence: `server/src/server.js`)
