# theharithsa/placement-management-system architecture

> Architecture diagram of the GitHub repository theharithsa/placement-management-system, 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/theharithsa/placement-management-system
- Repository: https://github.com/theharithsa/placement-management-system

## Overview

This PHP/MySQL placement-management system serves public visitors and four role-based portals. The main workflow is student registration and profile updates, HOD verification, placement-drive management and student registration, then principal queries and campus-status review. The README also documents notifications, eligibility checks, and a public drives homepage. Portal entry pages visibly submit to their login handlers; other cross-portal and database relationships below are based on README descriptions, since most feature implementations were not sampled.

Main entry points: [`Profilers/SProfile/index.php`](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/index.php) (Student login), [`Profilers/HODProfile/index.php`](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/index.php) (HOD login), [`Profilers/PriProfile/index.php`](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/index.php) (Principal login), [`Profilers/PProfile/index.php`](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/index.php) (Placement login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public pages"]
  node_master_home["Master homepage<br/>[home.php]"]
  node_drives_home["Public drives<br/>[index.php]"]
end

subgraph group_student["Student portal"]
  node_student_login["Student login<br/>[index.php]"]
  node_student_gate["Student session gate<br/>[index1.php]"]
  node_student_auth["Student authentication<br/>[login1.php]"]
  node_student_profile["Student biodata<br/>[Register.php]"]
  node_student_preferences["Student preferences<br/>[preferences.php]"]
end

subgraph group_staff["Staff portals"]
  node_hod_login["HOD login<br/>[index.php]"]
  node_hod_gate["HOD session gate<br/>[index1.php]"]
  node_hod_auth["HOD authentication<br/>[login1.php]"]
  node_hod_review["Student verification<br/>[manage-student.php]"]
  node_hod_notifications["HOD notifications<br/>[Notif.php]"]
  node_principal_login["Principal login<br/>[index.php]"]
  node_principal_gate["Principal session gate<br/>[index1.php]"]
  node_principal_auth["Principal authentication<br/>[login1.php]"]
  node_principal_queries["Campus queries<br/>[queries.php]"]
  node_principal_eligibility["Eligibility review<br/>[eligibility.php]"]
end

subgraph group_placement["Placement operations"]
  node_placement_login["Placement login<br/>[index.php]"]
  node_placement_gate["Placement session gate<br/>[index1.php]"]
  node_placement_auth["Placement authentication<br/>[login1.php]"]
  node_drive_management["Drive management<br/>[addpdrive.php]"]
  node_drive_registration["Drive registration<br/>[PUpload.php]"]
  node_placement_eligibility["Student eligibility<br/>[eligibility.php]"]
  node_placement_queries["Placement queries<br/>[queries.php]"]
end

node_visitor(("Visitor"))
node_student_actor(("Student"))
node_hod_actor(("HOD"))
node_principal_actor(("Principal"))
node_placement_actor(("Placement officer"))
node_database[("MySQL database")]

node_visitor -->|"opens"| node_master_home
node_visitor -->|"views drives"| node_drives_home
node_student_actor -->|"signs in"| node_student_login
node_student_login -->|"includes"| node_student_gate
node_student_login -->|"submits credentials"| node_student_auth
node_student_actor -->|"updates biodata"| node_student_profile
node_student_actor -->|"sets preferences"| node_student_preferences
node_hod_actor -->|"signs in"| node_hod_login
node_hod_login -->|"includes"| node_hod_gate
node_hod_login -->|"submits credentials"| node_hod_auth
node_hod_actor -->|"verifies profiles"| node_hod_review
node_hod_actor -->|"updates messages"| node_hod_notifications
node_principal_actor -->|"signs in"| node_principal_login
node_principal_login -->|"includes"| node_principal_gate
node_principal_login -->|"submits credentials"| node_principal_auth
node_principal_actor -->|"queries campus"| node_principal_queries
node_principal_actor -->|"reviews eligibility"| node_principal_eligibility
node_placement_actor -->|"signs in"| node_placement_login
node_placement_login -->|"includes"| node_placement_gate
node_placement_login -->|"submits credentials"| node_placement_auth
node_placement_actor -->|"manages drives"| node_drive_management
node_placement_actor -->|"registers students"| node_drive_registration
node_placement_actor -->|"checks eligibility"| node_placement_eligibility
node_placement_actor -->|"queries records"| node_placement_queries
node_student_profile -->|"writes profile"| node_database
node_hod_review -->|"verifies records"| node_database
node_hod_notifications -->|"updates messages"| node_database
node_drive_management -->|"stores drives"| node_database
node_drive_registration -->|"stores registrations"| node_database
node_principal_queries -->|"queries records"| node_database
node_placement_queries -->|"queries records"| node_database

click node_master_home "https://github.com/theharithsa/placement-management-system/blob/master/Homepage/home.php"
click node_drives_home "https://github.com/theharithsa/placement-management-system/blob/master/Drives/index.php"
click node_student_login "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/index.php"
click node_student_gate "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/index1.php"
click node_student_auth "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/login1.php"
click node_student_profile "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/Register.php"
click node_student_preferences "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/preferences.php"
click node_hod_login "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/index.php"
click node_hod_gate "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/index1.php"
click node_hod_auth "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/login1.php"
click node_hod_review "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/manage-student.php"
click node_hod_notifications "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/Notif.php"
click node_principal_login "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/index.php"
click node_principal_gate "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/index1.php"
click node_principal_auth "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/login1.php"
click node_principal_queries "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/queries.php"
click node_principal_eligibility "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/eligibility.php"
click node_placement_login "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/index.php"
click node_placement_gate "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/index1.php"
click node_placement_auth "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/login1.php"
click node_drive_management "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/Placement%20Drives/addpdrive.php"
click node_drive_registration "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/Placement%20Drives/PUpload.php"
click node_placement_eligibility "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/eligibility.php"
click node_placement_queries "https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/queries.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_master_home,node_drives_home toneBlue
class node_student_login,node_student_gate,node_student_auth,node_student_profile,node_student_preferences,node_database toneAmber
class node_hod_login,node_hod_gate,node_hod_auth,node_hod_review,node_hod_notifications,node_principal_login,node_principal_gate,node_principal_auth,node_principal_queries,node_principal_eligibility toneMint
class node_placement_login,node_placement_gate,node_placement_auth,node_drive_management,node_drive_registration,node_placement_eligibility,node_placement_queries toneRose
class node_visitor,node_student_actor,node_hod_actor,node_principal_actor,node_placement_actor toneIndigo
```

## Components

### Public pages

- [Master homepage](https://github.com/theharithsa/placement-management-system/blob/master/Homepage/home.php): `Homepage/home.php`
- [Public drives](https://github.com/theharithsa/placement-management-system/blob/master/Drives/index.php): `Drives/index.php`

### Student portal

- [Student login](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/index.php): `Profilers/SProfile/index.php`
- [Student session gate](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/index1.php): `Profilers/SProfile/index1.php`
- [Student authentication](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/login1.php): `Profilers/SProfile/login1.php`
- [Student biodata](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/Register.php): `Profilers/SProfile/Register.php`
- [Student preferences](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/SProfile/preferences.php): `Profilers/SProfile/preferences.php`

### Staff portals

- [HOD login](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/index.php): `Profilers/HODProfile/index.php`
- [HOD session gate](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/index1.php): `Profilers/HODProfile/index1.php`
- [HOD authentication](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/login1.php): `Profilers/HODProfile/login1.php`
- [Student verification](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/manage-student.php): `Profilers/HODProfile/manage-student.php`
- [HOD notifications](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/HODProfile/Notif.php): `Profilers/HODProfile/Notif.php`
- [Principal login](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/index.php): `Profilers/PriProfile/index.php`
- [Principal session gate](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/index1.php): `Profilers/PriProfile/index1.php`
- [Principal authentication](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/login1.php): `Profilers/PriProfile/login1.php`
- [Campus queries](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/queries.php): `Profilers/PriProfile/queries.php`
- [Eligibility review](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PriProfile/eligibility.php): `Profilers/PriProfile/eligibility.php`

### Placement operations

- [Placement login](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/index.php): `Profilers/PProfile/index.php`
- [Placement session gate](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/index1.php): `Profilers/PProfile/index1.php`
- [Placement authentication](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/login1.php): `Profilers/PProfile/login1.php`
- [Drive management](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/Placement%20Drives/addpdrive.php): `Profilers/PProfile/Placement Drives/addpdrive.php`
- [Drive registration](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/Placement%20Drives/PUpload.php): `Profilers/PProfile/Placement Drives/PUpload.php`
- [Student eligibility](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/eligibility.php): `Profilers/PProfile/eligibility.php`
- [Placement queries](https://github.com/theharithsa/placement-management-system/blob/master/Profilers/PProfile/queries.php): `Profilers/PProfile/queries.php`

### Other components

- **Visitor**
- **Student**
- **HOD**
- **Principal**
- **Placement officer**
- **MySQL database**

## Connections

- Visitor → Master homepage: opens
- Visitor → Public drives: views drives
- Student → Student login: signs in (evidence: `Profilers/SProfile/index.php`)
- Student login → Student session gate: includes (evidence: `Profilers/SProfile/index.php`)
- Student login → Student authentication: submits credentials (evidence: `Profilers/SProfile/index.php`)
- Student → Student biodata: updates biodata
- Student → Student preferences: sets preferences
- HOD → HOD login: signs in (evidence: `Profilers/HODProfile/index.php`)
- HOD login → HOD session gate: includes (evidence: `Profilers/HODProfile/index.php`)
- HOD login → HOD authentication: submits credentials (evidence: `Profilers/HODProfile/index.php`)
- HOD → Student verification: verifies profiles
- HOD → HOD notifications: updates messages
- Principal → Principal login: signs in (evidence: `Profilers/PriProfile/index.php`)
- Principal login → Principal session gate: includes (evidence: `Profilers/PriProfile/index.php`)
- Principal login → Principal authentication: submits credentials (evidence: `Profilers/PriProfile/index.php`)
- Principal → Campus queries: queries campus
- Principal → Eligibility review: reviews eligibility
- Placement officer → Placement login: signs in (evidence: `Profilers/PProfile/index.php`)
- Placement login → Placement session gate: includes (evidence: `Profilers/PProfile/index.php`)
- Placement login → Placement authentication: submits credentials (evidence: `Profilers/PProfile/index.php`)
- Placement officer → Drive management: manages drives
- Placement officer → Drive registration: registers students
- Placement officer → Student eligibility: checks eligibility
- Placement officer → Placement queries: queries records
- Student biodata → MySQL database: writes profile
- Student verification → MySQL database: verifies records
- HOD notifications → MySQL database: updates messages
- Drive management → MySQL database: stores drives
- Drive registration → MySQL database: stores registrations
- Campus queries → MySQL database: queries records
- Placement queries → MySQL database: queries records