# sharantandra/placement-portal architecture

> Architecture diagram of the GitHub repository sharantandra/placement-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/sharantandra/placement-portal
- Repository: https://github.com/sharantandra/placement-portal

## Overview

Sreyas Campus Placement Portal is a student-and-admin placement management system. Students authenticate, manage profiles and skills, find jobs, check resumes, and apply; admins manage students and jobs and review placement information. The frontend’s JavaScript API helpers call the Flask backend, which persists data through SQLAlchemy. README capabilities such as startup ideas, CSV management, and analytics are included, but their individual implementations were not sampled; the backend is a monolith, so those features share its source path.

Main entry points: [`frontend/js/api.js`](https://github.com/sharantandra/placement-portal/blob/main/frontend/js/api.js) (API helpers), [`backend/app.py`](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py) (Flask application), [`frontend/js/auth.js`](https://github.com/sharantandra/placement-portal/blob/main/frontend/js/auth.js) (Authentication), [`backend/wsgi.py`](https://github.com/sharantandra/placement-portal/blob/main/backend/wsgi.py) (WSGI startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_auth["Authentication<br/>[auth.js]"]
  node_api["API helpers<br/>[api.js]"]
end

subgraph group_backend["Backend"]
  node_flask["Flask application<br/>[app.py]"]
  node_runtime["WSGI startup<br/>[wsgi.py]"]
  node_database[("Application database<br/>[app.py]")]
end

subgraph group_placement["Placement workflows"]
  node_profiles["Student profiles<br/>[app.py]"]
  node_skills["Skills management<br/>[app.py]"]
  node_resume["Resume upload and ATS<br/>[app.py]"]
  node_jobs["Job listings<br/>[app.py]"]
  node_applications["Job applications<br/>[app.py]"]
  node_admin_management["Admin management<br/>[app.py]"]
end

subgraph group_community["Community and reporting"]
  node_startup["Startup ideas<br/>[app.py]"]
  node_analytics["Placement analytics<br/>[app.py]"]
end

node_student(("Student"))
node_admin(("Admin / TPO"))

node_student -->|"signs in"| node_auth
node_auth -->|"authenticates via HTTP"| node_flask
node_api -->|"calls API"| node_flask
node_runtime -->|"loads app"| node_flask
node_flask -->|"reads and writes"| node_database
node_api -->|"requests profiles"| node_profiles
node_api -->|"manages skills"| node_skills
node_api -->|"checks ATS"| node_resume
node_api -->|"fetches listings"| node_jobs
node_api -->|"submits applications"| node_applications
node_admin -->|"manages placement"| node_admin_management
node_student -->|"pitches ideas"| node_startup
node_admin -->|"reviews reports"| node_analytics

click node_auth "https://github.com/sharantandra/placement-portal/blob/main/frontend/js/auth.js"
click node_api "https://github.com/sharantandra/placement-portal/blob/main/frontend/js/api.js"
click node_flask "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_runtime "https://github.com/sharantandra/placement-portal/blob/main/backend/wsgi.py"
click node_database "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_profiles "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_skills "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_resume "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_jobs "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_applications "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_admin_management "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_startup "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"
click node_analytics "https://github.com/sharantandra/placement-portal/blob/main/backend/app.py"

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_auth,node_api toneBlue
class node_flask,node_runtime,node_database toneAmber
class node_profiles,node_skills,node_resume,node_jobs,node_applications,node_admin_management toneMint
class node_startup,node_analytics toneRose
class node_student,node_admin toneIndigo
```

## Components

### Frontend

- [Authentication](https://github.com/sharantandra/placement-portal/blob/main/frontend/js/auth.js): `frontend/js/auth.js`
- [API helpers](https://github.com/sharantandra/placement-portal/blob/main/frontend/js/api.js): `frontend/js/api.js`

### Backend

- [Flask application](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [WSGI startup](https://github.com/sharantandra/placement-portal/blob/main/backend/wsgi.py): `backend/wsgi.py`
- [Application database](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`

### Placement workflows

- [Student profiles](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Skills management](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Resume upload and ATS](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Job listings](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Job applications](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Admin management](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`

### Community and reporting

- [Startup ideas](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`
- [Placement analytics](https://github.com/sharantandra/placement-portal/blob/main/backend/app.py): `backend/app.py`

### Other components

- **Student**
- **Admin / TPO**

## Connections

- Student → Authentication: signs in (evidence: `frontend/js/auth.js`)
- Authentication → Flask application: authenticates via HTTP (evidence: `frontend/js/auth.js`)
- API helpers → Flask application: calls API (evidence: `frontend/js/api.js`)
- WSGI startup → Flask application: loads app (evidence: `backend/wsgi.py`)
- Flask application → Application database: reads and writes (evidence: `backend/app.py`)
- API helpers → Student profiles: requests profiles (evidence: `frontend/js/api.js`)
- API helpers → Skills management: manages skills (evidence: `frontend/js/api.js`)
- API helpers → Resume upload and ATS: checks ATS (evidence: `frontend/js/api.js`)
- API helpers → Job listings: fetches listings (evidence: `frontend/js/api.js`)
- API helpers → Job applications: submits applications (evidence: `frontend/js/api.js`)
- Admin / TPO → Admin management: manages placement (evidence: `README.md`)
- Student → Startup ideas: pitches ideas (evidence: `README.md`)
- Admin / TPO → Placement analytics: reviews reports (evidence: `README.md`)
