# 23f2000448/placement-portal-application architecture

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

- Interactive diagram: https://gitdiagram.com/23f2000448/placement-portal-application
- Repository: https://github.com/23f2000448/placement-portal-application

## Overview

Placement Portal is a campus recruitment platform for students, companies, and placement administrators. Students register, maintain profiles, discover eligible approved drives, apply, track application and interview outcomes, and view placements; companies manage drives and candidates, while administrators approve companies and moderate drives. The Vue portals use a Flask REST backend, whose services implement recruitment rules over relational models. Celery jobs provide reminders, reports, and exports. The README documents these capabilities; several frontend-to-API links and unsampled task wiring are shown as unverified rather than asserted.

Main entry points: [`frontend/src/services/api.js`](https://github.com/23f2000448/placement-portal-application/blob/main/frontend/src/services/api.js) (API client), [`backend/app/models`](https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/models) (Recruitment records), [`backend/app/routes/student.py`](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/student.py) (Student routes), [`backend/app/routes/company.py`](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/company.py) (Company routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portals["User portals"]
  node_student["Student portal"]
  node_company["Company portal"]
  node_admin["Admin portal"]
  node_authui["Sign-in and registration"]
  node_authstate["Auth state and routing<br/>[auth.js]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_api["Backend API"]
  node_authroutes["Authentication routes<br/>[auth.py]"]
  node_studentroutes["Student routes<br/>[student.py]"]
  node_drivesroutes["Drive routes<br/>[drives.py]"]
  node_applicationroutes["Application routes<br/>[applications.py]"]
  node_companyroutes["Company routes<br/>[company.py]"]
  node_adminroutes["Admin routes<br/>[admin.py]"]
  node_schemas["Validation and serialization"]
  node_access["Role authorization<br/>[decorators.py]"]
  node_responses["API responses<br/>[responses.py]"]
end

subgraph group_domain["Recruitment domain"]
  node_student_service["Student workflows<br/>[student_service.py]"]
  node_company_service["Company workflows<br/>[company_service.py]"]
  node_admin_service["Admin management<br/>[admin_service.py]"]
  node_models["Recruitment records"]
end

subgraph group_async["Background work"]
  node_celery["Celery task setup<br/>[celery_app.py]"]
  node_reminders["Interview reminders<br/>[reminders.py]"]
  node_reports["Reports and exports"]
end

node_student_actor(("Student"))
node_company_actor(("Company"))
node_admin_actor(("Administrator"))
node_db[("SQL database")]
node_redis[("Redis cache")]

node_student_actor -->|"uses"| node_student
node_company_actor -->|"uses"| node_company
node_admin_actor -->|"uses"| node_admin
node_student -.->|"requests"| node_apiclient
node_company -.->|"requests"| node_apiclient
node_admin -.->|"requests"| node_apiclient
node_authui -.->|"updates session"| node_authstate
node_authstate -.->|"authenticates"| node_authroutes
node_apiclient -.->|"calls REST"| node_studentroutes
node_apiclient -.->|"calls REST"| node_companyroutes
node_apiclient -.->|"calls REST"| node_adminroutes
node_studentroutes -->|"checks roles"| node_access
node_companyroutes -->|"checks roles"| node_access
node_adminroutes -->|"checks roles"| node_access
node_studentroutes -->|"delegates to"| node_student_service
node_drivesroutes -->|"gets approved drives"| node_student_service
node_companyroutes -->|"delegates to"| node_company_service
node_adminroutes -->|"delegates to"| node_admin_service
node_studentroutes -->|"serializes inputs"| node_schemas
node_companyroutes -->|"serializes inputs"| node_schemas
node_adminroutes -->|"serializes results"| node_schemas
node_applicationroutes -->|"serializes application"| node_schemas
node_applicationroutes -->|"loads application"| node_models
node_applicationroutes -->|"returns response"| node_responses
node_student_service -->|"reads and writes"| node_models
node_company_service -->|"reads and writes"| node_models
node_admin_service -->|"reads and writes"| node_models
node_models -->|"persists records"| node_db
node_student_service -->|"caches drives"| node_redis
node_company_service -->|"caches company drives"| node_redis
node_admin_service -->|"caches admin queries"| node_redis
node_celery -.->|"runs jobs"| node_reminders
node_celery -.->|"runs jobs"| node_reports
node_reminders -->|"reads schedules"| node_models
node_reports -.->|"generates reports"| node_db

click node_student "https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/student"
click node_company "https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/company"
click node_admin "https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/admin"
click node_authui "https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/auth"
click node_authstate "https://github.com/23f2000448/placement-portal-application/blob/main/frontend/src/stores/auth.js"
click node_apiclient "https://github.com/23f2000448/placement-portal-application/blob/main/frontend/src/services/api.js"
click node_authroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/auth.py"
click node_studentroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/student.py"
click node_drivesroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/drives.py"
click node_applicationroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/applications.py"
click node_companyroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/company.py"
click node_adminroutes "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/admin.py"
click node_schemas "https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/schemas"
click node_access "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/utils/decorators.py"
click node_responses "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/utils/responses.py"
click node_student_service "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/student_service.py"
click node_company_service "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/company_service.py"
click node_admin_service "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/admin_service.py"
click node_models "https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/models"
click node_celery "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/tasks/celery_app.py"
click node_reminders "https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/tasks/reminders.py"
click node_reports "https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/tasks"

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_student,node_company,node_admin,node_authui,node_authstate,node_apiclient toneBlue
class node_authroutes,node_studentroutes,node_drivesroutes,node_applicationroutes,node_companyroutes,node_adminroutes,node_schemas,node_access,node_responses,node_db,node_redis toneAmber
class node_student_service,node_company_service,node_admin_service,node_models toneMint
class node_celery,node_reminders,node_reports toneRose
class node_student_actor,node_company_actor,node_admin_actor toneIndigo
```

## Components

### User portals

- [Student portal](https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/student): `frontend/src/views/student`
- [Company portal](https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/company): `frontend/src/views/company`
- [Admin portal](https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/admin): `frontend/src/views/admin`
- [Sign-in and registration](https://github.com/23f2000448/placement-portal-application/tree/main/frontend/src/views/auth): `frontend/src/views/auth`
- [Auth state and routing](https://github.com/23f2000448/placement-portal-application/blob/main/frontend/src/stores/auth.js): `frontend/src/stores/auth.js`
- [API client](https://github.com/23f2000448/placement-portal-application/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Backend API

- [Authentication routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Student routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/student.py): `backend/app/routes/student.py`
- [Drive routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/drives.py): `backend/app/routes/drives.py`
- [Application routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/applications.py): `backend/app/routes/applications.py`
- [Company routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/company.py): `backend/app/routes/company.py`
- [Admin routes](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/routes/admin.py): `backend/app/routes/admin.py`
- [Validation and serialization](https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/schemas): `backend/app/schemas`
- [Role authorization](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/utils/decorators.py): `backend/app/utils/decorators.py`
- [API responses](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/utils/responses.py): `backend/app/utils/responses.py`

### Recruitment domain

- [Student workflows](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/student_service.py): `backend/app/services/student_service.py`
- [Company workflows](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/company_service.py): `backend/app/services/company_service.py`
- [Admin management](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/services/admin_service.py): `backend/app/services/admin_service.py`
- [Recruitment records](https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/models): `backend/app/models`

### Background work

- [Celery task setup](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/tasks/celery_app.py): `backend/app/tasks/celery_app.py`
- [Interview reminders](https://github.com/23f2000448/placement-portal-application/blob/main/backend/app/tasks/reminders.py): `backend/app/tasks/reminders.py`
- [Reports and exports](https://github.com/23f2000448/placement-portal-application/tree/main/backend/app/tasks): `backend/app/tasks`

### Other components

- **Student**
- **Company**
- **Administrator**
- **SQL database**
- **Redis cache**

## Connections

- Student → Student portal: uses (evidence: `README.md`)
- Company → Company portal: uses (evidence: `README.md`)
- Administrator → Admin portal: uses (evidence: `README.md`)
- Student portal → API client: requests
- Company portal → API client: requests
- Admin portal → API client: requests
- Sign-in and registration → Auth state and routing: updates session
- Auth state and routing → Authentication routes: authenticates
- API client → Student routes: calls REST
- API client → Company routes: calls REST
- API client → Admin routes: calls REST
- Student routes → Role authorization: checks roles (evidence: `backend/app/routes/student.py`)
- Company routes → Role authorization: checks roles (evidence: `backend/app/routes/company.py`)
- Admin routes → Role authorization: checks roles (evidence: `backend/app/routes/admin.py`)
- Student routes → Student workflows: delegates to (evidence: `backend/app/routes/student.py`)
- Drive routes → Student workflows: gets approved drives (evidence: `backend/app/routes/drives.py`)
- Company routes → Company workflows: delegates to (evidence: `backend/app/routes/company.py`)
- Admin routes → Admin management: delegates to (evidence: `backend/app/routes/admin.py`)
- Student routes → Validation and serialization: serializes inputs (evidence: `backend/app/routes/student.py`)
- Company routes → Validation and serialization: serializes inputs (evidence: `backend/app/routes/company.py`)
- Admin routes → Validation and serialization: serializes results (evidence: `backend/app/routes/admin.py`)
- Application routes → Validation and serialization: serializes application (evidence: `backend/app/routes/applications.py`)
- Application routes → Recruitment records: loads application (evidence: `backend/app/routes/applications.py`)
- Application routes → API responses: returns response (evidence: `backend/app/routes/applications.py`)
- Student workflows → Recruitment records: reads and writes (evidence: `backend/app/services/student_service.py`)
- Company workflows → Recruitment records: reads and writes (evidence: `backend/app/services/company_service.py`)
- Admin management → Recruitment records: reads and writes (evidence: `backend/app/services/admin_service.py`)
- Recruitment records → SQL database: persists records (evidence: `README.md`)
- Student workflows → Redis cache: caches drives (evidence: `backend/app/services/student_service.py`)
- Company workflows → Redis cache: caches company drives (evidence: `backend/app/services/company_service.py`)
- Admin management → Redis cache: caches admin queries (evidence: `backend/app/services/admin_service.py`)
- Celery task setup → Interview reminders: runs jobs (evidence: `backend/app/tasks/reminders.py`)
- Celery task setup → Reports and exports: runs jobs (evidence: `backend/app/tasks/reminders.py`)
- Interview reminders → Recruitment records: reads schedules (evidence: `backend/app/tasks/reminders.py`)
- Reports and exports → SQL database: generates reports
