How ssaisriharsha/personal-cloud-storage works
Project Type and Purpose
• This is a Spring Boot–based backend service named “PersonalCloudStorage.”
• It exposes REST endpoints for user authentication (signup/login) and file operations (upload, download, list, delete).
• It uses Spring Security for authentication/authorization, Spring Data JPA for persistence, and likely local or cloud‐based file storage.
High-Level Architecture Components
a. Clients (Web/Mobile)
b. API Layer (Spring MVC Controllers)
• AuthController
• FileOperationsController
c. Security Layer (Spring Security)
• SFCConfig (security filter chain)
• AppUserDetails / AppUserDetailsService
d. Service Layer (Business Logic)
• AuthService
• FileManagementService
e. Persistence Layer
• Repositories (AppUserRepository, FileRepository)
• Entities (AppUser, UserFile)
f. Data Storage
• Relational Database (e.g., PostgreSQL, MySQL)
• File Storage (local filesystem or S3/Blob Storage)
g. Exception Handling
• RestAdvice for global exception-to-HTTP mapping
Component Relationships & Data Flows
1. Client → HTTP Request → Controllers
• Authentication requests hit AuthController
• File operations hit FileOperationsController
2. Controllers → Service Layer
• Controller delegates to AuthService or FileManagementService
3. Service Layer → Security & Validation
• AuthService interacts with AppUserDetailsService + PasswordEncoder
• FileManagementService enforces request validation
4. Service Layer → Repository Layer
• Repositories persist/fetch AppUser and UserFile entities
5. Service Layer → File Storage
• FileManagementService writes to/reads from filesystem or object store
6. Service Layer → Controllers → HTTP Response
7. RestAdvice intercepts exceptions at top, returns proper HTTP status & JSON
Architectural Patterns & Principles
• Layered Architecture (Controller → Service → Repository)
• Dependency Injection (Spring-managed beans)
• Separation of Concerns (Authentication vs. File Logic)
• Global Exception Handling (ControllerAdvice)
3. Below that, two side-by-side rectangles:
• “AuthController”
• “FileOperationsController”
4. Under controllers, two rectangles:
• “AuthService”
• “FileManagementService”
5. Under services, two rectangles:
• “AppUserRepository”
• “FileRepository”
6. To the right of repositories:
7. Off to the left: “Client (Browser/Mobile App).”
• Client → SFCConfig → Controllers → Services → Repos/Storage → Controllers → Client