Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


🧭 "Measure. Understand. Improve. Get Placed."

A full-stack career intelligence platform that helps students analyze skills, track placement readiness, and grow systematically using AI-driven insights.



📌 Table of Contents

Click to expand

🌟 Vision


AI-Powered Insights
Smart career recommendations tailored to each student

Data-Driven Analytics
Visual skill breakdowns and readiness scoring

Placement Focused
Structured guidance toward real placement success

CareerCompass is built to help students measure, understand, and improve their placement readiness using intelligent analytics and structured career guidance — all in one platform.


✨ Key Features

Feature Description
📊 Career Readiness Score Composite score based on DSA, CS fundamentals, projects & resume
📈 Skill Visualization Dashboard Radar charts, bar charts, and performance comparison graphs
🧠 Intelligent Gap Analysis Highlights exactly what to study and which skills need improvement
🎯 Personalized Improvement Path Step-by-step guidance tailored to each student's profile
🧪 Technical Test System In-platform tests to assess and track skill growth
👥 Multi-Role Platform Separate dashboards for Students, Mentors, TPO & Admin
🔐 Secure Auth System Firebase ID token + JWT with role-based access control

🧩 System Architecture

flowchart TD
    A["🖥️ Client — Next.js Frontend"] --> B["⚙️ API Layer — Express.js Backend"]
    A --> C["🔑 Authentication — Firebase"]
    B --> D["🧠 Business Logic Layer"]
    D --> E["🗄️ MongoDB Database"]
    C --> B

    style A fill:#0f172a,color:#38bdf8,stroke:#38bdf8
    style B fill:#0f172a,color:#a78bfa,stroke:#a78bfa
    style C fill:#0f172a,color:#fb923c,stroke:#fb923c
    style D fill:#0f172a,color:#34d399,stroke:#34d399
    style E fill:#0f172a,color:#f472b6,stroke:#f472b6
Loading

🧠 Skill Evaluation Model

CareerCompass calculates a holistic Placement Readiness Score using four core pillars:

┌─────────────────────────────────────────────────────────────┐
│              🎯  PLACEMENT READINESS SCORE                  │
├──────────────────┬──────────────────┬───────────────────────┤
│  📐 DSA Skills   │  🖥️ Core CS      │  🗂️ Projects          │
│  Algorithms &    │  OS, DBMS,       │  Complexity,          │
│  Data Structures │  Networks, OOP   │  Stack, Impact        │
├──────────────────┴──────────────────┴───────────────────────┤
│                    📄 Resume Quality                        │
│           Formatting · Keywords · Completeness              │
└─────────────────────────────────────────────────────────────┘

Each component contributes a weighted score toward the overall readiness percentage shown on the dashboard.


🛠 Tech Stack

🖥️ Frontend

Next.js React TypeScript TailwindCSS Framer Motion Chart.js

⚙️ Backend

Node.js Express.js TypeScript

🗄️ Database & Auth

MongoDB Mongoose Firebase JWT

🔧 Dev Tools

Git GitHub Postman ESLint


📊 Platform Modules

🎓 Student Dashboard
  • 📊 Real-time skill analytics with visual charts
  • 🎯 Placement readiness score with breakdown
  • 📝 Personalized improvement suggestions
  • 📈 Performance tracking over time
🧪 Test System
  • ✅ Attempt technical assessments in-platform
  • 📉 Post-test performance analysis
  • 📊 Skill growth tracking across attempts
  • 🔁 Retry tests to monitor improvement
👨‍🏫 Mentor Dashboard
  • 👀 Review assigned student progress
  • 🎯 Identify individual skill gaps
  • 💬 Provide structured guidance and feedback
  • 📊 Cohort-level analytics
🛡️ Admin Panel
  • 👥 User management (create, suspend, delete)
  • ✅ Approve Mentor / TPO role requests
  • 🔧 Control platform-wide operations
  • 📊 Platform usage analytics

👨‍💼 Multi-Role System

╔══════════════╦═══════════════════════════════════════════════════════╗
║    Role      ║  Capabilities                                         ║
╠══════════════╬═══════════════════════════════════════════════════════╣
║ 🎓 Student   ║  Track skills · Attempt tests · View insights        ║
║ 👨‍🏫 Mentor   ║  Guide students · Analyze performance                ║
║ 🏢 TPO       ║  Monitor placement readiness · Batch analytics       ║
║ 🛡️ Admin     ║  Manage users · Approve roles · Platform control     ║
╚══════════════╩═══════════════════════════════════════════════════════╝

🔐 Security Architecture

🔒 Security Layers
├── 🔑 Firebase ID Token Verification    (Identity Layer)
├── 🪙 JWT Session Tokens               (Session Layer)
├── 🛡️ Role-Based Access Control (RBAC) (Authorization Layer)
└── 🚧 Protected API Routes             (Route Guard Layer)

📂 Project Structure

career-compass/
│
├── 📁 client/                   # Next.js Frontend
│   ├── 📁 app/                  # App router pages
│   ├── 📁 components/           # Reusable UI components
│   ├── 📁 hooks/                # Custom React hooks
│   └── 📁 lib/                  # Utilities & helpers
│
└── 📁 server/                   # Express.js Backend
    ├── 📁 controllers/          # Route handler logic
    ├── 📁 models/               # Mongoose data models
    ├── 📁 routes/               # API route definitions
    ├── 📁 middleware/           # Auth & validation middleware
    └── 📁 config/               # Environment configuration

⚙️ Installation

Prerequisites

  • Node.js v18+
  • MongoDB (local or Atlas)
  • Firebase project configured

1️⃣ Clone the Repository

git clone https://github.com/yourusername/career-compass.git
cd career-compass

2️⃣ Install Dependencies

# Frontend
cd client
npm install

# Backend
cd ../server
npm install

3️⃣ Configure Environment Variables

# server/.env
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
FIREBASE_PROJECT_ID=your_firebase_project_id

# client/.env.local
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_API_URL=http://localhost:5000

4️⃣ Run the Application

# Start Backend (from /server)
npm run dev

# Start Frontend (from /client)
npm run dev

Open http://localhost:3000 in your browser 🚀


🌍 Deployment

Layer Platform Status
🖥️ Frontend Vercel Live
⚙️ Backend Render Live
🗄️ Database MongoDB Atlas Live

🚀 Future Enhancements

🔮 Coming Soon
│
├── 🤖 AI-Powered Career Path Recommendations
├── 📄 Resume AI Analysis & Feedback Engine
├── 💻 Integrated Coding Practice Module
├── 🎤 AI Interview Simulation
└── 📚 Personalized Interview Preparation Roadmaps

👨‍💻 Author

Kanishak

B.Tech Computer Science (AI)

GitHub LinkedIn Portfolio

Full Stack Developer · AI Enthusiast · Building tools that help students succeed


⭐ Support the Project

If CareerCompass helped you or you found it interesting:

Star Fork Share


💡 Project Mission

CareerCompass aims to become the most comprehensive career intelligence system — helping students prepare smarter, improve faster, and succeed in technical careers.

Made with ❤️ by Kanishak

About

Career Compass is an AI-powered career guidance platform that helps users explore career paths, analyze skills, and receive personalized recommendations for their professional growth.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages