{"openapi":"3.1.0","info":{"title":"Otheloo Orientation Engine","version":"1.0.0"},"paths":{"/health":{"get":{"tags":["health"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/v1/orientation/system/info":{"get":{"tags":["system"],"summary":"System Info","operationId":"system_info_v1_orientation_system_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response System Info V1 Orientation System Info Get"}}}}}}},"/v1/orientation/profiles":{"post":{"tags":["profiles"],"summary":"Create Profile","operationId":"create_profile_v1_orientation_profiles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/profiles/{student_id}":{"get":{"tags":["profiles"],"summary":"Get Profile","operationId":"get_profile_v1_orientation_profiles__student_id__get","parameters":[{"name":"student_id","in":"path","required":true,"schema":{"type":"string","title":"Student Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/profiles/{student_id}/history":{"get":{"tags":["profiles"],"summary":"Profile History","operationId":"profile_history_v1_orientation_profiles__student_id__history_get","parameters":[{"name":"student_id","in":"path","required":true,"schema":{"type":"string","title":"Student Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StudentProfile"},"title":"Response Profile History V1 Orientation Profiles  Student Id  History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/profiles/{student_id}/evolve":{"post":{"tags":["profiles"],"summary":"Evolve Profile","description":"Applique des observations : fusion pondérée, version incrémentée.","operationId":"evolve_profile_v1_orientation_profiles__student_id__evolve_post","parameters":[{"name":"student_id","in":"path","required":true,"schema":{"type":"string","title":"Student Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EvolveRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/assessments":{"post":{"tags":["assessments"],"summary":"Create Assessment","operationId":"create_assessment_v1_orientation_assessments_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentResult"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/assessment-v1/questions":{"get":{"tags":["assessment-v1"],"summary":"Get Questions","operationId":"get_questions_v1_orientation_assessment_v1_questions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Question"},"type":"array","title":"Response Get Questions V1 Orientation Assessment V1 Questions Get"}}}}}}},"/v1/orientation/assessment-v1/profile":{"post":{"tags":["assessment-v1"],"summary":"Build Profile","operationId":"build_profile_v1_orientation_assessment_v1_profile_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentSubmission"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LatentProfile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/assessment-v1/adaptive":{"post":{"tags":["assessment-v1"],"summary":"Get Adaptive Questions","operationId":"get_adaptive_questions_v1_orientation_assessment_v1_adaptive_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Body_get_adaptive_questions_v1_orientation_assessment_v1_adaptive_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Question"},"type":"array","title":"Response Get Adaptive Questions V1 Orientation Assessment V1 Adaptive Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/assessment-v1/telemetry":{"post":{"tags":["assessment-v1"],"summary":"Ingest Telemetry","operationId":"ingest_telemetry_v1_orientation_assessment_v1_telemetry_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryIngestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TelemetryEvent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/occupation-v2/recommend":{"post":{"tags":["occupation-v2"],"summary":"Recommend Occupations","operationId":"recommend_occupations_v1_orientation_occupation_v2_recommend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OccupationRecommendationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OccupationMatch"},"type":"array","title":"Response Recommend Occupations V1 Orientation Occupation V2 Recommend Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/recommendations":{"post":{"tags":["recommendations"],"summary":"Generate Recommendation","operationId":"generate_recommendation_v1_orientation_recommendations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StudentProfile"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Recommendation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/knowledge/{version}":{"get":{"tags":["knowledge"],"summary":"Get Knowledge","operationId":"get_knowledge_v1_orientation_knowledge__version__get","parameters":[{"name":"version","in":"path","required":true,"schema":{"type":"string","title":"Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Knowledge V1 Orientation Knowledge  Version  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orientation/feedback":{"post":{"tags":["feedback"],"summary":"Record Feedback","operationId":"record_feedback_v1_orientation_feedback_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackEvent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FeedbackEvent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AdaptiveQuestionRequest":{"properties":{"profile_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Profile Confidence"},"maximum_questions":{"type":"integer","maximum":3.0,"minimum":0.0,"title":"Maximum Questions","default":3},"answered_question_ids":{"items":{"type":"string"},"type":"array","title":"Answered Question Ids","default":[]}},"additionalProperties":false,"type":"object","required":["profile_confidence"],"title":"AdaptiveQuestionRequest"},"Answer":{"properties":{"question_id":{"type":"string","title":"Question Id"},"option_ids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Option Ids"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence","default":0.8},"answered_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Answered At"}},"additionalProperties":false,"type":"object","required":["question_id","option_ids"],"title":"Answer"},"AnswerOption":{"properties":{"option_id":{"type":"string","title":"Option Id"},"label":{"type":"string","title":"Label"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"latent_weights":{"additionalProperties":{"type":"number"},"type":"object","title":"Latent Weights"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]}},"additionalProperties":false,"type":"object","required":["option_id","label"],"title":"AnswerOption"},"AssessmentResult":{"properties":{"assessment_id":{"type":"string","title":"Assessment Id"},"session_id":{"type":"string","title":"Session Id"},"instrument_version":{"type":"string","title":"Instrument Version"},"traits":{"additionalProperties":{"type":"number"},"type":"object","title":"Traits"},"theta":{"additionalProperties":{"type":"number"},"type":"object","title":"Theta"},"standard_error":{"additionalProperties":{"type":"number"},"type":"object","title":"Standard Error"},"information":{"additionalProperties":{"type":"number"},"type":"object","title":"Information"},"responses_count":{"type":"integer","minimum":0.0,"title":"Responses Count"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"completed_at":{"type":"string","format":"date-time","title":"Completed At"}},"additionalProperties":false,"type":"object","required":["assessment_id","session_id","instrument_version","traits","responses_count","confidence","completed_at"],"title":"AssessmentResult"},"AssessmentSubmission":{"properties":{"assessment_id":{"type":"string","title":"Assessment Id"},"session_id":{"type":"string","title":"Session Id"},"student_id":{"type":"string","title":"Student Id"},"instrument_version":{"type":"string","title":"Instrument Version"},"answers":{"items":{"$ref":"#/components/schemas/Answer"},"type":"array","minItems":1,"title":"Answers"}},"additionalProperties":false,"type":"object","required":["assessment_id","session_id","student_id","instrument_version","answers"],"title":"AssessmentSubmission"},"AuditSnapshot":{"properties":{"request_id":{"type":"string","title":"Request Id"},"student_id":{"type":"string","title":"Student Id"},"profile_version":{"type":"string","title":"Profile Version"},"assessment_version":{"type":"string","title":"Assessment Version"},"knowledge_version":{"type":"string","title":"Knowledge Version"},"configuration_version":{"type":"string","title":"Configuration Version"},"feature_schema_version":{"type":"string","title":"Feature Schema Version"},"model_version":{"type":"string","title":"Model Version"},"candidate_set":{"items":{"type":"string"},"type":"array","title":"Candidate Set"},"ranking":{"items":{"type":"string"},"type":"array","title":"Ranking"},"scores":{"additionalProperties":{"type":"number"},"type":"object","title":"Scores"},"uncertainty":{"additionalProperties":{"type":"number"},"type":"object","title":"Uncertainty"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["request_id","student_id","profile_version","assessment_version","knowledge_version","configuration_version","feature_schema_version","model_version","candidate_set","ranking","scores","uncertainty","timestamp"],"title":"AuditSnapshot"},"Body_get_adaptive_questions_v1_orientation_assessment_v1_adaptive_post":{"properties":{"request":{"$ref":"#/components/schemas/AdaptiveQuestionRequest"},"submission":{"$ref":"#/components/schemas/AssessmentSubmission"}},"type":"object","required":["request","submission"],"title":"Body_get_adaptive_questions_v1_orientation_assessment_v1_adaptive_post"},"DataState":{"type":"string","enum":["known","unknown","not_applicable","contradictory"],"title":"DataState"},"DimensionEstimate":{"properties":{"value":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Value"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"raw_mean":{"type":"number","title":"Raw Mean"},"z_score":{"type":"number","title":"Z Score"},"evidence_count":{"type":"integer","minimum":0.0,"title":"Evidence Count"}},"type":"object","required":["value","confidence","raw_mean","z_score","evidence_count"],"title":"DimensionEstimate"},"EvolveRequest":{"properties":{"observations":{"items":{"$ref":"#/components/schemas/Observation"},"type":"array","title":"Observations"}},"type":"object","title":"EvolveRequest"},"Explanation":{"properties":{"facts":{"items":{"$ref":"#/components/schemas/ExplanationFact"},"type":"array","title":"Facts"}},"type":"object","title":"Explanation"},"ExplanationFact":{"properties":{"kind":{"type":"string","title":"Kind"},"dimension":{"type":"string","title":"Dimension"},"direction_id":{"type":"string","title":"Direction Id"},"statement_key":{"type":"string","title":"Statement Key"},"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Value"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence"}},"type":"object","required":["kind","dimension","direction_id","statement_key"],"title":"ExplanationFact"},"ExplorationIdea":{"properties":{"exploration_id":{"type":"string","title":"Exploration Id"},"kind":{"type":"string","title":"Kind"},"title":{"type":"string","title":"Title"},"purpose":{"type":"string","title":"Purpose"},"related_dimensions":{"items":{"type":"string"},"type":"array","title":"Related Dimensions"}},"type":"object","required":["exploration_id","kind","title","purpose"],"title":"ExplorationIdea"},"FeedbackEvent":{"properties":{"event_id":{"type":"string","title":"Event Id"},"student_id":{"type":"string","title":"Student Id"},"direction_id":{"type":"string","title":"Direction Id"},"event_type":{"type":"string","enum":["view","save","reject","explore","complete_exploration","request_detail"],"title":"Event Type"},"value":{"type":"number","maximum":1.0,"minimum":-1.0,"title":"Value","default":1.0},"occurred_at":{"type":"string","title":"Occurred At"},"context":{"additionalProperties":{"type":"string"},"type":"object","title":"Context"},"profile_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Profile Version"}},"type":"object","required":["event_id","student_id","direction_id","event_type","occurred_at"],"title":"FeedbackEvent"},"FormationPath":{"properties":{"formation_id":{"type":"string","title":"Formation Id"},"title":{"type":"string","title":"Title"},"level":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Level","default":0.5},"duration_years":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Years"}},"type":"object","required":["formation_id","title"],"title":"FormationPath","description":"Parcours de formation associé (accessibilité, pas verdict)."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LatentProfile":{"properties":{"profile_version":{"type":"string","title":"Profile Version"},"questionnaire_version":{"type":"string","title":"Questionnaire Version"},"riasec":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Riasec"},"abilities":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Abilities"},"values":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Values"},"work_style":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Work Style"},"environment":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Environment"},"learning":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Learning"},"adaptability":{"additionalProperties":{"$ref":"#/components/schemas/DimensionEstimate"},"type":"object","title":"Adaptability"},"constraints":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"}]},"type":"object","title":"Constraints"},"interest_efficacy_gap":{"additionalProperties":{"type":"number"},"type":"object","title":"Interest Efficacy Gap"},"riasec_entropy":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Riasec Entropy"},"profile_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Profile Confidence"},"contradictions":{"items":{"type":"string"},"type":"array","title":"Contradictions","default":[]},"answered_count":{"type":"integer","minimum":0.0,"title":"Answered Count"},"total_questions":{"type":"integer","minimum":1.0,"title":"Total Questions"}},"additionalProperties":false,"type":"object","required":["profile_version","questionnaire_version","riasec","abilities","values","work_style","environment","learning","adaptability","riasec_entropy","profile_confidence","answered_count","total_questions"],"title":"LatentProfile"},"Observation":{"properties":{"dimension":{"type":"string","title":"Dimension"},"value":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Value"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"source":{"$ref":"#/components/schemas/SourceType"},"state":{"$ref":"#/components/schemas/DataState","default":"known"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"},"context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context"},"version":{"type":"string","title":"Version","default":"v1"},"provenance":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provenance"}},"additionalProperties":false,"type":"object","required":["dimension","value","confidence","source"],"title":"Observation"},"OccupationMatch":{"properties":{"occupation_id":{"type":"string","title":"Occupation Id"},"title":{"type":"string","title":"Title"},"source":{"type":"string","title":"Source"},"score":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Score"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"recommendation_class":{"type":"string","enum":["strong_fit","good_fit","adjacent","exploration"],"title":"Recommendation Class","default":"exploration"},"isco08_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isco08 Code"},"isco_major_group":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isco Major Group"},"components":{"items":{"$ref":"#/components/schemas/ScoreComponent"},"type":"array","title":"Components","default":[]},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons","default":[]},"gaps":{"items":{"type":"string"},"type":"array","title":"Gaps","default":[]},"evidence_count":{"type":"integer","minimum":0.0,"title":"Evidence Count","default":0}},"additionalProperties":false,"type":"object","required":["occupation_id","title","source","score","confidence"],"title":"OccupationMatch"},"OccupationPath":{"properties":{"occupation_id":{"type":"string","title":"Occupation Id"},"title":{"type":"string","title":"Title"},"match":{"type":"number","maximum":100.0,"minimum":0.0,"title":"Match"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"recommendation_class":{"type":"string","title":"Recommendation Class","default":"exploration"},"key_skills":{"items":{"type":"string"},"type":"array","title":"Key Skills"}},"type":"object","required":["occupation_id","title","match","confidence"],"title":"OccupationPath","description":"Voie métier concrète, scorée et expliquée."},"OccupationRecommendationRequest":{"properties":{"profile":{"$ref":"#/components/schemas/StudentProfile"},"limit":{"type":"integer","maximum":100.0,"minimum":1.0,"title":"Limit","default":20},"major_group":{"anyOf":[{"type":"string","pattern":"^[0-9]$"},{"type":"null"}],"title":"Major Group"}},"additionalProperties":false,"type":"object","required":["profile"],"title":"OccupationRecommendationRequest"},"Question":{"properties":{"question_id":{"type":"string","title":"Question Id"},"block":{"type":"string","enum":["A","B","C","D","adaptive"],"title":"Block"},"text":{"type":"string","title":"Text"},"response_type":{"type":"string","enum":["single","multi","likert","ranked"],"title":"Response Type"},"min_selections":{"type":"integer","minimum":0.0,"title":"Min Selections","default":1},"max_selections":{"type":"integer","minimum":1.0,"title":"Max Selections","default":1},"options":{"items":{"$ref":"#/components/schemas/AnswerOption"},"type":"array","minItems":2,"title":"Options"},"dimensions":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Dimensions"},"required":{"type":"boolean","title":"Required","default":true}},"additionalProperties":false,"type":"object","required":["question_id","block","text","response_type","options","dimensions"],"title":"Question"},"Recommendation":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"profile_version":{"type":"string","title":"Profile Version"},"model_version":{"type":"string","title":"Model Version"},"knowledge_version":{"type":"string","title":"Knowledge Version"},"candidates":{"items":{"$ref":"#/components/schemas/RecommendationItem"},"type":"array","title":"Candidates"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"audit":{"$ref":"#/components/schemas/AuditSnapshot"}},"type":"object","required":["recommendation_id","profile_version","model_version","knowledge_version","created_at","audit"],"title":"Recommendation"},"RecommendationItem":{"properties":{"direction_id":{"type":"string","title":"Direction Id"},"direction_name":{"type":"string","title":"Direction Name"},"taxonomy":{"type":"string","title":"Taxonomy"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"uncertainty":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Uncertainty"},"score_breakdown":{"$ref":"#/components/schemas/ScoreBreakdown"},"skill_gaps":{"items":{"$ref":"#/components/schemas/SkillGap"},"type":"array","title":"Skill Gaps"},"explanation":{"$ref":"#/components/schemas/Explanation"},"explorations":{"items":{"$ref":"#/components/schemas/ExplorationIdea"},"type":"array","title":"Explorations"},"occupation_paths":{"items":{"$ref":"#/components/schemas/OccupationPath"},"type":"array","title":"Occupation Paths"},"formations":{"items":{"$ref":"#/components/schemas/FormationPath"},"type":"array","title":"Formations"}},"type":"object","required":["direction_id","direction_name","taxonomy","score","confidence","uncertainty","score_breakdown"],"title":"RecommendationItem"},"ScoreBreakdown":{"properties":{"interest_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Interest Fit"},"ability_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Ability Fit"},"skill_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Skill Fit"},"value_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Value Fit"},"subject_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Subject Fit"},"self_efficacy_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Self Efficacy Fit"},"adaptability_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Adaptability Fit"},"environment_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Environment Fit"},"trajectory_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Trajectory Fit"},"semantic_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Semantic Fit"},"graph_fit":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Graph Fit"},"skill_gap_penalty":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Skill Gap Penalty"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"compatibility":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Compatibility"}},"type":"object","required":["interest_fit","ability_fit","skill_fit","value_fit","subject_fit","self_efficacy_fit","adaptability_fit","environment_fit","trajectory_fit","semantic_fit","graph_fit","skill_gap_penalty","confidence","compatibility"],"title":"ScoreBreakdown"},"ScoreComponent":{"properties":{"name":{"type":"string","title":"Name"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"weight":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Weight"},"evidence":{"items":{"type":"string"},"type":"array","title":"Evidence","default":[]}},"additionalProperties":false,"type":"object","required":["name","score","weight"],"title":"ScoreComponent"},"SkillGap":{"properties":{"skill_id":{"type":"string","title":"Skill Id"},"current_level":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Current Level"},"required_level":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Required Level"},"gap":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Gap"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"priority":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Priority"}},"type":"object","required":["skill_id","required_level","gap","confidence","priority"],"title":"SkillGap"},"SourceType":{"type":"string","enum":["declared","assessed","observed","inferred"],"title":"SourceType"},"StudentProfile":{"properties":{"student_id":{"type":"string","title":"Student Id"},"profile_version":{"type":"string","title":"Profile Version","default":"v1"},"questionnaire_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Questionnaire Version"},"assessment_confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Assessment Confidence","default":0.0},"riasec_entropy":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Riasec Entropy","default":0.0},"contradictions":{"items":{"type":"string"},"type":"array","title":"Contradictions","default":[]},"interests":{"additionalProperties":{"type":"number"},"type":"object","title":"Interests"},"abilities":{"additionalProperties":{"type":"number"},"type":"object","title":"Abilities"},"values":{"additionalProperties":{"type":"number"},"type":"object","title":"Values"},"subjects":{"additionalProperties":{"type":"number"},"type":"object","title":"Subjects"},"self_efficacy":{"additionalProperties":{"type":"number"},"type":"object","title":"Self Efficacy"},"adaptability":{"additionalProperties":{"type":"number"},"type":"object","title":"Adaptability"},"environment":{"additionalProperties":{"type":"number"},"type":"object","title":"Environment"},"skills":{"items":{"$ref":"#/components/schemas/StudentSkill"},"type":"array","title":"Skills"},"trajectory":{"additionalProperties":{"type":"number"},"type":"object","title":"Trajectory"},"constraints":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"},{"$ref":"#/components/schemas/DataState"}]},"type":"object","title":"Constraints"},"observations":{"items":{"$ref":"#/components/schemas/Observation"},"type":"array","title":"Observations"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"}},"additionalProperties":false,"type":"object","required":["student_id"],"title":"StudentProfile"},"StudentSkill":{"properties":{"skill_id":{"type":"string","title":"Skill Id"},"level":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Level"},"confidence":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Confidence"},"source":{"type":"string","title":"Source"},"status":{"$ref":"#/components/schemas/SourceType"},"observed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Observed At"}},"additionalProperties":false,"type":"object","required":["skill_id","level","confidence","source","status"],"title":"StudentSkill"},"TelemetryEvent":{"properties":{"event_id":{"type":"string","title":"Event Id"},"event_type":{"type":"string","enum":["QUESTIONNAIRE_STARTED","QUESTIONNAIRE_COMPLETED","ADAPTIVE_QUESTION_SHOWN","DIRECTION_CLICKED","JOB_DETAIL_DWELL_TIME","JOB_FAVORITED","JOB_COMPARED","FORMATION_CLICKED","FORMATION_STARTED","FORMATION_COMPLETED","USER_FEEDBACK_GIVEN","REAL_CHOICE_DECLARED"],"title":"Event Type"},"student_id":{"type":"string","title":"Student Id"},"occurred_at":{"type":"string","format":"date-time","title":"Occurred At"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"direction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction Id"},"position":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Position"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"questionnaire_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Questionnaire Version"},"knowledge_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Knowledge Version"},"propensity":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Propensity"},"reward":{"anyOf":[{"type":"number","maximum":1.0,"minimum":-1.0},{"type":"null"}],"title":"Reward"},"context":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Context"},"payload":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"}]},"type":"object","title":"Payload"}},"additionalProperties":false,"type":"object","required":["event_id","event_type","student_id","occurred_at"],"title":"TelemetryEvent"},"TelemetryIngestRequest":{"properties":{"event_type":{"type":"string","enum":["QUESTIONNAIRE_STARTED","QUESTIONNAIRE_COMPLETED","ADAPTIVE_QUESTION_SHOWN","DIRECTION_CLICKED","JOB_DETAIL_DWELL_TIME","JOB_FAVORITED","JOB_COMPARED","FORMATION_CLICKED","FORMATION_STARTED","FORMATION_COMPLETED","USER_FEEDBACK_GIVEN","REAL_CHOICE_DECLARED"],"title":"Event Type"},"student_id":{"type":"string","minLength":1,"title":"Student Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"direction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Direction Id"},"position":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Position"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"questionnaire_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Questionnaire Version"},"knowledge_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Knowledge Version"},"propensity":{"anyOf":[{"type":"number","maximum":1.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Propensity"},"context":{"additionalProperties":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Context","default":{}},"payload":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"integer"},{"type":"number"},{"type":"boolean"},{"items":{"type":"string"},"type":"array"}]},"type":"object","title":"Payload","default":{}}},"additionalProperties":false,"type":"object","required":["event_type","student_id"],"title":"TelemetryIngestRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}