mohamed-imran-12/resume-analyser

Purpose and deployment

Resume Analyzer is a full-stack application that accepts resumes, uses Gemini AI to produce evaluation/skill/improvement insights, and retrieves job suggestions from Adzuna. It also supports local and Google authentication, email verification, password reset, and analysis history. Spring Boot is the production entry point and serves the compiled React SPA.

• src/main/java/com/ai/Resume/analyser/ResumeAnalyserApplication.java

• src/main/resources/static/index.html

• Dockerfile, render.yaml

Client application

The editable frontend is a Vite/React SPA. main.jsx mounts the app; shared application context coordinates client-side state. Pages cover landing, login, password reset, resume upload, and analysis result views. Production assets are copied into Spring Boot static resources rather than hosted separately.

• frontend src/src/main.jsx

• frontend src/src/App.jsx

• frontend src/src/appcontext.jsx

• frontend src/src/upload/upload.jsx

• frontend src/src/analyse/analyse.jsx

HTTP and application boundary

Spring MVC controllers expose the backend surface and separate general application, frontend/static routing, and security-related flows. Service classes hold the orchestration boundary between requests, persistence, AI/job APIs, and authentication outcomes.

• src/main/java/com/ai/Resume/analyser/controller/appController.java

• src/main/java/com/ai/Resume/analyser/controller/securityController.java

• src/main/java/com/ai/Resume/analyser/service/appService.java

• src/main/java/com/ai/Resume/analyser/service/securityService.java

Resume analysis and job enrichment

The primary user flow is frontend upload/request → application service → Gemini analysis → structured result DTO returned to the UI. The same application layer integrates Adzuna job search and maps external job/company/location data into internal models. Gemini model/API behavior is centralized in the application service, making it the replacement point for a different AI provider.

• src/main/java/com/ai/Resume/analyser/service/appService.java

• src/main/java/com/ai/Resume/analyser/model/resultsDto.java

• src/main/java/com/ai/Resume/analyser/model/JobSearchResponse.java

• src/main/java/com/ai/Resume/analyser/model/Job.java

Identity and access control

Spring Security configuration and a JWT filter protect authenticated backend operations. Authentication can use credentials or Google OAuth2; JWT creation/validation is isolated in the JWT service. Success/failure handlers likely bridge OAuth/security outcomes into application redirects or responses.

• src/main/java/com/ai/Resume/analyser/configuration/securityConfiguration.java

• src/main/java/com/ai/Resume/analyser/jwt/jwtFilter.java

• src/main/java/com/ai/Resume/analyser/jwt/jwtService.java

• src/main/java/com/ai/Resume/analyser/service/successHandler.java

Verification and recovery

Registration/email verification and password-reset workflows persist OTP-related state, invoke Brevo through the mail service, and render dedicated HTML email templates. This is a distinct external-service boundary from core authentication.

• src/main/java/com/ai/Resume/analyser/mail/mailService.java

• src/main/java/com/ai/Resume/analyser/repository/otpVerifyRepo.java

• src/main/resources/templates/verify-otp.html

• src/main/resources/templates/reset-otp.html

Persistence and infrastructure

MySQL is the required datastore, accessed through repositories for users, OTP verification, and prior analysis/history records. Runtime configuration supplies MySQL, Google OAuth, Gemini, Brevo, Adzuna, and JWT secrets. Maven builds the Java runtime; Node/Vite builds frontend artifacts.

• src/main/java/com/ai/Resume/analyser/repository/usersTableRepo.java

• src/main/java/com/ai/Resume/analyser/repository/prevTable.java

• src/main/java/com/ai/Resume/analyser/model/usersTable.java

• src/main/resources/application.properties

• pom.xml