# cankurttekin/job-application-tracker architecture

> Architecture diagram of the GitHub repository cankurttekin/job-application-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cankurttekin/job-application-tracker
- Repository: https://github.com/cankurttekin/job-application-tracker

## Overview

##### Main Components

a) Frontend Layer:
- React Single Page Application
- Key components: Authentication, Dashboard, Job Applications, Resume Management, AI Tools
- State Management (AuthContext)
- Internationalization support (i18n)
- UI Components (Charts, Forms, Tables)

b) Backend Layer (Spring Boot):
- Presentation Layer (REST Controllers)
- Application Layer (Services)
- Domain Layer (Business Logic, Models)
- Infrastructure Layer (Repositories, Security, Configuration)

c) External Services:
- AI/LLM Integration
- Email Service
- Turnstile Verification
- AWS Infrastructure

d) Database:
- PostgreSQL Database
- Entity relationships (Users, Job Applications, Resumes, etc.)

**[Client Layer]**
- Web Browser
- Firefox Extension
**↓ (HTTPS/REST)**
**[Frontend Layer (React)]**
- Components
- Services
- Context
**↓ (REST API)**
**[API Gateway/Security]**
- JWT Authentication
- Rate Limiting
- CORS
**↓**
**[Backend Layer (Spring Boot)]**
- Controllers
- Services
- Domain Model
- Infrastructure
**↓**
**[Persistence Layer]**
- PostgreSQL
- Hibernate ORM

**[External Services]**
- LLM Service
- Email Service
- Turnstile
- AWS Services

##### Important Relationships

- JWT authentication flow
- Job application data flow
- Resume management flow
- AI/LLM integration
- Data export functionality
- Email verification flow

##### Architectural Patterns to Highlight

- MVC pattern in the frontend
- Repository pattern for data access
- Service layer pattern
- Clean Architecture (Uncle Bob's architecture)

##### Technical Details

- Spring Security configuration
- Hibernate/JPA integration
- React component hierarchy
- API endpoints structure
- Docker containerization
- CI/CD pipeline integration

## Diagram (Mermaid)

```mermaid
graph TB
    %% Client Layer
    subgraph Client
        Browser["Web Browser"]
        Extension["Firefox Extension"]
    end

    %% Frontend Layer
    subgraph Frontend
        Auth["Authentication Components"]:::frontend
        click Auth "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/components/Login.js"
        AuthContext["Auth Context"]:::frontend
        click AuthContext "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/contexts/AuthContext.js"
        Dashboard["Dashboard"]:::frontend
        click Dashboard "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/components/Dashboard.js"
        JobApps["Job Applications"]:::frontend
        click JobApps "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/components/JobApplications.js"
        ResumeMgmt["Resume Management"]:::frontend
        click ResumeMgmt "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/components/Resume.js"
        AITools["AI Tools"]:::frontend
        click AITools "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/components/AITools.js"
        I18n["Internationalization"]:::frontend
        click I18n "https://github.com/cankurttekin/job-application-tracker/blob/main/frontend/src/i18n.js"
    end

    %% API Gateway/Security Layer
    subgraph Security
        JWT["JWT Authentication"]:::security
        click JWT "https://github.com/cankurttekin/job-application-tracker/blob/main/backend/src/main/java/com/kurttekin/can/job_track/infrastructure/security/jwt/JwtProvider.java"
        RateLimit["Rate Limiting"]:::security
        click RateLimit "https://github.com/cankurttekin/job-application-tracker/blob/main/backend/src/main/java/com/kurttekin/can/job_track/infrastructure/security/config/RateLimitingFilter.java"
        CORS["CORS"]:::security
    end

    %% Backend Layer
    subgraph Backend
        Controllers["REST Controllers"]:::backend
        click Controllers "https://github.com/cankurttekin/job-application-tracker/tree/main/backend/src/main/java/com/kurttekin/can/job_track/presentation/rest"
        Services["Application Services"]:::backend
        click Services "https://github.com/cankurttekin/job-application-tracker/tree/main/backend/src/main/java/com/kurttekin/can/job_track/application/service"
        Domain["Domain Models"]:::backend
        click Domain "https://github.com/cankurttekin/job-application-tracker/tree/main/backend/src/main/java/com/kurttekin/can/job_track/domain/model"
        Repos["Repositories"]:::backend
        click Repos "https://github.com/cankurttekin/job-application-tracker/tree/main/backend/src/main/java/com/kurttekin/can/job_track/infrastructure/repository"
    end

    %% External Services
    subgraph External
        LLM["LLM Service"]:::external
        EmailSvc["Email Service"]:::external
        click EmailSvc "https://github.com/cankurttekin/job-application-tracker/blob/main/backend/src/main/java/com/kurttekin/can/job_track/application/service/EmailService.java"
        Turnstile["Turnstile"]:::external
        click Turnstile "https://github.com/cankurttekin/job-application-tracker/blob/main/backend/src/main/java/com/kurttekin/can/job_track/application/service/TurnstileVerificationService.java"
        AWS["AWS Services"]:::external
    end

    %% Database Layer
    subgraph Database
        PostgreSQL["PostgreSQL"]:::database
    end

    %% Relationships
    Browser --> Auth
    Extension --> Auth
    Auth --> AuthContext
    AuthContext --> Dashboard
    AuthContext --> JobApps
    AuthContext --> ResumeMgmt
    AuthContext --> AITools
    
    Frontend --> JWT
    JWT --> Controllers
    RateLimit --> Controllers
    CORS --> Controllers
    
    Controllers --> Services
    Services --> Domain
    Domain --> Repos
    Repos --> PostgreSQL
    
    Services --> LLM
    Services --> EmailSvc
    Services --> Turnstile
    Services --> AWS

    %% Styles
    classDef frontend fill:#3498db,stroke:#2980b9,color:white
    classDef backend fill:#2ecc71,stroke:#27ae60,color:white
    classDef security fill:#e74c3c,stroke:#c0392b,color:white
    classDef database fill:#9b59b6,stroke:#8e44ad,color:white
    classDef external fill:#f1c40f,stroke:#f39c12,color:black

    %% Legend
    subgraph Legend
        Frontend_L["Frontend"]:::frontend
        Backend_L["Backend"]:::backend
        Security_L["Security"]:::security
        Database_L["Database"]:::database
        External_L["External Services"]:::external
    end
```
