# mr-jafri/crudify architecture

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

- Interactive diagram: https://gitdiagram.com/mr-jafri/crudify
- Repository: https://github.com/mr-jafri/crudify

## Overview

##### Project Type and Purpose
- Crudify is a full-stack CRUD application.
- Backend: ASP.NET Core Web API using Clean Architecture layers (API, Application, Domain, Infrastructure).
- Frontend: Next.js + TypeScript SPA/SSR for user login and student management.

##### File Structure
- Top-level Division:
- crudify-api (backend)
- crudify-web (frontend)
- Backend Layers (Clean Architecture):
- Api: Controllers, Middlewares, ActionFilters, Swagger setup
- Application: DTOs, Interfaces, Services (AuthService, StudentsService, TokenService, LoggingService)
- Domain: Core entities (Student, ApplicationUser, RefreshToken, JwtSettings, ActivityLog, ExceptionLog)
- Infrastructure: EF Core DbContext, Migrations, FluentConfigurations, SQL seed scripts, context factory
- Frontend Modules:
- app/: Pages (login, students list, add/edit forms)
- auth/: Context API for JWT authentication, ProtectedRoute
- components/: Reusable UI (buttons, hook-form helpers)
- services/: axios instance, studentService for API calls
- hooks, routes, sections: navigation, parametrization, form and view components

##### README for Additional Insights
- Clean Architecture pattern on backend
- JWT-based auth, Swagger UI for testing
- Automatic EF migrations and SQL seeding
- Next.js routed pages with ‘use client’ segregation
- Protected routes and AuthContext challenges

a. Main Components
- Frontend (Next.js)
– Pages: Login, StudentList, StudentForm
– AuthContext & ProtectedRoute
– HTTP client (axios)
- API Gateway (ASP.NET Core Web API)
– Controllers: AuthController, StudentsController
– Middlewares: ActivityLogging, ExceptionLogging
– ActionFilters: TokenAuthentication
– Swagger UI
- Application Layer (Business Logic)
– AuthService, StudentsService, TokenService, LoggingService
- Domain Layer (Entities & Models)
- Infrastructure Layer
– EF Core DbContext (ApplicationContext)
– Fluent Entity Configurations
– Migrations + SQL Seed Scripts
- Database (SQL Server or configured RDBMS)
- External Clients
– Swagger UI for manual testing
– HTTP clients (Postman, browser via axios)

b. Relationships and Data Flow
1. User → Browser → Next.js Page
2. Next.js (AuthContext) attaches JWT → axios → API Controller
3. Controller calls Application Service → Domain Entities → Infrastructure DbContext
4. DbContext executes SQL (migrations/seedings) → Database
5. Responses bubble back through layers → Controller → Frontend
6. Middleware logs activities/exceptions to DB

c. Architectural Patterns & Design Principles
- Layered (Clean) Architecture
- Dependency Injection in API and Infrastructure
- Separation of Concerns: UI / API / Business Logic / Data Access
- JWT Authentication filter & context provider
- Middleware pipeline for cross-cutting concerns
- EF Core Code-First Migrations + Embedded SQL seeding

d. Key Technologies & Frameworks
- Backend: .NET 9, ASP.NET Core, EF Core, Swagger, SQL Server
- Frontend: Next.js, React, TypeScript, axios, React Context API
- Testing: xUnit for API/Application unit tests

##### Detail and Separation
- DbContext and seed execution sub-component
- Next.js AuthContext and ProtectedRoute module

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% External Clients
    User["User (Browser)"]:::external
    Postman["Postman / Swagger UI"]:::external

    %% Frontend Layer
    subgraph "Frontend (Next.js + TypeScript)" 
        direction TB
        LoginPage["Login Page"]:::frontend
        StudentListPage["Student List Page"]:::frontend
        AddStudentPage["Add Student Page"]:::frontend
        EditStudentPage["Edit Student Page"]:::frontend
        AuthContext["AuthContext (JWT)"]:::frontend
        ProtectedRoute["ProtectedRoute"]:::frontend
        UseAuth["useAuth Hook"]:::frontend
        AxiosInstance["Axios HTTP Client"]:::frontend
        StudentService["Student Service"]:::frontend
    end

    %% API Layer
    subgraph "API Layer (ASP.NET Core Web API)" 
        direction TB
        Controllers["Controllers"]:::api
        Middlewares["Middlewares"]:::api
        Filters["ActionFilters"]:::api
        SwaggerUI["Swagger UI"]:::api
    end

    %% Application Layer
    subgraph "Application Layer" 
        direction TB
        AuthService["AuthService"]:::service
        StudentsService["StudentsService"]:::service
        TokenService["TokenService"]:::service
        LoggingService["LoggingService"]:::service
    end

    %% Domain Layer
    subgraph "Domain Layer" 
        direction TB
        Entities["Entities & Models"]:::service
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer" 
        direction TB
        DbContext["ApplicationContext (DbContext)"]:::data
        Factory["Context Factory"]:::data
        Configs["Fluent Configurations"]:::data
        Migrations["EF Core Migrations"]:::data
        SeedScripts["SQL Seed Scripts"]:::data
        DbExtensions["DbContext Extensions"]:::data
    end

    %% Database
    Database[(Database)]:::data

    %% Connections
    User -->|visits| LoginPage
    User -->|visits| StudentListPage
    User -->|visits| AddStudentPage
    User -->|visits| EditStudentPage
    LoginPage -->|uses| AuthContext
    StudentListPage -->|uses| AuthContext
    AddStudentPage -->|uses| AuthContext
    EditStudentPage -->|uses| AuthContext
    AuthContext -->|provides token| ProtectedRoute
    ProtectedRoute -->|wraps| LoginPage
    ProtectedRoute -->|wraps| StudentListPage
    ProtectedRoute -->|wraps| AddStudentPage
    ProtectedRoute -->|wraps| EditStudentPage
    StudentListPage -->|calls| StudentService
    AddStudentPage -->|calls| StudentService
    EditStudentPage -->|calls| StudentService
    LoginPage -->|calls| AxiosInstance
    StudentService -->|calls| AxiosInstance
    AxiosInstance -->|HTTP| Controllers
    SwaggerUI -->|HTTP| Controllers
    Controllers -->|invoke| Filters
    Controllers -->|through| Middlewares
    Controllers -->|call| AuthService
    Controllers -->|call| StudentsService
    Controllers -->|call| LoggingService
    AuthService -->|uses| TokenService
    AuthService -->|manages| Entities
    StudentsService -->|manages| Entities
    TokenService -->|manages| Entities
    LoggingService -->|manages| Entities
    Entities -->|persist via| DbContext
    DbContext -->|configured by| Configs
    DbContext -->|seeded by| SeedScripts
    Migrations -->|update schema| DbContext
    DbContext -->|exposed| DbExtensions
    DbContext -->|reads/writes| Database
    Middlewares -->|log to| Database
    Filters -->|validate| Tokens

    %% Click Events - Frontend Pages
    click LoginPage "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/app/login/page.tsx"
    click StudentListPage "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/app/students/page.tsx"
    click AddStudentPage "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/app/students/add/page.tsx"
    click EditStudentPage "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/app/students/edit/[id]/page.tsx"

    %% Click Events - Frontend Auth
    click AuthContext "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/auth/context/jwt/index.ts"
    click ProtectedRoute "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/auth/protectedRoute.tsx"
    click UseAuth "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/auth/useAuth.ts"

    %% Click Events - Frontend Services
    click AxiosInstance "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/services/axios.ts"
    click StudentService "https://github.com/mr-jafri/crudify/blob/main/crudify-web/src/services/studentService.ts"

    %% Click Events - Backend API Layer
    click Controllers "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Api/Controllers"
    click Middlewares "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Api/Middlewares"
    click Filters "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Api/ActionFilters/TokenAuthentication.cs"
    click SwaggerUI "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Api/Extensions/Swagger.cs"
    
    %% Click Events - Backend Program
    click _ "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Api/Program.cs"

    %% Click Events - Application Layer
    click AuthService "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Application/Services/AuthService.cs"
    click StudentsService "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Application/Services/StudentsService.cs"
    click TokenService "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Application/Services/TokenService.cs"
    click LoggingService "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Application/Services/LoggingService.cs"

    %% Click Events - Domain Entities
    click Entities "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Domain/Entities"

    %% Click Events - Infrastructure Layer
    click DbContext "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Infrastructure/Database/ApplicationContext.cs"
    click Factory "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Infrastructure/Database/AplicationContextFactory.cs"
    click Configs "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Infrastructure/FluentConfigurations"
    click Migrations "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Infrastructure/Migrations"
    click SeedScripts "https://github.com/mr-jafri/crudify/tree/main/crudify-api/src/Crudify.Infrastructure/Seedings/SqlScripts"
    click DbExtensions "https://github.com/mr-jafri/crudify/blob/main/crudify-api/src/Crudify.Infrastructure/Extensions/DbContextExtensions.cs"

    %% Styles
    classDef frontend fill:#CEF,stroke:#036,stroke-width:1px
    classDef api fill:#CFC,stroke:#093,stroke-width:1px
    classDef service fill:#FFEB99,stroke:#995700,stroke-width:1px
    classDef data fill:#FDD,stroke:#D00,stroke-width:1px
    classDef external fill:#EEE,stroke:#666,stroke-width:1px
```
