# sevdesakar/companyexpensetracking architecture

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

- Interactive diagram: https://gitdiagram.com/sevdesakar/companyexpensetracking
- Repository: https://github.com/sevdesakar/companyexpensetracking

## Overview

##### Project Type and Purpose
- This is a layered .NET 8.0 Web API for a Company Expense Tracking application.
- It implements a clean-architecture style:
- CompanyExpenseTracking.Domain: core entities (Users, Expense, Category)
- CompanyExpenseTracking.Application: business logic / service interfaces
- CompanyExpenseTracking.Infrastructure: EF Core DbContext, JWT config, Redis & Hangfire integration
- CompanyExpenseTracking.API: REST controllers, validators, migrations, Swagger, authentication
- CompanyExpenseTracking.Tests: xUnit unit tests

##### File-Structure Analysis
- Top-level solution (CompanyExpenseTracking.sln) contains five projects:
- .Domain – entity definitions
- .Application – use-case/services layer
- .Infrastructure – data access & external infra (SQL via EF, JWT, Redis, Hangfire)
- .API – presentation layer (Web API controllers, HTTP endpoints, Swagger)
- .Tests – automated unit tests
- Key indicators:
- Controllers folder: REST resources (Auth, User, Expense, Category, Reports)
- DbContext folder in both .API and .Infrastructure: application-level vs shared data context
- Migrations folder: EF Core Code-First schema evolution
- Validators: FluentValidation rules for incoming models
- appsettings.json + launchSettings: environment & hosting configs
- Background jobs: Hangfire dashboard integrated in API
- Redis cache config: performance optimization layer

##### README Insights
- Feature highlights: JWT auth, role-based authorization, CRUD operations, background jobs (Hangfire), Redis caching, Swagger docs, xUnit tests
- Technology stack mapped directly to your layers

a. Main Components
1) External Clients – Web/Mobile UI, Postman/Swagger UI
2) API Gateway / Web API (CompanyExpenseTracking.API)
3) Authentication & Authorization (JWT middleware)
4) Controllers & Endpoint Layer
5) Application Services (CompanyExpenseTracking.Application)
6) Domain Model (CompanyExpenseTracking.Domain)
7) Infrastructure Services:
- SQL Database (via EF Core migrations)
- Redis Cache
- Hangfire Server & Dashboard
8) Unit Tests (for Application & Domain logic)

b. Relationships & Data Flows
- Client → HTTP(S) → API Controllers
- Controllers → validate (Validators) → invoke Application Services
- Application Services → enforce business rules → manipulate Domain entities
- Repositories in Infrastructure layer → EF Core DbContext → SQL Database
- Caching calls: Application Services ↔ Redis
- Background tasks: Application Services schedule jobs with Hangfire → Hangfire Server
- JWT Middleware sits on the API pipeline: intercepts requests, issues tokens on AuthController, enforces roles

c. Architectural Patterns & Principles
- Layered / Clean Architecture: strict dependency from API → Application → Domain → Infrastructure
- CQRS-style separation (commands for create/update, queries for read) can be highlighted if implemented
- Dependency Injection for services & repositories
- Code-First Migrations for schema evolution
- Background processing via Hangfire (fire-and-forget, delayed, recurring jobs)
- Redis used as a distributed in-memory cache

d. Key Technologies & Frameworks
- .NET 8 Web API (ASP.NET Core)
- Entity Framework Core (Code-First)
- Hangfire (with Dashboard)
- StackExchange.Redis
- JWT Bearer Authentication
- Swagger / Swashbuckle
- xUnit (unit testing)

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "External Clients"
        Clients["Browser/Mobile/Swagger UI"]:::external
    end

    subgraph "API Layer"
        JWT["JWT Middleware"]:::api
        AuthController["AuthController"]:::api
        UserController["UserControllers"]:::api
        ExpenseController["ExpenseController"]:::api
        CategoryController["CategoryController"]:::api
        ReportsController["ReportsController"]:::api

        subgraph "Validators"
            CategoryValidator["CategoryValidator"]:::api
            ExpenseValidator["ExpenseValidator"]:::api
            UserValidator["UserValidator"]:::api
        end

        APIContext["OtsDbContext"]:::api
        Migrations["EF Core Migrations"]:::api
        Program["Program.cs (Swagger, Hangfire, Redis, JWT)"]:::api
    end

    subgraph "Application Layer"
        ApplicationProject["CompanyExpenseTracking.Application"]:::app
        ApplicationServices["Service Interfaces & Business Logic"]:::app
    end

    subgraph "Domain Layer"
        UserEntity["User Entity"]:::domain
        ExpenseEntity["Expense Entity"]:::domain
        CategoryEntity["Category Entity"]:::domain
    end

    subgraph "Infrastructure Layer"
        InfraContext["ApplicationDbContext"]:::infra
        JwtConfig["JwtConfig"]:::infra
    end

    subgraph "External Services"
        SQLDB["SQL Database"]:::externalInfra
        Redis["Redis Cache"]:::externalInfra
        Hangfire["Hangfire Server & Dashboard"]:::externalInfra
    end

    subgraph "Tests"
        UnitTests["xUnit Unit Tests"]:::tests
    end

    Clients -->|"HTTP/HTTPS"| JWT
    JWT --> AuthController
    JWT --> UserController
    JWT --> ExpenseController
    JWT --> CategoryController
    JWT --> ReportsController

    AuthController -->|"validate"| UserValidator
    UserController -->|"validate"| UserValidator
    ExpenseController -->|"validate"| ExpenseValidator
    CategoryController -->|"validate"| CategoryValidator
    ReportsController -->|"none"| CategoryValidator

    AuthController -->|"invoke"| ApplicationServices
    UserController -->|"invoke"| ApplicationServices
    ExpenseController -->|"invoke"| ApplicationServices
    CategoryController -->|"invoke"| ApplicationServices
    ReportsController -->|"invoke"| ApplicationServices

    ApplicationServices --> DomainLayer(( ))
    ApplicationServices --> InfraContext
    ApplicationServices <-->|"cache read/write (Redis)"| Redis
    ApplicationServices -.->|"schedule jobs"| Hangfire

    InfraContext -->|"EF Core" | SQLDB

    Program --> JWT
    Program --> APIContext
    Program --> Migrations

    ApplicationProject --> ApplicationServices
    ApplicationServices --> UserEntity
    ApplicationServices --> ExpenseEntity
    ApplicationServices --> CategoryEntity

    UnitTests --> ApplicationServices
    UnitTests --> UserEntity
    UnitTests --> ExpenseEntity
    UnitTests --> CategoryEntity

    classDef api fill:#D0E8FF,stroke:#1E70BF
    classDef app fill:#D0FFE8,stroke:#2E8B57
    classDef domain fill:#E8FFD0,stroke:#6B8E23
    classDef infra fill:#FFE8D0,stroke:#FF8C00
    classDef externalInfra fill:#FFF0E0,stroke:#E87600
    classDef external fill:#F0F0F0,stroke:#666
    classDef tests fill:#F7E8FF,stroke:#9B30FF

    click AuthController "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Controllers/AuthController.cs"
    click UserController "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Controllers/UserControllers.cs"
    click ExpenseController "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Controllers/ExpenseController.cs"
    click CategoryController "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Controllers/CategoryController.cs"
    click ReportsController "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Controllers/ReportsController.cs"
    click CategoryValidator "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Validators/CategoryValidator.cs"
    click ExpenseValidator "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Validators/ExpenseValidator.cs"
    click UserValidator "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Validators/UserValidator.cs"
    click APIContext "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/DbContext/OtsDbContext.cs"
    click Migrations "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Migrations/20250506233558_InitialCreate.cs"
    click Program "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.API/Program.cs"
    click InfraContext "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Infrastructure/DbContext/ApplicationDbContext.cs"
    click JwtConfig "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Infrastructure/JwtConfig.cs"
    click UserEntity "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Domain/Entities/Users.cs"
    click ExpenseEntity "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Domain/Entities/Expense.cs"
    click CategoryEntity "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Domain/Entities/Category.cs"
    click ApplicationProject "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Application/CompanyExpenseTracking.Application.csproj"
    click UnitTests "https://github.com/sevdesakar/companyexpensetracking/blob/main/CompanyExpenseTracking.Projects/CompanyExpenseTracking.Tests/UnitTest1.cs"
```
