# anujshukla2610/the-drive architecture

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

- Interactive diagram: https://gitdiagram.com/anujshukla2610/the-drive
- Repository: https://github.com/anujshukla2610/the-drive

## Overview

Drive-BE is a Spring backend for managing files and folder membership. A client uploads a file through the HTTP API; the service saves its contents on disk and its metadata in the repository. Clients can list folder contents, download a file by ID, or delete it. The controller owns the download and deletion disk operations, while the service owns metadata access. The excerpts show the file and JPA repository layers, but do not reveal database configuration or other integrations.

Main entry points: [`Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java) (File controller), [`Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java`](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java) (File service), [`Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java`](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java) (File repository), [`Drive-BE/src/main/java/com/anuj/Drive_BE/entity/FileEntity.java`](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/entity/FileEntity.java) (File metadata)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["File controller"]
end

subgraph group_files["File operations"]
  node_service["File service"]
  node_disk["Local file disk"]
end

subgraph group_metadata["Metadata persistence"]
  node_entity["File metadata<br/>[FileEntity.java]"]
  node_repository["File repository"]
  node_database[("JPA database")]
end

node_client(("Client"))

node_client -->|"calls endpoints"| node_controller
node_controller -->|"delegates requests"| node_service
node_service -->|"writes uploads"| node_disk
node_controller -->|"reads and deletes"| node_disk
node_service -->|"creates metadata"| node_entity
node_controller -->|"reads file fields"| node_entity
node_service -->|"queries and saves"| node_repository
node_repository -->|"persists records"| node_entity
node_repository -->|"uses JPA"| node_database

click node_controller "https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java"
click node_service "https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java"
click node_entity "https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/entity/FileEntity.java"
click node_repository "https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java"

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_controller,node_client toneBlue
class node_service,node_disk toneAmber
class node_entity,node_repository,node_database toneMint
```

## Components

### HTTP API

- [File controller](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java): `Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`

### File operations

- [File service](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java): `Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java`
- **Local file disk**

### Metadata persistence

- [File metadata](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/entity/FileEntity.java): `Drive-BE/src/main/java/com/anuj/Drive_BE/entity/FileEntity.java`
- [File repository](https://github.com/anujshukla2610/the-drive/blob/main/Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java): `Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java`
- **JPA database**

### Other components

- **Client**

## Connections

- Client → File controller: calls endpoints (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`)
- File controller → File service: delegates requests (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`)
- File service → Local file disk: writes uploads (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java`)
- File controller → Local file disk: reads and deletes (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`)
- File service → File metadata: creates metadata (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java`)
- File controller → File metadata: reads file fields (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/controller/FileController.java`)
- File service → File repository: queries and saves (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/services/FileServiceStorage.java`)
- File repository → File metadata: persists records (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java`)
- File repository → JPA database: uses JPA (evidence: `Drive-BE/src/main/java/com/anuj/Drive_BE/repo/FileRepository.java`)
