Skip to content

Kannu20/career-compass

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

No releases published

Packages

 
 
 

Contributors

Languages