# abudujana-05/parse_resume_using_ner architecture

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

- Interactive diagram: https://gitdiagram.com/abudujana-05/parse_resume_using_ner
- Repository: https://github.com/abudujana-05/parse_resume_using_ner

## Overview

Parse Resume using NER is a web application for extracting structured entities and ATS-readiness signals from resumes. Users submit a file or pasted text in the sandbox, the FastAPI service extracts document text and performs NER and scoring, then returns annotated text and entities for display; the gallery exercises the same parser with domain samples. A separate proof dashboard presents training metrics and artifacts. Backend internals are based on the shown excerpts; training/data-preparation subsystems are represented only where the tree supports them.

Main entry points: [`backend/app.py`](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/app.py) (Resume API), [`src/App.jsx`](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/App.jsx) (App and tabs), [`src/api.js`](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/api.js) (API client), [`src/components/ParserSandbox.jsx`](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/ParserSandbox.jsx) (Parser sandbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["App and tabs<br/>[App.jsx]"]
  node_sandbox["Parser sandbox<br/>[ParserSandbox.jsx]"]
  node_upload["File upload<br/>[FileUpload.jsx]"]
  node_gallery["Domain gallery<br/>[DomainGallery.jsx]"]
  node_entityview["Entity display<br/>[EntityDisplay.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_background["Animated background<br/>[GhostFibers.jsx]"]
end

subgraph group_backend["Parsing service"]
  node_backendapi["Resume API<br/>[app.py]"]
  node_extract["Document extraction<br/>[cv_engine.py]"]
  node_ats["Entity rules and ATS score<br/>[app.py]"]
  node_samples["Sample text catalog<br/>[sample_texts.py]"]
  node_gallerysample["Domain sample resumes"]
end

subgraph group_model["NER and training"]
  node_ner["Resume NER wrapper<br/>[ner_model.py]"]
  node_modelartifact["Trained spaCy model"]
  node_training["Training and evaluation"]
  node_dataprep["Dataset preparation<br/>[prepare_data.py]"]
end

subgraph group_proof["Training evidence"]
  node_metrics["Training metrics"]
  node_dashboard["Proof dashboard<br/>[ProofDashboard.jsx]"]
  node_terminal["Training replay<br/>[TerminalReplay.jsx]"]
  node_staticproof["Bundled proof metrics"]
end

node_user(("Resume user"))

node_user -->|"uses"| node_app
node_app -->|"shows tab"| node_sandbox
node_app -->|"shows tab"| node_gallery
node_app -->|"shows tab"| node_dashboard
node_app -->|"renders"| node_background
node_sandbox -->|"renders"| node_upload
node_sandbox -->|"submits parse"| node_api
node_gallery -->|"submits sample"| node_api
node_gallerysample -.->|"sample content"| node_gallery
node_sandbox -->|"renders entities"| node_entityview
node_gallery -->|"renders entities"| node_entityview
node_api -->|"HTTP requests"| node_backendapi
node_backendapi -->|"extracts file text"| node_extract
node_backendapi -->|"runs model"| node_ner
node_backendapi -->|"builds entities and score"| node_ats
node_backendapi -->|"serves samples"| node_samples
node_ner -.->|"loads model"| node_modelartifact
node_training -.->|"produces model"| node_modelartifact
node_dataprep -.->|"prepares training data"| node_training
node_training -.->|"writes metrics"| node_metrics
node_dashboard -->|"requests metrics"| node_api
node_dashboard -->|"renders replay"| node_terminal
node_dashboard -->|"loads fallback"| node_staticproof
node_terminal -->|"requests metrics"| node_api
node_terminal -->|"loads fallback"| node_staticproof
node_backendapi -.->|"serves metrics"| node_metrics

click node_app "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/App.jsx"
click node_sandbox "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/ParserSandbox.jsx"
click node_upload "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/FileUpload.jsx"
click node_gallery "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/DomainGallery.jsx"
click node_entityview "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/EntityDisplay.jsx"
click node_api "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/api.js"
click node_background "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/GhostFibers.jsx"
click node_backendapi "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/app.py"
click node_extract "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/cv_engine.py"
click node_ner "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/ner_model.py"
click node_ats "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/app.py"
click node_samples "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/sample_texts.py"
click node_modelartifact "https://github.com/abudujana-05/parse_resume_using_ner/tree/main/backend/models/ner_model"
click node_training "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/train_antigravity.py"
click node_dataprep "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/prepare_data.py"
click node_metrics "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/output/training_metrics.json"
click node_dashboard "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/ProofDashboard.jsx"
click node_terminal "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/TerminalReplay.jsx"
click node_staticproof "https://github.com/abudujana-05/parse_resume_using_ner/blob/main/public/proof/training_metrics.json"
click node_gallerysample "https://github.com/abudujana-05/parse_resume_using_ner/tree/main/backend/data/resumes"

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_sandbox,node_upload,node_gallery,node_entityview,node_api,node_background,node_user toneBlue
class node_backendapi,node_extract,node_ats,node_samples,node_gallerysample toneAmber
class node_ner,node_modelartifact,node_training,node_dataprep toneMint
class node_metrics,node_dashboard,node_terminal,node_staticproof toneRose
```

## Components

### Web interface

- [App and tabs](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/App.jsx): `src/App.jsx`
- [Parser sandbox](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/ParserSandbox.jsx): `src/components/ParserSandbox.jsx`
- [File upload](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/FileUpload.jsx): `src/components/FileUpload.jsx`
- [Domain gallery](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/DomainGallery.jsx): `src/components/DomainGallery.jsx`
- [Entity display](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/EntityDisplay.jsx): `src/components/EntityDisplay.jsx`
- [API client](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/api.js): `src/api.js`
- [Animated background](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/GhostFibers.jsx): `src/components/GhostFibers.jsx`

### Parsing service

- [Resume API](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/app.py): `backend/app.py`
- [Document extraction](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/cv_engine.py): `backend/cv_engine.py`
- [Entity rules and ATS score](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/app.py): `backend/app.py`
- [Sample text catalog](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/sample_texts.py): `backend/sample_texts.py`
- [Domain sample resumes](https://github.com/abudujana-05/parse_resume_using_ner/tree/main/backend/data/resumes): `backend/data/resumes`

### NER and training

- [Resume NER wrapper](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/ner_model.py): `backend/ner_model.py`
- [Trained spaCy model](https://github.com/abudujana-05/parse_resume_using_ner/tree/main/backend/models/ner_model): `backend/models/ner_model`
- [Training and evaluation](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/train_antigravity.py): `backend/train_antigravity.py`
- [Dataset preparation](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/prepare_data.py): `backend/prepare_data.py`

### Training evidence

- [Training metrics](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/backend/output/training_metrics.json): `backend/output/training_metrics.json`
- [Proof dashboard](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/ProofDashboard.jsx): `src/components/ProofDashboard.jsx`
- [Training replay](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/src/components/TerminalReplay.jsx): `src/components/TerminalReplay.jsx`
- [Bundled proof metrics](https://github.com/abudujana-05/parse_resume_using_ner/blob/main/public/proof/training_metrics.json): `public/proof/training_metrics.json`

### Other components

- **Resume user**

## Connections

- Resume user → App and tabs: uses (evidence: `src/App.jsx`)
- App and tabs → Parser sandbox: shows tab (evidence: `src/App.jsx`)
- App and tabs → Domain gallery: shows tab (evidence: `src/App.jsx`)
- App and tabs → Proof dashboard: shows tab (evidence: `src/App.jsx`)
- App and tabs → Animated background: renders (evidence: `src/App.jsx`)
- Parser sandbox → File upload: renders (evidence: `src/components/ParserSandbox.jsx`)
- Parser sandbox → API client: submits parse (evidence: `src/components/ParserSandbox.jsx`)
- Domain gallery → API client: submits sample (evidence: `src/components/DomainGallery.jsx`)
- Domain sample resumes → Domain gallery: sample content
- Parser sandbox → Entity display: renders entities (evidence: `src/components/ParserSandbox.jsx`)
- Domain gallery → Entity display: renders entities (evidence: `src/components/DomainGallery.jsx`)
- API client → Resume API: HTTP requests (evidence: `src/api.js`)
- Resume API → Document extraction: extracts file text (evidence: `backend/app.py`)
- Resume API → Resume NER wrapper: runs model (evidence: `backend/app.py`)
- Resume API → Entity rules and ATS score: builds entities and score (evidence: `backend/app.py`)
- Resume API → Sample text catalog: serves samples (evidence: `backend/app.py`)
- Resume NER wrapper → Trained spaCy model: loads model
- Training and evaluation → Trained spaCy model: produces model
- Dataset preparation → Training and evaluation: prepares training data
- Training and evaluation → Training metrics: writes metrics
- Proof dashboard → API client: requests metrics (evidence: `src/components/ProofDashboard.jsx`)
- Proof dashboard → Training replay: renders replay (evidence: `src/components/ProofDashboard.jsx`)
- Proof dashboard → Bundled proof metrics: loads fallback (evidence: `src/components/ProofDashboard.jsx`)
- Training replay → API client: requests metrics (evidence: `src/components/TerminalReplay.jsx`)
- Training replay → Bundled proof metrics: loads fallback (evidence: `src/components/TerminalReplay.jsx`)
- Resume API → Training metrics: serves metrics
