"""Schemas — Unified Candidate Performance (JD-style ?action=).

GET  /api/v1/candidates/{id}/performance?action=overall|ai|assessments
POST /api/v1/candidates/{id}/performance?action=ai|assessments
"""

from __future__ import annotations

from datetime import datetime
from enum import Enum
from typing import Any, Literal

from pydantic import BaseModel, Field

from app.schemas.common import StubMeta


class PerformanceGetAction(str, Enum):
    OVERALL = "overall"
    AI = "ai"
    ASSESSMENTS = "assessments"


class PerformanceIngestAction(str, Enum):
    AI = "ai"
    ASSESSMENTS = "assessments"


AssessmentStatus = Literal[
    "not_started",
    "in_progress",
    "passed",
    "failed",
    "expired",
]

AiSourceType = Literal[
    "mock_interview",
    "recruiter_interview",
    "candidate_scoring",
    "ingest",
]


class AiDimensionScores(BaseModel):
    technical: float | None = None
    confidence: float | None = None
    communication: float | None = None
    culture_fit: float | None = None


class HiringRecommendation(BaseModel):
    label: str | None = None
    display: str | None = None
    confidence: float | None = Field(
        default=None,
        description="Recommendation confidence 0–100",
    )


class PerformanceScoreCard(BaseModel):
    score: float | None = None
    status: str | None = None
    available: bool = False
    recorded_at: datetime | None = None


class CandidateOverallPerformanceResponse(StubMeta):
    """GET ?action=overall"""

    action: Literal["overall"] = "overall"
    candidate_id: str
    company_id: str | None = None
    available: bool = False
    overall_score: float | None = Field(
        default=None,
        description="Combined 0–100 from mock + recruiter interviews + assessments",
    )
    ai_performance: PerformanceScoreCard = Field(default_factory=PerformanceScoreCard)
    assessment: PerformanceScoreCard = Field(default_factory=PerformanceScoreCard)
    breakdown: dict[str, Any] = Field(default_factory=dict)
    updated_at: datetime | None = None


class CandidateAiPerformanceResponse(StubMeta):
    """GET/POST ?action=ai"""

    action: Literal["ai"] = "ai"
    candidate_id: str
    company_id: str | None = None
    available: bool = False
    evaluation_id: str | None = None
    interview_id: str | None = None
    source_type: str | None = None
    role_title: str | None = None
    score: float | None = Field(default=None, description="AI Performance 0–100")
    dimensions: AiDimensionScores = Field(default_factory=AiDimensionScores)
    match_percent: float | None = None
    strengths: list[str] = Field(default_factory=list)
    growth_areas: list[str] = Field(default_factory=list)
    verified_skills: list[str] = Field(default_factory=list)
    recommendation: HiringRecommendation = Field(default_factory=HiringRecommendation)
    recorded_at: datetime | None = None


class AssessmentAttemptItem(BaseModel):
    attempt_id: str
    assessment_id: str
    attempt_number: int = 1
    kind: str | None = None
    role_title: str | None = None
    score: float | None = None
    status: AssessmentStatus | str = "in_progress"
    passed: bool | None = None
    skill_scores: list[dict[str, Any]] = Field(default_factory=list)
    recorded_at: datetime | None = None


class CandidateAssessmentsPerformanceResponse(StubMeta):
    """GET/POST ?action=assessments"""

    action: Literal["assessments"] = "assessments"
    candidate_id: str
    company_id: str | None = None
    available: bool = False
    latest: AssessmentAttemptItem | None = None
    history: list[AssessmentAttemptItem] = Field(default_factory=list)
    summary: dict[str, Any] = Field(default_factory=dict)


# --- Platform / gateway ingest bodies (POST; no LLM) ---


class AiPerformanceIngestBody(BaseModel):
    """POST ?action=ai body"""

    source_key: str | None = Field(
        default=None,
        description="Stable upsert key; defaults to interview:<id> or ingest:<uuid>",
    )
    source_type: AiSourceType = "ingest"
    interview_id: str | None = None
    role_title: str | None = None
    overall_score: float | None = Field(default=None, description="0–100 or 0–1")
    technical_score: float | None = None
    confidence_score: float | None = None
    communication_score: float | None = None
    culture_fit_score: float | None = None
    match_percent: float | None = None
    recommendation_label: str | None = None
    recommendation_confidence: float | None = None
    strengths: list[str] = Field(default_factory=list)
    growth_areas: list[str] = Field(default_factory=list)
    verified_skills: list[str] = Field(default_factory=list)
    meta: dict[str, Any] = Field(default_factory=dict)


class AssessmentAttemptIngestBody(BaseModel):
    """POST ?action=assessments body"""

    assessment_id: str
    attempt_number: int | None = Field(
        default=None,
        ge=1,
        description="Omit to auto-increment (retake). Same number upserts/replaces.",
    )
    kind: str | None = None
    role_title: str | None = None
    score: float | None = Field(default=None, description="0–100 or total points")
    max_score: float | None = Field(
        default=None,
        description="When set with score, converts to percent 0–100",
    )
    status: AssessmentStatus | None = None
    passed: bool | None = None
    skill_scores: list[dict[str, Any]] = Field(default_factory=list)
    feedback_markdown: str | None = None
    meta: dict[str, Any] = Field(default_factory=dict)


# Backward-compatible aliases (hooks / older imports)
AiPerformanceIngestRequest = AiPerformanceIngestBody
AssessmentAttemptIngestRequest = AssessmentAttemptIngestBody

PERFORMANCE_INGEST_BODY_BY_ACTION: dict[PerformanceIngestAction, type[BaseModel]] = {
    PerformanceIngestAction.AI: AiPerformanceIngestBody,
    PerformanceIngestAction.ASSESSMENTS: AssessmentAttemptIngestBody,
}

PERFORMANCE_INGEST_OPENAPI_EXAMPLES: dict[str, dict[str, Any]] = {
    "ai": {
        "summary": "Ingest AI Performance",
        "description": "Use query `?action=ai`. Body: AiPerformanceIngestBody.",
        "value": {
            "source_type": "recruiter_interview",
            "interview_id": "int-emily-001",
            "role_title": "Senior React Developer",
            "overall_score": 92,
            "technical_score": 89,
            "confidence_score": 87,
            "communication_score": 91,
            "culture_fit_score": 89,
            "match_percent": 94,
            "recommendation_label": "strong_hire",
            "recommendation_confidence": 90,
            "strengths": ["Strong React component modular architecture"],
            "growth_areas": ["Limited Kubernetes & container orchestration"],
            "verified_skills": ["React", "TypeScript", "Node.js"],
        },
    },
    "assessments": {
        "summary": "Ingest assessment attempt",
        "description": "Use query `?action=assessments`. Body: AssessmentAttemptIngestBody.",
        "value": {
            "assessment_id": "asmt-react-1",
            "kind": "mcq",
            "role_title": "Senior React Developer",
            "score": 84,
            "status": "in_progress",
            "passed": False,
        },
    },
}
