How sofyan-lamperouge/securevault works
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: database.py Database session · dependencies.py JWT user lookup · models.py Domain models · App.tsx Route application
Components 18
React client
- Route application
frontend/src/App.tsx - Login and register
frontend/src/pages/Login.tsx - Registration page
frontend/src/pages/Register.tsx - Auth context
frontend/src/context/AuthContext.tsx - Vault dashboard
frontend/src/pages/Dashboard.tsx - HTTP API client
frontend/src/services/api.ts
API and identity
- FastAPI app
backend/app/main.py - Auth routes
backend/app/routes/auth.py - JWT user lookup
backend/app/dependencies.py
Encrypted file operations
- File routes
backend/app/routes/files.py
Sharing and activity
- Share routes
backend/app/routes/share.py - Activity routes
backend/app/routes/activity.py
Persistence and crypto
- Cryptographic utilities
backend/app/crypto_utils.py - Domain models
backend/app/models.py - Database session
backend/app/database.py - Settings
backend/app/config.py
Other components
- Vault user
- MySQL database
Connections 35
- Vault user → Route application: uses
frontend/src/App.tsx - Route application → Auth context: provides auth
frontend/src/App.tsx - Route application → Login and register: routes to
frontend/src/App.tsx - Route application → Registration page: routes to
frontend/src/App.tsx - Route application → Vault dashboard: guards route
frontend/src/App.tsx - Login and register → Auth context: uses auth
frontend/src/pages/Login.tsx - Registration page → Auth context: uses auth
frontend/src/pages/Register.tsx - Auth context → HTTP API client: calls auth
frontend/src/context/AuthContext.tsx - Vault dashboard → Auth context: uses auth
frontend/src/pages/Dashboard.tsx - Vault dashboard → HTTP API client: requests operations
frontend/src/pages/Dashboard.tsx - HTTP API client → FastAPI app: HTTP requests
frontend/src/services/api.ts - FastAPI app → Auth routes: registers router
backend/app/main.py - FastAPI app → File routes: registers router
backend/app/main.py - FastAPI app → Share routes: registers router
backend/app/main.py - FastAPI app → Activity routes: registers router
backend/app/main.py - Auth routes → Cryptographic utilities: uses key utilities
backend/app/routes/auth.py - Auth routes → Domain models: queries users
backend/app/routes/auth.py - Auth routes → Database session: opens session
backend/app/routes/auth.py - Auth routes → JWT user lookup: uses user guard
backend/app/routes/auth.py - File routes → Cryptographic utilities: encrypts and decrypts
backend/app/routes/files.py - File routes → Domain models: reads and writes
backend/app/routes/files.py - File routes → JWT user lookup: requires user
backend/app/routes/files.py - File routes → Database session: opens session
backend/app/routes/files.py - Share routes → Cryptographic utilities: uses key utilities
backend/app/routes/share.py - Share routes → Domain models: queries sharing data
backend/app/routes/share.py - Share routes → JWT user lookup: requires user
backend/app/routes/share.py - Share routes → Database session: opens session
backend/app/routes/share.py - Activity routes → Domain models: queries activity data
backend/app/routes/activity.py - Activity routes → JWT user lookup: requires user
backend/app/routes/activity.py - Activity routes → Database session: opens session
backend/app/routes/activity.py - JWT user lookup → Domain models: looks up user
backend/app/dependencies.py - JWT user lookup → Database session: opens session
backend/app/dependencies.py - Database session → Settings: reads connection settings
backend/app/database.py - Database session → Domain models: provides ORM base
backend/app/models.py - Database session → MySQL database: connects to
backend/app/database.py