okongomathews/CareerCompass

CareerCompass Kenya - AI-Powered Career Guidance Platform # CareerCompass Kenya - AI-Powered Career Guidance Platform ## 📋 Table of Contents 1. Executive Summary 2. Project Architecture 3. Core Features 4. Technical Implementation 5. Database Schema 6. API Documentation 7. Installation & Deployment 8. Development Guidelines 9. Testing Strategy 10. Security Measures 11. Performance Optimization 12. Future Roadmap 13. Contributing 14. License & Support ## 🎯 Executive Summary CareerCompass Kenya is a sophisticated, production-ready AI-powered career guidance platform specifically designed for the Kenyan education ecosystem. The system combines personality psychology, machine learning algorithms, and localized market intelligence to deliver personalized career pathway recommendations with 94% accuracy. **⚠ Unverified claim — see note below.** ### Key Differentiators - **Kenyan Context Integration**: Localized salary data, university requirements, and market trends - **Scientific Personality Assessment**: 60-question MBTI-based assessment with balanced scoring - **Dynamic Recommendation Engine**: Multi-factor weighted algorithm with real-time adjustments - **AI Career Coaching**: Context-aware guidance with Kenyan educational system understanding ## 🏗️ Project Architecture careeratlas-kenya/ ├── backend/ # Django project configuration │ ├── settings.py # Project settings and configurations │ ├── urls.py # Main URL routing │ ├── wsgi.py # WSGI application entry point │ └── asgi.py # ASGI application entry point ├── users/ # User management application │ ├── models.py # CustomUser, StudentProfile, School models │ ├── views.py # Authentication and profile management │ ├── serializers.py # API serializers for data transformation │ ├── forms.py # Django forms for HTML interfaces │ ├── urls.py # User-specific URL patterns │ ├── admin.py # Admin interface configuration │ ├── apps.py # App configuration │ └── signals.py # Signal handlers for user operations ├── assessments/ # Personality assessment engine │ ├── models.py # Questio …