# dhars17/documentvault architecture

> Architecture diagram of the GitHub repository dhars17/documentvault, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dhars17/documentvault
- Repository: https://github.com/dhars17/documentvault

## Overview

This is a cross-platform document manager: users authenticate, browse/search documents from connected sources, inspect or upload files, find duplicates, and review license-expiry alerts. The app shell gates navigation on authentication; screens call a service layer that communicates with the Express API. The backend exposes separate route modules for authentication, cloud/local documents, AI, duplicate detection, uploads, and alerts. Evidence is limited to the provided excerpts and SOURCE INDEX; undocumented route internals and integrations are not expanded.

Main entry points: [`server/server.js`](https://github.com/dhars17/documentvault/blob/main/server/server.js) (Express API), [`src/navigation/AppNavigator.js`](https://github.com/dhars17/documentvault/blob/main/src/navigation/AppNavigator.js) (Screen Navigation), [`src/services/documentService.js`](https://github.com/dhars17/documentvault/blob/main/src/services/documentService.js) (Document Service), [`src/services/authService.js`](https://github.com/dhars17/documentvault/blob/main/src/services/authService.js) (Session Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile and Web App"]
  node_app["App Shell<br/>[App.js]"]
  node_navigation["Screen Navigation<br/>[AppNavigator.js]"]
  node_login["Login Screen<br/>[LoginScreen.js]"]
  node_home["Home Dashboard<br/>[HomeScreen.js]"]
  node_documents["Documents Screen<br/>[DocumentsScreen.js]"]
  node_docdetails["Document Details"]
  node_uploadscreen["Upload Screen<br/>[UploadScreen.js]"]
  node_hashtable["Hash Table Screen<br/>[HashTableScreen.js]"]
  node_details["App Details<br/>[DetailsScreen.js]"]
end

subgraph group_services["Client Services"]
  node_authservice["Session Service<br/>[authService.js]"]
  node_docservice["Document Service<br/>[documentService.js]"]
  node_license["License Detection"]
  node_apiservice["API Service<br/>[ApiService.js]"]
end

subgraph group_backend["API Backend"]
  node_api["Express API<br/>[server.js]"]
end

subgraph group_features["Document Features"]
  node_authroutes["Authentication API<br/>[auth.js]"]
  node_drive["Drive API<br/>[drive.js]"]
  node_gmail["Gmail API<br/>[gmail.js]"]
  node_local["Local Files API<br/>[local.js]"]
  node_ai["AI Features API<br/>[ai.js]"]
  node_duplicates["Duplicate Detection<br/>[duplicates.js]"]
  node_uploads["Upload API<br/>[uploads.js]"]
  node_alerts["Alerts API<br/>[alerts.js]"]
end

subgraph group_persistence["Persistence"]
  node_filemodel[("Uploaded File Records<br/>[UploadedFile.js]")]
  node_dbconfig["Database Connection<br/>[db.js]"]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"checks session"| node_authservice
node_app -->|"shows signed out"| node_login
node_app -->|"shows signed in"| node_navigation
node_login -->|"authenticates"| node_authservice
node_navigation -->|"routes to"| node_home
node_navigation -->|"routes to"| node_documents
node_navigation -->|"routes to"| node_docdetails
node_navigation -->|"routes to"| node_uploadscreen
node_navigation -->|"routes to"| node_hashtable
node_navigation -->|"routes to"| node_details
node_home -->|"gets token"| node_authservice
node_home -->|"loads documents"| node_docservice
node_home -->|"checks expiry"| node_license
node_documents -->|"searches and scans"| node_docservice
node_hashtable -->|"loads records"| node_docservice
node_docservice -->|"gets session"| node_authservice
node_authservice -->|"validates session"| node_api
node_docservice -->|"requests documents"| node_api
node_api -->|"mounts routes"| node_authroutes
node_api -->|"mounts routes"| node_drive
node_api -->|"mounts routes"| node_gmail
node_api -->|"mounts routes"| node_local
node_api -->|"mounts routes"| node_ai
node_api -->|"mounts routes"| node_duplicates
node_api -->|"mounts routes"| node_uploads
node_api -->|"mounts routes"| node_alerts
node_api -->|"loads connection"| node_dbconfig
node_duplicates -->|"uses authentication"| node_authroutes
node_drive -->|"uses authentication"| node_authroutes
node_gmail -->|"uses authentication"| node_authroutes
node_alerts -->|"uses authentication"| node_authroutes
node_duplicates -->|"reads records"| node_filemodel
node_uploads -->|"uses records"| node_filemodel

click node_app "https://github.com/dhars17/documentvault/blob/main/App.js"
click node_navigation "https://github.com/dhars17/documentvault/blob/main/src/navigation/AppNavigator.js"
click node_login "https://github.com/dhars17/documentvault/blob/main/src/screens/LoginScreen.js"
click node_home "https://github.com/dhars17/documentvault/blob/main/src/screens/HomeScreen.js"
click node_documents "https://github.com/dhars17/documentvault/blob/main/src/screens/DocumentsScreen.js"
click node_docdetails "https://github.com/dhars17/documentvault/blob/main/src/screens/DocumentDetailsScreen.js"
click node_uploadscreen "https://github.com/dhars17/documentvault/blob/main/src/screens/UploadScreen.js"
click node_hashtable "https://github.com/dhars17/documentvault/blob/main/src/screens/HashTableScreen.js"
click node_details "https://github.com/dhars17/documentvault/blob/main/src/screens/DetailsScreen.js"
click node_authservice "https://github.com/dhars17/documentvault/blob/main/src/services/authService.js"
click node_docservice "https://github.com/dhars17/documentvault/blob/main/src/services/documentService.js"
click node_license "https://github.com/dhars17/documentvault/blob/main/src/services/licenseDetectionService.js"
click node_apiservice "https://github.com/dhars17/documentvault/blob/main/src/services/ApiService.js"
click node_api "https://github.com/dhars17/documentvault/blob/main/server/server.js"
click node_authroutes "https://github.com/dhars17/documentvault/blob/main/server/routes/auth.js"
click node_drive "https://github.com/dhars17/documentvault/blob/main/server/routes/drive.js"
click node_gmail "https://github.com/dhars17/documentvault/blob/main/server/routes/gmail.js"
click node_local "https://github.com/dhars17/documentvault/blob/main/server/routes/local.js"
click node_ai "https://github.com/dhars17/documentvault/blob/main/server/routes/ai.js"
click node_duplicates "https://github.com/dhars17/documentvault/blob/main/server/routes/duplicates.js"
click node_uploads "https://github.com/dhars17/documentvault/blob/main/server/routes/uploads.js"
click node_alerts "https://github.com/dhars17/documentvault/blob/main/server/routes/alerts.js"
click node_filemodel "https://github.com/dhars17/documentvault/blob/main/server/models/UploadedFile.js"
click node_dbconfig "https://github.com/dhars17/documentvault/blob/main/server/db.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_app,node_navigation,node_login,node_home,node_documents,node_docdetails,node_uploadscreen,node_hashtable,node_details,node_user toneBlue
class node_authservice,node_docservice,node_license,node_apiservice toneAmber
class node_api toneMint
class node_authroutes,node_drive,node_gmail,node_local,node_ai,node_duplicates,node_uploads,node_alerts toneRose
class node_filemodel,node_dbconfig toneIndigo
```

## Components

### Mobile and Web App

- [App Shell](https://github.com/dhars17/documentvault/blob/main/App.js): `App.js`
- [Screen Navigation](https://github.com/dhars17/documentvault/blob/main/src/navigation/AppNavigator.js): `src/navigation/AppNavigator.js`
- [Login Screen](https://github.com/dhars17/documentvault/blob/main/src/screens/LoginScreen.js): `src/screens/LoginScreen.js`
- [Home Dashboard](https://github.com/dhars17/documentvault/blob/main/src/screens/HomeScreen.js): `src/screens/HomeScreen.js`
- [Documents Screen](https://github.com/dhars17/documentvault/blob/main/src/screens/DocumentsScreen.js): `src/screens/DocumentsScreen.js`
- [Document Details](https://github.com/dhars17/documentvault/blob/main/src/screens/DocumentDetailsScreen.js): `src/screens/DocumentDetailsScreen.js`
- [Upload Screen](https://github.com/dhars17/documentvault/blob/main/src/screens/UploadScreen.js): `src/screens/UploadScreen.js`
- [Hash Table Screen](https://github.com/dhars17/documentvault/blob/main/src/screens/HashTableScreen.js): `src/screens/HashTableScreen.js`
- [App Details](https://github.com/dhars17/documentvault/blob/main/src/screens/DetailsScreen.js): `src/screens/DetailsScreen.js`

### Client Services

- [Session Service](https://github.com/dhars17/documentvault/blob/main/src/services/authService.js): `src/services/authService.js`
- [Document Service](https://github.com/dhars17/documentvault/blob/main/src/services/documentService.js): `src/services/documentService.js`
- [License Detection](https://github.com/dhars17/documentvault/blob/main/src/services/licenseDetectionService.js): `src/services/licenseDetectionService.js`
- [API Service](https://github.com/dhars17/documentvault/blob/main/src/services/ApiService.js): `src/services/ApiService.js`

### API Backend

- [Express API](https://github.com/dhars17/documentvault/blob/main/server/server.js): `server/server.js`

### Document Features

- [Authentication API](https://github.com/dhars17/documentvault/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Drive API](https://github.com/dhars17/documentvault/blob/main/server/routes/drive.js): `server/routes/drive.js`
- [Gmail API](https://github.com/dhars17/documentvault/blob/main/server/routes/gmail.js): `server/routes/gmail.js`
- [Local Files API](https://github.com/dhars17/documentvault/blob/main/server/routes/local.js): `server/routes/local.js`
- [AI Features API](https://github.com/dhars17/documentvault/blob/main/server/routes/ai.js): `server/routes/ai.js`
- [Duplicate Detection](https://github.com/dhars17/documentvault/blob/main/server/routes/duplicates.js): `server/routes/duplicates.js`
- [Upload API](https://github.com/dhars17/documentvault/blob/main/server/routes/uploads.js): `server/routes/uploads.js`
- [Alerts API](https://github.com/dhars17/documentvault/blob/main/server/routes/alerts.js): `server/routes/alerts.js`

### Persistence

- [Uploaded File Records](https://github.com/dhars17/documentvault/blob/main/server/models/UploadedFile.js): `server/models/UploadedFile.js`
- [Database Connection](https://github.com/dhars17/documentvault/blob/main/server/db.js): `server/db.js`

### Other components

- **User**

## Connections

- User → App Shell: opens (evidence: `App.js`)
- App Shell → Session Service: checks session (evidence: `App.js`)
- App Shell → Login Screen: shows signed out (evidence: `App.js`)
- App Shell → Screen Navigation: shows signed in (evidence: `App.js`)
- Login Screen → Session Service: authenticates (evidence: `src/screens/LoginScreen.js`)
- Screen Navigation → Home Dashboard: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen Navigation → Documents Screen: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen Navigation → Document Details: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen Navigation → Upload Screen: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen Navigation → Hash Table Screen: routes to (evidence: `src/navigation/AppNavigator.js`)
- Screen Navigation → App Details: routes to (evidence: `src/navigation/AppNavigator.js`)
- Home Dashboard → Session Service: gets token (evidence: `src/screens/HomeScreen.js`)
- Home Dashboard → Document Service: loads documents (evidence: `src/screens/HomeScreen.js`)
- Home Dashboard → License Detection: checks expiry (evidence: `src/screens/HomeScreen.js`)
- Documents Screen → Document Service: searches and scans (evidence: `src/screens/DocumentsScreen.js`)
- Hash Table Screen → Document Service: loads records (evidence: `src/screens/HashTableScreen.js`)
- Document Service → Session Service: gets session (evidence: `src/services/documentService.js`)
- Session Service → Express API: validates session (evidence: `src/services/authService.js`)
- Document Service → Express API: requests documents (evidence: `src/services/documentService.js`)
- Express API → Authentication API: mounts routes (evidence: `server/server.js`)
- Express API → Drive API: mounts routes (evidence: `server/server.js`)
- Express API → Gmail API: mounts routes (evidence: `server/server.js`)
- Express API → Local Files API: mounts routes (evidence: `server/server.js`)
- Express API → AI Features API: mounts routes (evidence: `server/server.js`)
- Express API → Duplicate Detection: mounts routes (evidence: `server/server.js`)
- Express API → Upload API: mounts routes (evidence: `server/server.js`)
- Express API → Alerts API: mounts routes (evidence: `server/server.js`)
- Express API → Database Connection: loads connection (evidence: `server/server.js`)
- Duplicate Detection → Authentication API: uses authentication (evidence: `server/routes/duplicates.js`)
- Drive API → Authentication API: uses authentication (evidence: `server/routes/drive.js`)
- Gmail API → Authentication API: uses authentication (evidence: `server/routes/gmail.js`)
- Alerts API → Authentication API: uses authentication (evidence: `server/routes/alerts.js`)
- Duplicate Detection → Uploaded File Records: reads records (evidence: `server/routes/duplicates.js`)
- Upload API → Uploaded File Records: uses records (evidence: `server/routes/uploads.js`)
