# vishal-3600/file-sharing-manager architecture

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

- Interactive diagram: https://gitdiagram.com/vishal-3600/file-sharing-manager
- Repository: https://github.com/vishal-3600/file-sharing-manager

## Overview

File Sharing Manager is a Spring web application for uploading files, browsing stored files, sharing a file link, downloading, and deleting files; stored files expire after 24 hours and are periodically purged. The main request path is browser → file controller → service → JPA repository, with templates for the user-facing pages. OAuth login and route authorization are configured separately. The service maps persisted entities to response models and raises not-found errors handled globally. The README shows the product visually but gives no textual implementation details; relationships below are limited to the supplied source excerpts and index.

Main entry points: [`src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java) (File service), [`src/main/java/com/company/fileSharingManagement/controller/fileController.java`](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/controller/fileController.java) (File controller), [`src/main/java/com/company/fileSharingManagement/repository/FileRepository.java`](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/repository/FileRepository.java) (File repository), [`src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java`](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java) (Security config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_controller["File controller"]
  node_pages["File pages"]
end

subgraph group_access["Access and runtime"]
  node_security["Security config"]
  node_app["Spring application"]
  node_webconfig["Web config<br/>[WebConfig.java]"]
  node_scheduler["Scheduling config"]
end

subgraph group_files["File operations"]
  node_service["File service"]
  node_serviceapi["Service contract<br/>[FileService.java]"]
  node_model["File model<br/>[FileModel.java]"]
  node_notfound["Not-found error"]
  node_handler["Error handler"]
end

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

node_user(("User"))
node_oauth(("OAuth provider"))

node_user -->|"uses routes"| node_controller
node_controller -->|"calls"| node_serviceapi
node_controller -->|"selects views"| node_pages
node_security -->|"protects routes"| node_controller
node_security -.->|"starts login"| node_oauth
node_service -->|"reads and writes"| node_repository
node_repository -->|"persists"| node_entity
node_service -->|"maps file data"| node_entity
node_service -->|"builds responses"| node_model
node_service -->|"throws"| node_notfound
node_handler -->|"handles"| node_notfound
node_scheduler -.->|"enables scheduled purge"| node_service
node_repository -.->|"JPA operations"| node_database

click node_controller "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/controller/fileController.java"
click node_pages "https://github.com/vishal-3600/file-sharing-manager/tree/main/src/main/resources/templates"
click node_security "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java"
click node_app "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/FileSharingManagementApplication.java"
click node_webconfig "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/WebConfig.java"
click node_scheduler "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/SchedulingConfig.java"
click node_service "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java"
click node_serviceapi "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/service/FileService.java"
click node_model "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/model/FileModel.java"
click node_notfound "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/exception/FileNotFoundException.java"
click node_handler "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/exception/GlobalExceptionHandler.java"
click node_repository "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/repository/FileRepository.java"
click node_entity "https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/entity/FileEntity.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_pages,node_user toneBlue
class node_security,node_app,node_webconfig,node_scheduler toneAmber
class node_service,node_serviceapi,node_model,node_notfound,node_handler toneMint
class node_repository,node_entity,node_database toneRose
class node_oauth toneIndigo
```

## Components

### Web interface

- [File controller](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/controller/fileController.java): `src/main/java/com/company/fileSharingManagement/controller/fileController.java`
- [File pages](https://github.com/vishal-3600/file-sharing-manager/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Access and runtime

- [Security config](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java): `src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java`
- [Spring application](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/FileSharingManagementApplication.java): `src/main/java/com/company/fileSharingManagement/FileSharingManagementApplication.java`
- [Web config](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/WebConfig.java): `src/main/java/com/company/fileSharingManagement/configuration/WebConfig.java`
- [Scheduling config](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/configuration/SchedulingConfig.java): `src/main/java/com/company/fileSharingManagement/configuration/SchedulingConfig.java`

### File operations

- [File service](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java): `src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`
- [Service contract](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/service/FileService.java): `src/main/java/com/company/fileSharingManagement/service/FileService.java`
- [File model](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/model/FileModel.java): `src/main/java/com/company/fileSharingManagement/model/FileModel.java`
- [Not-found error](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/exception/FileNotFoundException.java): `src/main/java/com/company/fileSharingManagement/exception/FileNotFoundException.java`
- [Error handler](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/exception/GlobalExceptionHandler.java): `src/main/java/com/company/fileSharingManagement/exception/GlobalExceptionHandler.java`

### File persistence

- [File repository](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/repository/FileRepository.java): `src/main/java/com/company/fileSharingManagement/repository/FileRepository.java`
- [File entity](https://github.com/vishal-3600/file-sharing-manager/blob/main/src/main/java/com/company/fileSharingManagement/entity/FileEntity.java): `src/main/java/com/company/fileSharingManagement/entity/FileEntity.java`
- **JPA database**

### Other components

- **User**
- **OAuth provider**

## Connections

- User → File controller: uses routes (evidence: `src/main/java/com/company/fileSharingManagement/controller/fileController.java`)
- File controller → Service contract: calls (evidence: `src/main/java/com/company/fileSharingManagement/controller/fileController.java`)
- File controller → File pages: selects views (evidence: `src/main/java/com/company/fileSharingManagement/controller/fileController.java`)
- Security config → File controller: protects routes (evidence: `src/main/java/com/company/fileSharingManagement/configuration/SecurityConfig.java`)
- Security config → OAuth provider: starts login
- File service → File repository: reads and writes (evidence: `src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`)
- File repository → File entity: persists (evidence: `src/main/java/com/company/fileSharingManagement/repository/FileRepository.java`)
- File service → File entity: maps file data (evidence: `src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`)
- File service → File model: builds responses (evidence: `src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`)
- File service → Not-found error: throws (evidence: `src/main/java/com/company/fileSharingManagement/service/FileServiceImpl.java`)
- Error handler → Not-found error: handles (evidence: `src/main/java/com/company/fileSharingManagement/exception/GlobalExceptionHandler.java`)
- Scheduling config → File service: enables scheduled purge
- File repository → JPA database: JPA operations
