# vars-123/jobportal_frontend_v2 architecture

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

- Interactive diagram: https://gitdiagram.com/vars-123/jobportal_frontend_v2
- Repository: https://github.com/vars-123/jobportal_frontend_v2

## Overview

This is a React job-listing and candidate application portal with Gemini-backed resume analysis. The principal workflow presents a job, accepts a resume, analyzes it against the job description, displays a score and skills feedback, and lets candidates submit an application; the enhanced form also displays the analysis outcome. The README documents PDF reports and a 60% auto-submit rule, while the sampled form excerpt shows a below-threshold submission warning. Source excerpts do not establish every UI transition or backend behavior, so uncertain links are omitted.

Main entry points: [`src/App.jsx`](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/App.jsx) (Page Orchestrator), [`src/components/EnhancedApplicationForm.jsx`](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/EnhancedApplicationForm.jsx) (Enhanced Application), [`src/components/AIResumeAnalyzer.jsx`](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/AIResumeAnalyzer.jsx) (Analysis Widget), [`src/services/aiService.js`](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/services/aiService.js) (Resume AI Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_job_ui["Job Portal UI"]
  node_app_entry["React Entry<br/>[index.jsx]"]
  node_app_shell["Page Orchestrator<br/>[App.jsx]"]
  node_header["Navigation<br/>[Header.jsx]"]
  node_hero["Job Overview<br/>[Hero.jsx]"]
  node_job_details["Job Details<br/>[JobDetails.jsx]"]
  node_footer["Footer<br/>[Footer.jsx]"]
end

subgraph group_candidate_flow["Candidate Application"]
  node_application["Application Form"]
  node_enhanced_application["Enhanced Application"]
  node_business_rules["Business Rules<br/>[businessRules.js]"]
end

subgraph group_resume_ai["Resume Analysis"]
  node_resume_section["Resume Analysis UI"]
  node_analyzer_widget["Analysis Widget"]
  node_ai_service["Resume AI Service<br/>[aiService.js]"]
  node_pdf_report["PDF Report Generation"]
end

subgraph group_integrations["External Integrations"]
  node_gemini{{"Google Gemini API"}}
  node_application_backend{{"Application Backend"}}
end

node_candidate(("Candidate"))

node_app_entry -->|"renders"| node_app_shell
node_app_shell -->|"renders"| node_header
node_app_shell -->|"renders"| node_hero
node_app_shell -->|"renders"| node_resume_section
node_app_shell -->|"renders"| node_job_details
node_app_shell -->|"renders"| node_enhanced_application
node_app_shell -->|"renders"| node_footer
node_candidate -->|"opens portal"| node_app_entry
node_candidate -->|"submits details"| node_enhanced_application
node_resume_section -->|"requests analysis"| node_ai_service
node_analyzer_widget -->|"requests analysis"| node_ai_service
node_enhanced_application -->|"uses analyzer"| node_analyzer_widget
node_ai_service -->|"sends prompt"| node_gemini
node_enhanced_application -->|"posts application"| node_application_backend
node_analyzer_widget -->|"generates report"| node_pdf_report

click node_app_entry "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/index.jsx"
click node_app_shell "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/App.jsx"
click node_header "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Header.jsx"
click node_hero "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Hero.jsx"
click node_job_details "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/JobDetails.jsx"
click node_footer "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Footer.jsx"
click node_application "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/ApplicationForm.jsx"
click node_enhanced_application "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/EnhancedApplicationForm.jsx"
click node_resume_section "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/ResumeAnalysisSection.jsx"
click node_analyzer_widget "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/AIResumeAnalyzer.jsx"
click node_ai_service "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/services/aiService.js"
click node_business_rules "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/utils/businessRules.js"
click node_pdf_report "https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/AIResumeAnalyzer.jsx"

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_entry,node_app_shell,node_header,node_hero,node_job_details,node_footer toneBlue
class node_application,node_enhanced_application,node_business_rules toneAmber
class node_resume_section,node_analyzer_widget,node_ai_service,node_pdf_report toneMint
class node_gemini,node_application_backend toneRose
class node_candidate toneIndigo
```

## Components

### Job Portal UI

- [React Entry](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/index.jsx): `src/index.jsx`
- [Page Orchestrator](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/App.jsx): `src/App.jsx`
- [Navigation](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Header.jsx): `src/components/Header.jsx`
- [Job Overview](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Job Details](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/JobDetails.jsx): `src/components/JobDetails.jsx`
- [Footer](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/Footer.jsx): `src/components/Footer.jsx`

### Candidate Application

- [Application Form](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/ApplicationForm.jsx): `src/components/ApplicationForm.jsx`
- [Enhanced Application](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/EnhancedApplicationForm.jsx): `src/components/EnhancedApplicationForm.jsx`
- [Business Rules](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/utils/businessRules.js): `src/utils/businessRules.js`

### Resume Analysis

- [Resume Analysis UI](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/ResumeAnalysisSection.jsx): `src/components/ResumeAnalysisSection.jsx`
- [Analysis Widget](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/AIResumeAnalyzer.jsx): `src/components/AIResumeAnalyzer.jsx`
- [Resume AI Service](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/services/aiService.js): `src/services/aiService.js`
- [PDF Report Generation](https://github.com/vars-123/jobportal_frontend_v2/blob/main/src/components/AIResumeAnalyzer.jsx): `src/components/AIResumeAnalyzer.jsx`

### External Integrations

- **Google Gemini API**
- **Application Backend**

### Other components

- **Candidate**

## Connections

- React Entry → Page Orchestrator: renders (evidence: `src/index.jsx`)
- Page Orchestrator → Navigation: renders (evidence: `src/App.jsx`)
- Page Orchestrator → Job Overview: renders (evidence: `src/App.jsx`)
- Page Orchestrator → Resume Analysis UI: renders (evidence: `src/App.jsx`)
- Page Orchestrator → Job Details: renders (evidence: `src/App.jsx`)
- Page Orchestrator → Enhanced Application: renders (evidence: `src/App.jsx`)
- Page Orchestrator → Footer: renders (evidence: `src/App.jsx`)
- Candidate → React Entry: opens portal (evidence: `README.md`)
- Candidate → Enhanced Application: submits details (evidence: `README.md`)
- Resume Analysis UI → Resume AI Service: requests analysis (evidence: `src/components/ResumeAnalysisSection.jsx`)
- Analysis Widget → Resume AI Service: requests analysis (evidence: `src/components/AIResumeAnalyzer.jsx`)
- Enhanced Application → Analysis Widget: uses analyzer (evidence: `src/components/EnhancedApplicationForm.jsx`)
- Resume AI Service → Google Gemini API: sends prompt (evidence: `src/services/aiService.js`)
- Enhanced Application → Application Backend: posts application (evidence: `src/components/EnhancedApplicationForm.jsx`)
- Analysis Widget → PDF Report Generation: generates report (evidence: `src/components/AIResumeAnalyzer.jsx`)
