🚀 CareerJob

AI-Powered Career Development Platform - The ultimate career companion with 70+ features, AI assistance, job tracking, resume building, interview prep, and comprehensive career tools.

📊 Platform Statistics

Metric	Count
Career Components	63
Career Paths	50
Documented Positions	300
C-Level Roles	50
Git Commits	240+
Documentation Files	50+
Total Pages	100+

✨ Features

🤖 AI Career Tools

• AI Chat Assistant - Get career advice with streaming responses
• Career Copilot - Auth-gated DeepSeek V4 Pro assistant with site context
• Model-safe AI Runtime - DeepSeek legacy aliases normalize to deepseek-v4-pro and surface through response headers/UI
• Resume Analyzer - AI-powered resume feedback
• Cover Letter Generator - Generate personalized cover letters
• Interview Prep - Practice with AI-generated questions & STAR answers
• Smart Job Matching - Match your profile with job descriptions
• Voice Input - Speak to the AI assistant

📊 Job Application Tracker

• Track applications with status pipeline
• Direct edit, autosave, full form, CSV export, and Supabase-ready sync
• Company research database
• Salary insights and comparisons
• Interview scheduling
• Document attachments

🌐 Job Platform Directory

• Curated job platforms for Indonesia/SEA, US market, remote global, freelance, startup, executive, impact, academia, and product/design
• Search and filter by category, market, tags, platform priority, fit score, cadence, and access model
• Integrated into Career Copilot knowledge context for conversational platform recommendations

🔔 Real-time Features

• Live notifications
• WebSocket chat
• Typing indicators
• Presence tracking

📱 PWA

• Install as mobile app
• Offline support
• Push notifications ready

🛠️ Tech Stack

• Framework: Next.js 16 + React 19
• Language: TypeScript
• Styling: Tailwind CSS 4
• UI Components: shadcn/ui
• Database: Supabase (PostgreSQL)
• Auth: Supabase Auth
• AI: DeepSeek API primary, Moonshot/Kimi fallback
• Testing: Vitest + Playwright
• Deployment: Vercel

🚀 Getting Started

Prerequisites

• Node.js 22+
• npm or yarn
• Supabase account
• DeepSeek API key

Installation

1. Clone the repository:

git clone https://github.com/subkhanibnuaji/career-job.git
cd career-job

2. Install dependencies:

npm install

3. Set up environment variables:

cp .env.local.example .env.local

Edit .env.local:

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# AI
DEEPSEEK_API_KEY=your-deepseek-api-key
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-v4-pro
AI_CHAT_MODEL=deepseek-v4-pro

# Optional fallback
KIMI_API_KEY=your-kimi-api-key
KIMI_BASE_URL=https://api.moonshot.cn/v1

# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

AI_CHAT_MODEL is the preferred production override. Legacy DeepSeek aliases such as deepseek-chat, deepseek-reasoner, or DeepSeek V3 labels are normalized to deepseek-v4-pro so Career Copilot does not drift to older model names.

4. Set up database:

• Go to Supabase Dashboard
• Create a new project
• Run migrations from supabase/migrations/

5. Run development server:

npm run dev

Open http://localhost:3000

📊 Data Policy

Data Labeling System

All data in this platform follows a strict labeling policy:

Badge	Meaning	Usage
📊 Data Real	Data from actual surveys or user input	HRDBacot SalSur 3.0 (9,532 respondents), user profile
🔮 Estimasi	Calculated estimates based on real data	Salary projections, market ranges
❌ Mock Data	Prohibited — removed from platform	Previously used for demo purposes

Data Sources

• Salary Data: HRDBacot Salary Survey 3.0 — 9,532 valid responses
• User Profile: Real data from src/data/user-profile.ts
• Platform Stats: Real analytics from career-job.vercel.app

Rules

1. 🚫 Mock data is strictly prohibited
2. 📊 All data must have a clear source
3. 🔮 Estimates must be clearly labeled as such
4. 🔄 Use src/data/career-data.ts as single source of truth

📁 Project Structure

career-job/
├── src/
│   ├── app/              # Next.js App Router
│   │   ├── (app)/        # Main app routes
│   │   ├── (auth)/       # Auth routes
│   │   └── api/          # API routes
│   ├── components/       # React components
│   ├── lib/             # Utilities
│   │   ├── ai/          # AI integration
│   │   ├── auth/        # Auth hooks
│   │   ├── supabase/    # Supabase clients
│   │   ├── security/    # Security utils
│   │   └── validation/  # Zod schemas
│   └── data/            # Static data
├── supabase/
│   └── migrations/      # Database migrations
├── .github/
│   └── workflows/       # GitHub Actions
└── public/              # Static assets

🧪 Testing

# Unit tests
npm run test

# E2E tests
npm run e2e

# Test coverage
npm run test:coverage

📚 Documentation

• Getting Started - Onboarding guide
• Features - Platform features overview
• About - Our story & mission
• Help Center - FAQs & support
• Pricing - Plans & pricing
• Contact - Get in touch
• Status - System status
• Careers - Join our team
• Testimonials - Success stories
• Blog - Career insights
• Partners - Partnership opportunities
• Newsletter - Subscribe for updates
• Resources Hub - Ebooks, videos, templates
• Community - Join 10K+ members
• API Docs - Developer documentation
• Roadmap - Future plans & features
• Press - Media & press kit
• Tools - Recommended career tools
• Glossary - Career terminology
• Privacy - Privacy policy
• Terms - Terms of service
• Security - Security center
• Accessibility - Accessibility statement
• Search - Universal search
• Platform Stats - Analytics & metrics
• API Documentation - API endpoints and usage
• Architecture - Technical architecture
• Contributing - Contribution guidelines
• Component Showcase - Browse all 63+ components
• Sitemap - Navigate all 100+ pages
• Changelog - Version history
• FAQ - Frequently asked questions

📝 Changelog Workflow

Every user-visible product change must be recorded in two places:

1. CHANGELOG.md for repository history, deployment notes, verification, and security notes.
2. /changelog (src/app/[locale]/(app)/changelog/page.tsx) for the in-app release timeline.

For each release, include the date, feature summary, changed behavior, security implications, verification commands, and deployment status. Keep this workflow updated whenever a major page, AI behavior, tracker workflow, data catalog, or production config changes.

🚀 Deployment

Vercel (Recommended)

1. Push to GitHub
2. Import project on Vercel
3. Add environment variables
4. Deploy!

Manual

# Build
npm run build

# Start production server
npm start

🔒 Security

• Rate limiting on all API routes
• Row Level Security (RLS) on database
• Content Security Policy (CSP)
• XSS protection
• CSRF protection
• Input validation with Zod
• Audit logging

🎯 Roadmap

• Job scraping integration
• Email notifications
• Calendar integration
• Admin dashboard
• Mobile app (React Native)
• Advanced analytics

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• shadcn/ui for beautiful components
• Supabase for backend infrastructure
• DeepSeek for primary AI capabilities
• Moonshot AI for fallback AI support
• Vercel for hosting

---

Built with ❤️ by Ibnu Aji