# dattritat/cmpe272 architecture

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

- Interactive diagram: https://gitdiagram.com/dattritat/cmpe272
- Repository: https://github.com/dattritat/cmpe272

## Overview

##### Project type and purpose
- This is a full-stack, cloud-native web application named “FEDBRIDGE / resume-analyze.”
- Purpose: AI-powered career transition platform for laid-off federal employees, offering resume parsing, skill mapping, job/course recommendations, interview simulation, and mentorship.

##### File structure
- Top level: `.github` (CI/CD), root `README.md`, and a folder `resume-analyze`.
- `resume-analyze/frontend`: React + TypeScript SPA with Tailwind, deployed in Docker, built via Vite.
- `resume-analyze/server`: Node.js + Express app (MVC pattern with controllers, services, models), uses Firebase Auth, connects to MongoDB Atlas.
- `resume-analyze/k8s`: Kubernetes manifests for frontend, backend, services, and Kong API gateway.
- Configuration: Dockerfiles in both frontend & server, Kubernetes YAML, GitHub Actions workflow for full CI/CD.

##### README for additional insights
- Frontend: React, Tailwind CSS, HeroUI.
- Backend: Express, MongoDB Atlas, Firebase Auth.
- AI/ML: LangChain + GPT-4.
- External APIs: APIFY (course scraping), AFFINDA (resume parsing), RapidAPI (job listings).
- Deployment: GCP (GKE), Docker, Kubernetes, CI/CD via GitHub Actions.

## Diagram (Mermaid)

```mermaid
graph TB
    %% CI/CD Pipeline
    CI["GitHub Actions\n(.github/workflows/full-ci-cd.yml)"]:::ci
    CI -->|"Build & Push Docker Images"| DockerImages["Docker Images"]:::docker
    DockerImages -->|"Deploy to GKE"| K8sCluster["Kubernetes Cluster"]:::cluster

    %% Kubernetes Cluster Boundary
    subgraph "Kubernetes Cluster"
      direction TB
      subgraph "Frontend Deployment"
        React["React SPA"]:::frontend
      end
      KongGW["Kong API Gateway"]:::gateway
      Express["Express Server"]:::backend
    end

    %% User Flow
    React -->|"HTTPS Requests"| KongGW
    KongGW -->|"Routes to"| Express

    %% Frontend Components
    React --> AuthCtx["AuthContext.tsx"]:::frontend
    React --> ProtRoute["ProtectedRoute.tsx"]:::frontend
    React --> PubRoute["PublicRoute.tsx"]:::frontend
    React --> FirebaseSDK["firebase.ts"]:::frontend
    React --> APIUtil["api.ts"]:::frontend
    React --> AuthHdr["authHeaders.ts"]:::frontend
    React --> ResumePipe["fetchResumePipeline.ts"]:::frontend

    %% Backend Authentication
    Express --> AuthMW["authMiddleware.js"]:::middleware
    AuthMW --> FirebaseAuth["Firebase Auth"]:::auth
    Express --> RoleMW["roleMiddleware.js"]:::middleware

    %% Backend Controllers
    Express --> AuthController["authController.js"]:::controller
    Express --> AnalyzeCtrl["analyzeResumeController.js"]:::controller
    Express --> CourseCtrl["courseController.js"]:::controller
    Express --> JobCtrl["jobController.js"]:::controller
    Express --> InterviewCtrl["interviewController.js"]:::controller
    Express --> UserCtrl["userController.js"]:::controller

    %% Backend Services & Integrations
    AuthController --> FirebaseAdmin["firebaseAdmin.js"]:::service
    AnalyzeCtrl --> ResumeService["resumeService.js"]:::service
    ResumeService --> AFFINDA["AFFINDA API"]:::external
    CourseCtrl --> CourseService["courseService.js"]:::service
    CourseService --> UdemyScraper["udemyScraper.js"]:::utils
    CourseCtrl --> APIFY["APIFY"]:::external
    JobCtrl --> JobService["jobService.js"]:::service
    JobService --> RapidAPI["RapidAPI"]:::external
    JobService --> IndeedScraper["indeedScaper.js"]:::utils
    InterviewCtrl --> InterviewService["interviewService.js"]:::service
    Express --> LangChainService["langchainService.js"]:::service
    LangChainService --> GPT4["OpenAI GPT-4"]:::ai

    %% Database
    Express --> MongoDB["MongoDB Atlas"]:::db
    MongoDB --> UserModel["User.js"]:::model
    MongoDB --> CourseModel["CachedCourseSchema.js"]:::model
    MongoDB --> CareerModel["CareerResult.js"]:::model
    MongoDB --> InterviewModel["interviewSessionSchema.js"]:::model

    %% Infrastructure Configs
    CI --> DockerFE["frontend/Dockerfile"]:::dockerfile
    CI --> DockerBE["server/Dockerfile"]:::dockerfile
    CI --> K8sMan["k8s manifests"]:::k8s
    CI --> KongMan["kong.yaml"]:::k8s

    %% Click Events
    click React "https://github.com/dattritat/cmpe272/tree/main/resume-analyze/frontend"
    click AuthCtx "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/context/AuthContext.tsx"
    click ProtRoute "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/context/ProtectedRoute.tsx"
    click PubRoute "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/context/PublicRoute.tsx"
    click FirebaseSDK "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/firebase.ts"
    click APIUtil "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/utils/api.ts"
    click AuthHdr "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/utils/authHeaders.ts"
    click ResumePipe "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/frontend/src/utils/fetchResumePipeline.ts"
    click Express "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/server.js"
    click AuthController "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/authController.js"
    click AnalyzeCtrl "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/analyzeResumeController.js"
    click CourseCtrl "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/courseController.js"
    click JobCtrl "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/jobController.js"
    click InterviewCtrl "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/interviewController.js"
    click UserCtrl "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/controllers/userController.js"
    click ResumeService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/resumeService.js"
    click CareerService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/careerService.js"
    click CourseService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/courseService.js"
    click UdemyScraper "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/utils/udemyScraper.js"
    click JobService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/jobService.js"
    click IndeedScraper "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/utils/indeedScaper.js"
    click InterviewService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/interviewService.js"
    click LangChainService "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/services/langchainService.js"
    click FirebaseAdmin "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/firebase/firebaseAdmin.js"
    click AuthMW "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/middlewares/authMiddleware.js"
    click RoleMW "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/server/middlewares/roleMiddleware.js"
    click DockerFE "https://github.com/dattritat/cmpe272/tree/main/resume-analyze/frontend/Dockerfile"
    click DockerBE "https://github.com/dattritat/cmpe272/tree/main/resume-analyze/server/Dockerfile"
    click K8sMan "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/k8s/frontend-deployment.yaml"
    click KongMan "https://github.com/dattritat/cmpe272/blob/main/resume-analyze/k8s/kong.yaml"
    click CI "https://github.com/dattritat/cmpe272/blob/main/ .github/workflows/full-ci-cd.yml"

    %% Styles
    classDef frontend fill:#AEDFF7,stroke:#0366d6
    classDef backend fill:#CFE2CF,stroke:#228B22
    classDef gateway fill:#FFF2CC,stroke:#DAA520
    classDef db fill:#D9D9D9,stroke:#808080
    classDef auth fill:#FDD7E4,stroke:#C71585
    classDef controller fill:#E4D0F6,stroke:#8A2BE2
    classDef service fill:#FCE5CD,stroke:#FF8C00
    classDef utils fill:#FFE599,stroke:#CD853F
    classDef external fill:#F4CCCC,stroke:#CC0000
    classDef ai fill:#D0E0E3,stroke:#0B5394
    classDef middleware fill:#E6E0F8,stroke:#5B2C6F
    classDef model fill:#F9E79F,stroke:#B7950B
    classDef ci fill:#E8F8F5,stroke:#117A65,stroke-dasharray: 5 5
    classDef docker fill:#D6EAF8,stroke:#1B4F72
    classDef dockerfile fill:#EBEDEF,stroke:#424949
    classDef k8s fill:#D5F5E3,stroke:#1D8348
    classDef cluster fill:#F2F3F4,stroke:#A6ACAF,stroke-dasharray: 5 5
```
