An enterprise-grade, open-source Career Operations OS and Recruitment Intelligence Engine built for modern tech professionals and government/bank candidates. Features comprehensive pipeline management, multi-variable post-mortem failure analytics, full account isolation, and an AI Strategic Career Advisor with intelligent SHA-256 state caching.
🌐 Live Production App: https://job-trackerr.vercel.app
- Executive Diagnostics: High-level synthesis of your pipeline momentum, interview conversion ratios, and bottlenecks.
- Govt vs. Corporate Strategy: Dual-track recommendations tailored to Bangladesh Govt/Bank recruitment exams (BPSC, Combined Bank) and Corporate Software Engineering roles.
- Tactical Strengths & Critical Gaps: Actionable SWOT-style insights identifying stage drop-offs and weak technical areas.
- Prioritized Action Plan: Concrete weekly tasks tagged by priority and category.
- ⚡ SHA-256 State-Hash Caching: If no application or post-mortem data has changed, cached insights are returned instantly with zero redundant AI API calls. Automatically invalidates when new data is logged.
- Comprehensive post-interview & exam diagnostic survey covering Corporate Tech stages (Coding, System Design, Behavioral) and Govt/Bank stages (Preliminary MCQ, Written, Viva, Practical).
- Quantifies exam difficulty, time pressure, and self-confidence indices.
- Subject topic gap frequency heatmap, environmental blocker tracking, and preparation duration correlation matrix.
- Prescribed remediation roadmaps with targeted practice strategies.
- Complete tenant data isolation: user-created companies, custom job roles, circulars, applications, and post-mortems belong strictly to the authenticated
UserId. - Shared global templates for standard roles and organizations.
- Role-based JWT security with refresh token rotation and rate-limited endpoints.
- 6 Key Performance Indicator (KPI) metrics cards.
- Conversion velocity funnel with drop-off analytics.
- Recharts visualizations: Weekly Application Velocity, Pipeline Status Donut, Application Portals Breakdown, and Target Role Priorities.
- Graceful empty states with zero dummy placeholders for new accounts.
- Core Framework: React 19 + TypeScript + Vite 8
- Styling & Motion: TailwindCSS v4, Framer Motion (
framer-motion), Lenis Smooth Scroll, Lucide Icons - State & Data: React Query (TanStack Query v5), Zustand, Axios
- Visualization: Recharts Data Visualization Suite
- Tooling & Test Runner: Vitest, React Testing Library, ESLint
- Core Framework: ASP.NET Core 10.0 Web API
- AI Engine: Google Gemini API (
gemini-3.6-flash) with SHA-256 data signature caching - Database & ORM: PostgreSQL (Local / Neon Cloud) via Entity Framework Core 10
- Security & Auth: ASP.NET Core Identity, JWT Bearer Tokens, Rate Limiting, Security Headers
- Testing: xUnit, Moq, EF Core InMemory Provider (49 unit tests)
- .NET 10.0 SDK
- Node.js (
>= 20.0) or Bun (>= 1.1) - PostgreSQL (or use Docker / Neon Cloud)
- Google Gemini API Key (Optional for AI Advisor)
git clone https://github.com/maruf-pfc/job-tracker.git
cd job-tracker
cp .env.example .envEdit .env to configure your DATABASE_URL, JWT_KEY, and GEMINI_API_KEY.
cd server/JobTracker.API
dotnet restore
dotnet run- Swagger API Docs:
http://localhost:5104/swagger - Entity Framework automatically applies pending migrations on startup!
cd client
bun install
bun run dev- Open
http://localhost:5173in your browser!
dotnet test JobTracker.slnxcd client
bun run testcd client
bun run lint
bun run buildThe unified full-stack image (React Client + .NET 10 Web API) is available on Docker Hub: hub.docker.com/r/marufsarker/job-tracker
# Pull the latest v0.1.0 full-stack image
docker pull marufsarker/job-tracker:v0.1.0
# Run container with your PostgreSQL database
docker run -d \
-p 8080:8080 \
--name job-tracker \
-e DATABASE_URL="Host=your_postgres_host;Database=jobtracker_db;Username=postgres;Password=your_password;" \
-e JWT_KEY="your-secure-32-plus-characters-secret-key" \
marufsarker/job-tracker:v0.1.0- Access full web app at
http://localhost:8080
Run the full production stack with local PostgreSQL using Docker Compose:
docker compose up --build -d- Frontend Web App:
http://localhost:3000 - Backend Web API:
http://localhost:5104 - PostgreSQL Database:
localhost:5432
- 🏗 System Architecture & Design: Clean architecture, AI caching subsystem, multi-tenant isolation.
- 🛡 Refactoring & Hardening Report: Senior audit findings, SSRF mitigation, exception taxonomy, and test expansion report.
- 🗄 Database Model & Schema: PostgreSQL ER Diagram, table constraints, indices, and UTC timestamp mappings.
- 🔌 REST API Specifications: Endpoints reference, AI Advisor endpoints, request/response DTO schemas.
- 🛠 Troubleshooting & Bug Fixes: Resolution log (React hook ordering, state caching, user isolation).
- 🚀 Deployment & Webhooks Guide: Docker Compose orchestration, Vercel monorepo settings, n8n integrations.
- ⚡ Coolify Deployment Guide: Self-hosting setup on Coolify v4.
This project is licensed under the MIT License.