How xuanxuan205/classic-cloud-source works
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: security Security filters · repository Data repositories · main.ts Vue application · FileService.java File services
Components 23
Client experience
- Vue application
frontend/src/main.ts - File views
frontend/src/views/files/Files.vue - Share views
frontend/src/views/shares/Shares.vue - Admin views
frontend/src/views/Admin.vue
Edge security
- nginx gateway
Application workflows
- Auth endpoints
backend/src/main/java/com/jdy/cloud/controller/AuthController.java - File endpoints
backend/src/main/java/com/jdy/cloud/controller/FileController.java - Share endpoints
backend/src/main/java/com/jdy/cloud/controller/ShareController.java - Admin endpoints
backend/src/main/java/com/jdy/cloud/controller/AdminController.java - Account services
backend/src/main/java/com/jdy/cloud/service/AuthService.java - File services
backend/src/main/java/com/jdy/cloud/service/FileService.java - Share services
backend/src/main/java/com/jdy/cloud/service/ShareService.java - Administration
backend/src/main/java/com/jdy/cloud/service/AdminService.java
IronWall defenses
- Security filters
backend/src/main/java/com/jdy/cloud/security - Attack guard
backend/src/main/java/com/jdy/cloud/security/AttackGuardService.java - Upload safety
backend/src/main/java/com/jdy/cloud/security/FileContentSafetyService.java - Storage encryption
backend/src/main/java/com/jdy/cloud/security/StorageCryptoService.java
Persistence
- Data repositories
backend/src/main/java/com/jdy/cloud/repository - MySQL
- Encrypted files
Other components
- Browser user
- Email service
- fail2ban
Connections 28
- Browser user → nginx gateway: sends requests
README.md - nginx gateway → Vue application: serves SPA
README.md - nginx gateway → Security filters: proxies API
README.md - Vue application → File views: renders views
frontend/src/main.ts - Vue application → Share views: routes views
- Vue application → Admin views: routes views
- File views → File endpoints: uses file API
README.md - Share views → Share endpoints: uses share API
README.md - Admin views → Admin endpoints: uses admin API
README.md - Security filters → Auth endpoints: admits requests
README.md - Security filters → File endpoints: admits requests
README.md - Security filters → Share endpoints: admits requests
README.md - Security filters → Admin endpoints: admits requests
README.md - Security filters → Attack guard: checks threats
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
backend/src/main/java/com/jdy/cloud/controller/AdminController.java - File services → Upload safety: checks uploads
backend/src/main/java/com/jdy/cloud/service/FileService.java - File services → Storage encryption: encrypts files
backend/src/main/java/com/jdy/cloud/service/FileService.java - Account services → Email service: sends messages
- Account services → Data repositories: persists accounts
backend/src/main/java/com/jdy/cloud/service/AuthService.java - File services → Data repositories: persists metadata
backend/src/main/java/com/jdy/cloud/service/FileService.java - Share services → Data repositories: persists shares
backend/src/main/java/com/jdy/cloud/service/ShareService.java - Administration → Data repositories: manages records
backend/src/main/java/com/jdy/cloud/service/AdminService.java - Data repositories → MySQL: reads and writes
README.md - Storage encryption → Encrypted files: encrypts at rest
README.md - Attack guard → fail2ban: syncs bans
README.md