Analyzes resume, GitHub, LeetCode, and portfolio in parallel
where possible. Records analysis runs for auditing.

Args:
    student_id: The student's UUID.

Returns:
    Analysis results summary with status for each component.

Args:
    student_id: The student's UUID.

Returns:
    Resume analysis results including extracted skills and experience.

Args:
    student_id: The student's UUID.

Returns:
    GitHub analysis including repositories, languages, and activity.

Args:
    student_id: The student's UUID.

Returns:
    LeetCode analysis including problems solved and topic distribution.

Args:
    student_id: The student's UUID.

Returns:
    Portfolio analysis including projects and technologies found.

Includes CGPA distribution, skill coverage, project counts,
internship rates, and certification coverage.

Returns:
    Formatted statistics report.

Shows which skills are most common, least common, and
how skills cluster by category.

Returns:
    Skill distribution report.

Reports on missing fields, invalid URLs, format issues,
and overall data completeness.

Returns:
    Data quality metrics and recommendations.

Checks file format, detects columns, maps to schema fields,
and reports any ambiguous or missing columns.

Args:
    file_path: Absolute path to the .xlsx file on the server filesystem.

Returns:
    Validation result including detected columns, mapping, and warnings.

Runs the full pipeline: validate → map columns → normalize →
detect duplicates → persist to database → report statistics.

Args:
    file_path: Absolute path to the .xlsx file on the server filesystem.

Returns:
    Import result with statistics (total, successful, failed, duplicate rows).

Args:
    import_id: The UUID of the import to check.

Returns:
    Import status including row counts and any error details.

Shows each skill with its evidence sources (resume, GitHub, projects, etc.)
and evidence strength (declared_only, weak_evidence, strong_evidence).

Args:
    student_id: The student's UUID.

Returns:
    Structured skill evidence report.

Shows missing, weakly evidenced, and declared-but-unverified skills.

Args:
    student_id: The student's UUID.

Returns:
    Skill gap analysis with recommendations.

Returns a percentage score and breakdown by section
(education, skills, projects, resume, GitHub, etc.).

Args:
    student_id: The student's UUID.

Returns:
    Completeness score and section-by-section breakdown.

Args:
    student_id: The student's UUID.

Returns:
    Student profile information including name, email, roll number.

Args:
    name: Partial name to search for (optional).
    page: Page number (default: 1).
    page_size: Items per page (default: 20, max: 100).

Returns:
    List of matching students with their basic information.

Args:
    page: Page number (default: 1).
    page_size: Items per page (default: 20, max: 100).

Returns:
    Paginated list of students with total count.