Merge pull request #420 from rrvrs/issue-379

console errors fix

Author: srbhr

Makefile

@@ -9,7 +9,9 @@ help:
 	@echo "Available targets:"
 	@echo "  setup        Run the setup script to configure the project"
 	@echo "  run-dev      Setup and start the development server (with graceful shutdown)"
-	@echo "  run-prod     Build the project for production"
+	@echo "  build-prod   Build the project for production"
+	@echo "  start-prod   Start the production server (after building)"
+	@echo "  run-prod     Build and start the production server"
 	@echo "  clean        Clean up generated artifacts"
 
 setup:
@@ -20,10 +22,18 @@ run-dev:
 	@echo "🚀 Starting development server…"
 	@bash -c 'trap "echo "\n🛑 Development server stopped"; exit 0" SIGINT; npm run dev'
 
-run-prod:
+build-prod:
 	@echo "📦 Building for production…"
 	@npm run build
 
+start-prod:
+	@echo "🚀 Starting production server…"
+	@bash -c 'trap "echo "\n🛑 Production server stopped"; exit 0" SIGINT; npm run start'
+
+run-prod: build-prod
+	@echo "🚀 Starting production server…"
+	@bash -c 'trap "echo "\n🛑 Production server stopped"; exit 0" SIGINT; npm run start'
+
 clean:
 	@echo "🧹 Cleaning artifacts…"
 	# Add commands to clean build and temp files, e.g.:

apps/backend/app/api/router/v1/resume.py

@@ -21,7 +21,11 @@
     ScoreImprovementService,
     ResumeNotFoundError,
     ResumeParsingError,
+    ResumeValidationError,
     JobNotFoundError,
+    JobParsingError,
+    ResumeKeywordExtractionError,
+    JobKeywordExtractionError,
 )
 from app.schemas.pydantic import ResumeImprovementRequest
 
@@ -72,6 +76,12 @@ async def upload_resume(
             filename=file.filename,
             content_type="md",
         )
+    except ResumeValidationError as e:
+        logger.warning(f"Resume validation failed: {str(e)}")
+        raise HTTPException(
+            status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+            detail=str(e),
+        )
     except Exception as e:
         logger.error(
             f"Error processing file: {str(e)} - traceback: {traceback.format_exc()}"
@@ -163,6 +173,24 @@ async def score_and_improve(
             status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
             detail=str(e),
         )
+    except JobParsingError as e:
+        logger.error(str(e))
+        raise HTTPException(
+            status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
+            detail=str(e),
+        )
+    except ResumeKeywordExtractionError as e:
+        logger.warning(str(e))
+        raise HTTPException(
+            status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+            detail=str(e),
+        )
+    except JobKeywordExtractionError as e:
+        logger.warning(str(e))
+        raise HTTPException(
+            status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+            detail=str(e),
+        )
     except Exception as e:
         logger.error(f"Error: {str(e)} - traceback: {traceback.format_exc()}")
         raise HTTPException(

apps/backend/app/schemas/json/resume_preview.py

@@ -9,7 +9,7 @@
         "linkedin": "string | null",
         "github": "string | null",
     },
-    "summary": "string",
+    "summary": "string | null",
     "experience": [
         {
             "id": 0,
@@ -25,8 +25,8 @@
             "id": 0,
             "institution": "string",
             "degree": "string",
-            "years": "string",
-            "description": "string",
+            "years": "string | null",
+            "description": "string | null",
         }
     ],
     "skills": ["string"],

apps/backend/app/schemas/json/structured_resume.py

@@ -33,19 +33,19 @@
     "Skills": [{"category": "string", "skillName": "string"}],
     "Research Work": [
         {
-            "title": "string",
-            "publication": "string",
-            "date": "YYYY-MM-DD",
-            "link": "string",
-            "description": "string",
+            "title": "string | null",
+            "publication": "string | null",
+            "date": "YYYY-MM-DD | null",
+            "link": "string | null",
+            "description": "string | null",
         }
     ],
     "Achievements": ["string", "..."],
     "Education": [
         {
             "institution": "string",
             "degree": "string",
-            "fieldOfStudy": "string",
+            "fieldOfStudy": "string | null",
             "startDate": "YYYY-MM-DD",
             "endDate": "YYYY-MM-DD",
             "grade": "string",

apps/backend/app/schemas/pydantic/resume_preview.py

@@ -26,13 +26,13 @@ class EducationItem(BaseModel):
     id: int
     institution: str
     degree: str
-    years: str
+    years: Optional[str] = None
     description: Optional[str] = None
 
 
 class ResumePreviewerModel(BaseModel):
     personalInfo: PersonalInfo
-    summary: str
+    summary: Optional[str] = None
     experience: List[ExperienceItem]
     education: List[EducationItem]
     skills: List[str]

apps/backend/app/schemas/pydantic/structured_job.py

@@ -36,6 +36,7 @@ class RemoteStatusEnum(str, enum.Enum):
     ON_SITE = "On-site"
     REMOTE = "Remote"
     NOT_SPECIFIED = "Not Specified"
+    MULTIPLE_LOCATIONS = "Multiple Locations"
 
     @classmethod
     def _missing_(cls, value: object):

apps/backend/app/schemas/pydantic/structured_resume.py

@@ -44,17 +44,17 @@ class Skill(BaseModel):
 
 
 class ResearchWork(BaseModel):
-    title: str
-    publication: str
-    date: str
+    title: Optional[str] = None
+    publication: Optional[str] = None
+    date: Optional[str] = None
     link: Optional[str] = None
     description: Optional[str] = None
 
 
 class Education(BaseModel):
     institution: str
     degree: str
-    field_of_study: str = Field(..., alias="fieldOfStudy")
+    field_of_study: Optional[str] = Field(None, alias="fieldOfStudy")
     start_date: str = Field(..., alias="startDate")
     end_date: str = Field(..., alias="endDate")
     grade: Optional[str] = None

apps/backend/app/services/__init__.py

@@ -4,8 +4,11 @@
 from .exceptions import (
     ResumeNotFoundError,
     ResumeParsingError,
+    ResumeValidationError,
     JobNotFoundError,
     JobParsingError,
+    ResumeKeywordExtractionError,
+    JobKeywordExtractionError,
 )
 
 __all__ = [
@@ -15,5 +18,8 @@
     "JobNotFoundError",
     "ResumeParsingError",
     "ResumeNotFoundError",
+    "ResumeValidationError",
+    "ResumeKeywordExtractionError",
+    "JobKeywordExtractionError",
     "ScoreImprovementService",
 ]

apps/backend/app/services/exceptions.py

@@ -29,14 +29,29 @@ def __init__(self, job_id: Optional[str] = None, message: Optional[str] = None):
         self.job_id = job_id
 
 
-class EmbeddingError(Exception):
+class ResumeValidationError(Exception):
     """
-    Exception raised when there is an error in embedding.
+    Exception raised when structured resume validation fails.
     """
 
-    def __init__(self, message: str = None):
+    def __init__(
+        self,
+        resume_id: Optional[str] = None,
+        validation_error: Optional[str] = None,
+        message: Optional[str] = None,
+    ):
+        if message:
+            # we can use custom message if provided
+            pass
+        elif validation_error:
+            message = f"Resume parsing failed: {validation_error}. Please ensure your resume contains all required information with proper formatting."
+        elif resume_id:
+            message = f"Resume with ID {resume_id} failed validation during structured parsing."
+        else:
+            message = "Resume validation failed during structured parsing."
         super().__init__(message)
-        self.message = message
+        self.resume_id = resume_id
+        self.validation_error = validation_error
 
 
 class ResumeParsingError(Exception):
@@ -64,4 +79,32 @@ def __init__(self, job_id: Optional[str] = None, message: Optional[str] = None):
         elif not message:
             message = "Parsed job not found."
         super().__init__(message)
-        self.resume_id = job_id
+        self.job_id = job_id
+
+
+class ResumeKeywordExtractionError(Exception):
+    """
+    Exception raised when keyword extraction from resume failed or no keywords were extracted.
+    """
+
+    def __init__(self, resume_id: Optional[str] = None, message: Optional[str] = None):
+        if resume_id and not message:
+            message = f"Keyword extraction failed for resume with ID {resume_id}. Cannot proceed with resume improvement without extracted keywords."
+        elif not message:
+            message = "Resume keyword extraction failed. Cannot improve resume without keywords."
+        super().__init__(message)
+        self.resume_id = resume_id
+
+
+class JobKeywordExtractionError(Exception):
+    """
+    Exception raised when keyword extraction from job failed or no keywords were extracted.
+    """
+
+    def __init__(self, job_id: Optional[str] = None, message: Optional[str] = None):
+        if job_id and not message:
+            message = f"Keyword extraction failed for job with ID {job_id}. Cannot proceed with resume improvement without job keywords."
+        elif not message:
+            message = "Job keyword extraction failed. Cannot improve resume without job requirements."
+        super().__init__(message)
+        self.job_id = job_id