# postreen/multimedia-service architecture

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

- Interactive diagram: https://gitdiagram.com/postreen/multimedia-service
- Repository: https://github.com/postreen/multimedia-service

## Overview

Rugid Multimedia Service is a Spring-based media file service. Clients upload, retrieve, delete, or request the default ID for images and videos; REST endpoints validate requests and dispatch to shared domain use cases, with file bytes persisted by a filesystem adapter. It also exposes an image gRPC adapter. The README gives no capability details, so the workflow is grounded mainly in the source index and shown excerpts; unsampled wiring is omitted where it cannot be established.

Main entry points: [`src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java) (Image REST API), [`src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java) (Video REST API), [`src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java`](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java) (File Output Port), [`src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java`](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java) (Upload Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inbound["Inbound APIs"]
  node_image_api["Image REST API<br/>[ImageEndpoint.java]"]
  node_video_api["Video REST API<br/>[VideoEndpoint.java]"]
  node_grpc_api["Image gRPC API"]
end

subgraph group_domain["Media Use Cases"]
  node_upload["Upload Service"]
  node_download["Download Service"]
  node_delete["Delete Service"]
  node_default_id["Default ID Service"]
  node_upload_port["Upload Use Case"]
  node_download_port["Download Use Case"]
  node_delete_port["Delete Use Case"]
  node_default_port["Default ID Use Case"]
end

subgraph group_storage["File Storage"]
  node_file_port["File Output Port"]
  node_file_adapter["System File Adapter"]
end

subgraph group_support["Validation and Errors"]
  node_dto_validator["DTO Validator"]
  node_exception_handler["Exception Handler"]
end

node_client(("API Client"))
node_filesystem[("Local Filesystem")]

node_client -->|"calls REST"| node_image_api
node_client -->|"calls REST"| node_video_api
node_client -.->|"calls gRPC"| node_grpc_api
node_image_api -->|"validates requests"| node_dto_validator
node_video_api -->|"validates requests"| node_dto_validator
node_image_api -->|"invokes upload"| node_upload
node_image_api -->|"invokes download"| node_download
node_image_api -->|"invokes delete"| node_delete
node_image_api -->|"requests default ID"| node_default_id
node_video_api -->|"invokes upload"| node_upload
node_video_api -->|"invokes delete"| node_delete
node_video_api -->|"requests default ID"| node_default_id
node_grpc_api -.->|"references use case"| node_delete_port
node_upload -->|"writes media"| node_file_port
node_download -->|"reads media"| node_file_port
node_delete -->|"deletes media"| node_file_port
node_file_adapter -->|"implements port"| node_file_port
node_file_adapter -->|"reads and writes"| node_filesystem
node_dto_validator -.->|"raises validation error"| node_exception_handler

click node_image_api "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java"
click node_video_api "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java"
click node_grpc_api "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java"
click node_upload "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java"
click node_download "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java"
click node_delete "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java"
click node_default_id "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/GetDefaultFileUrlService.java"
click node_upload_port "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/UploadFileUseCase.java"
click node_download_port "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/DownloadFileUseCase.java"
click node_delete_port "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/DeleteFileUseCase.java"
click node_default_port "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/GetDefaultFileUrlUseCase.java"
click node_file_port "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java"
click node_file_adapter "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java"
click node_dto_validator "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/validator/JsonDtoValidator.java"
click node_exception_handler "https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/exception/handler/GlobalExceptionHandler.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_image_api,node_video_api,node_grpc_api,node_client toneBlue
class node_upload,node_download,node_delete,node_default_id,node_upload_port,node_download_port,node_delete_port,node_default_port,node_filesystem toneAmber
class node_file_port,node_file_adapter toneMint
class node_dto_validator,node_exception_handler toneRose
```

## Components

### Inbound APIs

- [Image REST API](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java): `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`
- [Video REST API](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java): `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`
- [Image gRPC API](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java): `src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java`

### Media Use Cases

- [Upload Service](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java): `src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java`
- [Download Service](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java): `src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java`
- [Delete Service](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java): `src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java`
- [Default ID Service](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/core/service/GetDefaultFileUrlService.java): `src/main/java/com/rugid/multimediaservice/domain/core/service/GetDefaultFileUrlService.java`
- [Upload Use Case](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/UploadFileUseCase.java): `src/main/java/com/rugid/multimediaservice/domain/port/in/UploadFileUseCase.java`
- [Download Use Case](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/DownloadFileUseCase.java): `src/main/java/com/rugid/multimediaservice/domain/port/in/DownloadFileUseCase.java`
- [Delete Use Case](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/DeleteFileUseCase.java): `src/main/java/com/rugid/multimediaservice/domain/port/in/DeleteFileUseCase.java`
- [Default ID Use Case](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/in/GetDefaultFileUrlUseCase.java): `src/main/java/com/rugid/multimediaservice/domain/port/in/GetDefaultFileUrlUseCase.java`

### File Storage

- [File Output Port](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java): `src/main/java/com/rugid/multimediaservice/domain/port/out/FileOutputPort.java`
- [System File Adapter](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java): `src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java`

### Validation and Errors

- [DTO Validator](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/rest/validator/JsonDtoValidator.java): `src/main/java/com/rugid/multimediaservice/adapter/in/rest/validator/JsonDtoValidator.java`
- [Exception Handler](https://github.com/postreen/multimedia-service/blob/main/src/main/java/com/rugid/multimediaservice/adapter/in/exception/handler/GlobalExceptionHandler.java): `src/main/java/com/rugid/multimediaservice/adapter/in/exception/handler/GlobalExceptionHandler.java`

### Other components

- **API Client**
- **Local Filesystem**

## Connections

- API Client → Image REST API: calls REST (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- API Client → Video REST API: calls REST (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`)
- API Client → Image gRPC API: calls gRPC
- Image REST API → DTO Validator: validates requests (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- Video REST API → DTO Validator: validates requests (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`)
- Image REST API → Upload Service: invokes upload (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- Image REST API → Download Service: invokes download (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- Image REST API → Delete Service: invokes delete (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- Image REST API → Default ID Service: requests default ID (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/ImageEndpoint.java`)
- Video REST API → Upload Service: invokes upload (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`)
- Video REST API → Delete Service: invokes delete (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`)
- Video REST API → Default ID Service: requests default ID (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/rest/controller/VideoEndpoint.java`)
- Image gRPC API → Delete Use Case: references use case (evidence: `src/main/java/com/rugid/multimediaservice/adapter/in/grpc/ImageServiceGrpc.java`)
- Upload Service → File Output Port: writes media (evidence: `src/main/java/com/rugid/multimediaservice/domain/core/service/UploadFileService.java`)
- Download Service → File Output Port: reads media (evidence: `src/main/java/com/rugid/multimediaservice/domain/core/service/DownloadFileService.java`)
- Delete Service → File Output Port: deletes media (evidence: `src/main/java/com/rugid/multimediaservice/domain/core/service/DeleteFileService.java`)
- System File Adapter → File Output Port: implements port (evidence: `src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java`)
- System File Adapter → Local Filesystem: reads and writes (evidence: `src/main/java/com/rugid/multimediaservice/adapter/out/persistence/SystemFileStorageAdapter.java`)
- DTO Validator → Exception Handler: raises validation error
