# practika2024/backend_api architecture

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

- Interactive diagram: https://gitdiagram.com/practika2024/backend_api
- Repository: https://github.com/practika2024/backend_api

## Overview

##### Project Type and Purpose
- This is a back-end API built on ASP .NET Core (C#) using a classic layered architecture (API, Application, Domain, DataAccess).
- Its purpose is to manage users, containers, container histories, products, product types, reminders, and reminder types. It includes authentication, authorization, email verification, image uploading, and pagination.

##### File Structure
- Top-level solution (.sln) with “src” and “tests” folders.
- “src/Api”: ASP .NET Core Web API project (Controllers, DTOs, MappingProfiles, Modules, Program.cs, configuration files, Dockerfile).
- “src/Application”: business logic via Commands, Behaviours, Interfaces, Services (EmailService, HashPasswordService, ImageService, PaginationService, ReminderService, JwtTokenService).
- “src/Domain”: pure domain entities and models.
- “src/DataAccessLayer”: EF Core context, Migrations, Entities, Configurations, Repositories, MappingProfiles.
- “tests”: Integration tests for API controllers and common test helpers/data.

##### README

a. Main Components
- API Layer
– ASP .NET Core Web API (Controllers, DTOs, Error Handlers, DI Modules)
- Application Layer
– Command/Query Handlers, Validators (FluentValidation), Business Services (Email/Hashing/Image/Token/Pagination/Reminder)
- Domain Layer
– Core domain models and interfaces/abstractions
- DataAccess Layer
– EF Core DbContext, Repositories, Mappings, Migrations
- Database
– Relational database (e.g., SQL Server or Postgres)
- Test Harness
– Integration tests against in-memory or test DB

b. Relationships & Interactions
1. HTTP Request → API Controllers
2. Controllers use injected Application interfaces (IUserProvider, ICommandHandler, IQueries)
3. Application layer orchestrates domain models and calls DataAccessLayer repositories via interfaces
4. DataAccessLayer translates to SQL and reads/writes to Database
5. Services in Application (EmailService, JwtTokenService, etc.) are invoked by commands/handlers
6. Responses bubble back through API (mapped via AutoMapper) to client

c. Architectural Patterns & Principles
- Layered (Clean Architecture) separation: keep UI (API) separate from business rules (Application), from data concerns (DataAccess).
- Dependency Inversion: API → Application → Domain; DataAccess implements Domain/Application interfaces.
- CQRS-like Command/Query segregation in Application layer.
- Repository pattern in DataAccess for persistence abstraction.
- Middleware for cross-cutting concerns (error handling, user validation).

d. Key Technologies & Frameworks
- ASP .NET Core Web API
- Entity Framework Core (DbContext, Migrations)
- AutoMapper (MappingProfiles across layers)
- FluentValidation (Validators in Application)
- Docker / docker-compose for containerization
- xUnit (.NET) and custom Test Common libraries for integration testing

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Layers stacked vertically
    subgraph "API Layer"
        direction TB
        Controllers["Controllers"]:::api
        DTOs["DTOs"]:::api
        ApiMapping["AutoMapper Profiles"]:::api
        Modules["DI Modules & Errors"]:::api
        Program["Program.cs & appsettings.json"]:::api
        Docker["Dockerfile & .dockerignore"]:::api
    end

    subgraph "Application Layer"
        direction TB
        Commands["Commands & CQRS Handlers"]:::app
        Behaviours["MediatR Behaviours & Validators"]:::app
        Interfaces["Interfaces (Providers, Queries)"]:::app
        Services["Services (Email, Hash, Image, Pagination, Reminder, JWT)"]:::app
        AppMapping["MappingProfiles"]:::app
        Middlewares["Middlewares (Exception, User Validation)"]:::app
        ConfigureApp["ConfigureApplication.cs"]:::app
    end

    subgraph "Domain Layer"
        direction TB
        Entities["Core Entities & Models"]:::domain
        DomainCommon["Common Abstractions & Interfaces"]:::domain
    end

    subgraph "DataAccess Layer"
        direction TB
        DbContext["ApplicationDbContext & Initializer"]:::data
        Configurations["Entity Configurations"]:::data
        Converters["Converters"]:::data
        Repositories["Repository Implementations"]:::data
        DalMapping["MappingProfiles"]:::data
        Migrations["Migrations"]:::data
    end

    Database["Database"]:::db

    subgraph "Test Harness"
        direction TB
        IntegrationTests["Integration Tests"]:::test
        TestCommon["Test Helpers & Data"]:::test
    end

    %% Relationships
    HTTP["HTTP Request"]:::external -->|"/api/.../"| Controllers
    Controllers -->|calls| Interfaces
    Controllers -->|maps via| ApiMapping
    Controllers -->|configured by| Modules

    Interfaces -->|implemented by| Repositories
    Commands -->|invoke| Services
    Commands -->|use| Entities
    Behaviours -->|validate| Commands
    Services -->|operate on| DomainCommon
    Services -->|use| Repositories

    Repositories -->|use| DbContext
    DbContext -->|reads/writes| Database
    Configurations -->|configure| DbContext
    Converters -->|convert| DbContext
    DalMapping -->|map| Repositories
    Migrations -->|define| Database

    Middlewares -->|wrap| Controllers
    ConfigureApp -->|bootstraps| Behaviours
    ConfigureApp -->|bootstraps| Middlewares

    IntegrationTests -->|test| Controllers
    IntegrationTests -->|use| TestCommon
    TestCommon -->|setup| Database

    %% Click Events for component mapping
    click Controllers "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Api/Controllers"
    click DTOs "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Api/Dtos"
    click ApiMapping "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Api/MappingProfiles"
    click Modules "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Api/Modules"
    click Program "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/Api/Program.cs"
    click Docker "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Dockerfile"
    click Docker "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/.dockerignore"

    click Commands "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Application/Commands"
    click Behaviours "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/Application/Common/Behaviours/ValidationBehaviour.cs"
    click Interfaces "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Application/Common/Interfaces"
    click Services "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Application/Services"
    click AppMapping "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Application/MappingProfiles"
    click Middlewares "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Application/Middlewares"
    click ConfigureApp "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/Application/ConfigureApplication.cs"

    click Entities "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Domain"
    click DomainCommon "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/Domain/Common"

    click DbContext "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/DataAccessLayer/Data/ApplicationDbContext.cs"
    click DbContext "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/src/DataAccessLayer/Data/ApplicationDbContextInitializer.cs"
    click Configurations "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/DataAccessLayer/Data/Configurations"
    click Converters "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/DataAccessLayer/Converters"
    click Repositories "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/DataAccessLayer/Repositories"
    click DalMapping "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/DataAccessLayer/MappingProfiles"
    click Migrations "https://github.com/practika2024/backend_api/tree/main/TermPaperApi/src/DataAccessLayer/Migrations"

    click IntegrationTests "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/tests/Api.Tests.Integration"
    click TestCommon "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/tests/Tests.Common"
    click TestCommon "https://github.com/practika2024/backend_api/blob/main/TermPaperApi/tests/Tests.Data"

    %% Styles
    classDef api fill:#cce5ff,stroke:#004085,color:#004085;
    classDef app fill:#d4edda,stroke:#155724,color:#155724;
    classDef domain fill:#fff3cd,stroke:#856404,color:#856404;
    classDef data fill:#e2e3e5,stroke:#6c757d,color:#6c757d;
    classDef db fill:#f5c6cb,stroke:#721c24,color:#721c24,stroke-dasharray: 5 5;
    classDef test fill:#ffeeba,stroke:#856404,color:#856404;
    classDef external fill:#d6d8d9,stroke:#1b1e21,color:#1b1e21;
```
