Merge pull request #11 from HardMax71/dev

Dev

Author: HardMax71

backend/backend/urls.py

@@ -1,7 +1,5 @@
-from typing import Any
-
 from django.contrib import admin
-from django.http import HttpResponse
+from django.http import HttpRequest, HttpResponse
 from django.urls import include, path
 from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView
 from prometheus_client import CONTENT_TYPE_LATEST, generate_latest
@@ -10,7 +8,7 @@
 from processor.services.job_service import JobService
 
 
-async def metrics_view(_request: Any) -> HttpResponse:
+async def metrics_view(_request: HttpRequest) -> HttpResponse:
     try:
         job_service = JobService()
         stats = await job_service.get_queue_stats()

backend/core/domain/resume.py

@@ -63,10 +63,6 @@ class Contact(BaseModel):
     email: str
     phone: str | None = None
     links: ContactLinks | None = None
-    # Direct access for legacy compatibility
-    linkedin: str | None = None
-    github: str | None = None
-    website: str | None = None
 
 
 class WorkAuthorization(BaseModel):
@@ -311,9 +307,6 @@ class LanguageProficiency(BaseModel):
     language: Language
     self_assessed: str
     cefr: str
-    # Legacy/alternative field names
-    name: str | None = None
-    level: str | None = None
 
     @model_validator(mode="before")
     @classmethod
@@ -331,10 +324,6 @@ class Award(BaseModel):
     position: str | None = None
     description: str | None = None
     url: str | None = None
-    # Legacy/alternative field names
-    title: str | None = None
-    issuer: str | None = None
-    date: str | None = None
 
 
 class ScientificContribution(BaseModel):
@@ -372,15 +361,6 @@ class Resume(BaseModel):
     language_proficiency: list[LanguageProficiency] = Field(default_factory=list)
     awards: list[Award] = Field(default_factory=list)
     scientific_contributions: list[ScientificContribution] = Field(default_factory=list)
-    # Legacy flat fields for backward compatibility
-    name: str | None = None
-    email: str | None = None
-    phone: str | None = None
-    location: Location | None = None
-    linkedin: str | None = None
-    github: str | None = None
-    website: str | None = None
-    resume_lang: str | None = None
 
     @model_validator(mode="before")
     @classmethod

backend/processor/views.py

@@ -1,14 +1,13 @@
 import logging
-from typing import Any
 
 from adrf.views import APIView
 from django.conf import settings
 from django.core.cache import cache as django_cache
 from django.utils.decorators import method_decorator
 from django.views.decorators.cache import cache_page
+from drf_spectacular.extensions import OpenApiSerializerExtension
 from drf_spectacular.utils import OpenApiParameter, OpenApiResponse, extend_schema
-from pydantic import BaseModel, Field
-from rest_framework import status
+from rest_framework import serializers, status
 from rest_framework.exceptions import NotFound
 from rest_framework.pagination import LimitOffsetPagination
 from rest_framework.request import Request
@@ -24,13 +23,65 @@
 THROTTLE_RATES: dict[str, str] = settings.REST_FRAMEWORK.get("DEFAULT_THROTTLE_RATES", {})  # type: ignore[assignment]
 
 
-class ResumeListResponse(BaseModel):
-    """Paginated list of resumes."""
+class QueueMetricsSerializer(serializers.Serializer):
+    stream_length = serializers.IntegerField(help_text="Total items in Redis stream")
+    queue_length = serializers.IntegerField(help_text="Pending items in queue")
+    scheduled_retries = serializers.IntegerField(help_text="Items scheduled for retry")
+    active_jobs = serializers.IntegerField(help_text="Currently processing jobs")
+    redis_memory_usage = serializers.IntegerField(help_text="Redis memory usage in bytes")
 
-    count: int = Field(description="Total number of resumes")
-    next: str | None = Field(default=None, description="Next page URL")
-    previous: str | None = Field(default=None, description="Previous page URL")
-    results: list[ResumeResponse] = Field(description="Resumes for current page")
+
+class ProcessingConfigSerializer(serializers.Serializer):
+    text_llm_provider = serializers.CharField(help_text="LLM provider for text extraction")
+    text_llm_model = serializers.CharField(help_text="LLM model for text extraction")
+    ocr_llm_provider = serializers.CharField(help_text="LLM provider for OCR")
+    ocr_llm_model = serializers.CharField(help_text="LLM model for OCR")
+    generate_review = serializers.BooleanField(help_text="Whether AI review is enabled")
+    store_in_db = serializers.BooleanField(help_text="Whether to store in database")
+
+
+class HealthResponseSerializer(serializers.Serializer):
+    status = serializers.CharField(help_text="Service status: ok, degraded, or down")
+    service = serializers.CharField(help_text="Service name")
+    queue = QueueMetricsSerializer()
+    processing_config = ProcessingConfigSerializer()
+
+
+class FileTypeConfigSerializer(serializers.Serializer):
+    """Configuration for a single file type."""
+
+    media_type = serializers.CharField(help_text="MIME type")
+    category = serializers.CharField(help_text="File category (document, image, etc)")
+    max_size_mb = serializers.IntegerField(help_text="Maximum file size in MB")
+    parser = serializers.CharField(help_text="Parser used for this file type")
+
+
+class FileConfigResponseSerializer(serializers.Serializer):
+    """Dictionary of file type configurations keyed by extension."""
+
+    def to_representation(self, instance: dict) -> dict:
+        """Return the dict as-is since keys are dynamic extensions."""
+        return instance
+
+
+class FileConfigResponseExtension(OpenApiSerializerExtension):
+    """Extension to generate proper additionalProperties schema for FileConfigResponse."""
+
+    target_class = "processor.views.FileConfigResponseSerializer"
+
+    def map_serializer(self, auto_schema, direction):
+        """Generate object schema with additionalProperties pointing to FileTypeConfig."""
+        return {
+            "type": "object",
+            "additionalProperties": auto_schema.resolve_serializer(FileTypeConfigSerializer, direction).ref,
+        }
+
+
+class ResumeListResponse(serializers.Serializer):
+    count = serializers.IntegerField(help_text="Total number of resumes")
+    next = serializers.CharField(allow_null=True, help_text="Next page URL")
+    previous = serializers.CharField(allow_null=True, help_text="Previous page URL")
+    results = serializers.ListField(help_text="Resumes for current page")
 
 
 class ResumeCollectionView(APIView):
@@ -135,7 +186,7 @@ class HealthView(APIView):
     """Service health status endpoint."""
 
     @extend_schema(
-        responses={200: OpenApiResponse(description="Health status including queue stats and configuration")},
+        responses={200: HealthResponseSerializer},
         description="Get service health status. Returns system status, queue statistics, and processing configuration.",
     )
     async def get(self, request: Request) -> Response:
@@ -159,11 +210,11 @@ class FileConfigView(APIView):
     """File upload configuration endpoint."""
 
     @extend_schema(
-        responses={200: OpenApiResponse(description="File upload configuration")},
-        description="Get file upload configuration. Returns allowed extensions, MIME types, max sizes, and categories.",
+        responses={200: FileConfigResponseSerializer},
+        description="Get file upload configuration. Returns allowed extensions, MIME types, max sizes, and categories. Keys are file extensions.",
     )
     @method_decorator(cache_page(60 * 60 * 24))
-    def get(self, request: Any) -> Response:
+    def get(self, request: Request) -> Response:
         cache_key = "file_config_v1"
         cached = django_cache.get(cache_key)
         if cached:

backend/rag/views.py

@@ -6,6 +6,7 @@
 from rest_framework.request import Request
 from rest_framework.response import Response
 
+from core.domain.rag import CandidateComparison, InterviewQuestionSet, JobMatchExplanation
 from core.metrics import RAG_GENERATION_COUNT, RAG_GENERATION_DURATION
 
 from .serializers import (
@@ -23,7 +24,7 @@ class ExplainMatchView(APIView):
     @extend_schema(
         request=ExplainMatchRequestSerializer,
         responses={
-            200: OpenApiResponse(description="Structured match explanation"),
+            200: JobMatchExplanation,
             404: OpenApiResponse(description="Resume not found"),
         },
         description="Generate AI-powered explanation of candidate-job fit with structured strengths, concerns, and recommendations.",
@@ -53,7 +54,7 @@ class CompareCandidatesView(APIView):
     @extend_schema(
         request=CompareCandidatesRequestSerializer,
         responses={
-            200: OpenApiResponse(description="Structured candidate comparison"),
+            200: CandidateComparison,
             400: OpenApiResponse(description="Invalid request"),
             404: OpenApiResponse(description="One or more resumes not found"),
         },
@@ -85,7 +86,7 @@ class InterviewQuestionsView(APIView):
     @extend_schema(
         request=InterviewQuestionsRequestSerializer,
         responses={
-            200: OpenApiResponse(description="Structured interview question set"),
+            200: InterviewQuestionSet,
             404: OpenApiResponse(description="Resume not found"),
         },
         description="Generate 6-12 interview questions tailored to candidate's background, with follow-ups and assessment criteria.",

backend/search/serializers.py

@@ -234,6 +234,7 @@ class SearchResponseSerializer(serializers.Serializer):
     results = SearchResultSerializer(many=True, help_text="Search results")
     query = serializers.CharField(required=False, allow_null=True, allow_blank=True, help_text="Original query")
     search_type = serializers.CharField(help_text="Type of search performed")
+    total_found = serializers.IntegerField(help_text="Total number of matching results found")
 
 
 class FilterOptionSerializer(serializers.Serializer):
@@ -255,7 +256,10 @@ class CountryOptionSerializer(serializers.Serializer):
 
 class EducationLevelOptionSerializer(serializers.Serializer):
     level = serializers.CharField(help_text="Education level")
-    statuses = serializers.ListField(child=serializers.CharField(), help_text="Education statuses for this level")
+    statuses = serializers.ListField(
+        child=serializers.ChoiceField(choices=[status.value for status in EducationStatus]),
+        help_text="Education statuses for this level",
+    )
     resume_count = serializers.IntegerField(help_text="Number of resumes with this level")
 
 

frontend/src/App.tsx

@@ -1,4 +1,4 @@
-import { Route, Routes, useLocation } from "react-router-dom";
+import { Route, Routes } from "react-router-dom";
 import Header from "./components/Header";
 import Footer from "./components/Footer";
 import PersistentSelectionBar from "./components/PersistentSelectionBar";

frontend/src/api/generated/sdk.gen.ts

@@ -6,7 +6,7 @@ import type { V1ConfigFileTypesRetrieveError, V1ConfigFileTypesRetrieveResponse,
 export const client = createClient(createConfig());
 
 /**
- * Get file upload configuration. Returns allowed extensions, MIME types, max sizes, and categories.
+ * Get file upload configuration. Returns allowed extensions, MIME types, max sizes, and categories. Keys are file extensions.
  */
 export const v1ConfigFileTypesRetrieve = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => {
     return (options?.client ?? client).get<V1ConfigFileTypesRetrieveResponse, V1ConfigFileTypesRetrieveError, ThrowOnError>({