mohdmusheer/resumegap-ai

By mohdmusheer

•Updated 20 days ago

AI resume analyzer with skill-gap detection and recommendations.

Image

Machine learning & AI

Data science

Web servers

Overview Tags

mohdmusheer/resumegap-ai repository overview

⁠ResumeGap AI

AI-powered resume analyzer that finds skill gaps and suggests resume improvements, resources, and projects.

⚠️ This project uses Razorpay Test Mode and does not process real payments.

⁠Live Demo

🌐 Live: LIVE_URL⁠ ←

🐳 Docker Hub: hub.docker.com/r/mohdmusheer/resumegap-ai⁠

⁠Features

Feature	Tier
Match Score (0–100%)	Free
Strong Skills Detected	Free
Missing Skills List	Free
ATS Keyword Coverage	Free
Resume Section Checklist	Free
Job Fit Explanation	Free
3 Basic Recommendations	Free
Exact Resume Changes per Section	Premium (₹10)
Detailed Skill Gap Analysis	Premium
5 Project Recommendations	Premium
30-Day Learning Roadmap	Premium
RAG Learning Resources	Premium
Interview Preparation (15 questions)	Premium

Graceful degradation: The app runs fully without Razorpay keys. When payment is clicked, it shows "Razorpay not connected" instead of crashing.

⁠Tech Stack

Framework: ASP.NET Core 10 MVC
AI Provider: Groq API — model openai/gpt-oss-20b
PDF Extraction: PdfPig 0.1.16
Payment: Razorpay .NET SDK 3.3.2 (Test Mode)
RAG: Keyword-based retrieval from local JSON knowledge base
State: ISession in-memory (no database)
Frontend: Bootstrap 5 + Bootstrap Icons + Vanilla JS

⁠Architecture

Browser
  │
  ├── GET  /                      → Landing Page
  ├── GET  /Analysis              → Upload Form
  ├── POST /Analysis/Free         → PDF → Groq → Free Result → Session
  ├── GET  /Analysis/Result       → Free Result + Paywall
  ├── POST /Payment/CreateOrder   → Razorpay Orders API → orderId
  ├── [Razorpay Checkout opens]
  ├── POST /Payment/Verify        → HMAC-SHA256 → Premium Analysis → Session
  ├── GET  /Analysis/Premium      → Premium Dashboard (session-gated)
  └── POST /Payment/Webhook       → Webhook Signature Validation

⁠Environment Variables

Variable	Required	Default	Description
`GROQ__APIKEY`	✅ Yes	(empty)	Groq API key from console.groq.com⁠
`RAZORPAY__KEYID`	⬜ Optional	(empty)	Razorpay public key — `rzp_test_...`
`RAZORPAY__SECRETKEY`	⬜ Optional	(empty)	Razorpay secret key
`GROQ__MODEL`	⬜ Optional	`openai/gpt-oss-20b`	Groq model name
`GROQ__BASEURL`	⬜ Optional	`https://api.groq.com/openai/v1`	Groq API base URL
`RAZORPAY__AMOUNTINPAISE`	⬜ Optional	`1000`	Payment amount (paise) — 1000 = ₹10
`RAZORPAY__CURRENCY`	⬜ Optional	`INR`	Payment currency
`ASPNETCORE_ENVIRONMENT`	⬜ Optional	`Production`	`Development` or `Production`

Note: ASP.NET Core uses __ (double underscore) to separate config sections in env vars.
e.g., Groq:ApiKey in JSON → GROQ__APIKEY as env var.

⁠🐳 Docker Deployment

⁠Option 1 — Pull from Docker Hub

docker pull YOUR_USERNAME/resumegap-ai:latest

⁠Option 2 — Build locally

git clone https://github.com/YOUR_USERNAME/ResumeGap-AI.git
cd "ResumeGap AI"
docker build -t resumegap-ai .

⁠Run with `docker run` (3 key env vars)

docker run -d \
  -p 8080:8080 \
  -e GROQ__APIKEY=gsk_your_groq_key \
  -e RAZORPAY__KEYID=rzp_test_your_key \
  -e RAZORPAY__SECRETKEY=your_secret \
  --name resumegap-ai \
  resumegap-ai:latest

Without Razorpay (app still works, payment shows "not connected"):

docker run -d \
  -p 8080:8080 \
  -e GROQ__APIKEY=gsk_your_groq_key \
  --name resumegap-ai \
  resumegap-ai:latest

All 7 environment variables (full control):

docker run -d \
  -p 8080:8080 \
  -e GROQ__APIKEY=gsk_your_groq_key \
  -e GROQ__MODEL=openai/gpt-oss-20b \
  -e GROQ__BASEURL=https://api.groq.com/openai/v1 \
  -e RAZORPAY__KEYID=rzp_test_your_key \
  -e RAZORPAY__SECRETKEY=your_secret \
  -e RAZORPAY__AMOUNTINPAISE=1000 \
  -e RAZORPAY__CURRENCY=INR \
  --name resumegap-ai \
  resumegap-ai:latest

Then open: http://localhost:8080⁠

⁠Run with Docker Compose (recommended)

Step 1 — Copy the env template:

cp .env.example .env

Step 2 — Edit .env with your keys:

GROQ__APIKEY=gsk_your_groq_key
RAZORPAY__KEYID=rzp_test_your_key
RAZORPAY__SECRETKEY=your_secret

Step 3 — Start:

docker compose up -d

Open: http://localhost:8080⁠

Stop:

docker compose down

⁠Build and push to Docker Hub

docker build -t YOUR_USERNAME/resumegap-ai:latest .
docker push YOUR_USERNAME/resumegap-ai:latest

⁠Running Locally (without Docker)

cd "e:\dotnet\ResumeGap AI"
dotnet run

Open: https://localhost:5001⁠ or http://localhost:5000⁠

Credentials are read from appsettings.json locally.

⁠Razorpay Test Mode

⁠Test Card

Field	Value
Card Number	`4111 1111 1111 1111`
Expiry	Any future date
CVV	Any 3 digits
OTP	`1234`

⁠Payment Flow

1. Click "Unlock for ₹10"
2. Browser → POST /Payment/CreateOrder (amount from server, never browser)
3. Server → Razorpay Orders API → returns orderId
4. Browser opens Razorpay Checkout (only public KeyId used)
5. Complete test payment
6. Browser → POST /Payment/Verify {payment_id, order_id, signature}
7. Server: cross-checks orderId + HMAC-SHA256 verification
8. Only on success: runs premium analysis, sets session flag
9. Redirects to Premium Dashboard

⁠How Groq AI Works

Calls POST /chat/completions with response_format: { type: "json_object" }
System prompt instructs exact JSON schema — no extra text
Response deserialized into strongly typed C# DTOs
Markdown code fences automatically stripped
Fallback result returned on failure — never crashes

⁠How RAG Works

No vector database — lightweight keyword matching:

Free analysis identifies missing skills
IRagService searches Data/skills.json, Data/resources.json, Data/projects.json
Skill aliases enable fuzzy matching (e.g., EF Core → Entity Framework Core)
Matching resources injected server-side into Groq premium prompt
AI explicitly instructed: "use these URLs, do not invent new ones"

Future: Replace with Qdrant/Chroma vector database for semantic search.

⁠Security Notes

Concern	Implementation
CSRF	`[AutoValidateAntiforgeryToken]` global filter
Payment amount	Always from `IOptions<RazorpayOptions>` — never from browser
Signature	HMAC-SHA256 with `CryptographicOperations.FixedTimeEquals`
SecretKey	Never sent to browser — only public `KeyId` in JS
Resume storage	`MemoryStream` only — never written to disk
API key logging	Structured logging — keys never appear in logs
Premium access	Session flag only set after server-side HMAC verification

⁠No Database

All state is stored in ISession (in-memory, cookie-based):

Free analysis result (JSON)
Premium analysis result (JSON)
Resume text (for premium reprocessing)
Payment verified flag
Razorpay order ID (for cross-check)

Sessions expire after 2 hours. Nothing persisted across server restarts.

⁠Project Structure

ResumeGap AI/
├── Controllers/           HomeController, AnalysisController, PaymentController
├── Models/                Analysis, Payment, Rag DTOs
├── Services/              AI, Resume, Analysis, Rag, Payment services
├── Options/               RazorpayOptions, GroqOptions
├── Data/                  skills.json, resources.json, projects.json
├── Views/                 Landing, Upload, Result, Premium
├── wwwroot/               site.css, analysis.js, payment.js
├── .env.example           ← copy to .env for docker-compose
├── docker-compose.yml
├── Dockerfile
└── README.md

⁠Future Improvements

Vector database (Qdrant) for semantic RAG
PostgreSQL for payment history persistence
User accounts + email report delivery
Cover letter generator
LinkedIn profile analyzer
Multi-language support

Tag summary

Recent tags

Content type

Image

Digest

sha256:137beadfe…

Size

100.2 MB

Last updated

20 days ago

docker pull mohdmusheer/resumegap-ai