# alexd36/career-advisor-ai-mvp architecture

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

- Interactive diagram: https://gitdiagram.com/alexd36/career-advisor-ai-mvp
- Repository: https://github.com/alexd36/career-advisor-ai-mvp

## Overview

##### Project type and purpose
- This is a full-stack web application called “Next Step — AI-Powered Career Advisor.”
- Frontend: Next.js + Tailwind CSS offering pages and interactive components (career path discovery, CV builder, interview simulator, dashboards).
- Backend: Spring Boot REST API serving business logic (user management, OpenAI integration, CV PDF generation, interview sessions) and persisting data in MySQL.
- External services: OpenAI GPT-4 for AI features, Google OAuth 2.0 for authentication.

##### File structure
Top-level:
- frontend/Meta – Next.js app folder (app-router pages, shared components, hooks, utilities, Tailwind styles, Dockerfile).
- backend/Meta – Spring Boot project (controllers, services, models, repositories, security & CORS config, application.properties).
- career_db_dump.sql – initial MySQL dump.
- podman-compose.yml & start.bat – container orchestration for frontend, backend, MySQL.

Backend directory breakdown:
- controller – REST endpoints (AuthController, ChatGPTController, CvController, etc.).
- service – business logic layers (ChatGPTService, JwtService, UserService, etc.).
- repository – Spring Data JPA interfaces (UserRepository, InterviewSessionRepository, etc.).
- model/dto – persistence entities and data‐transfer objects.
- config & auth – JWT filters, security, CORS, OpenAPI docs.

Frontend directory breakdown:
- app – Next.js routes under /app (login, signUp, dashboard roles, cvTools, interview-sim, etc.).
- components/ui – reusable UI building blocks (Button, Card).
- hooks & lib – custom React hooks (useAuthToken, useAxiosAuth) and utility functions.
- public – static assets.
- next.config.ts, package.json – build configuration.

##### Detail without clutter
- Controllers (Auth, ChatGPT, CV, Interview, User, Admin, Mentor, DailyTask) grouped under “API Endpoints.”
- Service layer between controllers and repositories, label key services (ChatGPTService, JwtService, CvPdfService).
- Repository layer connecting to MySQL.
- ChatGPTService → OpenAI GPT-4 API
- AuthController → Google OAuth 2.0
- That the frontend uses custom hooks (useAuthToken, useAxiosAuth) to manage tokens and API calls.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User Agent
    Browser["Web Browser (User)"]:::browser

    %% Container Orchestration Boundary
    subgraph "Container Orchestration\n(Podman-Compose)" 
        direction TB

        %% Frontend Layer
        subgraph "Frontend Layer" 
            direction TB
            NextjsApp["Next.js App"]:::frontend
            Tailwind["Tailwind CSS Styles"]:::frontend
            UIComp["UI Components"]:::frontend
            Hooks["Custom Hooks & Utils"]:::frontend
            FEConfig["Build & Config"]:::frontend
        end

        %% Backend Layer
        subgraph "Backend Layer"
            direction TB
            Controllers["API Controllers"]:::backend
            Services["Business Logic Services"]:::backend
            Repos["Data Access Repositories"]:::backend
            ModelsDTO["Models & DTOs"]:::backend
            ConfigSec["Security & Config"]:::backend
            AppProps["application.properties"]:::backend
            Build["Backend Build & Entry"]:::backend
        end

        %% Database
        MySQL["MySQL Database"]:::database
    end

    %% External Services
    subgraph "External Services"
        direction TB
        OpenAI["OpenAI GPT-4 API"]:::external
        GoogleOAuth["Google OAuth 2.0"]:::external
    end

    %% Database Dump & Scripts
    DBdump["DB Schema Dump"]:::database
    Scripts["Orchestration Scripts"]:::infra

    %% Flows
    Browser -->|"HTTPS/JSON"| NextjsApp
    NextjsApp -->|"HTTPS/JSON"| Controllers
    Controllers -->|calls| Services
    Services -->|JPA/JDBC| Repos
    Repos -->|reads/writes| MySQL
    Services -->|"REST API"| OpenAI
    Controllers -->|"OAuth2 Code"| GoogleOAuth
    Scripts -.-> NextjsApp
    Scripts -.-> Controllers
    DBdump -.-> MySQL

    %% Click Events Frontend
    click NextjsApp "https://github.com/alexd36/career-advisor-ai-mvp/tree/main/frontend/Meta/app"
    click Tailwind "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/app/globals.css"
    click Tailwind "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/postcss.config.mjs"
    click UIComp "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/components/ui/button.tsx"
    click UIComp "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/components/ui/card.tsx"
    click Hooks "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/hooks/useAuthToken.ts"
    click Hooks "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/hooks/useAxiosAuth.ts"
    click Hooks "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/lib/utils.ts"
    click FEConfig "https://github.com/alexd36/career-advisor-ai-mvp/tree/main/frontend/Meta/Dockerfile"
    click FEConfig "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/next.config.ts"
    click FEConfig "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/frontend/Meta/package.json"

    %% Click Events Backend
    click Controllers "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/controller/AuthController.java"
    click Controllers "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/controller/ChatGPTController.java"
    click Controllers "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/controller/CvController.java"
    click Controllers "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/controller/InterviewController.java"
    click Controllers "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/controller/UserController.java"
    click Services "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/service/ChatGPTService.java"
    click Services "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/service/CvPdfService.java"
    click Services "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/service/InterviewService.java"
    click Services "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/service/JwtService.java"
    click Repos "https://github.com/alexd36/career-advisor-ai-mvp/tree/main/backend/Meta/src/main/java/com/springboot/chatgpt/repository"
    click ModelsDTO "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/model/User.java"
    click ModelsDTO "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/dto/ChatGPTRequest.java"
    click ConfigSec "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/auth/JwtAuthFilter.java"
    click ConfigSec "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/config/CorsConfig.java"
    click ConfigSec "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/config/OpenAPIConfiguration.java"
    click AppProps "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/resources/application.properties"
    click Build "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/build.gradle"
    click Build "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/settings.gradle"
    click Build "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/backend/Meta/src/main/java/com/springboot/chatgpt/CareerAdvisorAiApplication.java"

    %% Click Events Others
    click DBdump "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/career_db_dump.sql"
    click Scripts "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/podman-compose.yml"
    click Scripts "https://github.com/alexd36/career-advisor-ai-mvp/blob/main/start.bat"

    %% Styles
    classDef frontend fill:#add8e6,stroke:#000,stroke-width:1px
    classDef backend fill:#90ee90,stroke:#000,stroke-width:1px
    classDef database fill:#d3d3d3,stroke:#000,stroke-width:1px
    classDef external fill:#ffcc99,stroke:#000,stroke-width:1px
    classDef browser fill:#e6f7ff,stroke:#000,stroke-width:1px
    classDef infra fill:#f0e68c,stroke:#000,stroke-width:1px
```
