# wamender007-sara/resume-analyser-system architecture

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

- Interactive diagram: https://gitdiagram.com/wamender007-sara/resume-analyser-system
- Repository: https://github.com/wamender007-sara/resume-analyser-system

## Overview

This is a browser-based resume review and career-support application. Its primary workflow accepts a resume file, extracts and validates its text, runs local ATS/resume analysis, and presents results; users can also export a report or use career-advice features. Separate capabilities include an authentic resume editor, score-improvement guidance, and staff-facing batch candidate review. The source excerpts establish the main orchestration and several module calls; the README is empty, and relationships for the opportunities page are not shown.

Main entry points: [`app.js`](https://github.com/wamender007-sara/resume-analyser-system/blob/main/app.js) (App orchestration), [`staff.js`](https://github.com/wamender007-sara/resume-analyser-system/blob/main/staff.js) (Batch candidate review), [`ui.js`](https://github.com/wamender007-sara/resume-analyser-system/blob/main/ui.js) (Results interface), [`analysis-engine.js`](https://github.com/wamender007-sara/resume-analyser-system/blob/main/analysis-engine.js) (Resume and ATS analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_review["Resume Review"]
  node_app["App orchestration<br/>[app.js]"]
  node_parser["Document extraction<br/>[pdf-parser.js]"]
  node_analysis["Resume and ATS analysis<br/>[analysis-engine.js]"]
  node_ui["Results interface<br/>[ui.js]"]
  node_export["PDF report export<br/>[pdf-export.js]"]
  node_ads["Ad slots<br/>[ad-slot.js]"]
end

subgraph group_improve["Resume Improvement"]
  node_potential["Score improvement<br/>[score-potential.js]"]
  node_editor["Resume editor and optimizer<br/>[resume-editor.js]"]
end

subgraph group_career["Career Support"]
  node_gemini["AI career assistance<br/>[gemini.js]"]
  node_opportunities["Opportunities page<br/>[opportunities.js]"]
end

subgraph group_staff["Staff Review"]
  node_staff["Batch candidate review<br/>[staff.js]"]
end

node_applicant(("Resume user"))
node_staff_user(("Staff user"))
node_gemini_api(("Google Gemini API"))

node_applicant -.->|"submits resume"| node_app
node_app -->|"extracts text"| node_parser
node_app -->|"validates and analyzes"| node_analysis
node_app -->|"renders results"| node_ui
node_app -->|"generates report"| node_export
node_app -->|"requests AI help"| node_gemini
node_app -->|"imports scoring"| node_potential
node_app -->|"imports editor"| node_editor
node_gemini -->|"calls API"| node_gemini_api
node_editor -->|"validates resume"| node_analysis
node_staff_user -.->|"submits resumes"| node_staff
node_staff -->|"extracts text"| node_parser
node_staff -->|"validates and analyzes"| node_analysis
node_staff -->|"renders review"| node_ui
node_ui -->|"formats analysis"| node_analysis
node_ui -->|"updates slots"| node_ads

click node_app "https://github.com/wamender007-sara/resume-analyser-system/blob/main/app.js"
click node_parser "https://github.com/wamender007-sara/resume-analyser-system/blob/main/pdf-parser.js"
click node_analysis "https://github.com/wamender007-sara/resume-analyser-system/blob/main/analysis-engine.js"
click node_ui "https://github.com/wamender007-sara/resume-analyser-system/blob/main/ui.js"
click node_export "https://github.com/wamender007-sara/resume-analyser-system/blob/main/pdf-export.js"
click node_potential "https://github.com/wamender007-sara/resume-analyser-system/blob/main/score-potential.js"
click node_editor "https://github.com/wamender007-sara/resume-analyser-system/blob/main/resume-editor.js"
click node_gemini "https://github.com/wamender007-sara/resume-analyser-system/blob/main/gemini.js"
click node_opportunities "https://github.com/wamender007-sara/resume-analyser-system/blob/main/opportunities.js"
click node_staff "https://github.com/wamender007-sara/resume-analyser-system/blob/main/staff.js"
click node_ads "https://github.com/wamender007-sara/resume-analyser-system/blob/main/ad-slot.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_parser,node_analysis,node_ui,node_export,node_ads,node_applicant,node_staff_user toneBlue
class node_potential,node_editor toneAmber
class node_gemini,node_opportunities,node_gemini_api toneMint
class node_staff toneRose
```

## Components

### Resume Review

- [App orchestration](https://github.com/wamender007-sara/resume-analyser-system/blob/main/app.js): `app.js`
- [Document extraction](https://github.com/wamender007-sara/resume-analyser-system/blob/main/pdf-parser.js): `pdf-parser.js`
- [Resume and ATS analysis](https://github.com/wamender007-sara/resume-analyser-system/blob/main/analysis-engine.js): `analysis-engine.js`
- [Results interface](https://github.com/wamender007-sara/resume-analyser-system/blob/main/ui.js): `ui.js`
- [PDF report export](https://github.com/wamender007-sara/resume-analyser-system/blob/main/pdf-export.js): `pdf-export.js`
- [Ad slots](https://github.com/wamender007-sara/resume-analyser-system/blob/main/ad-slot.js): `ad-slot.js`

### Resume Improvement

- [Score improvement](https://github.com/wamender007-sara/resume-analyser-system/blob/main/score-potential.js): `score-potential.js`
- [Resume editor and optimizer](https://github.com/wamender007-sara/resume-analyser-system/blob/main/resume-editor.js): `resume-editor.js`

### Career Support

- [AI career assistance](https://github.com/wamender007-sara/resume-analyser-system/blob/main/gemini.js): `gemini.js`
- [Opportunities page](https://github.com/wamender007-sara/resume-analyser-system/blob/main/opportunities.js): `opportunities.js`

### Staff Review

- [Batch candidate review](https://github.com/wamender007-sara/resume-analyser-system/blob/main/staff.js): `staff.js`

### Other components

- **Resume user**
- **Staff user**
- **Google Gemini API**

## Connections

- Resume user → App orchestration: submits resume
- App orchestration → Document extraction: extracts text (evidence: `app.js`)
- App orchestration → Resume and ATS analysis: validates and analyzes (evidence: `app.js`)
- App orchestration → Results interface: renders results (evidence: `app.js`)
- App orchestration → PDF report export: generates report (evidence: `app.js`)
- App orchestration → AI career assistance: requests AI help (evidence: `app.js`)
- App orchestration → Score improvement: imports scoring (evidence: `app.js`)
- App orchestration → Resume editor and optimizer: imports editor (evidence: `app.js`)
- AI career assistance → Google Gemini API: calls API (evidence: `gemini.js`)
- Resume editor and optimizer → Resume and ATS analysis: validates resume (evidence: `resume-editor.js`)
- Staff user → Batch candidate review: submits resumes
- Batch candidate review → Document extraction: extracts text (evidence: `staff.js`)
- Batch candidate review → Resume and ATS analysis: validates and analyzes (evidence: `staff.js`)
- Batch candidate review → Results interface: renders review (evidence: `staff.js`)
- Results interface → Resume and ATS analysis: formats analysis (evidence: `ui.js`)
- Results interface → Ad slots: updates slots (evidence: `ui.js`)
