fix(opportunities): normalize unknown categories and support programs

app/schemas/opportunity.py

@@ -8,6 +8,7 @@ from pydantic import (
     ConfigDict,
     Field,
     HttpUrl,
+    field_validator,
 )
 
 
@@ -20,6 +21,7 @@ class OpportunityCategory(StrEnum):
     HACKATHON = "hackathon"
     GRANT = "grant"
     JOB = "job"
+    PROGRAM = "program"
     OTHER = "other"
 
 
@@ -29,12 +31,62 @@ class OpportunityStatus(StrEnum):
     EXPIRED = "expired"
     ARCHIVED = "archived"
     REJECTED = "rejected"
-    
+
+
 class OpportunitySort(StrEnum):
     RECENT = "recent"
     DEADLINE = "deadline"
     FEATURED = "featured"
 
+
+CATEGORY_ALIASES: dict[str, OpportunityCategory] = {
+    # Français
+    "bourse": OpportunityCategory.SCHOLARSHIP,
+    "stage": OpportunityCategory.INTERNSHIP,
+    "formation": OpportunityCategory.TRAINING,
+    "concours": OpportunityCategory.COMPETITION,
+    "subvention": OpportunityCategory.GRANT,
+    "emploi": OpportunityCategory.JOB,
+    "programme": OpportunityCategory.PROGRAM,
+
+    # Variantes anglaises
+    "scholarships": OpportunityCategory.SCHOLARSHIP,
+    "internships": OpportunityCategory.INTERNSHIP,
+    "fellowships": OpportunityCategory.FELLOWSHIP,
+    "trainings": OpportunityCategory.TRAINING,
+    "competitions": OpportunityCategory.COMPETITION,
+    "hackathons": OpportunityCategory.HACKATHON,
+    "grants": OpportunityCategory.GRANT,
+    "jobs": OpportunityCategory.JOB,
+    "programs": OpportunityCategory.PROGRAM,
+    "programme": OpportunityCategory.PROGRAM,
+    "programmes": OpportunityCategory.PROGRAM,
+}
+
+
+def normalize_opportunity_category(
+    value: Any,
+) -> OpportunityCategory:
+    if isinstance(value, OpportunityCategory):
+        return value
+
+    if not isinstance(value, str):
+        return OpportunityCategory.OTHER
+
+    normalized_value = value.strip().lower()
+
+    if not normalized_value:
+        return OpportunityCategory.OTHER
+
+    try:
+        return OpportunityCategory(normalized_value)
+    except ValueError:
+        return CATEGORY_ALIASES.get(
+            normalized_value,
+            OpportunityCategory.OTHER,
+        )
+
+
 class SourceRead(BaseModel):
     model_config = ConfigDict(from_attributes=True)
 
@@ -70,6 +122,14 @@ class OpportunityListItem(BaseModel):
     verified_at: datetime | None
     source: SourceRead
 
+    @field_validator("category", mode="before")
+    @classmethod
+    def validate_category(
+        cls,
+        value: Any,
+    ) -> OpportunityCategory:
+        return normalize_opportunity_category(value)
+
 
 class OpportunityDetail(OpportunityListItem):
     description: str | None