NexIntern: Smart AI Micro-Internship Platform

NexIntern connects university students with short, paid micro-internships posted by companies. Students build a profile and get tasks ranked by how well they fit; companies post tasks, review ranked applicants, interview and evaluate them; mentors guide students through the work. Every AI score comes with written reasons.

• Live: https://fyp-two-green.vercel.app
• Case study: https://osama-s-porfolio-beige.vercel.app/projects/nexintern

Final-year project for the BS in Software Engineering at SZABIST Islamabad, designed and built by Osama Khattak.

Architecture

Three services: a Next.js front end, an Express API that owns the data and business rules, and a Python FastAPI service for the AI scoring.

┌──────────────────┐      ┌──────────────────────┐      ┌─────────────┐
│ Next.js frontend │ ───▶ │ Express + Node.js API│ ───▶ │  MySQL 8    │
│  (port 3000)     │      │  (port 5000)         │      │ (Sequelize) │
└──────────────────┘      └──────────┬───────────┘      └─────────────┘
                                     │
                                     ▼
                          ┌──────────────────────┐
                          │ FastAPI AI service   │
                          │  (port 8000)         │
                          └──────────────────────┘

The API calls the AI service for matching, progress risk, evaluation, feedback drafting and performance insights. If the AI service is unreachable, the API falls back to its own copy of the same rules, so the platform keeps working.

Database history: the project started on MongoDB with Mongoose. In May 2026, at my supervisor's request, I moved it to MySQL with Sequelize, splitting nested data (student skills, education, task attachments and so on) into their own tables.

Tech stack

Layer	Tools
Frontend	Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS, Radix UI, Formik + Yup, Axios
Backend	Node.js, Express 4, Sequelize 6 on MySQL 8, JWT, Passport (Google OAuth), bcrypt, Multer, Nodemailer or Brevo for email
Security	Helmet, CORS, express-rate-limit, express-validator, xss-clean
AI service	Python 3.11, FastAPI, Pydantic, scikit-learn (TF-IDF), optional sentence-transformers embeddings
Payments	Stripe Checkout over Stripe's REST API, with signed webhooks and a sandbox provider for testing
Testing	Jest + Supertest (backend), pytest (AI service)
Deployment	Vercel (frontend), Render (API), managed MySQL over TLS, Docker and docker-compose for local runs

Features

Accounts and roles

• Four roles with their own dashboards: student, company, mentor and admin
• Registration with email verification by one-time code, password reset and Google sign-in
• JWT authentication with role-based route protection on both the API and the frontend

Students

• Profile with skills, education, experience, projects and certificates
• Task recommendations ranked by match score, applications and interview tracking
• Internship progress with milestones, time logs and submissions; mentorship; feedback, analytics and payouts

Companies

• Task posting with required skills and an evaluation rubric
• Applicants ranked by match score, interviews, mentor assignment and progress monitoring
• Analytics and payments

Mentors and admins

• Mentors review assigned students' progress and give feedback
• Admins verify mentors and oversee platform analytics and payments

Evaluation and trust

• Rubric-based evaluations, finalized with reviewer sign-off and checkable by anyone at /verify/<code>
• Feedback assistant that drafts balanced feedback and flags personal or insulting language before it is saved

AI service

Every engine is deterministic: the same input always gives the same output, and every score comes with plain-language reasons. Nothing is a black box, so each number can be explained in a viva or to a user.

Endpoint	What it does
POST /match	0-100 match score between a student and a task
POST /rank-candidates	Ranks a task's applicants by match score
POST /rank-mentors	Suggests mentors for a student
POST /progress-insight	Performance indicators and early delay warnings for an internship
POST /evaluate-internship	Scores each rubric criterion with a rationale and evidence
POST /feedback-assist	Drafts feedback and reviews tone
POST /performance-insights	Performance index, score trend and projection
GET /health	Service status and whether the embedding model is loaded

The match score is a weighted sum: skill match 55%, experience fit 15%, level fit 10%, interest overlap 10% and text similarity 10% (TF-IDF, or sentence embeddings when AI_USE_EMBEDDINGS=true). See docs/module-6-matching-explained.md.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗