TrackJobs API

A RESTful backend API for the TrackJobs application — a job application tracking system built with NestJS, TypeScript, and PostgreSQL.

Live Demo

https://trackjobs-api.onrender.com

Service spins down after inactivity on free tier. First request may take ~30 seconds.

Tech Stack

• Framework: NestJS + TypeScript
• Database: PostgreSQL (Supabase)
• ORM: TypeORM
• Auth: JWT (httpOnly cookies) + Refresh Token
• AI: Claude API (Anthropic)
• Logging: Winston
• Documentation: Swagger / OpenAPI
• Containerization: Docker Compose (local development)

Features

• JWT authentication with httpOnly cookies
• Refresh token support with "Remember Me" option
• Full CRUD for job applications
• Kanban-style status management (Applied, Interview, Offer, Rejected)
• Route protection with Guards
• Global exception filter with standardized error responses
• Request/response logging with Winston
• Input validation with class-validator and DTOs
• API documentation with Swagger UI
• CORS configuration for cross-origin requests
• Claude AI-powered CV analysis — compatibility scoring, strengths, weaknesses, and actionable recommendations

Coming Soon

• Cover letter generation with streaming response
• Role-based access control (RBAC)
• Database migrations
• Unit and E2E tests

Architecture

src/
├── common/
│   ├── decorators/
│   ├── filters/
│   ├── guards/
│   ├── interceptors/
│   └── logger/
├── config/
├── modules/
│   ├── ai/
│   ├── applications/
│   ├── auth/
│   └── users/
├── app.module.ts
└── main.ts

Getting Started

Prerequisites

• Node.js 18+
• Docker & Docker Compose
• npm

Installation

git clone https://github.com/fffset/trackjobs-api
cd trackjobs-api
npm install

Environment Variables

Create a .env file in the root directory:

DATABASE_URL=postgresql://user:password@host:5432/dbname
JWT_SECRET=your_jwt_secret
REFRESH_TOKEN_SECRET=your_refresh_secret
NODE_ENV=development
FRONTEND_URL=http://localhost:3000
ANTHROPIC_API_KEY=your_anthropic_api_key
ANTHROPIC_MODEL=claude-sonnet-4-6

Running Locally

# Start PostgreSQL with Docker
docker-compose up -d

# Start the API
npm run start:dev

API will be available at http://localhost:8000

API Documentation

Swagger UI available at http://localhost:8000/api/docs

API Endpoints

Auth

Method	Endpoint	Description
POST	/auth/register	Register new user
POST	/auth/login	Login
POST	/auth/logout	Logout
POST	/auth/refresh	Refresh access token
GET	/auth/me	Get current user

Applications

Method	Endpoint	Description
GET	/applications	Get all applications
POST	/applications	Create application
PATCH	/applications/:id	Update application
DELETE	/applications/:id	Delete application

AI

Method	Endpoint	Description
POST	/ai/analyze-cv	Analyze CV against job description
POST	/ai/cover-letter	Generate cover letter (streaming)

Deployment

Deployed on Render with Supabase PostgreSQL.