# sheikhsarim/online-aptitde-test architecture

> Architecture diagram of the GitHub repository sheikhsarim/online-aptitde-test, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-31). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sheikhsarim/online-aptitde-test
- Repository: https://github.com/sheikhsarim/online-aptitde-test

## Overview

##### Project type and purpose
- This is a full-stack web application built with ASP.NET Core MVC.
- Purpose: deliver an online aptitude testing platform with three user roles (Admin, Manager, Candidate), backed by a SQL Server database and Entity Framework Core.

##### File structure and architectural patterns
- Top-level folders:
- Controllers – MVC controllers for each role and test flow
- Models (and ViewModels) – domain entities (Admin, Manager, Candidate, Test, Question, Result, Role, UserRole) plus DTOs for views
- Views – Razor pages organized by controller (Account, Admin, Manager, Test, Shared, Home)
- Data – EF Core ApplicationDbContext + Migrations
- wwwroot – static assets (CSS, JS, libraries)
- Program.cs / launchSettings.json – application startup configuration
- Architectural pattern: classic layered MVC
- Presentation layer (Razor Views + static assets)
- Controller layer (HTTP endpoints, authentication, role checks)
- Domain/model layer (business objects)
- Data access layer (EF Core DbContext, Migrations)
- Cross-cutting concerns: authentication & authorization, password hashing (BCrypt.Net), configuration (appsettings.json)

##### Key insights from the README
- Roles & use cases: Admin manages managers; Manager manages candidates/questions/tests; Candidate takes tests & views results
- Tech stack: ASP.NET Core MVC, EF Core (SQL Server), Bootstrap + jQuery on frontend

##### Main components
a. Client (Browser)
- Renders Razor views + static assets (CSS, JS)
- Sends HTTP requests (GET/POST)
b. Web Server (ASP.NET Core MVC App)
- Presentation Layer: Razor Views (.cshtml) & wwwroot content
- Controllers:
- AccountController (login/register)
- AdminController (dashboard, manager CRUD)
- ManagerController (candidate & question/test management)
- TestController (test flow for candidates)
- HomeController (landing & privacy)
- Models & ViewModels: data structures passed between Controllers and Views
- Data Access Layer: ApplicationDbContext (EF Core)
- Migrations: code-first schema evolution
- Services & Middleware: authentication, authorization, configuration
c. Database (SQL Server)
- Stores Users, Roles, Tests, Questions, Results, etc.
- Accessed via EF Core

##### Relationships and data flows
- Browser → Web Server
- User requests pages or submits forms
- Web Server.Controllers → Data Access Layer
- Controllers invoke DbContext to query/update database
- Data Access Layer → SQL Server
- EF Core translates LINQ to SQL
- SQL Server → Web Server
- Data records returned to DbContext
- Web Server → Browser
- Razor Views render HTML + embed dynamic data

##### Important architectural patterns & principles
- MVC separation of concerns
- Layered architecture (Presentation → Business/Controllers → Data)
- Code-first migrations for database versioning
- Role-based access control enforced in Controllers
- Dependency injection for DbContext and configuration

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Layer
    Browser["Browser"]:::presentation
    Views["Views (Razor Pages)"]:::presentation
    WWWRoot["wwwroot (Static Assets)"]:::presentation

    Browser -->|"HTTP GET/POST"| Controllers
    Browser -->|Fetch Assets| WWWRoot

    %% Server Layer
    subgraph "ASP.NET Core MVC App"
        direction TB

        %% Startup & Configuration
        subgraph "Startup & Config"
            Program["Program.cs"]:::external
            AppSettings["appsettings.json"]:::external
            DevSettings["appsettings.Development.json"]:::external
            LaunchSettings["launchSettings.json"]:::external
        end

        %% Presentation Layer
        subgraph "Presentation Layer"
            direction TB
            Views
            WWWRoot
        end

        %% Controller Layer
        subgraph "Controllers" 
            direction TB
            Controllers["Controllers"]:::business
            AccountController["AccountController"]:::business
            AdminController["AdminController"]:::business
            ManagerController["ManagerController"]:::business
            TestController["TestController"]:::business
            HomeController["HomeController"]:::business
        end

        %% Domain Models & ViewModels
        subgraph "Domain & ViewModels"
            direction TB
            Models["Models (Entities)"]:::data
            ViewModels["ViewModels/DTOs"]:::data
        end

        %% Data Access Layer
        subgraph "Data Access Layer"
            direction TB
            DbContext["ApplicationDbContext"]:::data
            Migrations["Migrations"]:::data
        end

        %% External Libraries & Services
        subgraph "External Libraries"
            direction TB
            EFCore["EF Core"]:::external
            BCrypt["BCrypt.Net"]:::external
        end

        %% Relationships within Server
        Program -->|Read Config| AppSettings
        Program -->|Read Config| DevSettings
        Program -->|Use| LaunchSettings
        Controllers -->|Invoke| DbContext
        DbContext -->|Apply Migrations| Migrations
        DbContext -->|Translate LINQ| EFCore
        Controllers -->|Use| BCrypt
        EFCore -->|Connects To| SQLServer
    end

    %% Database Layer
    SQLServer["SQL Server Database"]:::data

    DbContext -->|Execute SQL| SQLServer
    SQLServer -->|Return Data| DbContext
    Controllers -->|Render Views| Views

    %% Click Events
    click Views "https://github.com/sheikhsarim/online-aptitde-test/tree/master/OnlineAptitdeTest/Views/"
    click WWWRoot "https://github.com/sheikhsarim/online-aptitde-test/tree/master/OnlineAptitdeTest/wwwroot/"
    click Program "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Program.cs"
    click AppSettings "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/appsettings.json"
    click DevSettings "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/appsettings.Development.json"
    click LaunchSettings "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Properties/launchSettings.json"
    click AccountController "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Controllers/AccountController.cs"
    click AdminController "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Controllers/AdminController.cs"
    click ManagerController "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Controllers/ManagerController.cs"
    click TestController "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Controllers/TestController.cs"
    click HomeController "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Controllers/HomeController.cs"
    click Models "https://github.com/sheikhsarim/online-aptitde-test/tree/master/OnlineAptitdeTest/Models/"
    click ViewModels "https://github.com/sheikhsarim/online-aptitde-test/tree/master/OnlineAptitdeTest/Models/ViewModels/"
    click DbContext "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/Data/ApplicationDbContext.cs"
    click Migrations "https://github.com/sheikhsarim/online-aptitde-test/tree/master/OnlineAptitdeTest/Migrations/"
    click SQLServer "https://github.com/sheikhsarim/online-aptitde-test/blob/master/OnlineAptitdeTest/OnlineAptitdeTest.csproj"

    %% Styles
    classDef presentation fill:#cce5ff,stroke:#004085,color:#004085
    classDef business fill:#d4edda,stroke:#155724,color:#155724
    classDef data fill:#fff3cd,stroke:#856404,color:#856404
    classDef external fill:#e2e3e5,stroke:#6c757d,color:#6c757d
```
