# sofyan-lamperouge/securevault architecture

> Architecture diagram of the GitHub repository sofyan-lamperouge/securevault, 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/sofyan-lamperouge/securevault
- Repository: https://github.com/sofyan-lamperouge/securevault

## Overview

SecureVault is a web application for password-protected file storage and sharing. Users register or log in, then manage files from a dashboard: upload, preview, download, delete, share with one or multiple users, revoke access, and review activity. The React UI calls a FastAPI API; backend routes handle authentication and domain operations, using cryptographic utilities and SQLAlchemy models for persistence. The README documents MySQL and preview support for text, images, and PDF. Some route implementations are only indexed, so their internal behavior is not expanded beyond documented features and indexed references.

Main entry points: [`backend/app/database.py`](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/database.py) (Database session), [`backend/app/dependencies.py`](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/dependencies.py) (JWT user lookup), [`backend/app/models.py`](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/models.py) (Domain models), [`frontend/src/App.tsx`](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/App.tsx) (Route application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.tsx]"]
  node_login["Login and register<br/>[Login.tsx]"]
  node_register["Registration page<br/>[Register.tsx]"]
  node_authctx["Auth context<br/>[AuthContext.tsx]"]
  node_dashboard["Vault dashboard<br/>[Dashboard.tsx]"]
  node_api_client["HTTP API client<br/>[api.ts]"]
end

subgraph group_api["API and identity"]
  node_api_server["FastAPI app<br/>[main.py]"]
  node_auth_routes["Auth routes<br/>[auth.py]"]
  node_auth_guard["JWT user lookup<br/>[dependencies.py]"]
end

subgraph group_files["Encrypted file operations"]
  node_file_routes["File routes<br/>[files.py]"]
end

subgraph group_collaboration["Sharing and activity"]
  node_share_routes["Share routes<br/>[share.py]"]
  node_activity_routes["Activity routes<br/>[activity.py]"]
end

subgraph group_persistence["Persistence and crypto"]
  node_crypto["Cryptographic utilities<br/>[crypto_utils.py]"]
  node_models["Domain models<br/>[models.py]"]
  node_db_session["Database session<br/>[database.py]"]
  node_config["Settings<br/>[config.py]"]
end

node_user(("Vault user"))
node_mysql[("MySQL database")]

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_authctx
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_app -->|"guards route"| node_dashboard
node_login -->|"uses auth"| node_authctx
node_register -->|"uses auth"| node_authctx
node_authctx -->|"calls auth"| node_api_client
node_dashboard -->|"uses auth"| node_authctx
node_dashboard -->|"requests operations"| node_api_client
node_api_client -->|"HTTP requests"| node_api_server
node_api_server -->|"registers router"| node_auth_routes
node_api_server -->|"registers router"| node_file_routes
node_api_server -->|"registers router"| node_share_routes
node_api_server -->|"registers router"| node_activity_routes
node_auth_routes -->|"uses key utilities"| node_crypto
node_auth_routes -->|"queries users"| node_models
node_auth_routes -->|"opens session"| node_db_session
node_auth_routes -->|"uses user guard"| node_auth_guard
node_file_routes -->|"encrypts and decrypts"| node_crypto
node_file_routes -->|"reads and writes"| node_models
node_file_routes -->|"requires user"| node_auth_guard
node_file_routes -->|"opens session"| node_db_session
node_share_routes -->|"uses key utilities"| node_crypto
node_share_routes -->|"queries sharing data"| node_models
node_share_routes -->|"requires user"| node_auth_guard
node_share_routes -->|"opens session"| node_db_session
node_activity_routes -->|"queries activity data"| node_models
node_activity_routes -->|"requires user"| node_auth_guard
node_activity_routes -->|"opens session"| node_db_session
node_auth_guard -->|"looks up user"| node_models
node_auth_guard -->|"opens session"| node_db_session
node_db_session -->|"reads connection settings"| node_config
node_db_session -->|"provides ORM base"| node_models
node_db_session -->|"connects to"| node_mysql

click node_app "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/App.tsx"
click node_login "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Login.tsx"
click node_register "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Register.tsx"
click node_authctx "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/context/AuthContext.tsx"
click node_dashboard "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Dashboard.tsx"
click node_api_client "https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/services/api.ts"
click node_api_server "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/main.py"
click node_auth_routes "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/auth.py"
click node_auth_guard "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/dependencies.py"
click node_file_routes "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/files.py"
click node_share_routes "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/share.py"
click node_activity_routes "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/activity.py"
click node_crypto "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/crypto_utils.py"
click node_models "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/models.py"
click node_db_session "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/database.py"
click node_config "https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/config.py"

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_login,node_register,node_authctx,node_dashboard,node_api_client,node_user toneBlue
class node_api_server,node_auth_routes,node_auth_guard,node_mysql toneAmber
class node_file_routes toneMint
class node_share_routes,node_activity_routes toneRose
class node_crypto,node_models,node_db_session,node_config toneIndigo
```

## Components

### React client

- [Route application](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Login and register](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Login.tsx): `frontend/src/pages/Login.tsx`
- [Registration page](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Register.tsx): `frontend/src/pages/Register.tsx`
- [Auth context](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Vault dashboard](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/pages/Dashboard.tsx): `frontend/src/pages/Dashboard.tsx`
- [HTTP API client](https://github.com/sofyan-lamperouge/securevault/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### API and identity

- [FastAPI app](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/main.py): `backend/app/main.py`
- [Auth routes](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [JWT user lookup](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/dependencies.py): `backend/app/dependencies.py`

### Encrypted file operations

- [File routes](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/files.py): `backend/app/routes/files.py`

### Sharing and activity

- [Share routes](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/share.py): `backend/app/routes/share.py`
- [Activity routes](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/routes/activity.py): `backend/app/routes/activity.py`

### Persistence and crypto

- [Cryptographic utilities](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/crypto_utils.py): `backend/app/crypto_utils.py`
- [Domain models](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/models.py): `backend/app/models.py`
- [Database session](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/database.py): `backend/app/database.py`
- [Settings](https://github.com/sofyan-lamperouge/securevault/blob/main/backend/app/config.py): `backend/app/config.py`

### Other components

- **Vault user**
- **MySQL database**

## Connections

- Vault user → Route application: uses (evidence: `frontend/src/App.tsx`)
- Route application → Auth context: provides auth (evidence: `frontend/src/App.tsx`)
- Route application → Login and register: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Registration page: routes to (evidence: `frontend/src/App.tsx`)
- Route application → Vault dashboard: guards route (evidence: `frontend/src/App.tsx`)
- Login and register → Auth context: uses auth (evidence: `frontend/src/pages/Login.tsx`)
- Registration page → Auth context: uses auth (evidence: `frontend/src/pages/Register.tsx`)
- Auth context → HTTP API client: calls auth (evidence: `frontend/src/context/AuthContext.tsx`)
- Vault dashboard → Auth context: uses auth (evidence: `frontend/src/pages/Dashboard.tsx`)
- Vault dashboard → HTTP API client: requests operations (evidence: `frontend/src/pages/Dashboard.tsx`)
- HTTP API client → FastAPI app: HTTP requests (evidence: `frontend/src/services/api.ts`)
- FastAPI app → Auth routes: registers router (evidence: `backend/app/main.py`)
- FastAPI app → File routes: registers router (evidence: `backend/app/main.py`)
- FastAPI app → Share routes: registers router (evidence: `backend/app/main.py`)
- FastAPI app → Activity routes: registers router (evidence: `backend/app/main.py`)
- Auth routes → Cryptographic utilities: uses key utilities (evidence: `backend/app/routes/auth.py`)
- Auth routes → Domain models: queries users (evidence: `backend/app/routes/auth.py`)
- Auth routes → Database session: opens session (evidence: `backend/app/routes/auth.py`)
- Auth routes → JWT user lookup: uses user guard (evidence: `backend/app/routes/auth.py`)
- File routes → Cryptographic utilities: encrypts and decrypts (evidence: `backend/app/routes/files.py`)
- File routes → Domain models: reads and writes (evidence: `backend/app/routes/files.py`)
- File routes → JWT user lookup: requires user (evidence: `backend/app/routes/files.py`)
- File routes → Database session: opens session (evidence: `backend/app/routes/files.py`)
- Share routes → Cryptographic utilities: uses key utilities (evidence: `backend/app/routes/share.py`)
- Share routes → Domain models: queries sharing data (evidence: `backend/app/routes/share.py`)
- Share routes → JWT user lookup: requires user (evidence: `backend/app/routes/share.py`)
- Share routes → Database session: opens session (evidence: `backend/app/routes/share.py`)
- Activity routes → Domain models: queries activity data (evidence: `backend/app/routes/activity.py`)
- Activity routes → JWT user lookup: requires user (evidence: `backend/app/routes/activity.py`)
- Activity routes → Database session: opens session (evidence: `backend/app/routes/activity.py`)
- JWT user lookup → Domain models: looks up user (evidence: `backend/app/dependencies.py`)
- JWT user lookup → Database session: opens session (evidence: `backend/app/dependencies.py`)
- Database session → Settings: reads connection settings (evidence: `backend/app/database.py`)
- Database session → Domain models: provides ORM base (evidence: `backend/app/models.py`)
- Database session → MySQL database: connects to (evidence: `backend/app/database.py`)
