How aswina1636/home-server works
HomeServer is a private cloud file manager and video streamer, with user and administrator workflows. Users sign up or log in, then browse, search, upload, download, and view files; administrators manage accounts, quota requests, messages, devices, deletion requests, settings, and audit history. React pages call a FastAPI service, whose routes use authentication, file/admin logic, and SQLAlchemy models and database access. The README documents security controls, password recovery, streaming, and admin features; some subsystem links are based on documentation or the source index rather than sampled route code.
Main entry points: files.py File routes · main.py FastAPI routes · auth.py Auth routes · api.js API client
Components 19
Web client
- App routing
frontend/src/App.jsx - Auth state
frontend/src/contexts/AuthContext.jsx - API client
frontend/src/api.js - File dashboard
frontend/src/pages/Dashboard.jsx - File views
frontend/src/components/FileGrid.jsx - File utilities
frontend/src/utils/fileUtils.js - Media viewer
frontend/src/components/FileViewer.jsx - Video player
frontend/src/components/VideoPlayer.jsx
Identity and security
- Auth routes
backend/auth.py - Security middleware
backend/middleware.py - Domain models
backend/models.py - SQL database access
backend/database.py
File and media
- File routes
backend/files.py - File storage
Administration
- Admin pages
frontend/src/pages/admin - Storage requests
frontend/src/pages/admin/AdminStorageRequests.jsx - Admin routes
backend/admin.py
Other components
- User or admin
- FastAPI routes
backend/main.py
Connections 27
- User or admin → App routing: uses
README.md - App routing → Auth state: provides auth
frontend/src/App.jsx - App routing → File dashboard: routes to
frontend/src/App.jsx - App routing → Admin pages: routes to
frontend/src/App.jsx - Auth state → API client: checks profile
frontend/src/contexts/AuthContext.jsx - File dashboard → API client: requests files
frontend/src/pages/Dashboard.jsx - File dashboard → File views: renders
frontend/src/pages/Dashboard.jsx - File views → File utilities: uses
frontend/src/components/FileGrid.jsx - File dashboard → Media viewer: opens files
frontend/src/pages/Dashboard.jsx - Media viewer → Video player: embeds
frontend/src/components/FileViewer.jsx - Admin pages → API client: requests admin data
frontend/src/pages/admin/AdminLayout.jsx - Storage requests → API client: submits decisions
frontend/src/pages/admin/AdminStorageRequests.jsx - API client → FastAPI routes: calls HTTP API
README.md - FastAPI routes → Auth routes: routes auth
backend/main.py - FastAPI routes → File routes: routes files
backend/main.py - FastAPI routes → Admin routes: routes admin
backend/main.py - FastAPI routes → Security middleware: configures
backend/main.py - Auth routes → Domain models: queries users
backend/auth.py - Auth routes → SQL database access: gets sessions
backend/auth.py - File routes → Domain models: uses records
backend/files.py - File routes → SQL database access: gets sessions
backend/files.py - File routes → Auth routes: checks identity
backend/files.py - File routes → File storage: reads and writes
- Admin routes → Domain models: uses records
backend/admin.py - Admin routes → SQL database access: gets sessions
backend/admin.py - Admin routes → Auth routes: checks admins
backend/admin.py - Domain models → SQL database access: declares tables
backend/models.py