# joshuafrancisjf4/securevault architecture

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

- Interactive diagram: https://gitdiagram.com/joshuafrancisjf4/securevault
- Repository: https://github.com/joshuafrancisjf4/securevault

## Overview

SecureVault is a Flask file-vault application. A user signs up or logs in, creates a password-protected vault, opens it, then uploads, views, downloads, or deletes files. The sampled app.py implements these stages directly, storing user and vault records in MongoDB and vault files under uploads/. The README documents the same core capabilities. Templates and external MongoDB are represented at directory/service level; no separate authorization or encryption subsystem is evidenced in the sampled code.

Main entry points: [`uploads`](https://github.com/joshuafrancisjf4/securevault/tree/main/uploads) (Vault File Storage), [`app.py`](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py) (Open Vault), [`templates`](https://github.com/joshuafrancisjf4/securevault/tree/main/templates) (HTML Templates)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["User Identity"]
  node_auth["Signup and Login<br/>[app.py]"]
  node_dashboard["Dashboard<br/>[app.py]"]
end

subgraph group_vault["Vault Access"]
  node_vault_create["Create Vault<br/>[app.py]"]
  node_vault_list["List Vaults<br/>[app.py]"]
  node_vault_access["Open Vault<br/>[app.py]"]
end

subgraph group_files["File Operations"]
  node_upload["Upload Files<br/>[app.py]"]
  node_view_download["View and Download<br/>[app.py]"]
  node_delete["Delete Files<br/>[app.py]"]
end

subgraph group_persistence["Persistence and UI"]
  node_mongo[("MongoDB")]
  node_file_store[("Vault File Storage")]
  node_templates["HTML Templates"]
end

node_user(("User"))

node_user -->|"submits credentials"| node_auth
node_auth -->|"checks or saves users"| node_mongo
node_user -->|"requests dashboard"| node_dashboard
node_dashboard -->|"renders page"| node_templates
node_user -->|"creates vault"| node_vault_create
node_vault_create -->|"saves vault record"| node_mongo
node_vault_create -->|"creates vault folder"| node_file_store
node_user -->|"requests vault list"| node_vault_list
node_vault_list -->|"queries user vaults"| node_mongo
node_vault_list -->|"renders vault list"| node_templates
node_user -->|"enters vault password"| node_vault_access
node_vault_access -->|"checks vault ownership and password"| node_mongo
node_vault_access -->|"lists vault files"| node_file_store
node_vault_access -->|"renders vault contents"| node_templates
node_user -->|"uploads file"| node_upload
node_upload -->|"saves file"| node_file_store
node_user -->|"requests file"| node_view_download
node_view_download -->|"serves file"| node_file_store
node_user -->|"deletes file"| node_delete
node_delete -->|"removes file"| node_file_store

click node_auth "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_dashboard "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_vault_create "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_vault_list "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_vault_access "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_upload "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_view_download "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_delete "https://github.com/joshuafrancisjf4/securevault/blob/main/app.py"
click node_file_store "https://github.com/joshuafrancisjf4/securevault/tree/main/uploads"
click node_templates "https://github.com/joshuafrancisjf4/securevault/tree/main/templates"

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_auth,node_dashboard,node_user toneBlue
class node_vault_create,node_vault_list,node_vault_access toneAmber
class node_upload,node_view_download,node_delete toneMint
class node_mongo,node_file_store,node_templates toneRose
```

## Components

### User Identity

- [Signup and Login](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`
- [Dashboard](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`

### Vault Access

- [Create Vault](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`
- [List Vaults](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`
- [Open Vault](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`

### File Operations

- [Upload Files](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`
- [View and Download](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`
- [Delete Files](https://github.com/joshuafrancisjf4/securevault/blob/main/app.py): `app.py`

### Persistence and UI

- **MongoDB**
- [Vault File Storage](https://github.com/joshuafrancisjf4/securevault/tree/main/uploads): `uploads`
- [HTML Templates](https://github.com/joshuafrancisjf4/securevault/tree/main/templates): `templates`

### Other components

- **User**

## Connections

- User → Signup and Login: submits credentials (evidence: `app.py`)
- Signup and Login → MongoDB: checks or saves users (evidence: `app.py`)
- User → Dashboard: requests dashboard (evidence: `app.py`)
- Dashboard → HTML Templates: renders page (evidence: `app.py`)
- User → Create Vault: creates vault (evidence: `app.py`)
- Create Vault → MongoDB: saves vault record (evidence: `app.py`)
- Create Vault → Vault File Storage: creates vault folder (evidence: `app.py`)
- User → List Vaults: requests vault list (evidence: `app.py`)
- List Vaults → MongoDB: queries user vaults (evidence: `app.py`)
- List Vaults → HTML Templates: renders vault list (evidence: `app.py`)
- User → Open Vault: enters vault password (evidence: `app.py`)
- Open Vault → MongoDB: checks vault ownership and password (evidence: `app.py`)
- Open Vault → Vault File Storage: lists vault files (evidence: `app.py`)
- Open Vault → HTML Templates: renders vault contents (evidence: `app.py`)
- User → Upload Files: uploads file (evidence: `app.py`)
- Upload Files → Vault File Storage: saves file (evidence: `app.py`)
- User → View and Download: requests file (evidence: `app.py`)
- View and Download → Vault File Storage: serves file (evidence: `app.py`)
- User → Delete Files: deletes file (evidence: `app.py`)
- Delete Files → Vault File Storage: removes file (evidence: `app.py`)
