Internship & Placement Management Platform
Rathinam College of Arts and Science
R-Choice is a full-stack internship and placement management platform that unifies students, faculty approvers, administrators, and company partners into a single, role-aware system. It replaces fragmented spreadsheets, email chains, and manual approval workflows with a streamlined digital pipeline.
From profile building to placement certification β seamlessly managed.
- ποΈ 8-Role Architecture β Student, Tutor, Coordinator, HOD, Dean, PO, Principal, Company
- π 6-Tier Approval Pipeline β Automated routing through institutional hierarchy
- π Real-Time Dashboards β Role-specific analytics with animated visualizations
- π’ Company Portal β Self-service registration, job posting, and applicant review
- π Enterprise Security β Rate limiting, CSRF protection, audit logging, IDOR prevention
- π± Responsive Design β Glassmorphism UI with dark mode support
Internship and placement operations at educational institutions typically suffer from:
| Pain Point | Traditional Approach | R-Choice Solution |
|---|---|---|
| Approval Routing | Manual email chains | Automated 6-tier pipeline |
| Application Tracking | Spreadsheets | Real-time status dashboard |
| Company Management | Ad-hoc coordination | Self-service portal |
| Compliance | Paper trails | Digital audit logs |
| Visibility | Disconnected data | Unified analytics |
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β FRONTEND β
β Next.js 16 App Router β’ React 19 β’ CSS Modules β
β Framer Motion β’ Lucide Icons β’ Recharts β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β SERVER ACTIONS β
β Auth β’ Jobs β’ Approvals β’ Profile β’ Notifications β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β DATA LAYER β
β Drizzle ORM β’ Neon PostgreSQL β’ NextAuth v5 β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β INTEGRATIONS β
β Cloudinary (Media) β’ Nodemailer (SMTP) β’ Playwright β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| Role | Access Level | Dashboard | Key Capabilities |
|---|---|---|---|
| π Student | Self-service | Student | Profile builder, job browser, application tracker, OD requests |
| π Tutor | Tier 1 Approver | Staff | Review & approve student internship requests |
| π Placement Coordinator | Tier 2 Approver | Staff | Coordinate placement activities, manage approvals |
| ποΈ HOD | Tier 3 Approver | Staff | Department-level oversight and approvals |
| β Dean | Admin | Admin | Institutional approvals, analytics, user management |
| π Placement Officer | Admin | Admin | Job approvals, company reviews, placement analytics |
| π Principal | Admin | Admin | Final authority, full system visibility |
| πΌ Company | External | Company | Registration, job posting, applicant management |
Student submits OD Request
β
βΌ
βββββββββββ ββββββββββββββββ βββββββ
β Tutor βββββΆβ Coordinator βββββΆβ HOD β
β Tier 1 β β Tier 2 β βT. 3 β
βββββββββββ ββββββββββββββββ ββββ¬βββ
β
ββββββββββββββββββββββββββββββββββ
βΌ
βββββββββββ βββββββββββββββββββ βββββββββββββ
β Dean βββββΆβPlacement OfficerβββββΆβ Principal β
β Tier 4 β β Tier 5 β β Tier 6 β
βββββββββββ βββββββββββββββββββ βββββββ¬ββββββ
β
βΌ
β
APPROVED
Each tier auto-routes to the next authority. Rejections include feedback and return to the student.
| Layer | Technology | Purpose |
|---|---|---|
| Framework | Next.js 16 (App Router) | Full-stack React framework |
| UI Library | React 19 | Component architecture |
| Language | TypeScript 5 | Type-safe development |
| Styling | CSS Modules | Scoped, maintainable styles |
| Animation | Framer Motion | Micro-interactions & transitions |
| Icons | Lucide React | Consistent iconography |
| Charts | Recharts | Data visualizations |
| Auth | NextAuth v5 (Beta) | Credential-based authentication |
| Database | PostgreSQL (Neon) | Serverless relational database |
| ORM | Drizzle ORM | Type-safe database queries |
| File Storage | Cloudinary | Resume & media uploads |
| Nodemailer | SMTP-based notifications | |
| jsPDF + html2canvas | Certificate & report generation | |
| Testing | Playwright | End-to-end browser tests |
internflow/
βββ src/
β βββ app/
β β βββ (dashboard)/ # Role-based dashboard pages
β β β βββ dashboard/ # Student, Staff, Admin, Company dashboards
β β β βββ jobs/ # Job board, posting, management
β β β βββ applications/ # OD request forms & tracking
β β β βββ approvals/ # Staff approval queues
β β β βββ companies/ # Company directory & reviews
β β β βββ students/ # Student directory
β β β βββ profile/ # Profile builder & vCard
β β β βββ reports/ # Work report management
β β β βββ settings/ # User & system settings
β β β βββ users/ # User management (admin)
β β βββ actions/ # Server actions
β β β βββ auth.ts # Registration, login
β β β βββ jobs.ts # CRUD, approvals
β β β βββ approvals.ts # OD pipeline
β β β βββ profile.ts # Profile management
β β β βββ admin.ts # User & system admin
β β β βββ notifications.ts # Notification system
β β βββ api/ # API routes (uploads)
β β βββ v/[id]/ # Public vCard pages
β βββ components/
β β βββ dashboard/ # Dashboard-specific components
β β β βββ admin/ # Admin widgets (audit log, charts)
β β β βββ jobs/ # Job cards, swipe deck
β β β βββ DashboardShell.tsx # Main layout shell
β β βββ ui/ # Reusable UI primitives
β βββ lib/
β βββ auth.ts # NextAuth configuration
β βββ db/
β β βββ schema.ts # Drizzle schema definitions
β β βββ queries/ # Reusable query functions
β β βββ seed.ts # Dev seed data
β β βββ seed-students.ts # Batch student seeding
β βββ cloudinary.ts # Media upload config
β βββ mail.ts # SMTP helpers
β βββ validation.ts # Input sanitization
βββ e2e/ # Playwright E2E tests
βββ drizzle/ # Database migrations
βββ public/ # Static assets
βββ docs/ # Documentation & screenshots
- Node.js 18+
- PostgreSQL database (we recommend Neon)
git clone https://github.com/iamharishrohith/R-Choice.git
cd R-Choice/internflow
npm installCreate .env.local in the project root:
# Database
DATABASE_URL=postgresql://user:pass@host/dbname
# Auth
AUTH_SECRET=your-random-secret-key
AUTH_TRUST_HOST=true
# Cloudinary (for media uploads)
CLOUDINARY_CLOUD_NAME=your-cloud
CLOUDINARY_API_KEY=your-key
CLOUDINARY_API_SECRET=your-secret
# SMTP (for email notifications)
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=your-email
SMTP_PASS=your-app-password
EMAIL_FROM=noreply@rathinam.edu.in# Push schema to database
npx drizzle-kit push
# Seed test accounts
npx tsx src/lib/db/seed.ts
# Seed student batch (optional)
npx tsx src/lib/db/seed-students.tsnpm run devOpen http://localhost:3000 β you're ready to go! π
All seeded accounts use the shared password:
R-Choice@2025
| Role | Dashboard | |
|---|---|---|
| π Student | student@rathinam.edu.in |
/dashboard/student |
| π Tutor | tutor@rathinam.edu.in |
/dashboard/staff |
| π Coordinator | pc@rathinam.edu.in |
/dashboard/staff |
| ποΈ HOD | hod@rathinam.edu.in |
/dashboard/staff |
| β Dean | dean@rathinam.edu.in |
/dashboard/admin |
| π PO | po@rathinam.edu.in |
/dashboard/admin |
| π Principal | principal@rathinam.edu.in |
/dashboard/admin |
| πΌ Company | hr@techcorp.com |
/dashboard/company |
# Type checking
npx tsc --noEmit
# Linting
npm run lint
# Production build
npm run build
# E2E Tests
npx playwright testnpx playwright test e2e/auth.spec.ts # Authentication flows
npx playwright test e2e/applications.spec.ts # Student application pipeline
npx playwright test e2e/full-pipeline.spec.ts # End-to-end approval chain| Feature | Implementation |
|---|---|
| Authentication | NextAuth v5 with credential provider + role validation |
| Authorization | Server-side role checks on every action |
| Input Sanitization | Custom validation library with XSS prevention |
| CSRF Protection | Built-in NextAuth CSRF tokens |
| Rate Limiting | Login attempt tracking with lockout |
| Audit Logging | All admin actions logged with IP, timestamp, user |
| Security Headers | CSP, HSTS, X-Frame-Options via next.config.ts |
| IDOR Prevention | Ownership verification on all mutations |
- Migrate middleware to
proxyconvention (Next.js 16) - Replace remaining
anytypes with strict interfaces - Add CI/CD pipeline with GitHub Actions
- Implement real-time notifications via WebSocket
- Mobile app build with Capacitor
- Advanced analytics with cohort tracking
- PDF certificate generation for completed internships
- Validate changes with
npx tsc --noEmitandnpm run build - Run relevant Playwright tests for affected workflows
- Follow existing CSS Module and Server Action patterns
- Use Lucide icons β no emoji in UI components
This project is proprietary software built for Rathinam College of Arts and Science.
All rights reserved.
Built with β€οΈ for Rathinam College
Internship & Placement Cell β’ Powered by Symbio
