# navaneetha-krishnan-mv/resume-analyzer architecture

> Architecture diagram of the GitHub repository navaneetha-krishnan-mv/resume-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/navaneetha-krishnan-mv/resume-analyzer
- Repository: https://github.com/navaneetha-krishnan-mv/resume-analyzer

## Overview

##### Project type & purpose (what you’re diagramming)

There is also a **Python PDF extractor** (`python/pdfextractor.py`) which likely performs PDF-to-text extraction either:
- as a local/dev tool, or
- as code intended to run in a serverless function/container (Lambda) for parsing resumes before AI scoring.

- a **frontend web app** (this repo),
- a **serverless analysis backend** (conceptual/external in this repo),
- **storage and AI services** (conceptual/external),
- optional **client-side storage** (IndexedDB) and **deployment** (Vercel).

##### Frontend (React SPA)
- Entry points / app shell:
- `index.html` (Vite root HTML)
- `src/main.jsx` (bootstraps React)
- `src/App.jsx` (top-level routing/layout composition)
- Pages (feature-level UI screens):
- `src/pages/Home.jsx`
- `src/pages/Upload.jsx` (resume ingestion)
- `src/pages/Analyze.jsx` (analysis results/progress)
- UI Components:
- `src/components/Layout.jsx` (shared layout/chrome)
- `src/components/ProgressBar.jsx` (analysis progress UI)
- `src/components/ScoreRing.jsx` (score visualization)
- `src/components/AiScannerLogo.jsx` (branding)
- Client-side persistence:
- `src/utils/indexedDb.js` (IndexedDB usage—likely caching uploads/results/state)
- Tailwind: `tailwind.config.cjs`, `src/index.css`
- Vite: `vite.config.js`
- Linting: `eslint.config.js`

##### Hosting/Deployment
- `vercel.json` strongly suggests hosting the SPA on **Vercel** (static + edge routing).
- `public/` contains static assets shipped with the frontend bundle.

##### Python utility / parsing stage
- `python/pdfextractor.py` indicates a **PDF extraction** stage that should appear in the backend pipeline (even if implemented elsewhere in prod).

##### What the README tells you
- React frontend
- AWS serverless backend boundary
- AI analysis service(s)
- Data flow from upload → extraction → AI scoring → results returned

##### Upload
- Browser → SPA → API (upload request)
- API → Object storage
##### Extract
- Compute → PDF extractor (Python)
- Extractor output → orchestration
##### Analyze
- Orchestrator → AI provider
- AI response → results store
##### Return
- SPA polls or receives callback (if polling, show SPA → API “get status/results”)
- API → SPA returns scoring + feedback
- SPA caches in IndexedDB and renders ScoreRing/ProgressBar

Goal: reflect what’s actually here.
Inside “React SPA”, show:
- Router/App Shell: `App.jsx`
- Pages:
- `Home`
- `Upload` (calls API; writes IndexedDB)
- `Analyze` (reads IndexedDB; calls API for status/results; renders progress + scores)
- Shared UI:
- `Layout`, `ProgressBar`, `ScoreRing`
- Utility:
- `indexedDb.js`

- Upload/Analyze pages ↔ IndexedDB utility
- Page → ScoreRing/ProgressBar components (data-driven rendering)

Because you have Vercel + Vite:
- Developer → Git repo → Vercel build (Vite) → CDN/Edge hosting
If AWS IaC isn’t present, keep AWS deployment generic.

##### Relationships & interactions you must show (data flow)

- **Resume file (PDF/DOCX)**: from user → SPA → backend (upload)
- **Extracted text**: produced by PDF extractor → AI scoring
- **Prompts / model inputs**: orchestrator → AI provider
- **Scores + suggestions**: AI provider → orchestrator → results store → SPA
- **Progress updates**: SPA ↔ API (polling) OR backend → SPA (webhook/websocket)

##### Architectural patterns to highlight (specific to this repo)
- **SPA + Serverless backend**: thin UI, stateless API, scalable compute
- **Pipeline-style processing**: upload → extract → analyze → persist → present
- **Client-side caching**: IndexedDB to persist state across refresh/navigation
- **Presentation components**: ScoreRing/ProgressBar indicate a results visualization layer
- **Static hosting**: Vercel/CDN serving compiled assets

- **Clear labels**: “Upload Resume”, “Extract Text (Python)”, “AI Scoring”, “Results DB”, “Object Storage”
- “PDF bytes”
- “extracted plain text”
- “analysis requestId”
- “scores/feedback JSON”
- **Boundaries**:
- “Browser”
- “Vercel (hosting)”
- “AWS account / VPC (if relevant)”
- “External AI Provider”
- Rectangles = compute/services (SPA, API, Lambdas)
- Cloud boundary = AWS / external providers

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Actors
  %% =========================
  User["User"]:::actor
  Browser["Web Browser"]:::actor

  User -->|"uses"| Browser

  %% =========================
  %% Hosting / Frontend Delivery
  %% =========================
  subgraph "Vercel Hosting (Static SPA + CDN)"
    VercelCDN["Vercel CDN/Edge"]:::hosting
    ReactSPA["Resume Analyzer React SPA (Vite + Tailwind)"]:::frontend

    VercelCDN -->|"serves_static_assets"| ReactSPA
  end

  Browser -->|"HTTPS"| VercelCDN

  %% =========================
  %% Frontend (Repo) - Component Breakdown
  %% =========================
  subgraph "Frontend (This Repository)"
    direction TB

    subgraph "App Shell / Entrypoints"
      direction TB
      IndexHtml["index.html (Vite root HTML)"]:::frontend
      MainJsx["src/main.jsx (React bootstrap)"]:::frontend
      AppJsx["src/App.jsx (routing/layout)"]:::frontend
      IndexCss["src/index.css (global styles)"]:::tooling

      IndexHtml -->|"loads_bundle"| MainJsx
      MainJsx -->|"mounts"| AppJsx
      AppJsx -->|"imports_styles"| IndexCss
    end

    subgraph "Pages"
      direction TB
      HomePage["Home Page"]:::page
      UploadPage["Upload Page (Resume ingestion)"]:::page
      AnalyzePage["Analyze Page (Progress + results)"]:::page

      AppJsx -->|"route"| HomePage
      AppJsx -->|"route"| UploadPage
      AppJsx -->|"route"| AnalyzePage
    end

    subgraph "Shared UI Components"
      direction TB
      Layout["Layout (chrome)"]:::component
      Logo["AI Scanner Logo"]:::component
      ProgressBar["Progress Bar"]:::component
      ScoreRing["Score Ring (visualization)"]:::component

      AppJsx -->|"wraps"| Layout
      Layout -->|"renders"| Logo
      AnalyzePage -->|"renders"| ProgressBar
      AnalyzePage -->|"renders"| ScoreRing
    end

    subgraph "Client-side Persistence"
      direction TB
      IndexedDB[("IndexedDB (browser cache)")]:::datastore
      IndexedDbUtil["IndexedDB utility"]:::util

      IndexedDbUtil -->|"reads/writes"| IndexedDB
      UploadPage -->|"cache_requestId/file_meta"| IndexedDbUtil
      AnalyzePage -->|"load_cached_state"| IndexedDbUtil
    end

    subgraph "Build / Styling / Tooling"
      direction TB
      TailwindCfg["Tailwind config"]:::tooling
      ViteCfg["Vite config"]:::tooling
      ESLintCfg["ESLint config"]:::tooling
      PublicAssets["Static assets (public/)"]:::tooling
      VercelCfg["Vercel deployment config"]:::tooling
    end
  end

  ReactSPA -->|"renders_UI"| AppJsx
  PublicAssets -->|"bundled_into"| ReactSPA
  VercelCfg -->|"deploy_rules"| VercelCDN

  %% =========================
  %% Backend (External / Conceptual)
  %% =========================
  subgraph "AWS Serverless Backend (External / not in this repository)"
    direction TB

    ApiGateway["HTTPS API Layer (e.g., API Gateway)"]:::api

    subgraph "Compute (Functions)"
      direction TB
      UploadFn["Upload Handler (Lambda)"]:::compute
      ExtractFn["PDF Text Extractor (Lambda/Python)"]:::compute
      OrchestratorFn["AI Orchestrator/Scorer (Lambda)"]:::compute
    end

    subgraph "Storage"
      direction TB
      ObjStore[("Object Storage (e.g., S3 resumes)")]:::datastore
      ResultsDB[("Results Store (e.g., DynamoDB/RDS)")]:::datastore
    end

    AsyncLayer["Async/Workflow (Queue/Step Functions/EventBus)"]:::async

    ApiGateway -->|"invoke"| UploadFn
    UploadFn -->|"store_PDF_bytes"| ObjStore

    UploadFn -->|"emit_job(requestId)"| AsyncLayer
    AsyncLayer -->|"trigger"| ExtractFn

    ExtractFn -->|"read_PDF"| ObjStore
    ExtractFn -->|"extracted_plain_text"| OrchestratorFn

    OrchestratorFn -->|"persist_scores/feedback"| ResultsDB
  end

  %% =========================
  %% External AI Provider
  %% =========================
  subgraph "External AI Provider"
    direction TB
    AIService["LLM/AI Scoring Service (generic)"]:::external
  end

  OrchestratorFn -->|"prompts+extracted_text"| AIService
  AIService -->|"scores+suggestions"| OrchestratorFn

  %% =========================
  %% End-to-end Data Flows
  %% =========================
  UploadPage -->|"upload_PDF_bytes (HTTPS/JSON or multipart)"| ApiGateway
  UploadFn -->|"returns_requestId"| ApiGateway
  ApiGateway -->|"requestId/status"| UploadPage

  AnalyzePage -->|"poll_status/results(requestId)"| ApiGateway
  ApiGateway -->|"fetch_results"| ResultsDB
  ApiGateway -->|"scores/feedback_JSON"| AnalyzePage
  AnalyzePage -->|"cache_results"| IndexedDbUtil

  %% =========================
  %% Styling
  %% =========================
  classDef actor fill:#F4F1DE,stroke:#3D405B,stroke-width:1.5px,color:#1B1B1B
  classDef hosting fill:#E0FBFC,stroke:#3D5A80,stroke-width:1.5px,color:#0B1320
  classDef frontend fill:#E8F5E9,stroke:#2E7D32,stroke-width:1.5px,color:#0E2A12
  classDef page fill:#C8E6C9,stroke:#1B5E20,stroke-width:1.5px,color:#0E2A12
  classDef component fill:#D1F2EB,stroke:#117A65,stroke-width:1.5px,color:#063B33
  classDef util fill:#E3F2FD,stroke:#1565C0,stroke-width:1.5px,color:#0B2A4A
  classDef api fill:#FFF3E0,stroke:#EF6C00,stroke-width:1.5px,color:#4A2400
  classDef compute fill:#FFEBEE,stroke:#C62828,stroke-width:1.5px,color:#3A0D0D
  classDef datastore fill:#F3E5F5,stroke:#6A1B9A,stroke-width:1.8px,color:#2A0B3B
  classDef external fill:#E7E9ED,stroke:#455A64,stroke-width:1.5px,color:#1C2A30,stroke-dasharray: 6 4
  classDef async fill:#FFFDE7,stroke:#9E9D24,stroke-width:1.5px,color:#3B3A05
  classDef tooling fill:#ECEFF1,stroke:#607D8B,stroke-width:1.2px,color:#263238

  %% =========================
  %% Click Events (component mappings)
  %% =========================
  click ReactSPA "https://github.com/navaneetha-krishnan-mv/resume-analyzer/tree/main/src/"
  click IndexHtml "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/index.html"
  click MainJsx "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/main.jsx"
  click AppJsx "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/App.jsx"

  click HomePage "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/pages/Home.jsx"
  click UploadPage "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/pages/Upload.jsx"
  click AnalyzePage "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/pages/Analyze.jsx"

  click Layout "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/components/Layout.jsx"
  click ProgressBar "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/components/ProgressBar.jsx"
  click ScoreRing "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/components/ScoreRing.jsx"
  click Logo "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/components/AiScannerLogo.jsx"

  click IndexedDbUtil "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/utils/indexedDb.js"

  click TailwindCfg "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/tailwind.config.cjs"
  click IndexCss "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/src/index.css"
  click ViteCfg "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/vite.config.js"
  click ESLintCfg "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/eslint.config.js"

  click PublicAssets "https://github.com/navaneetha-krishnan-mv/resume-analyzer/tree/main/public/"
  click VercelCfg "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/vercel.json"

  %% Python utility mapped to extraction stage
  click ExtractFn "https://github.com/navaneetha-krishnan-mv/resume-analyzer/blob/main/python/pdfextractor.py"
```
