How gohilnitya08/aethera works
AETHERA is a FastAPI backend for privacy-focused document storage and collaboration. The principal workflow is authenticated workspace access, folder organization, file metadata and version management, then sharing; services enforce permissions and repositories persist domain state. Authentication supports password/JWT and Google OAuth. The README also names React and MySQL, but the frontend and cloud storage are outside this tree, and cloud hosting is pending. Several routes and services are unsampled, so their internal connections are not inferred.
Main entry points: router.py API router · workspace_service.py Workspace service · file_service.py File service · auth_service.py Auth service
Components 23
HTTP API
- FastAPI app
Backend/app/main.py - API router
Backend/app/api/router.py - Auth routes
Backend/app/api/routes/auth.py - File routes
Backend/app/api/routes/files.py - Folder routes
Backend/app/api/routes/folders.py - Share routes
Backend/app/api/routes/shares.py - Workspace routes
Backend/app/api/routes/workspaces.py
Identity
- Auth service
Backend/app/services/auth_service.py - Auth repository
Backend/app/repositories/auth_repository.py - User service
Backend/app/services/user_service.py - User repository
Backend/app/repositories/user_repository.py
Workspace Collaboration
- Workspace service
Backend/app/services/workspace_service.py - Workspace repository
Backend/app/repositories/workspace_repository.py - Share service
Backend/app/services/share_service.py - Share repository
Backend/app/repositories/share_repository.py
Document Management
- Folder service
Backend/app/services/folder_service.py - Folder repository
Backend/app/repositories/folder_repository.py - File service
Backend/app/services/file_service.py - File repository
Backend/app/repositories/file_repository.py
Persistence
- DB sessions
Backend/app/database/session.py - MySQL database
Other components
- API client
- Google OAuth
Connections 18
- API client → FastAPI app: HTTP requests
- FastAPI app → API router: mounts routes
- API router → Auth routes: dispatches
- API router → File routes: dispatches
- API router → Folder routes: dispatches
- API router → Share routes: dispatches
- API router → Workspace routes: dispatches
- Auth routes → Auth service: calls
- Auth service → Auth repository: queries and writes
- Auth service → Google OAuth: verifies identity
- Workspace service → Workspace repository: queries and writes
- Workspace service → User repository: checks active user
- Folder service → Folder repository: queries and writes
- Folder service → Workspace service: checks access
- File service → File repository: queries and writes
- File service → Folder service: checks folder access
- File service → Workspace service: checks permissions
- DB sessions → MySQL database: opens sessions