# 24f2007293/placement_portal architecture

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

- Interactive diagram: https://gitdiagram.com/24f2007293/placement_portal
- Repository: https://github.com/24f2007293/placement_portal

## Overview

This is a Flask placement portal for students, companies, and administrators. Its main workflow is company registration and approval, placement-drive creation and activation, student applications, and company decisions on applicants. The application routes coordinate authentication, profile management, drive discovery, and administration; SQLAlchemy models represent users, profiles, drives, and applications. The excerpts show only selected routes, so unsampled feature links are omitted or marked unverified. The README documents company verification and drive activation.

Main entry points: [`instance/placement.db`](https://github.com/24f2007293/placement_portal/blob/main/instance/placement.db) (Placement Database), [`app.py`](https://github.com/24f2007293/placement_portal/blob/main/app.py) (Flask Routes), [`templates/auth`](https://github.com/24f2007293/placement_portal/tree/main/templates/auth) (Auth Forms), [`templates/student`](https://github.com/24f2007293/placement_portal/tree/main/templates/student) (Student Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Profiles"]
  node_auth["Authentication<br/>[app.py]"]
  node_student_profile["Student Profiles<br/>[app.py]"]
  node_company_profile["Company Profiles<br/>[app.py]"]
  node_auth_views["Auth Forms"]
  node_student_views["Student Views"]
end

subgraph group_placement["Placement Workflow"]
  node_company_views["Company Views"]
  node_drive_management["Drive Management<br/>[app.py]"]
  node_drive_discovery["Drive Discovery"]
  node_applications["Applications<br/>[app.py]"]
  node_applicant_review["Applicant Review"]
end

subgraph group_governance["Portal Administration"]
  node_company_approval["Company Approval<br/>[app.py]"]
  node_drive_moderation["Drive Moderation<br/>[app.py]"]
  node_user_controls["User Restrictions<br/>[app.py]"]
  node_admin_views["Admin Views"]
end

subgraph group_runtime["Runtime and Data"]
  node_route_runtime["Flask Routes<br/>[app.py]"]
  node_auth_extensions["Login Extensions<br/>[extensions.py]"]
  node_domain_models["Domain Models<br/>[models.py]"]
  node_placement_db[("Placement Database<br/>[placement.db]")]
end

node_student(("Student"))
node_company(("Company"))
node_admin(("Administrator"))

node_student -->|"registers"| node_auth
node_company -->|"registers"| node_auth
node_auth -->|"renders forms"| node_auth_views
node_route_runtime -->|"uses login"| node_auth_extensions
node_route_runtime -->|"imports models"| node_domain_models
node_route_runtime -->|"queries and commits"| node_placement_db
node_student -.->|"manages profile"| node_student_profile
node_company -.->|"manages profile"| node_company_profile
node_student_profile -.->|"renders pages"| node_student_views
node_company_profile -.->|"renders pages"| node_company_views
node_company -->|"creates drives"| node_drive_management
node_admin -->|"approves companies"| node_company_approval
node_company_approval -->|"updates approval"| node_placement_db
node_admin -->|"verifies drives"| node_drive_moderation
node_drive_moderation -->|"updates drive status"| node_placement_db
node_student -.->|"browses drives"| node_drive_discovery
node_student -->|"applies"| node_applications
node_applications -->|"stores application"| node_placement_db
node_company -.->|"reviews applicants"| node_applicant_review
node_company -->|"updates decisions"| node_applications
node_admin -->|"restricts users"| node_user_controls
node_admin -.->|"uses dashboards"| node_admin_views

click node_auth "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_student_profile "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_company_profile "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_auth_views "https://github.com/24f2007293/placement_portal/tree/main/templates/auth"
click node_student_views "https://github.com/24f2007293/placement_portal/tree/main/templates/student"
click node_company_views "https://github.com/24f2007293/placement_portal/tree/main/templates/company"
click node_drive_management "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_drive_discovery "https://github.com/24f2007293/placement_portal/tree/main/templates/student"
click node_applications "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_applicant_review "https://github.com/24f2007293/placement_portal/tree/main/templates/company"
click node_company_approval "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_drive_moderation "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_user_controls "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_admin_views "https://github.com/24f2007293/placement_portal/tree/main/templates/admin"
click node_route_runtime "https://github.com/24f2007293/placement_portal/blob/main/app.py"
click node_auth_extensions "https://github.com/24f2007293/placement_portal/blob/main/extensions.py"
click node_domain_models "https://github.com/24f2007293/placement_portal/blob/main/models.py"
click node_placement_db "https://github.com/24f2007293/placement_portal/blob/main/instance/placement.db"

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_student_profile,node_company_profile,node_auth_views,node_student_views toneBlue
class node_company_views,node_drive_management,node_drive_discovery,node_applications,node_applicant_review toneAmber
class node_company_approval,node_drive_moderation,node_user_controls,node_admin_views toneMint
class node_route_runtime,node_auth_extensions,node_domain_models,node_placement_db toneRose
class node_student,node_company,node_admin toneIndigo
```

## Components

### Identity and Profiles

- [Authentication](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Student Profiles](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Company Profiles](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Auth Forms](https://github.com/24f2007293/placement_portal/tree/main/templates/auth): `templates/auth`
- [Student Views](https://github.com/24f2007293/placement_portal/tree/main/templates/student): `templates/student`

### Placement Workflow

- [Company Views](https://github.com/24f2007293/placement_portal/tree/main/templates/company): `templates/company`
- [Drive Management](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Drive Discovery](https://github.com/24f2007293/placement_portal/tree/main/templates/student): `templates/student`
- [Applications](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Applicant Review](https://github.com/24f2007293/placement_portal/tree/main/templates/company): `templates/company`

### Portal Administration

- [Company Approval](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Drive Moderation](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [User Restrictions](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Admin Views](https://github.com/24f2007293/placement_portal/tree/main/templates/admin): `templates/admin`

### Runtime and Data

- [Flask Routes](https://github.com/24f2007293/placement_portal/blob/main/app.py): `app.py`
- [Login Extensions](https://github.com/24f2007293/placement_portal/blob/main/extensions.py): `extensions.py`
- [Domain Models](https://github.com/24f2007293/placement_portal/blob/main/models.py): `models.py`
- [Placement Database](https://github.com/24f2007293/placement_portal/blob/main/instance/placement.db): `instance/placement.db`

### Other components

- **Student**
- **Company**
- **Administrator**

## Connections

- Student → Authentication: registers (evidence: `app.py`)
- Company → Authentication: registers (evidence: `app.py`)
- Authentication → Auth Forms: renders forms (evidence: `app.py`)
- Flask Routes → Login Extensions: uses login (evidence: `app.py`)
- Flask Routes → Domain Models: imports models (evidence: `app.py`)
- Flask Routes → Placement Database: queries and commits (evidence: `app.py`)
- Student → Student Profiles: manages profile
- Company → Company Profiles: manages profile
- Student Profiles → Student Views: renders pages
- Company Profiles → Company Views: renders pages
- Company → Drive Management: creates drives (evidence: `app.py`)
- Administrator → Company Approval: approves companies (evidence: `app.py`)
- Company Approval → Placement Database: updates approval (evidence: `app.py`)
- Administrator → Drive Moderation: verifies drives (evidence: `Readme.md`)
- Drive Moderation → Placement Database: updates drive status (evidence: `app.py`)
- Student → Drive Discovery: browses drives
- Student → Applications: applies (evidence: `app.py`)
- Applications → Placement Database: stores application (evidence: `app.py`)
- Company → Applicant Review: reviews applicants
- Company → Applications: updates decisions (evidence: `app.py`)
- Administrator → User Restrictions: restricts users (evidence: `app.py`)
- Administrator → Admin Views: uses dashboards
