# swayam888-cmd/personalized-cloud-computing architecture

> Architecture diagram of the GitHub repository swayam888-cmd/personalized-cloud-computing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swayam888-cmd/personalized-cloud-computing
- Repository: https://github.com/swayam888-cmd/personalized-cloud-computing

## Overview

This is a self-hosted personal cloud for authenticated file management across localhost and LAN clients. The main workflow is account signup/login, protected browsing, upload and organization of files, then dashboard activity and storage views; share links provide public access. Administration, LAN status, and system monitoring are distinct capabilities. The graph follows documented HTTP layering and indexed imports; unsampled service internals and several UI integrations are represented only where evidence supports them.

Main entry points: [`backend/app/main.py`](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/main.py) (Application entry), [`frontend/src/App.jsx`](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/App.jsx) (Page routing), [`frontend/src/api/client.js`](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/api/client.js) (API client), [`backend/app/database/session.py`](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/database/session.py) (Database sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser application"]
  node_routing["Page routing<br/>[App.jsx]"]
  node_authstate["Authentication state<br/>[AuthContext.jsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.jsx]"]
  node_filesui["File workspace<br/>[FilesPage.jsx]"]
  node_shareui["Share pages<br/>[SharesPage.jsx]"]
  node_publicshareui["Public share view<br/>[SharedFilePage.jsx]"]
  node_adminui["Admin console<br/>[AdminPage.jsx]"]
  node_apiclient["API client<br/>[client.js]"]
end

subgraph group_http["HTTP API"]
  node_authroutes["Authentication routes<br/>[auth.py]"]
  node_userroutes["User routes<br/>[users.py]"]
  node_fileroutes["File routes<br/>[files.py]"]
  node_shareroutes["Sharing routes<br/>[shares.py]"]
  node_activityroutes["Activity routes<br/>[activity.py]"]
  node_adminroutes["Admin routes<br/>[admin.py]"]
  node_networkroutes["Network routes<br/>[network.py]"]
  node_appmain["Application entry<br/>[main.py]"]
end

subgraph group_domain["Cloud services"]
  node_authservice["Auth service<br/>[auth.py]"]
  node_storageservice["File storage service<br/>[storage.py]"]
  node_sharingservice["Sharing service<br/>[sharing.py]"]
  node_activityservice["Activity service<br/>[activity.py]"]
  node_adminservice["Admin service<br/>[admin.py]"]
  node_systemservice["System monitoring<br/>[system.py]"]
end

subgraph group_infra["Persistence and network"]
  node_networkcore["LAN detection<br/>[network.py]"]
  node_dbsession["Database sessions<br/>[session.py]"]
  node_models["Domain records"]
  node_database[("Relational database")]
  node_filesystem[("User file storage")]
end

node_browser(("Browser user"))

node_browser -->|"uses"| node_routing
node_routing -->|"reads auth"| node_authstate
node_routing -->|"routes to"| node_dashboard
node_routing -->|"routes to"| node_filesui
node_routing -->|"routes to"| node_shareui
node_routing -->|"routes to"| node_publicshareui
node_routing -->|"routes to"| node_adminui
node_authstate -->|"requests through"| node_apiclient
node_dashboard -->|"fetches via"| node_apiclient
node_filesui -->|"requests via"| node_apiclient
node_shareui -->|"requests via"| node_apiclient
node_publicshareui -->|"requests via"| node_apiclient
node_adminui -.->|"requests via"| node_apiclient
node_apiclient -->|"HTTP requests"| node_appmain
node_appmain -->|"registers"| node_authroutes
node_appmain -->|"registers"| node_userroutes
node_appmain -->|"registers"| node_fileroutes
node_appmain -->|"registers"| node_shareroutes
node_appmain -->|"registers"| node_activityroutes
node_appmain -->|"registers"| node_adminroutes
node_appmain -->|"registers"| node_networkroutes
node_authroutes -->|"delegates to"| node_authservice
node_userroutes -->|"delegates to"| node_authservice
node_fileroutes -->|"delegates to"| node_storageservice
node_fileroutes -->|"records activity"| node_activityservice
node_shareroutes -->|"delegates to"| node_sharingservice
node_shareroutes -->|"uses"| node_storageservice
node_shareroutes -->|"records activity"| node_activityservice
node_activityroutes -->|"delegates to"| node_activityservice
node_adminroutes -->|"delegates to"| node_adminservice
node_adminroutes -->|"queries metrics"| node_systemservice
node_authservice -->|"queries users"| node_models
node_storageservice -->|"queries files"| node_models
node_activityservice -->|"stores activity"| node_models
node_sharingservice -.->|"uses share records"| node_models
node_models -->|"maps through"| node_dbsession
node_dbsession -->|"connects to"| node_database
node_storageservice -->|"stores file bytes"| node_filesystem
node_networkroutes -.->|"reports LAN info"| node_networkcore
node_adminroutes -->|"uses sessions"| node_dbsession
node_fileroutes -->|"uses sessions"| node_dbsession
node_authroutes -->|"uses sessions"| node_dbsession

click node_routing "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/context/AuthContext.jsx"
click node_dashboard "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_filesui "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/FilesPage.jsx"
click node_shareui "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/SharesPage.jsx"
click node_publicshareui "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/SharedFilePage.jsx"
click node_adminui "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/AdminPage.jsx"
click node_apiclient "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/api/client.js"
click node_authroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/auth.py"
click node_userroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/users.py"
click node_fileroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/files.py"
click node_shareroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/shares.py"
click node_activityroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/activity.py"
click node_adminroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/admin.py"
click node_networkroutes "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/network.py"
click node_appmain "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/main.py"
click node_authservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/auth.py"
click node_storageservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/storage.py"
click node_sharingservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/sharing.py"
click node_activityservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/activity.py"
click node_adminservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/admin.py"
click node_systemservice "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/system.py"
click node_networkcore "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/core/network.py"
click node_dbsession "https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/database/session.py"
click node_models "https://github.com/swayam888-cmd/personalized-cloud-computing/tree/main/backend/app/models"

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_routing,node_authstate,node_dashboard,node_filesui,node_shareui,node_publicshareui,node_adminui,node_apiclient,node_browser toneBlue
class node_authroutes,node_userroutes,node_fileroutes,node_shareroutes,node_activityroutes,node_adminroutes,node_networkroutes,node_appmain toneAmber
class node_authservice,node_storageservice,node_sharingservice,node_activityservice,node_adminservice,node_systemservice toneMint
class node_networkcore,node_dbsession,node_models,node_database,node_filesystem toneRose
```

## Components

### Browser application

- [Page routing](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication state](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Dashboard](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [File workspace](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/FilesPage.jsx): `frontend/src/pages/FilesPage.jsx`
- [Share pages](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/SharesPage.jsx): `frontend/src/pages/SharesPage.jsx`
- [Public share view](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/SharedFilePage.jsx): `frontend/src/pages/SharedFilePage.jsx`
- [Admin console](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/pages/AdminPage.jsx): `frontend/src/pages/AdminPage.jsx`
- [API client](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### HTTP API

- [Authentication routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [User routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/users.py): `backend/app/api/users.py`
- [File routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/files.py): `backend/app/api/files.py`
- [Sharing routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/shares.py): `backend/app/api/shares.py`
- [Activity routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/activity.py): `backend/app/api/activity.py`
- [Admin routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/admin.py): `backend/app/api/admin.py`
- [Network routes](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/api/network.py): `backend/app/api/network.py`
- [Application entry](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/main.py): `backend/app/main.py`

### Cloud services

- [Auth service](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/auth.py): `backend/app/services/auth.py`
- [File storage service](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [Sharing service](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/sharing.py): `backend/app/services/sharing.py`
- [Activity service](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/activity.py): `backend/app/services/activity.py`
- [Admin service](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/admin.py): `backend/app/services/admin.py`
- [System monitoring](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/services/system.py): `backend/app/services/system.py`

### Persistence and network

- [LAN detection](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/core/network.py): `backend/app/core/network.py`
- [Database sessions](https://github.com/swayam888-cmd/personalized-cloud-computing/blob/main/backend/app/database/session.py): `backend/app/database/session.py`
- [Domain records](https://github.com/swayam888-cmd/personalized-cloud-computing/tree/main/backend/app/models): `backend/app/models`
- **Relational database**
- **User file storage**

### Other components

- **Browser user**

## Connections

- Browser user → Page routing: uses (evidence: `frontend/src/App.jsx`)
- Page routing → Authentication state: reads auth (evidence: `frontend/src/App.jsx`)
- Page routing → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → File workspace: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Share pages: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Public share view: routes to (evidence: `frontend/src/App.jsx`)
- Page routing → Admin console: routes to (evidence: `frontend/src/App.jsx`)
- Authentication state → API client: requests through (evidence: `frontend/src/context/AuthContext.jsx`)
- Dashboard → API client: fetches via (evidence: `frontend/src/pages/DashboardPage.jsx`)
- File workspace → API client: requests via (evidence: `frontend/src/pages/FilesPage.jsx`)
- Share pages → API client: requests via (evidence: `frontend/src/pages/SharesPage.jsx`)
- Public share view → API client: requests via (evidence: `frontend/src/pages/SharedFilePage.jsx`)
- Admin console → API client: requests via
- API client → Application entry: HTTP requests (evidence: `README.md`)
- Application entry → Authentication routes: registers (evidence: `backend/app/main.py`)
- Application entry → User routes: registers (evidence: `backend/app/main.py`)
- Application entry → File routes: registers (evidence: `backend/app/main.py`)
- Application entry → Sharing routes: registers (evidence: `backend/app/main.py`)
- Application entry → Activity routes: registers (evidence: `backend/app/main.py`)
- Application entry → Admin routes: registers (evidence: `backend/app/main.py`)
- Application entry → Network routes: registers (evidence: `backend/app/main.py`)
- Authentication routes → Auth service: delegates to (evidence: `backend/app/api/auth.py`)
- User routes → Auth service: delegates to (evidence: `backend/app/api/users.py`)
- File routes → File storage service: delegates to (evidence: `backend/app/api/files.py`)
- File routes → Activity service: records activity (evidence: `backend/app/api/files.py`)
- Sharing routes → Sharing service: delegates to (evidence: `backend/app/api/shares.py`)
- Sharing routes → File storage service: uses (evidence: `backend/app/api/shares.py`)
- Sharing routes → Activity service: records activity (evidence: `backend/app/api/shares.py`)
- Activity routes → Activity service: delegates to (evidence: `backend/app/api/activity.py`)
- Admin routes → Admin service: delegates to (evidence: `backend/app/api/admin.py`)
- Admin routes → System monitoring: queries metrics (evidence: `backend/app/api/admin.py`)
- Auth service → Domain records: queries users (evidence: `backend/app/services/auth.py`)
- File storage service → Domain records: queries files (evidence: `backend/app/services/storage.py`)
- Activity service → Domain records: stores activity (evidence: `backend/app/services/activity.py`)
- Sharing service → Domain records: uses share records
- Domain records → Database sessions: maps through (evidence: `backend/app/models/user.py`)
- Database sessions → Relational database: connects to (evidence: `README.md`)
- File storage service → User file storage: stores file bytes (evidence: `README.md`)
- Network routes → LAN detection: reports LAN info
- Admin routes → Database sessions: uses sessions (evidence: `backend/app/api/admin.py`)
- File routes → Database sessions: uses sessions (evidence: `backend/app/api/files.py`)
- Authentication routes → Database sessions: uses sessions (evidence: `backend/app/api/auth.py`)
