# y0ar/jobboard architecture

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

- Interactive diagram: https://gitdiagram.com/y0ar/jobboard
- Repository: https://github.com/y0ar/jobboard

## Overview

##### Project type and purpose
- This is a full-stack “job board” application, comprising:
– A .NET Web API backend (ASP.NET Core, EF Core migrations, SQL database)
– A React + TypeScript single-page application frontend (Vite, component-based)
- Purpose: allow administrators, recruiters, candidates to manage jobs, applications, interviews, resumes, etc.

##### File structure
- Backend (folder: backend/JobBoard/JobBoard)
– Controllers: REST endpoints for Users, Jobs, Applications, Candidates, Companies, Authentication (JWT), Documents, Statistics, etc.
– Data: JobBoardContext (EF Core DbContext)
– Migrations: database schema evolution (InitialCreate, updates to recruiter, salary, job type)
– Models: domain entities mapping to database tables
– Configuration: appsettings.json (connection strings), launchSettings.json, Program.cs (middleware, routing, authentication)
- Frontend (folder: frontend)
– src/pages: route-level views (Home, Login, Register, Dashboard, JobDetails, AdminDashboard, AddJob, NotFound)
– src/components: reusable UI pieces (Header, Footer, JobCard, SearchBar, ProtectedRoute, etc.)
– src/contexts/AuthContext: authentication state management
– src/services: API wrapper modules (jobService, userService, applicationService, etc.)
– build & config: package.json, tsconfig, vite.config.js

##### Essential architectural elements
- Don’t add unnecessary components—focus on how data flows:
1. User interacts with React UI
2. UI invokes service methods (Axios)
3. HTTP request hits API Controller
4. Controller validates JWT, uses DbContext
5. Data persisted in SQL DB
6. Response flows back to UI
- Authentication flow, major entity domains (Jobs, Applications, Users), and configuration surfaces

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        FE_SPA["React SPA"]:::frontend
        subgraph "Pages" 
            direction TB
            Home["Home.tsx"]:::frontend
            Login["Login.tsx"]:::frontend
            Register["Register.tsx"]:::frontend
            Dashboard["Dashboard.tsx"]:::frontend
            JobDetails["JobDetails.tsx"]:::frontend
            AddJob["AddJob.tsx"]:::frontend
            AdminDashboard["AdminDashboard.tsx"]:::frontend
            NotFound["NotFound.tsx"]:::frontend
        end
        subgraph "Components"
            direction TB
            Header["Header.tsx"]:::frontend
            Footer["Footer.tsx"]:::frontend
            JobCard["JobCard.tsx"]:::frontend
            SearchBar["SearchBar.tsx"]:::frontend
            ProtectedRoute["ProtectedRoute.tsx"]:::frontend
            AdminHome["AdminHome.tsx"]:::frontend
            CandidateProfile["CandidateProfile.tsx"]:::frontend
            JobManagement["JobManagement.tsx"]:::frontend
            UserManagement["UserManagement.tsx"]:::frontend
        end
        subgraph "Context & Layout"
            direction TB
            AuthContext["AuthContext.tsx"]:::frontend
            Layout["Layout.tsx"]:::frontend
        end
        subgraph "Services"
            direction TB
            AxiosConfig["axios.ts"]:::frontend
            JobService["jobService.ts"]:::frontend
            UserService["userService.ts"]:::frontend
            CandidateService["candidateService.ts"]:::frontend
            ApplicationService["applicationService.ts"]:::frontend
            RecruiterService["recruiterService.ts"]:::frontend
            ResumeService["resumeService.ts"]:::frontend
            ExperienceService["experienceService.ts"]:::frontend
            StudyService["studyService.ts"]:::frontend
            MockJobs["mockJobs.ts"]:::frontend
        end
        FE_SPA -->|uses| Home
        FE_SPA -->|uses| Login
        FE_SPA -->|uses| Register
        FE_SPA -->|uses| Dashboard
        FE_SPA -->|uses| JobDetails
        FE_SPA -->|uses| AddJob
        FE_SPA -->|uses| AdminDashboard
        FE_SPA -->|uses| NotFound
        FE_SPA -->|renders| Header
        FE_SPA -->|renders| Footer
        FE_SPA -->|wraps with| AuthContext
        FE_SPA -->|wraps with| Layout
        FE_SPA -->|calls| AxiosConfig
        AxiosConfig -->|configures| JobService
        AxiosConfig -->|configures| UserService
        AxiosConfig -->|configures| CandidateService
        AxiosConfig -->|configures| ApplicationService
        AxiosConfig -->|configures| RecruiterService
        AxiosConfig -->|configures| ResumeService
        AxiosConfig -->|configures| ExperienceService
        AxiosConfig -->|configures| StudyService
        AxiosConfig -->|configures| MockJobs
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        API["ASP.NET Core API"]:::backend
        subgraph "Configuration"
            direction TB
            Program["Program.cs"]:::backend
            AppSettings["appsettings.json"]:::backend
            AppSettingsDev["appsettings.Development.json"]:::backend
            LaunchSettings["launchSettings.json"]:::backend
        end
        subgraph "Controllers"
            direction TB
            ControllersDir["Controllers Directory"]:::backend
        end
        subgraph "Data Access"
            direction TB
            DbContext["JobBoardContext.cs"]:::backend
            Migrations["Migrations Directory"]:::backend
        end
        subgraph "Domain Models"
            direction TB
            ModelsDir["Models Directory"]:::backend
        end
        API -->|loads| Program
        API -->|reads| AppSettings
        API -->|reads| AppSettingsDev
        API -->|reads| LaunchSettings
        API -->|exposes| ControllersDir
        ControllersDir -->|uses| API
        API -->|uses| DbContext
        DbContext -->|applies| Migrations
        API -->|manages| ModelsDir
    end

    %% Database
    Database["SQL Database"]:::db

    %% External Services
    subgraph "External Services"
        direction TB
        BlobStorage["Blob Storage"]:::external
        EmailService["Email Service"]:::external
    end

    %% Interactions
    FE_SPA -->|HTTPS requests| API
    API -->|ORM queries| Database
    API -->|stores files| BlobStorage
    API -->|sends emails| EmailService
    Database -->|persists data| DbContext

    %% Click Events - Frontend
    click FE_SPA "https://github.com/y0ar/jobboard/tree/main/frontend/src"
    click Home "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/Home.tsx"
    click Login "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/Login.tsx"
    click Register "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/Register.tsx"
    click Dashboard "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/Dashboard.tsx"
    click JobDetails "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/JobDetails.tsx"
    click AddJob "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/AddJob.tsx"
    click AdminDashboard "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/AdminDashboard.tsx"
    click NotFound "https://github.com/y0ar/jobboard/blob/main/frontend/src/pages/NotFound.tsx"
    click Header "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/Header.tsx"
    click Footer "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/Footer.tsx"
    click JobCard "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/JobCard.tsx"
    click SearchBar "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/SearchBar.tsx"
    click ProtectedRoute "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/ProtectedRoute.tsx"
    click AdminHome "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/AdminHome.tsx"
    click CandidateProfile "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/CandidateProfile.tsx"
    click JobManagement "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/JobManagement.tsx"
    click UserManagement "https://github.com/y0ar/jobboard/blob/main/frontend/src/components/UserManagement.tsx"
    click AuthContext "https://github.com/y0ar/jobboard/blob/main/frontend/src/contexts/AuthContext.tsx"
    click Layout "https://github.com/y0ar/jobboard/blob/main/frontend/src/layout/Layout.tsx"
    click AxiosConfig "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/axios.ts"
    click JobService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/jobService.ts"
    click UserService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/userService.ts"
    click CandidateService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/candidateService.ts"
    click ApplicationService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/applicationService.ts"
    click RecruiterService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/recruiterService.ts"
    click ResumeService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/resumeService.ts"
    click ExperienceService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/experienceService.ts"
    click StudyService "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/studyService.ts"
    click MockJobs "https://github.com/y0ar/jobboard/blob/main/frontend/src/services/mockJobs.ts"
    click FE_SPA "https://github.com/y0ar/jobboard/blob/main/frontend/src/main.tsx"
    click AppShell1 "https://github.com/y0ar/jobboard/blob/main/frontend/src/App.tsx"
    click AppShell2 "https://github.com/y0ar/jobboard/blob/main/frontend/src/index.html"
    click ViteConfig "https://github.com/y0ar/jobboard/blob/main/frontend/vite.config.ts"

    %% Click Events - Backend
    click API "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/JobBoard.csproj"
    click Program "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/Program.cs"
    click AppSettings "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/appsettings.json"
    click AppSettingsDev "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/appsettings.Development.json"
    click LaunchSettings "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/Properties/launchSettings.json"
    click ControllersDir "https://github.com/y0ar/jobboard/tree/main/backend/JobBoard/JobBoard/Controllers"
    click DbContext "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/Data/JobBoardContext.cs"
    click Migrations "https://github.com/y0ar/jobboard/tree/main/backend/JobBoard/JobBoard/Migrations"
    click ModelsDir "https://github.com/y0ar/jobboard/tree/main/backend/JobBoard/JobBoard/Models"
    click Solution "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard.sln"
    click ProjectFile "https://github.com/y0ar/jobboard/blob/main/backend/JobBoard/JobBoard/JobBoard.csproj"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#1E88E5,stroke-width:1px;
    classDef backend fill:#FFEBEE,stroke:#E53935,stroke-width:1px;
    classDef db fill:#FFF9C4,stroke:#FDD835,stroke-width:2px;
    classDef external fill:#E8F5E9,stroke:#43A047,stroke-width:1px;
```
