How sudobhavik/iips-placement-software works
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: services Business rules · main.py FastAPI app · db.py DB sessions · App.tsx React app
Components 21
Client
- React app
frontend/src/App.tsx
API foundation
- FastAPI app
backend/app/main.py - Configuration
backend/app/core/config.py - DB sessions
backend/app/core/db.py
Placement data
- PostgreSQL
- Student profiles
backend/app/models/student.py - Accounts and tokens
backend/app/models/user.py - Academic reference data
backend/app/models/master.py - Bulk import tracking
backend/app/models/import_job.py - File records
backend/app/models/file.py - Audit records
backend/app/models/audit.py - Model conventions
backend/app/models/base.py - Domain values
backend/app/models/enums.py
Placement workflow
- Business rules
backend/app/services - Student registration
backend/app/api/v1 - Company drives
backend/app/api/v1 - Interview tracking
backend/app/api/v1 - Offers
backend/app/api/v1 - Placement statistics
backend/app/api/v1 - Employability analytics
backend/app/services
Other components
- Placement user
Connections 14
- Placement user → React app: uses
README.md - React app → FastAPI app: checks health
frontend/src/App.tsx - FastAPI app → DB sessions: gets session
backend/app/main.py - FastAPI app → Configuration: configures CORS
backend/app/main.py - DB sessions → Configuration: reads URL
backend/app/core/db.py - DB sessions → PostgreSQL: connects
backend/app/core/db.py - FastAPI app → PostgreSQL: checks connection
backend/app/main.py - Student registration → Business rules: calls rules
README.md - Business rules → Student profiles: uses models
README.md - Company drives → Business rules: applies policy
README.md - Interview tracking → Business rules: tracks status
README.md - Offers → Business rules: applies policy
README.md - Placement statistics → Business rules: summarizes placements
README.md - Employability analytics → Business rules: extends analytics
README.md