# sudobhavik/iips-placement-software architecture

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

- Interactive diagram: https://gitdiagram.com/sudobhavik/iips-placement-software
- Repository: https://github.com/sudobhavik/iips-placement-software

## Overview

PlaceIQ is a placement-management and employability-analytics product, but the checked-in implementation is still an MVP foundation: the visible UI checks API/database health, and the backend defines configuration, database access, and core placement-related models. The README describes a larger intended workflow—student registration, company drives, interviews, offers, and statistics—but the corresponding routes and business services are not implemented in the sampled source. Those documented stages are shown separately from the running health-check path; unsampled details and their connections are left unspecified.

Main entry points: [`backend/app/services`](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/services) (Business rules), [`backend/app/main.py`](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/main.py) (FastAPI app), [`backend/app/core/db.py`](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/core/db.py) (DB sessions), [`frontend/src/App.tsx`](https://github.com/sudobhavik/iips-placement-software/blob/main/frontend/src/App.tsx) (React app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client"]
  node_ui["React app<br/>[App.tsx]"]
end

subgraph group_api["API foundation"]
  node_api_entry["FastAPI app<br/>[main.py]"]
  node_settings["Configuration<br/>[config.py]"]
  node_db_session["DB sessions<br/>[db.py]"]
end

subgraph group_data["Placement data"]
  node_postgres[("PostgreSQL")]
  node_student["Student profiles<br/>[student.py]"]
  node_account["Accounts and tokens<br/>[user.py]"]
  node_master["Academic reference data<br/>[master.py]"]
  node_imports["Bulk import tracking<br/>[import_job.py]"]
  node_files["File records<br/>[file.py]"]
  node_audit["Audit records<br/>[audit.py]"]
  node_model_conventions["Model conventions<br/>[base.py]"]
  node_domain_enums["Domain values<br/>[enums.py]"]
end

subgraph group_product["Placement workflow"]
  node_services["Business rules"]
  node_registration["Student registration"]
  node_drives["Company drives"]
  node_interviews["Interview tracking"]
  node_offers["Offers"]
  node_statistics["Placement statistics"]
  node_analytics["Employability analytics"]
end

node_user(("Placement user"))

node_user -->|"uses"| node_ui
node_ui -->|"checks health"| node_api_entry
node_api_entry -->|"gets session"| node_db_session
node_api_entry -->|"configures CORS"| node_settings
node_db_session -->|"reads URL"| node_settings
node_db_session -->|"connects"| node_postgres
node_api_entry -->|"checks connection"| node_postgres
node_registration -.->|"calls rules"| node_services
node_services -.->|"uses models"| node_student
node_drives -.->|"applies policy"| node_services
node_interviews -.->|"tracks status"| node_services
node_offers -.->|"applies policy"| node_services
node_statistics -.->|"summarizes placements"| node_services
node_analytics -.->|"extends analytics"| node_services

click node_ui "https://github.com/sudobhavik/iips-placement-software/blob/main/frontend/src/App.tsx"
click node_api_entry "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/main.py"
click node_settings "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/core/config.py"
click node_db_session "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/core/db.py"
click node_student "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/student.py"
click node_account "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/user.py"
click node_master "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/master.py"
click node_imports "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/import_job.py"
click node_files "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/file.py"
click node_audit "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/audit.py"
click node_model_conventions "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/base.py"
click node_domain_enums "https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/enums.py"
click node_services "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/services"
click node_registration "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1"
click node_drives "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1"
click node_interviews "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1"
click node_offers "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1"
click node_statistics "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1"
click node_analytics "https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/services"

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_ui,node_user toneBlue
class node_api_entry,node_settings,node_db_session toneAmber
class node_postgres,node_student,node_account,node_master,node_imports,node_files,node_audit,node_model_conventions,node_domain_enums toneMint
class node_services,node_registration,node_drives,node_interviews,node_offers,node_statistics,node_analytics toneRose
```

## Components

### Client

- [React app](https://github.com/sudobhavik/iips-placement-software/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### API foundation

- [FastAPI app](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/main.py): `backend/app/main.py`
- [Configuration](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/core/config.py): `backend/app/core/config.py`
- [DB sessions](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/core/db.py): `backend/app/core/db.py`

### Placement data

- **PostgreSQL**
- [Student profiles](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/student.py): `backend/app/models/student.py`
- [Accounts and tokens](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Academic reference data](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/master.py): `backend/app/models/master.py`
- [Bulk import tracking](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/import_job.py): `backend/app/models/import_job.py`
- [File records](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/file.py): `backend/app/models/file.py`
- [Audit records](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/audit.py): `backend/app/models/audit.py`
- [Model conventions](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/base.py): `backend/app/models/base.py`
- [Domain values](https://github.com/sudobhavik/iips-placement-software/blob/main/backend/app/models/enums.py): `backend/app/models/enums.py`

### Placement workflow

- [Business rules](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/services): `backend/app/services`
- [Student registration](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Company drives](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Interview tracking](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Offers](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Placement statistics](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/api/v1): `backend/app/api/v1`
- [Employability analytics](https://github.com/sudobhavik/iips-placement-software/tree/main/backend/app/services): `backend/app/services`

### Other components

- **Placement user**

## Connections

- Placement user → React app: uses (evidence: `README.md`)
- React app → FastAPI app: checks health (evidence: `frontend/src/App.tsx`)
- FastAPI app → DB sessions: gets session (evidence: `backend/app/main.py`)
- FastAPI app → Configuration: configures CORS (evidence: `backend/app/main.py`)
- DB sessions → Configuration: reads URL (evidence: `backend/app/core/db.py`)
- DB sessions → PostgreSQL: connects (evidence: `backend/app/core/db.py`)
- FastAPI app → PostgreSQL: checks connection (evidence: `backend/app/main.py`)
- Student registration → Business rules: calls rules (evidence: `README.md`)
- Business rules → Student profiles: uses models (evidence: `README.md`)
- Company drives → Business rules: applies policy (evidence: `README.md`)
- Interview tracking → Business rules: tracks status (evidence: `README.md`)
- Offers → Business rules: applies policy (evidence: `README.md`)
- Placement statistics → Business rules: summarizes placements (evidence: `README.md`)
- Employability analytics → Business rules: extends analytics (evidence: `README.md`)
