🚀 TalentBridgePro

A full-stack recruitment and applicant tracking platform built with ASP.NET Core, MVC, PostgreSQL, and AI-assisted hiring features.

---

✨ Why TalentBridgePro?

TalentBridgePro connects Applicants, Recruiters, and Admins in one workflow-driven platform. It supports secure authentication, job lifecycle management, ATS-based resume scoring, and real-time notifications for a modern hiring experience.

🎯 Features

• 👥 Multi-role flows: User, Applicant, Recruiter, Admin, Super Admin
• 🔐 JWT authentication and role-aware authorization
• 📄 Applicant profile management (education, experience, certificates)
• 💼 Recruiter job lifecycle (create, edit, publish, review applications)
• 🔎 Elasticsearch-powered search and recommendations
• 🔔 Real-time notifications using SignalR + RabbitMQ + Redis
• 🤖 ATS resume parsing and scoring with Python + Hugging Face model
• 📧 OTP/email flows for verification and password reset

🧰 Tech Stack

• Backend API: ASP.NET Core Web API (.NET 8)
• Frontend: ASP.NET Core MVC (.NET 8), Razor Views, JS/CSS in wwwroot
• Data: PostgreSQL (Npgsql)
• Search: Elasticsearch (NEST)
• Messaging: RabbitMQ
• Caching: Redis (StackExchange.Redis)
• Realtime: SignalR
• AI/ML: Python (transformers, torch) for Resume NER
• Docs: Swagger / OpenAPI

⚙️ Prerequisites

Before running the project, install:

• .NET SDK 8+
• PostgreSQL
• Redis
• RabbitMQ
• Elasticsearch
• Python 3.10+

🛠️ Installation

1. Clone the repository

   git clone https://github.com/Dev-Raval/TalentBridgePro.git
   cd TalentBridgePro
   

2. Restore .NET dependencies

   dotnet restore TalentBridgePro.sln
   

3. Configure local app settings
   • Add local values for DB, JWT, mail, and service credentials.
   • Never commit secrets to GitHub.
4. Install ATS Python dependencies

   cd ATS/ResumeNER
   pip install -r requirements.txt
   

5. Download model artifacts into ATS/ResumeNER/model/.

▶️ Run the Project

1) Run API

cd API
dotnet run

2) Run MVC

cd MVC
dotnet run

Open the MVC URL in browser and ensure API base URL/port is correctly configured.

🗂️ Folder Structure

TalentBridgePro/
├── TalentBridgePro.sln
├── API/                      # ASP.NET Core Web API
│   ├── Program.cs
│   ├── Controller/
│   ├── Services/
│   ├── Interfaces/
│   └── Implementations/
├── MVC/                      # ASP.NET Core MVC frontend
│   ├── Program.cs
│   ├── Controllers/
│   ├── Views/
│   └── wwwroot/
├── Repositories/             # Data access + repository implementations
│   ├── Interfaces/
│   ├── Implementations/
│   └── Models/
├── ATS/                      # Python ATS / Resume NER support
│   └── ResumeNER/
└── scripts/sql docs          # setup scripts and helper SQL files

🖼️ Screenshots

Create a folder docs/screenshots/ and add images like:

• 🏠 Home Page
• 👤 Applicant Dashboard
• 🧑‍💼 Recruiter Dashboard
• 🛡️ Admin Dashboard
• 📊 ATS Score Screen

Tip: Add markdown image links after uploading screenshots for a visually rich GitHub page.

🧭 Future Improvements

• 🐳 Docker Compose for one-command local setup
• 🔁 CI/CD with GitHub Actions
• 🔒 Secret management via environment variables / secret vault
• ✅ Stronger unit + integration test coverage
• 📈 Observability (structured logs + traces + health checks)
• 🧱 Better modularization for long-term maintainability

👨‍💻 Author

• Raval
• GitHub: https://github.com/Dev-Raval
• Repository: https://github.com/Dev-Raval/TalentBridgePro

---

💙 Support

If you like this project, consider giving it a ⭐ on GitHub.