# ssaisriharsha/personal-cloud-storage architecture

> Architecture diagram of the GitHub repository ssaisriharsha/personal-cloud-storage, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ssaisriharsha/personal-cloud-storage
- Repository: https://github.com/ssaisriharsha/personal-cloud-storage

## Overview

##### 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

## Diagram (Mermaid)

```mermaid
flowchart TD
    Client["Client\n(Browser/Mobile)"]:::external
    Client -->|"HTTP JSON"| SFCConfig

    subgraph "Spring Boot Application"
        direction TB
        style SpringBootApp stroke-dasharray: 5 5

        SFCConfig["Spring Security Filter Chain\n(SFCConfig)"]:::security

        subgraph Controllers
            direction TB
            AuthController["AuthController"]:::controller
            FileOperationsController["FileOperationsController"]:::controller
        end

        RestAdvice["RestAdvice\n(Global Exception Handler)"]:::exception

        subgraph Services
            direction TB
            AuthService["AuthService"]:::service
            FileManagementService["FileManagementService"]:::service
            AppUserDetailsService["AppUserDetailsService"]:::service
            AppUserDetails["AppUserDetails"]:::service
        end

        subgraph Repositories
            direction TB
            AppUserRepository["AppUserRepository"]:::repo
            FileRepository["FileRepository"]:::repo
        end

        subgraph Datastores
            direction TB
            RelationalDB["Relational DB"]:::datastore
            FileStorage["File Storage"]:::datastore
        end

        SFCConfig --> AuthController
        SFCConfig --> FileOperationsController

        AuthController --> AuthService
        FileOperationsController --> FileManagementService

        AuthController --> RestAdvice
        FileOperationsController --> RestAdvice

        AuthService --> AppUserDetailsService
        AppUserDetailsService --> AppUserDetails

        AuthService --> AppUserRepository
        FileManagementService --> FileRepository
        FileManagementService --> FileStorage

        AppUserRepository -->|"JPA"| RelationalDB
        FileRepository -->|"JPA"| RelationalDB

        RelationalDB -->|"JDBC"| AppUserRepository
        RelationalDB -->|"JDBC"| FileRepository

        FileStorage -->|"File I/O / S3 API"| FileManagementService
        RestAdvice -.-> Client
    end

    classDef controller fill:#feb668,stroke:#333,stroke-width:1px
    classDef service fill:#8fd5e1,stroke:#333,stroke-width:1px
    classDef repo fill:#b4f29b,stroke:#333,stroke-width:1px
    classDef datastore fill:#d3d3d3,stroke:#333,stroke-width:1px
    classDef security fill:#f9d1ff,stroke:#333,stroke-width:1px
    classDef exception fill:#ffc0cb,stroke:#333,stroke-width:1px
    classDef external fill:#ffffff,stroke:#333,stroke-width:1px

    click AuthController "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/controllers/AuthController.java"
    click FileOperationsController "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/controllers/FileOperationsController.java"
    click SFCConfig "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/SecurityConfig/SFCConfig.java"
    click AppUserDetails "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/SecurityConfig/AppUserDetails.java"
    click AppUserDetailsService "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/services/AppUserDetailsService.java"
    click AuthService "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/services/AuthService.java"
    click FileManagementService "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/services/FileManagementService.java"
    click AppUserRepository "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/models/repositories/AppUserRepository.java"
    click FileRepository "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/models/repositories/FileRepository.java"
    click RestAdvice "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/ExceptionHandlers/RestAdvice.java"
    click AppUserDetailsService "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/services/AppUserDetailsService.java"
    click RelationalDB "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/models/entities/AppUser.java"
    click FileStorage "https://github.com/ssaisriharsha/personal-cloud-storage/blob/main/src/main/java/com/ssaisriharsha/PersonalCloudStorage/models/entities/UserFile.java"
```
