CareerSathi - Your Trusted AI Career Advisor

A personalized AI-powered career and skills advisor for Indian students, designed to provide structured career guidance, skill gap analysis, and step-by-step roadmaps. Built with Next.js 14, TypeScript, Tailwind CSS, Prisma, and Google Cloud AI.

---

🚀 Features

🚀 CareerSathi – Key Features

• 🤖 AI-Powered Career Recommendations
  Suggests 2–3 personalized career paths across tech & non-tech fields (doctor, IAS, engineer, gamer, singer, entrepreneur, etc.)
  based on skills, interests, motivation, and time availability.

• 🎯 Career Roadmaps
  Adaptive, step-by-step roadmap updated every 4 months with latest industry trends (e.g., GenAI, creator economy).

• 📊 Skill Gap Analysis
  Compares user’s current profile with target career, highlights gaps, and suggests learning resources.

• 📝 Multi-Stage Assessment
  Interactive 4-stage onboarding capturing qualifications, interests, motivation, and goals.

• 💬 Empathetic Chatbot Guidance
  Context-aware AI chatbot for resolving doubts, handling personal challenges (finance, family, health, etc.),
  and suggesting micro-experiments for talent discovery.

• 📅 Daily Micro-Tasks
  Personalized small tasks as footprints toward career success, directly integrated in the user dashboard.

• 💼 Job Recommendation & Apply
  Matches user profiles with real-time job opportunities and allows direct applications from dashboard.

• 📱 Personal Dashboard
  Central hub to track progress via weekly graphs, update profile anytime, and connect back with the chatbot.

• 🔐 Secure Authentication
  Google OAuth + Email/Password with JWT-based sessions, CSRF protection, and secure storage.

• 🌐 Responsive & Scalable Design
  Built on Next.js 13+, TypeScript, Tailwind, Prisma, Framer Motion for modern UX and smooth performance.

• 🛡️ Privacy First
  User data stored securely in PostgreSQL & Firestore, processed via Vertex AI Gemini with encryption and consent control.

---

📂 Project Structure

src/
├── app/                        # Next.js App Router – all application routes
│   ├── api/                    # Serverless API endpoints
│   │   ├── assessment/         # Assessment logic and scoring
│   │   ├── auth/               # Authentication APIs (sign-in / sign-up / OAuth)
│   │   ├── careersathi/        # Career guidance and recommendation APIs
│   │   ├── charts/             # Data visualization & analytics APIs
│   │   ├── jobs/               # Job search & recommendation APIs
│   │   ├── questions/          # Dynamic question retrieval for assessments
│   │   └── roadmap/            # Career roadmap generation APIs
│   ├── auth/                   # Public authentication pages
│   │   ├── signin/             # Sign-in page
│   │   └── signup/             # Sign-up page
│   ├── dashboard/              # Personalized student dashboard
│   │   ├── loading/            # Suspense loading state
│   │   └── page/               # Dashboard entry point
│   ├── plan/                   # Career roadmap UI (renamed from `roadmap`)
│   │   ├── [[id]]/             # Dynamic roadmap details
│   │   └── page/               # Roadmap landing page
│   ├── practice/               # Skill-building practice modules
│   │   └── experiments/        # Guided micro-experiments
│   ├── how-it-helps/           # Static informational page
│   ├── jobs/                   # Job listings & search interface
│   │   ├── loading/
│   │   └── page/
│   ├── chat/                   # Real-time chat interface
│   │   └── [[id]]/             # Dynamic chat sessions
│   │       └── page/
│   ├── assessment/             # Assessment flow entry page
│   ├── layout/                 # Global layout wrapper (shared header/footer)
│   ├── page/                   # Root landing page
│   ├── error/                  # Application-wide error boundary
│   ├── not-found/              # 404 page
│   └── globals.css             # Global styles
│
├── components/                 # Reusable, feature-oriented React components
│   ├── auth/                   # Authentication UI widgets
│   ├── layout/                 # Header, footer, navigation bars
│   ├── providers/              # Context & session providers
│   ├── dashboard/              # Dashboard cards and charts
│   ├── assessment/             # Assessment UI elements
│   ├── chat/                   # Chat UI widgets
│   ├── jobs/                   # Job-related components
│   ├── roadmap/                # Career roadmap visuals
│   └── ui/                     # Shared UI primitives (buttons, cards, progress bars)
│
├── hooks/                      # Custom React hooks
│   ├── useAutoScroll/          # Auto-scrolling for chat windows
│   ├── useChatMessages/        # Chat message management
│   └── useChatSessions/        # Chat session handling
│
├── lib/                        # Core utilities and service layers
│   ├── assessmentChecker/      # Assessment validation and scoring helpers
│   ├── atom/                   # Jotai/Recoil state atoms
│   ├── auth/                   # Authentication configuration
│   ├── chatStorage/            # Persistent chat storage utilities
│   ├── firebase/               # Firebase client SDK
│   ├── prisma/                 # Prisma ORM client
│   ├── questionService/        # Question retrieval service
│   ├── randomGreeting/         # Friendly greeting generator
│   ├── utils/                  # General-purpose helper functions
│   ├── parseJDToHTML/          # Parse job descriptions into HTML
│   ├── getRecommendedJobs/     # Job recommendation engine
│   └── vertex/                 # AI helper functions (Vertex AI)
│
├── types/                      # Central TypeScript type definitions
│   ├── profile/                # User profile types
│   ├── roadmap/                # Career roadmap types
│   └── career/                 # Career and job types
│
├── middleware/                 # Route protection & JWT validation
├── .envExample                 # Environment variable template
├── .eslintrc.json              # ESLint configuration
└── .gitignore                  # Git ignore rules

---

⚡ Getting Started

Prerequisites

• Node.js v18+
• npm or yarn
• Google Cloud project (for Vertex AI)
• Firebase project (Authentication + Firestore)

---

1️⃣ Clone Repository

git clone https://github.com/itgithubplatform/careersathi.git
cd careersathi

2️⃣ Install Dependencies

npm install

3️⃣ Configure Environment Variables

Copy the example .env.local and update with actual credentials:

cp .env.local.example .env.local

Required variables:

# Database
DATABASE_URL="file:./dev.db"

# NextAuth.js
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-secret-key"

# Google OAuth
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"

# Firebase (client & admin)
NEXT_PUBLIC_FIREBASE_API_KEY="..."
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="..."
NEXT_PUBLIC_FIREBASE_PROJECT_ID="..."
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="..."
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="..."
NEXT_PUBLIC_FIREBASE_APP_ID="..."
FIREBASE_PRIVATE_KEY="..."
FIREBASE_CLIENT_EMAIL="..."
FIREBASE_PROJECT_ID="..."

# Optional: Google Cloud AI
GOOGLE_CLOUD_PROJECT_ID="..."
GOOGLE_CLOUD_API_KEY="..."

---

4️⃣ Setup Database

npx prisma generate
npx prisma db push

---

5️⃣ Run Development Server

npm run dev

Open http://localhost:3000 to access the app.

---

🧩 Authentication System

• Sign In / Sign Up Pages

  • Google OAuth ✅
  • Email/Password (optional)

• Security Features

  • JWT session
  • Middleware route protection
  • Secure cookies (HttpOnly, Secure, SameSite)
  • CSRF protection

• UI/UX

  • OAuth buttons with correct branding
  • Loading states & error handling
  • Responsive design

---

📝 Multi-Stage Assessment

Stage 1 – Identity & Context

• Collect basic info: age, education, location
• Preferences & consent

Stage 2 – Interests & Motivation

• Domain selection (AI, Web, Design, Finance, etc.)
• Work preferences & motivation type
• Optional: “I’m not sure” → chatbot redirection

Stage 3 – Skills & Competency

• Interactive skill sliders (1–5)
• Project experience & technology familiarity
• Optional: Chatbot assistance if confused

Stage 4 – Results & Recommendations

• AI-generated career matches (2–5 options)
• Skill gap analysis
• Satisfaction check → redirect to chatbot if needed

Chatbot Integration

• Redirection triggers: motivation unclear, skill assessment help, unsatisfied with results
• Contextual guidance using AI
• Previous responses available for continuity

---

🎨 UI / UX Highlights

• Mobile-first responsive design
• Gradient backgrounds, hover effects, smooth transitions
• Framer Motion animations for components
• Progress bars & stage indicators in assessment
• Touch-friendly sliders and buttons for mobile

---

📊 AI & Recommendation System

• Vertex AI Gemini + Vector DB integration
• Structured output for recommendations:

{
  "identity": { "age": 22, "education": "BTech", "location": "Mumbai" },
  "interests": { "domains": ["AI", "Web"], "motivation": "high-pay" },
  "skills": { "problemSolving": 4, "coding": 3, "communication": 4 },
  "chatbotTriggers": ["motivation_unclear", "skills_help_needed"]
}

• Dynamic re-mapping based on user feedback or micro-experiments
• Skill gap analysis and roadmap generation

---

🔐 Security & Privacy

• OAuth-only authentication (no passwords stored)
• JWT-based secure sessions
• Route protection middleware
• Explicit user consent for data usage
• Secure storage and no external sharing

---

✅ Manual Testing Checklist

1. /auth/signup → OAuth buttons visible
2. Google/LinkedIn sign-in → redirect to /dashboard
3. Attempt /dashboard without login → redirected to /auth/signin
4. Navigation buttons change based on auth state
5. Logout → redirects to landing page
6. Multi-stage assessment → all stages progress correctly
7. Chatbot redirection triggers working
8. Skill gap analysis and career recommendations shown correctly

---

💻 Tech Stack

• Frontend: Next.js 13+, TypeScript, Tailwind CSS, Framer Motion
• Backend: NextAuth.js, Prisma ORM, SQLite, postgreSQL, Firestore
• AI: Google Cloud Vertex AI Gemini, Vector DB(not implemented currently)
• Authentication: OAuth (Google), email/password (not implemented)(optional)
• Deployment: Vercel recommended

---

📚 Contributing

1. Fork the repo
2. Create a feature branch (git checkout -b feature/your-feature)
3. Commit changes (git commit -m "Add new feature")
4. Push branch (git push origin feature/your-feature)
5. Open a Pull Request

---

📄 License

MIT License – see LICENSE

---

📞 Support

• Email: hello@careersathi.com
• connect with us for real-time support

---

Made with ❤️ for Indian students by the CareerSathi Team