# xuanxuan205/classic-cloud-source architecture

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

- Interactive diagram: https://gitdiagram.com/xuanxuan205/classic-cloud-source
- Repository: https://github.com/xuanxuan205/classic-cloud-source

## Overview

Classic Cloud is a self-hosted private cloud-drive application: users authenticate, manage and upload files, then retrieve them or share them publicly; administrators manage users and security. The Vue client reaches the Spring Boot application through nginx, where IronWall defenses precede business handling. Files are encrypted for local storage, while metadata and account records use MySQL. The graph combines README-documented architecture and capabilities with sampled source references; several controller and service internals were not sampled, so their finer call relationships are not asserted.

Main entry points: [`backend/src/main/java/com/jdy/cloud/security`](https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/security) (Security filters), [`backend/src/main/java/com/jdy/cloud/repository`](https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/repository) (Data repositories), [`frontend/src/main.ts`](https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/main.ts) (Vue application), [`backend/src/main/java/com/jdy/cloud/service/FileService.java`](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/FileService.java) (File services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_frontend["Vue application<br/>[main.ts]"]
  node_file_views["File views<br/>[Files.vue]"]
  node_share_views["Share views<br/>[Shares.vue]"]
  node_admin_views["Admin views<br/>[Admin.vue]"]
end

subgraph group_edge["Edge security"]
  node_nginx["nginx gateway"]
end

subgraph group_business["Application workflows"]
  node_auth_controller["Auth endpoints"]
  node_file_controller["File endpoints"]
  node_share_controller["Share endpoints"]
  node_admin_controller["Admin endpoints"]
  node_auth_service["Account services<br/>[AuthService.java]"]
  node_file_service["File services<br/>[FileService.java]"]
  node_share_service["Share services<br/>[ShareService.java]"]
  node_admin_service["Administration<br/>[AdminService.java]"]
end

subgraph group_security["IronWall defenses"]
  node_ironwall_filters["Security filters"]
  node_attack_guard["Attack guard"]
  node_file_safety["Upload safety"]
  node_crypto["Storage encryption"]
end

subgraph group_data["Persistence"]
  node_repositories["Data repositories"]
  node_mysql[("MySQL")]
  node_local_storage[("Encrypted files")]
end

node_browser(("Browser user"))
node_email["Email service"]
node_fail2ban["fail2ban"]

node_browser -->|"sends requests"| node_nginx
node_nginx -->|"serves SPA"| node_frontend
node_nginx -->|"proxies API"| node_ironwall_filters
node_frontend -->|"renders views"| node_file_views
node_frontend -.->|"routes views"| node_share_views
node_frontend -.->|"routes views"| node_admin_views
node_file_views -->|"uses file API"| node_file_controller
node_share_views -->|"uses share API"| node_share_controller
node_admin_views -->|"uses admin API"| node_admin_controller
node_ironwall_filters -->|"admits requests"| node_auth_controller
node_ironwall_filters -->|"admits requests"| node_file_controller
node_ironwall_filters -->|"admits requests"| node_share_controller
node_ironwall_filters -->|"admits requests"| node_admin_controller
node_ironwall_filters -.->|"checks threats"| node_attack_guard
node_auth_controller -.->|"delegates"| node_auth_service
node_file_controller -.->|"delegates"| node_file_service
node_share_controller -.->|"delegates"| node_share_service
node_admin_controller -.->|"delegates"| node_admin_service
node_file_service -->|"checks uploads"| node_file_safety
node_file_service -->|"encrypts files"| node_crypto
node_auth_service -.->|"sends messages"| node_email
node_auth_service -->|"persists accounts"| node_repositories
node_file_service -->|"persists metadata"| node_repositories
node_share_service -.->|"persists shares"| node_repositories
node_admin_service -->|"manages records"| node_repositories
node_repositories -->|"reads and writes"| node_mysql
node_crypto -->|"encrypts at rest"| node_local_storage
node_attack_guard -.->|"syncs bans"| node_fail2ban

click node_frontend "https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/main.ts"
click node_file_views "https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/files/Files.vue"
click node_share_views "https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/shares/Shares.vue"
click node_admin_views "https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/Admin.vue"
click node_ironwall_filters "https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/security"
click node_attack_guard "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/AttackGuardService.java"
click node_file_safety "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/FileContentSafetyService.java"
click node_auth_controller "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/AuthController.java"
click node_file_controller "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/FileController.java"
click node_share_controller "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/ShareController.java"
click node_admin_controller "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/AdminController.java"
click node_auth_service "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/AuthService.java"
click node_file_service "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/FileService.java"
click node_share_service "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/ShareService.java"
click node_admin_service "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/AdminService.java"
click node_crypto "https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/StorageCryptoService.java"
click node_repositories "https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/repository"

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_frontend,node_file_views,node_share_views,node_admin_views,node_browser toneBlue
class node_nginx toneAmber
class node_auth_controller,node_file_controller,node_share_controller,node_admin_controller,node_auth_service,node_file_service,node_share_service,node_admin_service toneMint
class node_ironwall_filters,node_attack_guard,node_file_safety,node_crypto toneRose
class node_repositories,node_mysql,node_local_storage,node_email,node_fail2ban toneIndigo
```

## Components

### Client experience

- [Vue application](https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/main.ts): `frontend/src/main.ts`
- [File views](https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/files/Files.vue): `frontend/src/views/files/Files.vue`
- [Share views](https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/shares/Shares.vue): `frontend/src/views/shares/Shares.vue`
- [Admin views](https://github.com/xuanxuan205/classic-cloud-source/blob/main/frontend/src/views/Admin.vue): `frontend/src/views/Admin.vue`

### Edge security

- **nginx gateway**

### Application workflows

- [Auth endpoints](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/AuthController.java): `backend/src/main/java/com/jdy/cloud/controller/AuthController.java`
- [File endpoints](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/FileController.java): `backend/src/main/java/com/jdy/cloud/controller/FileController.java`
- [Share endpoints](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/ShareController.java): `backend/src/main/java/com/jdy/cloud/controller/ShareController.java`
- [Admin endpoints](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/controller/AdminController.java): `backend/src/main/java/com/jdy/cloud/controller/AdminController.java`
- [Account services](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/AuthService.java): `backend/src/main/java/com/jdy/cloud/service/AuthService.java`
- [File services](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/FileService.java): `backend/src/main/java/com/jdy/cloud/service/FileService.java`
- [Share services](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/ShareService.java): `backend/src/main/java/com/jdy/cloud/service/ShareService.java`
- [Administration](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/service/AdminService.java): `backend/src/main/java/com/jdy/cloud/service/AdminService.java`

### IronWall defenses

- [Security filters](https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/security): `backend/src/main/java/com/jdy/cloud/security`
- [Attack guard](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/AttackGuardService.java): `backend/src/main/java/com/jdy/cloud/security/AttackGuardService.java`
- [Upload safety](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/FileContentSafetyService.java): `backend/src/main/java/com/jdy/cloud/security/FileContentSafetyService.java`
- [Storage encryption](https://github.com/xuanxuan205/classic-cloud-source/blob/main/backend/src/main/java/com/jdy/cloud/security/StorageCryptoService.java): `backend/src/main/java/com/jdy/cloud/security/StorageCryptoService.java`

### Persistence

- [Data repositories](https://github.com/xuanxuan205/classic-cloud-source/tree/main/backend/src/main/java/com/jdy/cloud/repository): `backend/src/main/java/com/jdy/cloud/repository`
- **MySQL**
- **Encrypted files**

### Other components

- **Browser user**
- **Email service**
- **fail2ban**

## Connections

- Browser user → nginx gateway: sends requests (evidence: `README.md`)
- nginx gateway → Vue application: serves SPA (evidence: `README.md`)
- nginx gateway → Security filters: proxies API (evidence: `README.md`)
- Vue application → File views: renders views (evidence: `frontend/src/main.ts`)
- Vue application → Share views: routes views
- Vue application → Admin views: routes views
- File views → File endpoints: uses file API (evidence: `README.md`)
- Share views → Share endpoints: uses share API (evidence: `README.md`)
- Admin views → Admin endpoints: uses admin API (evidence: `README.md`)
- Security filters → Auth endpoints: admits requests (evidence: `README.md`)
- Security filters → File endpoints: admits requests (evidence: `README.md`)
- Security filters → Share endpoints: admits requests (evidence: `README.md`)
- Security filters → Admin endpoints: admits requests (evidence: `README.md`)
- Security filters → Attack guard: checks threats (evidence: `backend/src/main/java/com/jdy/cloud/security/DdosDefenseService.java`)
- Auth endpoints → Account services: delegates
- File endpoints → File services: delegates
- Share endpoints → Share services: delegates
- Admin endpoints → Administration: delegates (evidence: `backend/src/main/java/com/jdy/cloud/controller/AdminController.java`)
- File services → Upload safety: checks uploads (evidence: `backend/src/main/java/com/jdy/cloud/service/FileService.java`)
- File services → Storage encryption: encrypts files (evidence: `backend/src/main/java/com/jdy/cloud/service/FileService.java`)
- Account services → Email service: sends messages
- Account services → Data repositories: persists accounts (evidence: `backend/src/main/java/com/jdy/cloud/service/AuthService.java`)
- File services → Data repositories: persists metadata (evidence: `backend/src/main/java/com/jdy/cloud/service/FileService.java`)
- Share services → Data repositories: persists shares (evidence: `backend/src/main/java/com/jdy/cloud/service/ShareService.java`)
- Administration → Data repositories: manages records (evidence: `backend/src/main/java/com/jdy/cloud/service/AdminService.java`)
- Data repositories → MySQL: reads and writes (evidence: `README.md`)
- Storage encryption → Encrypted files: encrypts at rest (evidence: `README.md`)
- Attack guard → fail2ban: syncs bans (evidence: `README.md`)
