# harsh10099ht5/job-portal architecture

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

- Interactive diagram: https://gitdiagram.com/harsh10099ht5/job-portal
- Repository: https://github.com/harsh10099ht5/job-portal

## Overview

Job In India is a PHP/MySQL recruitment portal for job seekers and recruiters. The main workflow is account registration or login, job discovery, resume-backed application, and application-status tracking; recruiters post and manage jobs and review candidates. Profile and resume management support job seeking, while a Python recommendation engine provides a separate matching capability. The PHP pages use a shared MySQL connection. Edges reflect shown imports and calls or README-documented capabilities; unsampled page behavior is not inferred.

Main entry points: [`config/database.php`](https://github.com/harsh10099ht5/job-portal/blob/main/config/database.php) (MySQL Database), [`jobs.php`](https://github.com/harsh10099ht5/job-portal/blob/main/jobs.php) (Job Search), [`jobs/apply.php`](https://github.com/harsh10099ht5/job-portal/blob/main/jobs/apply.php) (Submit Application), [`applications.php`](https://github.com/harsh10099ht5/job-portal/blob/main/applications.php) (Candidate Review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Accounts &amp; Profiles"]
  node_register["Registration<br/>[register.php]"]
  node_login["Authentication<br/>[login.php]"]
  node_profile["Profile Management<br/>[profile.php]"]
  node_resume["Resume Upload<br/>[upload.php]"]
end

subgraph group_jobs["Job Discovery &amp; Posting"]
  node_jobsearch["Job Search<br/>[jobs.php]"]
  node_jobdetail["Job Listings<br/>[index.php]"]
  node_postjob["Job Posting<br/>[post-job.php]"]
  node_managejobs["Recruiter Job Management<br/>[my-jobs.php]"]
  node_editjob["Edit Job<br/>[edit-job.php]"]
end

subgraph group_applications["Applications &amp; Review"]
  node_apply["Submit Application<br/>[apply.php]"]
  node_myapps["Applicant Tracking"]
  node_review["Candidate Review<br/>[applications.php]"]
  node_status["Update Application Status"]
  node_dashboard["Role Dashboard<br/>[dashboard.php]"]
end

subgraph group_matching["Recommendations &amp; Data"]
  node_api["Recommendation API<br/>[api.py]"]
  node_matcher["Job Matching Engine<br/>[system.py]"]
  node_db[("MySQL Database<br/>[database.php]")]
end

node_seeker(("Job Seeker"))
node_recruiter(("Recruiter / Admin"))

node_seeker -->|"creates account"| node_register
node_seeker -->|"signs in"| node_login
node_recruiter -->|"signs in"| node_login
node_seeker -->|"searches jobs"| node_jobsearch
node_jobsearch -->|"applies to"| node_apply
node_apply -->|"tracks status"| node_myapps
node_recruiter -->|"posts jobs"| node_postjob
node_recruiter -->|"manages jobs"| node_managejobs
node_recruiter -->|"reviews candidates"| node_review
node_review -->|"updates status"| node_status
node_seeker -->|"manages profile"| node_profile
node_seeker -->|"uploads resume"| node_resume
node_register -->|"uses connection"| node_db
node_login -->|"uses connection"| node_db
node_profile -->|"uses connection"| node_db
node_resume -->|"uses connection"| node_db
node_jobsearch -->|"uses connection"| node_db
node_postjob -->|"uses connection"| node_db
node_managejobs -->|"uses connection"| node_db
node_editjob -->|"uses connection"| node_db
node_apply -->|"reads and writes"| node_db
node_myapps -->|"uses connection"| node_db
node_review -->|"uses connection"| node_db
node_api -->|"invokes"| node_matcher
node_jobdetail -.->|"reads jobs"| node_db
node_dashboard -.->|"reads portal data"| node_db

click node_register "https://github.com/harsh10099ht5/job-portal/blob/main/register.php"
click node_login "https://github.com/harsh10099ht5/job-portal/blob/main/login.php"
click node_profile "https://github.com/harsh10099ht5/job-portal/blob/main/profile.php"
click node_resume "https://github.com/harsh10099ht5/job-portal/blob/main/upload.php"
click node_jobsearch "https://github.com/harsh10099ht5/job-portal/blob/main/jobs.php"
click node_jobdetail "https://github.com/harsh10099ht5/job-portal/blob/main/index.php"
click node_postjob "https://github.com/harsh10099ht5/job-portal/blob/main/post-job.php"
click node_managejobs "https://github.com/harsh10099ht5/job-portal/blob/main/my-jobs.php"
click node_editjob "https://github.com/harsh10099ht5/job-portal/blob/main/edit-job.php"
click node_apply "https://github.com/harsh10099ht5/job-portal/blob/main/jobs/apply.php"
click node_myapps "https://github.com/harsh10099ht5/job-portal/blob/main/my-applications.php"
click node_review "https://github.com/harsh10099ht5/job-portal/blob/main/applications.php"
click node_status "https://github.com/harsh10099ht5/job-portal/blob/main/update-application-status.php"
click node_dashboard "https://github.com/harsh10099ht5/job-portal/blob/main/dashboard.php"
click node_api "https://github.com/harsh10099ht5/job-portal/blob/main/api.py"
click node_matcher "https://github.com/harsh10099ht5/job-portal/blob/main/system.py"
click node_db "https://github.com/harsh10099ht5/job-portal/blob/main/config/database.php"

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_register,node_login,node_profile,node_resume toneBlue
class node_jobsearch,node_jobdetail,node_postjob,node_managejobs,node_editjob toneAmber
class node_apply,node_myapps,node_review,node_status,node_dashboard toneMint
class node_api,node_matcher,node_db toneRose
class node_seeker,node_recruiter toneIndigo
```

## Components

### Accounts & Profiles

- [Registration](https://github.com/harsh10099ht5/job-portal/blob/main/register.php): `register.php`
- [Authentication](https://github.com/harsh10099ht5/job-portal/blob/main/login.php): `login.php`
- [Profile Management](https://github.com/harsh10099ht5/job-portal/blob/main/profile.php): `profile.php`
- [Resume Upload](https://github.com/harsh10099ht5/job-portal/blob/main/upload.php): `upload.php`

### Job Discovery & Posting

- [Job Search](https://github.com/harsh10099ht5/job-portal/blob/main/jobs.php): `jobs.php`
- [Job Listings](https://github.com/harsh10099ht5/job-portal/blob/main/index.php): `index.php`
- [Job Posting](https://github.com/harsh10099ht5/job-portal/blob/main/post-job.php): `post-job.php`
- [Recruiter Job Management](https://github.com/harsh10099ht5/job-portal/blob/main/my-jobs.php): `my-jobs.php`
- [Edit Job](https://github.com/harsh10099ht5/job-portal/blob/main/edit-job.php): `edit-job.php`

### Applications & Review

- [Submit Application](https://github.com/harsh10099ht5/job-portal/blob/main/jobs/apply.php): `jobs/apply.php`
- [Applicant Tracking](https://github.com/harsh10099ht5/job-portal/blob/main/my-applications.php): `my-applications.php`
- [Candidate Review](https://github.com/harsh10099ht5/job-portal/blob/main/applications.php): `applications.php`
- [Update Application Status](https://github.com/harsh10099ht5/job-portal/blob/main/update-application-status.php): `update-application-status.php`
- [Role Dashboard](https://github.com/harsh10099ht5/job-portal/blob/main/dashboard.php): `dashboard.php`

### Recommendations & Data

- [Recommendation API](https://github.com/harsh10099ht5/job-portal/blob/main/api.py): `api.py`
- [Job Matching Engine](https://github.com/harsh10099ht5/job-portal/blob/main/system.py): `system.py`
- [MySQL Database](https://github.com/harsh10099ht5/job-portal/blob/main/config/database.php): `config/database.php`

### Other components

- **Job Seeker**
- **Recruiter / Admin**

## Connections

- Job Seeker → Registration: creates account (evidence: `README.md`)
- Job Seeker → Authentication: signs in (evidence: `README.md`)
- Recruiter / Admin → Authentication: signs in (evidence: `README.md`)
- Job Seeker → Job Search: searches jobs (evidence: `README.md`)
- Job Search → Submit Application: applies to (evidence: `README.md`)
- Submit Application → Applicant Tracking: tracks status (evidence: `README.md`)
- Recruiter / Admin → Job Posting: posts jobs (evidence: `README.md`)
- Recruiter / Admin → Recruiter Job Management: manages jobs (evidence: `README.md`)
- Recruiter / Admin → Candidate Review: reviews candidates (evidence: `README.md`)
- Candidate Review → Update Application Status: updates status (evidence: `README.md`)
- Job Seeker → Profile Management: manages profile (evidence: `README.md`)
- Job Seeker → Resume Upload: uploads resume (evidence: `README.md`)
- Registration → MySQL Database: uses connection (evidence: `register.php`)
- Authentication → MySQL Database: uses connection (evidence: `login.php`)
- Profile Management → MySQL Database: uses connection (evidence: `profile.php`)
- Resume Upload → MySQL Database: uses connection (evidence: `upload.php`)
- Job Search → MySQL Database: uses connection (evidence: `jobs.php`)
- Job Posting → MySQL Database: uses connection (evidence: `post-job.php`)
- Recruiter Job Management → MySQL Database: uses connection (evidence: `my-jobs.php`)
- Edit Job → MySQL Database: uses connection (evidence: `edit-job.php`)
- Submit Application → MySQL Database: reads and writes (evidence: `jobs/apply.php`)
- Applicant Tracking → MySQL Database: uses connection (evidence: `my-applications.php`)
- Candidate Review → MySQL Database: uses connection (evidence: `applications.php`)
- Recommendation API → Job Matching Engine: invokes (evidence: `api.py`)
- Job Listings → MySQL Database: reads jobs
- Role Dashboard → MySQL Database: reads portal data
