# giorgospap2/abacus-hiring architecture

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

- Interactive diagram: https://gitdiagram.com/giorgospap2/abacus-hiring
- Repository: https://github.com/giorgospap2/abacus-hiring

## Overview

##### Project Type and Purpose
- This is a full-stack, web-based hiring application.
- Frontend: Angular Single-Page App in the abacus_hiring.client folder.
- Backend: ASP.NET Core Web API solution (Abacus_Hiring.Server + supporting class-library projects) organized around a Clean Architecture + CQRS pattern.
- Purpose: Manage user sign-up, login, hiring applications (create, update, delete, view), generate PDFs, and send email notifications.

##### File Structure
- Top-level split:
- abacus_hiring.client — Angular code: models, services, pages, routing, pipes, assets.
- Abacus_Hiring.Server (.csproj, Controllers, Program.cs, settings) — the Web API entry point.
- Abacus_hiring.Server.Application — application layer: abstractions (IEmailService, IHiringApplicationRepository), commands, queries, handlers, dependency-injection glue.
- Abacus_hiring.Server.Domain — domain layer: entities (User, HiringApplication, EmailObligation, ApplicationStatus), DTOs for create/update/view models.
- Abacus_hiring.Server.Infrastructure — infrastructure layer: EF Core DbContext, Migrations, Repositories, BackgroundServices (EmailSendingService), external-service adapters (EmailService), dependency-injection.
- Additional files: HTTP-client scripts (.http), EF migration SQL, launchSettings, appsettings.json.

##### README
- It is currently a placeholder; it does not define architecture explicitly. We rely on code structure.

##### Main Components and Their Interactions
a. Frontend (Angular SPA)
– Runs in user’s browser.
– Hosts pages for Sign-Up, Log-In, User Home, Application Forms, File Upload, Email Forms.
– Communicates via HTTP/HTTPS to the Web API.
b. Web API (ASP.NET Core)
– Controllers (HiringController) receive HTTP requests (REST endpoints).
– Forward commands/queries to Application layer.
c. Application Layer (CQRS)
– Commands: e.g., CreateUser, InitializeHiringApplication, UpdateHiringApplication, CreatePDF, CreateEmailObligation.
– Queries: e.g., GetUserByCredentials, GetAllHiringApplications, GetHiringApplicationById/Token.
– Handlers implement business logic and orchestrate domain entities & infrastructure services.
d. Domain Layer
– Defines core entities, aggregates, and DTOs.
e. Infrastructure Layer
– Persistence: EF Core DbContext → SQL Database.
– Repositories implement IHiringApplicationRepository and IEmailService interfaces.
– BackgroundServices: EmailSendingService reads queued EmailObligation entities and sends via SMTP.
– MigrationUtility scripts for DB schema.
f. External Services
– SMTP Email provider (for outgoing mails).
– PDF library (invoked in CreatePDFHandler).

##### Architectural Patterns and Design Principles
- Clean Architecture / Onion: clear dependency rule (outer layers depend on inner).
- CQRS: separation of commands (state changes) and queries (data retrieval).
- Repository pattern: abstracts data access.
- Dependency-Injection (Microsoft.Extensions.DependencyInjection) in each project’s DependencyInjection.cs.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        AngularSPA["Angular SPA"]:::frontend
    end

    %% API Layer
    subgraph "API Layer" 
        direction TB
        Program["Program.cs"]:::backend
        SettingsDev["appsettings.Development.json"]:::backend
        Settings["appsettings.json"]:::backend
        HiringController["HiringController"]:::backend
        HTTPTests["HTTP-client Scripts"]:::backend
    end

    %% Application & Domain Layer
    subgraph "Application & Domain Layer"
        direction TB
        AppDI["Application DI"]:::appdomain
        Abstractions["IEmailService & IHiringApplicationRepository"]:::appdomain
        subgraph "Commands & Handlers"
            direction TB
            CreateUserHandler["CreateUserHandler"]:::appdomain
            InitializeHiringHandler["InitializeHiringApplicationHandler"]:::appdomain
            UpdateHiringHandler["UpdateHiringApplicationHandler"]:::appdomain
            DeleteHiringHandler["DeleteHiringApplicationHandler"]:::appdomain
            CreatePDFHandler["CreatePDFHandler"]:::appdomain
            CreateEmailObligationHandler["CreateEmailObligationHandler"]:::appdomain
        end
        subgraph "Queries & Handlers"
            direction TB
            QueryHandlers["Query Handlers"]:::appdomain
        end
        Entities["Domain Entities"]:::appdomain
        DTOs["Domain DTOs"]:::appdomain
    end

    %% Infrastructure Layer
    subgraph "Infrastructure & External Systems"
        direction TB
        InfraDI["Infrastructure DI"]:::infra
        DbContext["ApplicationDBContext"]:::infra
        Migrations["EF Migrations"]:::infra
        MigrationUtility["MigrationUtility & SQL Scripts"]:::infra
        subgraph "Repositories & Services"
            direction TB
            HiringRepo["HiringApplicationRepository"]:::infra
            EmailServiceImpl["EmailService"]:::infra
            EmailSender["EmailSendingService"]:::infra
        end
        subgraph "External Services"
            direction TB
            SMTP["SMTP Email Provider"]:::external
            PDFLib["PDF Generation Library"]:::external
            SQLDB["SQL Database"]:::external
        end
    end

    %% Connections
    AngularSPA -->|HTTP/JSON| HiringController
    HiringController -->|Dispatch| AppDI
    AppDI --> Abstractions
    Abstractions --> CreateUserHandler
    Abstractions --> InitializeHiringHandler
    Abstractions --> UpdateHiringHandler
    Abstractions --> DeleteHiringHandler
    Abstractions --> CreatePDFHandler
    Abstractions --> CreateEmailObligationHandler
    CreateEmailObligationHandler --> EmailServiceImpl
    CreatePDFHandler --> PDFLib
    CreateUserHandler --> Entities
    InitializeHiringHandler --> Entities
    UpdateHiringHandler --> Entities
    DeleteHiringHandler --> Entities
    QueryHandlers -->|Read| DbContext
    CreateUserHandler -->|SaveChanges| DbContext
    InitializeHiringHandler -->|SaveChanges| DbContext
    UpdateHiringHandler -->|SaveChanges| DbContext
    DeleteHiringHandler -->|SaveChanges| DbContext
    EmailSender -->|Read Queue| DbContext
    EmailSender -->|SMTP.Mail| SMTP
    HiringRepo -->|CRUD| DbContext
    InfraDI --> HiringRepo
    InfraDI --> EmailServiceImpl
    AppDI --> InfraDI

    %% Click Events
    click AngularSPA "https://github.com/giorgospap2/abacus-hiring/tree/main/abacus_hiring.client/"
    click Program "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_Hiring.Server/Program.cs"
    click Settings "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_Hiring.Server/appsettings.json"
    click SettingsDev "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_Hiring.Server/appsettings.Development.json"
    click HiringController "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_Hiring.Server/Controllers/HiringController.cs"
    click HTTPTests "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_Hiring.Server/Abacus_Hiring.Server.http"
    click AppDI "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/DependencyInjection.cs"
    click Abstractions "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Abstractions/IEmailService.cs"
    click Abstractions "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Abstractions/IHiringApplicationRepository.cs"
    click CreateUserHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Hiring/CommandHandlers/CreateUserHandler.cs"
    click InitializeHiringHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Hiring/CommandHandlers/InitializeHiringApplicationHandler.cs"
    click UpdateHiringHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Hiring/CommandHandlers/UpdateHiringApplicationHandler.cs"
    click DeleteHiringHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Hiring/CommandHandlers/DeleteHiringApplicationHandler.cs"
    click CreatePDFHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Hiring/CommandHandlers/CreatePDFHandler.cs"
    click CreateEmailObligationHandler "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Application/Email/CommandHandlers/CreateEmailObligationHandler.cs"
    click QueryHandlers "https://github.com/giorgospap2/abacus-hiring/tree/main/Abacus_hiring.Server.Application/Hiring/QueryHandlers/"
    click Entities "https://github.com/giorgospap2/abacus-hiring/tree/main/Abacus_hiring.Server.Domain/Entities/"
    click DTOs "https://github.com/giorgospap2/abacus-hiring/tree/main/Abacus_hiring.Server.Domain/DTO/"
    click InfraDI "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/DependencyInjection.cs"
    click DbContext "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/Persistance/ApplicationDBContext.cs"
    click Migrations "https://github.com/giorgospap2/abacus-hiring/tree/main/Abacus_hiring.Server.Infrastructure/Migrations/"
    click MigrationUtility "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/MigrationUtility.cs"
    click HiringRepo "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/Repositories/HiringApplicationRepository/HiringApplicationRepository.cs"
    click EmailServiceImpl "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/Repositories/EmailService/EmailService.cs"
    click EmailSender "https://github.com/giorgospap2/abacus-hiring/blob/main/Abacus_hiring.Server.Infrastructure/BackgoundServices/EmailSendingService.cs"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef backend fill:#98FB98,stroke:#000,stroke-width:1px
    classDef appdomain fill:#FFFACD,stroke:#000,stroke-width:1px
    classDef infra fill:#FFA07A,stroke:#000,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:1px
```
