# peak-brosmao/camhost.space-open-soucre architecture

> Architecture diagram of the GitHub repository peak-brosmao/camhost.space-open-soucre, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/peak-brosmao/camhost.space-open-soucre
- Repository: https://github.com/peak-brosmao/camhost.space-open-soucre

## Overview

CamHost.space is a browser-based personal cloud drive backed by a PHP API, SQLite metadata and Telegram file storage. The main workflow is account access, file selection and chunked browser upload, API processing and Telegram storage, then browsing or sharing files and downloading them. The graph also includes folder management, public pages and the admin control center. Some links and subsystems are based on the README or SOURCE INDEX rather than inspected implementation; those evidence limits are reflected in the citations and omitted details.

Main entry points: [`api/index.php`](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/index.php) (API router), [`src/App.jsx`](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/App.jsx) (App routes), [`src/api/client.js`](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/api/client.js) (API client), [`api/db.php`](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/db.php) (SQLite metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser application"]
  node_app["App routes<br/>[App.jsx]"]
  node_public["Public pages<br/>[LandingPage.jsx]"]
end

subgraph group_identity["Account lifecycle"]
  node_authui["Login and signup<br/>[RegisterPage.jsx]"]
  node_authctx["Auth context<br/>[AuthContext.jsx]"]
  node_authapi["Authentication API<br/>[auth.php]"]
  node_signup["Signup handler<br/>[signup.php]"]
  node_mailer["SMTP mailer<br/>[mailer.php]"]
end

subgraph group_drive["Drive and transfers"]
  node_filesui["File explorer<br/>[FilesPage.jsx]"]
  node_foldersui["Folder manager<br/>[FoldersPage.jsx]"]
  node_uploadui["Upload page<br/>[UploadPage.jsx]"]
  node_shareui["Share experience<br/>[SharePage.jsx]"]
  node_fileapi["File operations<br/>[files.php]"]
  node_folderapi["Folder operations<br/>[folders.php]"]
  node_chunk["Chunk processor<br/>[upload-chunk.php]"]
  node_finalize["Upload finalizer"]
end

subgraph group_backend["API and persistence"]
  node_clientapi["API client<br/>[client.js]"]
  node_router["API router<br/>[index.php]"]
  node_security["WAF and rate limits<br/>[security.php]"]
  node_db[("SQLite metadata<br/>[db.php]")]
end

subgraph group_operations["Administration"]
  node_adminui["Admin control center"]
  node_adminapi["Admin API<br/>[admin.php]"]
end

node_user(("User"))
node_telegram["Telegram storage"]
node_smtp["Hostinger SMTP"]

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_public
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_filesui
node_app -->|"routes to"| node_foldersui
node_app -->|"routes to"| node_uploadui
node_app -->|"routes to"| node_shareui
node_app -->|"routes to"| node_adminui
node_authui -.->|"uses"| node_authctx
node_authctx -->|"calls"| node_clientapi
node_filesui -->|"calls"| node_clientapi
node_foldersui -->|"calls"| node_clientapi
node_uploadui -->|"uploads through"| node_clientapi
node_shareui -->|"calls"| node_clientapi
node_clientapi -->|"HTTP requests"| node_router
node_router -->|"applies checks"| node_security
node_router -->|"dispatches auth"| node_authapi
node_router -->|"dispatches signup"| node_signup
node_router -->|"dispatches files"| node_fileapi
node_router -->|"dispatches folders"| node_folderapi
node_router -->|"dispatches chunks"| node_chunk
node_router -->|"dispatches finalize"| node_finalize
node_router -->|"dispatches admin"| node_adminapi
node_authapi -->|"reads and writes"| node_db
node_fileapi -->|"reads and writes"| node_db
node_folderapi -.->|"accesses metadata"| node_db
node_chunk -->|"records chunks"| node_db
node_chunk -->|"completes upload"| node_finalize
node_finalize -->|"stores file parts"| node_telegram
node_fileapi -->|"retrieves file data"| node_telegram
node_authapi -->|"sends account mail"| node_mailer
node_mailer -->|"dispatches mail"| node_smtp
node_adminui -->|"calls"| node_clientapi
node_adminui -.->|"manages platform"| node_adminapi
node_adminapi -->|"reads and writes"| node_db

click node_app "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/App.jsx"
click node_public "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/LandingPage.jsx"
click node_authui "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/RegisterPage.jsx"
click node_authctx "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/context/AuthContext.jsx"
click node_clientapi "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/api/client.js"
click node_filesui "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/FilesPage.jsx"
click node_foldersui "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/FoldersPage.jsx"
click node_uploadui "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/UploadPage.jsx"
click node_shareui "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/SharePage.jsx"
click node_router "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/index.php"
click node_security "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/security.php"
click node_authapi "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/auth.php"
click node_signup "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/signup.php"
click node_fileapi "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/files.php"
click node_folderapi "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/folders.php"
click node_chunk "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/upload-chunk.php"
click node_finalize "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/upload-finalize.php"
click node_db "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/db.php"
click node_mailer "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/mailer.php"
click node_adminui "https://github.com/peak-brosmao/camhost.space-open-soucre/tree/main/src/pages/admin"
click node_adminapi "https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/admin.php"

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_public,node_user toneBlue
class node_authui,node_authctx,node_authapi,node_signup,node_mailer,node_telegram toneAmber
class node_filesui,node_foldersui,node_uploadui,node_shareui,node_fileapi,node_folderapi,node_chunk,node_finalize toneMint
class node_clientapi,node_router,node_security,node_db toneRose
class node_adminui,node_adminapi,node_smtp toneIndigo
```

## Components

### Browser application

- [App routes](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/App.jsx): `src/App.jsx`
- [Public pages](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/LandingPage.jsx): `src/pages/LandingPage.jsx`

### Account lifecycle

- [Login and signup](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/RegisterPage.jsx): `src/pages/RegisterPage.jsx`
- [Auth context](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Authentication API](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/auth.php): `api/auth.php`
- [Signup handler](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/signup.php): `api/signup.php`
- [SMTP mailer](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/mailer.php): `api/mailer.php`

### Drive and transfers

- [File explorer](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/FilesPage.jsx): `src/pages/FilesPage.jsx`
- [Folder manager](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/FoldersPage.jsx): `src/pages/FoldersPage.jsx`
- [Upload page](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/UploadPage.jsx): `src/pages/UploadPage.jsx`
- [Share experience](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/pages/SharePage.jsx): `src/pages/SharePage.jsx`
- [File operations](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/files.php): `api/files.php`
- [Folder operations](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/folders.php): `api/folders.php`
- [Chunk processor](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/upload-chunk.php): `api/upload-chunk.php`
- [Upload finalizer](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/upload-finalize.php): `api/upload-finalize.php`

### API and persistence

- [API client](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/src/api/client.js): `src/api/client.js`
- [API router](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/index.php): `api/index.php`
- [WAF and rate limits](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/security.php): `api/security.php`
- [SQLite metadata](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/db.php): `api/db.php`

### Administration

- [Admin control center](https://github.com/peak-brosmao/camhost.space-open-soucre/tree/main/src/pages/admin): `src/pages/admin`
- [Admin API](https://github.com/peak-brosmao/camhost.space-open-soucre/blob/main/api/admin.php): `api/admin.php`

### Other components

- **User**
- **Telegram storage**
- **Hostinger SMTP**

## Connections

- User → App routes: uses
- App routes → Public pages: routes to (evidence: `src/App.jsx`)
- App routes → Login and signup: routes to (evidence: `src/App.jsx`)
- App routes → File explorer: routes to (evidence: `src/App.jsx`)
- App routes → Folder manager: routes to (evidence: `src/App.jsx`)
- App routes → Upload page: routes to (evidence: `src/App.jsx`)
- App routes → Share experience: routes to (evidence: `src/App.jsx`)
- App routes → Admin control center: routes to (evidence: `src/App.jsx`)
- Login and signup → Auth context: uses
- Auth context → API client: calls (evidence: `src/context/AuthContext.jsx`)
- File explorer → API client: calls (evidence: `src/pages/FilesPage.jsx`)
- Folder manager → API client: calls (evidence: `src/pages/FoldersPage.jsx`)
- Upload page → API client: uploads through (evidence: `src/pages/UploadPage.jsx`)
- Share experience → API client: calls (evidence: `src/pages/SharePage.jsx`)
- API client → API router: HTTP requests (evidence: `README.md`)
- API router → WAF and rate limits: applies checks (evidence: `api/index.php`)
- API router → Authentication API: dispatches auth (evidence: `api/index.php`)
- API router → Signup handler: dispatches signup (evidence: `api/index.php`)
- API router → File operations: dispatches files (evidence: `api/index.php`)
- API router → Folder operations: dispatches folders (evidence: `api/index.php`)
- API router → Chunk processor: dispatches chunks (evidence: `api/index.php`)
- API router → Upload finalizer: dispatches finalize (evidence: `api/index.php`)
- API router → Admin API: dispatches admin (evidence: `api/index.php`)
- Authentication API → SQLite metadata: reads and writes (evidence: `api/auth.php`)
- File operations → SQLite metadata: reads and writes (evidence: `api/files.php`)
- Folder operations → SQLite metadata: accesses metadata
- Chunk processor → SQLite metadata: records chunks (evidence: `api/upload-chunk.php`)
- Chunk processor → Upload finalizer: completes upload (evidence: `README.md`)
- Upload finalizer → Telegram storage: stores file parts (evidence: `README.md`)
- File operations → Telegram storage: retrieves file data (evidence: `README.md`)
- Authentication API → SMTP mailer: sends account mail (evidence: `api/auth.php`)
- SMTP mailer → Hostinger SMTP: dispatches mail (evidence: `README.md`)
- Admin control center → API client: calls (evidence: `src/pages/admin/AdminSettings.jsx`)
- Admin control center → Admin API: manages platform
- Admin API → SQLite metadata: reads and writes (evidence: `api/admin.php`)
