# yunuspektass/asp.net-core-web-api-minio-object-storage-integration architecture

> Architecture diagram of the GitHub repository yunuspektass/asp.net-core-web-api-minio-object-storage-integration, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yunuspektass/asp.net-core-web-api-minio-object-storage-integration
- Repository: https://github.com/yunuspektass/asp.net-core-web-api-minio-object-storage-integration

## Overview

##### Main Components

- Presentation Layer (WebAPI)
- Business Layer (Business)
- Data Access Layer (DataAccess)
- Domain Layer (Domain)
- Core Layer (Core)

b) External Systems:
- MinIO Object Storage
- Client Applications
- Database (Entity Framework Core)

##### Architectural Pattern Representation

**[Client Applications] → [WebAPI Layer]**
- ↓
- [Business Layer]
- ↓
- [Data Access Layer] → [Database]
- ↓
- [Domain Layer]
- ↓
- [Core Layer]

##### Component Details

WebAPI Layer (Controllers):
- FileController with main endpoints
- Swagger/OpenAPI documentation
- API routing and middleware

Business Layer:
- FileManager service
- DTOs (FileCreateDto, FileGetDto, FileUpdateDto)
- AutoMapper profiles

Data Access Layer:
- Repository pattern implementation
- UnitOfWork pattern
- Entity Framework Context
- MinIO client integration

Domain Layer:
- FileInfo entity
- Relationship with Core entities

##### Integration Points

Clear connections between:
- API endpoints and MinIO storage
- Repository layer and database
- Business logic and external services

##### Data Flow Representation

- → Synchronous calls
- ⇢ Asynchronous operations
- ⇄ Two-way communication

##### Specific Implementation Details

- Dependency injection container
- Entity Framework configuration
- MinIO configuration
- Authentication/Authorization (if implemented)

##### Additional Elements

Include:
- Version information
- Technology stack list
- Main configuration points

##### Technical Details to Highlight

- File operations (upload, download, list, delete)
- MinIO SDK integration points
- Database operations
- Error handling flow
- DTOs and mapping

This system design should emphasize the project's focus on file management and object storage while maintaining clean architecture principles and separation of concerns.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        CA[Client Applications]
    end

    subgraph WebAPI
        FC["FileController"]:::api
        SW["Swagger/OpenAPI"]:::api
        PC["Program.cs"]:::api
        AS["appsettings.json"]:::api
    end

    subgraph Business
        FS["IFileService"]:::business
        FM["FileManager"]:::business
        subgraph DTOs
            FCD["FileCreateDto"]:::business
            FGD["FileGetDto"]:::business
            FUD["FileUpdateDto"]:::business
        end
        MP["MappingProfile"]:::business
    end

    subgraph DataAccess
        IR["IRepository"]:::data
        BR["BaseRepository"]:::data
        FR["FileRepository"]:::data
        IU["IUnitOfWork"]:::data
        UW["UnitOfWork"]:::data
        DC["FileManagementDbContext"]:::data
        MG["Migrations"]:::data
    end

    subgraph Domain
        FI["FileInfo Entity"]:::domain
    end

    subgraph Core
        BE["BaseEntity"]:::core
        ME["ModelBuilderExtensions"]:::core
        SD["ISoftDeletable"]:::core
    end

    subgraph External
        DB[(Database)]:::external
        MS[(MinIO Storage)]:::external
    end

    %% Relationships
    CA --> FC
    FC --> FS
    FS --> FM
    FM --> IR
    FM --> MS
    IR --> BR
    BR --> FR
    FR --> DC
    DC --> DB
    FR --> FI
    FI --> BE
    FI --> SD
    DC --> ME

    %% DTOs Relationships
    FM --> FCD
    FM --> FGD
    FM --> FUD
    MP --> FCD
    MP --> FGD
    MP --> FUD

    %% UnitOfWork Relationships
    FR --> IU
    IU --> UW
    UW --> DC

    %% Styling
    classDef api fill:#2196F3,stroke:#1565C0,color:white
    classDef business fill:#4CAF50,stroke:#2E7D32,color:white
    classDef data fill:#FF9800,stroke:#EF6C00,color:white
    classDef domain fill:#FFEB3B,stroke:#FBC02D,color:black
    classDef core fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef external fill:#9E9E9E,stroke:#424242,color:white

    %% Click Events
    click FC "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/WebAPI/Controllers/FileController.cs"
    click PC "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/WebAPI/Program.cs"
    click AS "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/WebAPI/appsettings.json"
    click FS "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/Abstract/IFileService.cs"
    click FM "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/Concrete/FileManager.cs"
    click FCD "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/DTOs/FileCreateDto.cs"
    click FGD "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/DTOs/FileGetDto.cs"
    click FUD "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/DTOs/FileUpdateDto.cs"
    click MP "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Business/Mapping/MappingProfile.cs"
    click IR "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/Abstract/IRepository.cs"
    click BR "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/Concrete/BaseRepository.cs"
    click FR "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/Concrete/FileRepository.cs"
    click IU "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/Abstract/IUnitOfWork.cs"
    click UW "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/Concrete/UnitOfWork.cs"
    click DC "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/DataAccess/FileManagementDbContext.cs"
    click MG "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/tree/main/DataAccess/Migrations"
    click FI "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Domain/Entities/FileInfo.cs"
    click BE "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Core/Entities/BaseEntity.cs"
    click ME "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Core/Domain/Extensions/ModelBuilderExtensions.cs"
    click SD "https://github.com/yunuspektass/ASP.NET-Core-Web-API-MinIO-Object-Storage-Integration/blob/main/Core/Domain/ISoftDeletable.cs"
```
