Here is your updated, complete, and professionally structured project documentation matching all current features, design upgrades, new recruitment modules, and live deployment architecture:

---

# CampusFlow – Smart Campus Management & Placement Portal 🎓

### Overview

CampusFlow is a comprehensive full-stack MERN platform designed to streamline collegiate placement operations and student campus services through a single centralized hub. It connects Students, TPO Placement Administrators, and Hiring Recruiters while offering essential student support features—including Online Assessment practice, drive-specific discussion noticeboards, placement analytics export, grievance redressal, campus lost & found, and event schedules.

Built with a human-crafted warm pastel design system #faf6f0), fluid micro-interactions using Framer Motion, and updated for Academic Year 2026-27, CampusFlow eliminates messy spreadsheets, manual eligibility filtering, and fragmented notices.

---

### Problem Statement

Educational institutions frequently rely on disconnected spreadsheets, manual WhatsApp groups, and paper notices to coordinate campus placements and student affairs. This causes:

- Inefficient eligibility checks and missed deadlines.

- Lack of standardized preparation materials for technical assessments.

- Fragmented communication between students and Placement Cell (TPO) coordinators.

- Disconnected systems for handling hostel/academic grievances and campus lost belongings.

CampusFlow solves this by unifying recruitment pipelines, automated cutoff screening, candidate practice assessments, placement data exports, and campus utility services into one secure, real-time web application.

---

## 🌟 Key Features by Role

### 🎓 1. Student Portal

- Secure Auth & 1-Click Quick Demo Login: Fast authentication with role-based dashboard routing.

- Placement Drive Discovery: Browse active recruitment drives with detailed eligibility criteria (min CGPA, allowed backlogs, eligible branches) and package CTC info.

- Automated Eligibility & 1-Click Apply: Direct eligibility screening preventing ineligible applicants; 1-click apply with uploaded resume dossiers.

- Mock Online Assessment (OA) Practice Portal: Interactive timed quiz portal covering DSA, DBMS/SQL, and Quantitative Aptitude with countdown timer, real-time progress, instant scorecards, and detailed answer explanations.

- Drive-Specific Q&A Noticeboard: Ask questions regarding syllabus, test links, or round timings under each drive, and read pinned coordinator replies.

- Student Profile & Document Vault: Maintain verified branch, semester CGPA, technical skill tags, and official PDF resume uploads.

- Grievance Redressal Cell: File confidential support tickets under Hostel, Academics, Infrastructure, or Placement disputes with live status tracking.

- Campus Events & Lost & Found: RSVP to guest lectures/hackathons and report/claim misplaced campus belongings.

---

### 🛡️ 2. Training & Placement Officer (TPO Admin)

- Placement Drive Management: Create and publish company drives with custom eligibility criteria (CGPA cutoff, allowed branches, deadline timers).

- Candidate Shortlisting & Pipeline Tracking: Monitor applications across Online Assessment, Technical Round 1, Technical Round 2, and Final HR.

- 1-Click Placement Report Export (.CSV): Download structured .csv reports of registered students, branch breakdowns, and placement statuses for institutional accreditation (NAAC/NBA).

- Company & Recruiter Onboarding: Maintain company partnership directories, tier tags, and HR contact points.

- Drive Q&A Moderation: Post official replies and pin urgent announcements on drive noticeboards.

- Campus Services Moderation: Resolve student grievances with administrative action notes, manage event schedules, and verify claimed lost items.

---

### 🏢 3. Recruiter Portal

- Drive Applications Review: Access eligible student profiles and download verified PDF resumes.

- Interview Slot Management: Schedule technical/HR interviews with meeting links, venue tags, and mode selection (Online / In-Person).

- Candidate Status Updates: Mark interview results Selected, Shortlisted, Rejected) with real-time student notifications.

---

## 🛠️ Technology Stack

| Layer | Technologies |

|---|---|

| Frontend | React 19, Vite, Tailwind CSS v4, Framer Motion, React Router v7, Lucide React Icons, Recharts, React Hot Toast, Axios |

| Backend | Node.js, Express.js (v5), RESTful APIs, Multer (PDF File Uploads), Cookie Parser, Bcrypt.js |

| Database | MongoDB Atlas (Cloud Cluster), Mongoose ODM |

| Authentication | JWT (JSON Web Tokens), Role-Based Access Control (RBAC), Protected Routes |

| Design System | Custom Warm Pastel System #faf6f0, Sage Green, Lavender, Sky, Peach), Plus Jakarta Sans, Inter, JetBrains Mono |

| Live Cloud Deployment | Frontend: Vercel (SPA with rewrites) <br> Backend: Render (Node.js Web Service) <br> Database: MongoDB Atlas |

---

## 🚀 Live Cloud Deployment Architecture

- Frontend Application (Vercel): Fast globally distributed CDN deployment handling Single Page Application (SPA) routing with zero client-side 404s.

- Backend REST API (Render): Containerized Express.js microservice with healthcheck probes /api/health), production CORS policies, and auto-restart capabilities.

- Database (MongoDB Atlas): Cloud M0 Cluster with multi-region backup and secure IP whitelist access.

---

## 📈 Learning Outcomes & Engineering Highlights

- Full-Stack MERN Architecture: Modular separation of concerns with REST controllers, Mongoose schemas, and clean frontend service abstractions.

- Role-Based Access Control (RBAC): Secure multi-tier authentication restricting administrative, recruiter, and student privileges at both API route and UI route levels.

- Real-Time Timed Assessment Engine: Interactive state machine managing countdown clocks, automatic question submissions, and server-side scorecard computation.

- Streaming CSV Generation: Building custom buffer pipelines to export placement datasets on the fly without heavy third-party report bloatware.

- Production Cloud Deployment & Debugging: Overcoming cross-origin resource sharing (CORS), Linux case-sensitive file systems, environment variable normalization, and deployment automation.

---

## 🔮 Future Enhancements

- AI-Powered Resume ATS Analyzer: Semantic match scoring between student resume keywords and company job descriptions.

- Email & WhatsApp Notifications: Automated alerts for interview scheduling and round clearance.

- Real-Time Chat & Discussion Channels: WebSocket-enabled instant messaging between candidates and student placement coordinators.

- Interview Calendar Integration: Syncing drive rounds directly to Google Calendar / Outlook.

- Mobile Application: Native mobile companion app built with React Native.