🚀 Talent Management Platform

1. Overview
2. Target Audience & Personas
3. Key Features & Capabilities
   • High School Student Portal
   • College Student Portal
   • Working Professional Portal
   • Admin Management Portal
4. AI Engine & Intelligence Suite
5. ATS Resume Builder & Analyzer
6. Reports, Analytics & Certifications
7. System Architecture
8. Technology Stack
9. Project Directory Structure
10. Database Schema & Data Models
11. Installation & Setup Guide
12. Usage & Workflow
13. Future Roadmap
14. Contributing & License

Talent Management Platform is a comprehensive, end-to-end career guidance and talent acceleration platform designed to empower individuals across every stage of their academic and professional journey. Powered by intelligent AI engines and interactive analytics, Talent Management Platform bridges the gap between skill acquisition, industry readiness, and career advancement.

Whether you are a high school student exploring foundational career options, a college student gearing up for competitive campus placements, or a working professional navigating role transitions and promotions, Talent Management Platform delivers personalized roadmaps, real-time assessments, ATS-compliant resume tools, and actionable insights.

graph TD
    User([User Registration & Login]) --> Persona{Select Persona}
    Persona --> HS["🎓 High School Student<br/>(Exploration & Foundations)"]
    Persona --> COL["🏫 College Student<br/>(Placement & Industry Readiness)"]
    Persona --> WP["💼 Working Professional<br/>(Career Growth & Transition)"]
    Persona --> ADM["🛡️ Admin<br/>(Platform Management & Analytics)"]

• High School Students: Build early career clarity, practice basic coding and aptitude, cultivate communication skills, and discover personalized educational paths.
• College Students: Master placement tests, conduct mock interviews, evaluate resume ATS scores, assess industry readiness, and discover targeted internships.
• Working Professionals: Benchmark salaries, assess promotion readiness, plan career switches, close skill gaps, and explore trending technologies.
• Administrators: Track platform analytics, manage courses and quiz banks, supervise user activity, and broadcast platform-wide notifications.

Designed to provide engaging, foundational guidance and skill development for secondary school students:

• Interactive Career Explorer: Explore diverse modern career paths with descriptions, required subjects, salary outlooks, and entry paths.
• AI Career Quiz & RIASEC Interest Assessment: Psychometric and interest evaluation mapping passions to suitable career clusters.
• Future Skills Roadmap: Dynamic step-by-step milestones tailored to high school milestones.
• Daily Learning Tasks: Gamified daily micro-tasks that build consistency and positive learning habits.
• Coding Basics Sandbox: Beginner-friendly programming concepts (Python, Logic, Web fundamentals) with interactive exercises.
• Aptitude & Logical Reasoning Practice: Quantitative and reasoning challenges with automated scoring and explanations.
• Communication Skills Builder: Verbal, written, and presentation etiquette modules.
• Goal Tracker & AI Mentor Chatbot: Track short-term academic goals and chat with an AI mentor for career Q&A.

A rigorous, placement-oriented module tailored to university and engineering students:

• Placement Readiness Score: Multi-dimensional gauge combining coding scores, resume strength, mock interviews, and project experience.
• Interactive Coding Practice Tests: Topic-wise timed assessments (Data Structures, Algorithms, SQL, OOP, System Design) evaluated by AI.
• AI Mock Interview Simulator: Realistic Technical, HR, and Behavioral mock interviews with instant scorecards, answer relevance ratings, and feedback.
• Skill Gap Analysis: Compares a student’s current profile with industry role benchmarks (Software Engineer, Data Analyst, Cloud Architect, AI Engineer).
• Internship Recommendation Engine: Suggests internships matching the student’s CGPA, technical skills, and location preferences.
• 30/60/90-Day Learning Roadmaps: Structured milestone trackers with automated progress indicators and checklist persistence.
• Comprehensive Student Profile: Manages academic credentials, branch, technical stack, career preferences, and target companies.

Accelerates corporate career trajectories and navigates transition opportunities:

• Promotion Readiness Calculator: Algorithmic scoring based on total experience, project complexity, technical depth, and leadership contributions.
• Career Transition Matcher: Analyzes current domain skills against target roles to generate a transition feasibility index and learning priorities.
• Salary Growth & Market Benchmarks: Compares compensation with market trends and forecasts salary growth upon acquiring recommended certifications.
• Trending Industry Skills: Curated catalog of high-demand skills (GenAI, Cloud/DevOps, Distributed Systems, ML Ops).
• Automated Growth PDF Reports: Generates detailed, downloadable executive career growth reports.

Provides centralized control and platform observability:

• Live System Analytics: Real-time visualization of total active users, assessment submissions, and system health metrics.
• User Management: Search, filter, inspect, and toggle user active/deactivated statuses.
• Course & Career Path Manager: Create, edit, and organize courses across multiple categories.
• Quiz & Question Bank Manager: Add and update assessment question pools dynamically.
• Notification Center: Dispatch targeted alerts and announcements to specific user cohorts or system-wide.

The platform utilizes a modular, extensible AI Engine architecture located in the ai/ package:

Built directly into the platform to prepare users for modern applicant tracking systems:

• Multi-Template ATS Resume Builder: Professional, clean resume templates optimized for machine parsing.
• ATS Compatibility Checker: Scans resumes against target job descriptions, scoring match percentage and identifying missing critical keywords.
• Live Resume Preview: Real-time interactive preview of candidate details, projects, education, and certifications.
• Direct PDF Export: High-fidelity PDF generation using ReportLab.

• Student Info Cards: Compact, shareable executive summary cards for student performance.
• Automated PDF Reports: High-resolution, multi-page PDF progress reports detailing skills, assessment history, and roadmaps.
• Milestone Completion Certificates: Generates verifiable certificates upon full completion of learning roadmaps.
• Visual Progress Trackers: Interactive Plotly gauges, radar charts, line charts, and bar graphs for immediate visual feedback.

graph TB
    subgraph UI ["User Interface Layer (Streamlit)"]
        APP["app.py (Router & Auth)"]
        HS_UI["High School Module"]
        COL_UI["College Module"]
        WP_UI["Professional Module"]
        ADM_UI["Admin Dashboard"]
    end

    subgraph Service ["Service & Core Logic Layer"]
        BASE["BasePortal (DRY Portal Base)"]
        NOTIF["Notification Service"]
        REP["Report & Certificate Engine"]
        RES["Resume & ATS Service"]
    end

    subgraph AI ["AI & Intelligence Engine"]
        AI_FACADE["AIEngine Facade"]
        PE["Placement Engine"]
        CE["Coding Engine"]
        IE["Interview Engine"]
        SGE["Skill Gap Engine"]
        RG["Roadmap Generator"]
        JME["Job Match Engine"]
    end

    subgraph Data ["Data & Storage Layer"]
        DB[("SQLite Database (talentsphere.db)")]
        ORM["SQLAlchemy ORM Models"]
    end

    UI --> Service
    Service --> AI
    Service --> ORM
    ORM --> DB

• Frontend & Framework: Streamlit (Interactive Web Application)
• Backend & ORM: Python 3.10+, SQLAlchemy
• Database: SQLite (Default, embedded), with support for PostgreSQL (psycopg2-binary, alembic)
• Security & Auth: Bcrypt Password Hashing, Session State Management
• Data Science & Analytics: Pandas, NumPy, Scikit-Learn
• Visualization: Plotly Express & Graph Objects, Matplotlib
• Document Processing & PDF Generation: ReportLab, python-docx, pdfplumber, PyPDF2
• AI / NLP Integrations: Google Generative AI, NLTK, spaCy

TalentSphere/
├── admin/                           # Admin Portal & Management System
│   ├── admin_dashboard.py           # Main Admin dashboard controller
│   ├── analytics.py                 # Platform-wide usage & analytics
│   ├── course_manager.py            # Course & career path management
│   ├── notification_manager.py      # System notification dispatcher
│   ├── quiz_manager.py              # Quiz question bank manager
│   └── user_manager.py              # User status & account management
├── ai/                              # Modular AI Intelligence Engines
│   ├── __init__.py                  # AIEngine facade
│   ├── career_predictor.py          # Career prediction model
│   ├── coding_engine.py             # Assessment generator & grader
│   ├── internship_engine.py         # Internship matching logic
│   ├── interview_engine.py          # Mock interview simulation & scoring
│   ├── job_matching.py              # Job role match calculation
│   ├── placement_engine.py          # Placement readiness score engine
│   ├── recommendation_engine.py     # Course & skill recommendations
│   ├── resume_analyzer.py           # ATS & resume review engine
│   ├── roadmap_generator.py         # 30/60/90-day roadmap synthesis
│   └── skill_gap.py                 # Skill gap & priority engine
├── modules/                         # Core User Persona Modules
│   ├── base_portal.py               # Shared BasePortal architecture
│   ├── career_data.py               # Pre-configured career benchmarks & data
│   ├── career_explorer.py           # Interactive career exploration logic
│   ├── college.py                   # College Student portal
│   ├── high_school.py               # High School Student portal
│   ├── professional.py              # Alternative professional portal module
│   ├── working_professional.py      # Working Professional portal
│   ├── wp_logic.py                  # Professional promotion/transition logic
│   ├── wp_models.py                 # Professional SQLAlchemy models
│   ├── wp_report.py                 # Professional growth PDF report builder
│   ├── wp_seed.py                   # Working professional seed data
│   ├── college_features/            # Dedicated college sub-features
│   │   └── college_profile.py       # Academic & placement profile UI
│   └── hs_features/                 # Dedicated high school sub-features
│       ├── ai_mentor.py             # AI Chatbot mentor for students
│       ├── aptitude_practice.py     # Logical reasoning practice tests
│       ├── career_quiz.py           # Psychometric career quiz
│       ├── coding_basics.py         # Beginner coding exercises
│       ├── communication_skills.py  # Soft skills training
│       ├── daily_tasks.py           # Gamified daily learning tasks
│       ├── future_roadmap.py        # High school milestone roadmaps
│       ├── goal_tracker.py          # Goal tracking & milestones
│       ├── interest_assessment.py   # RIASEC interest assessment
│       └── personal_information.py  # High school student profile UI
├── notifications/                   # Notification Subsystem
│   ├── notification_service.py      # Notification delivery & DB storage
│   ├── notification_ui.py           # In-app notification drawer & inbox
│   └── reminder_engine.py           # Automated task reminder triggers
├── reports/                         # PDF & Certificate Reporting Engines
│   ├── certificate_generator.py     # Roadmap milestone certificates
│   ├── pdf_report.py                # High-resolution PDF progress reports
│   ├── report_engine.py             # Comprehensive reporting aggregator
│   └── student_info_card.py         # Visual student summary cards
├── resume/                          # ATS Resume Suite
│   ├── ats_checker.py               # ATS keyword & format evaluator
│   ├── pdf_export.py                # PDF resume export pipeline
│   ├── resume_builder.py            # Interactive builder form
│   └── templates.py                 # Standard ATS-friendly templates
├── app.py                           # Application Entry Point & Authentication
├── database.py                      # SQLAlchemy Database Schema & Session Manager
├── updater.py                       # System update & migration script
├── validate_modules.py              # Script to validate module integrity
├── requirements.txt                 # Project Dependencies
├── LICENSE                          # MIT License
└── README.md                        # Project Documentation

TalentSphere uses an integrated SQLite relational database (talentsphere.db) managed via SQLAlchemy ORM. Key tables include:

erDiagram
    USERS ||--o{ ASSESSMENTS : completes
    USERS ||--o{ ROADMAPS : follows
    ROADMAPS ||--o{ PROGRESS : contains
    USERS ||--o| RESUME_DATA : maintains
    USERS ||--o{ USER_INBOX : receives
    USERS ||--o| COLLEGE_STUDENT_PROFILE : has
    USERS ||--o| WP_PROFESSIONAL_PROFILE : has
    USERS ||--o{ COLLEGE_CODING_TESTS : takes
    USERS ||--o{ MOCK_INTERVIEW_RESULTS : records
    USERS ||--o{ CAREER_QUIZ_RESULTS : saves
    USERS ||--o{ GOALS : tracks

    USERS {
        int id PK
        string username UK
        string password_hash
        string full_name
        string dob
        string user_type
        int is_active
        datetime created_at
    }

    COLLEGE_STUDENT_PROFILE {
        int id PK
        int user_id FK
        string degree
        string department
        float cgpa
        string technical_skills
        string preferred_roles
    }

    WP_PROFESSIONAL_PROFILE {
        int id PK
        int user_id FK
        string current_company
        string current_role
        float total_experience_years
        string technical_skills
        string career_goals
    }

Ensure you have Python 3.10 or higher installed on your system.

git clone https://github.com/yashlohar9005/TalentSphere.git
cd TalentSphere

• On Windows (PowerShell):

  python -m venv venv
  .\venv\Scripts\Activate.ps1

• On Linux / macOS:

  python3 -m venv venv
  source venv/bin/activate

pip install --upgrade pip
pip install -r requirements.txt

streamlit run app.py

Once launched, open your browser at http://localhost:8501.

1. Sign Up / Login: Create a user profile and choose your persona (High School Student, College Student, Working Professional, or Admin).
2. Setup Your Profile: Navigate to the Profile tab to enter academic or professional background details.
3. Take Assessments: Complete domain assessments, coding practice tests, or mock interviews.
4. Generate Your Roadmap: Click Generate Roadmap to receive an AI-crafted 30/60/90-day learning curriculum.
5. Build an ATS Resume: Format your resume with industry-standard templates and run real-time ATS compatibility checks.
6. Download Reports & Certificates: Export progress reports and milestone certificates as PDFs.

• Real-Time Voice AI Interviews: Integrate WebRTC-based voice speech analysis for mock interviews.
• GitHub & LinkedIn Integration: Direct profile parsing and repository portfolio analysis.
• Multi-Tenant College Admin Portals: Dedicated dashboards for university placement officers and corporate recruiters.
• Expanded Multi-Language Support: Support for regional languages across high school modules.

This project is developed as part of the Infosys Springboard Internship Program.

Distributed under the MIT License. See LICENSE for more details.

Built with ❤️ by Yash Lohar & the Talent Management Platform Team
Empowering Careers through AI Intelligence