cristian/hermes-2026-07-08-job-tracker
Watch
1
0
Fork
You've already forked hermes-2026-07-08-job-tracker
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Migrated from GitHub: hermes-2026-07-08-job-tracker
3 commits 1 branch 0 tags 261 KiB
  • TypeScript 89.3%
  • HTML 8.6%
  • CSS 2.1%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Hermes 47d6d90bdf feat(web): add Angular 22 frontend with 11 lazy routes (dashboard, applications, companies, interviews, settings)
2026-07-08 02:25:12 +00:00
apps feat(web): add Angular 22 frontend with 11 lazy routes (dashboard, applications, companies, interviews, settings) 2026-07-08 02:25:12 +00:00
docs docs: add README, architecture docs, .env.example, and .gitignore 2026-07-08 02:25:11 +00:00
.env.example docs: add README, architecture docs, .env.example, and .gitignore 2026-07-08 02:25:11 +00:00
.gitignore docs: add README, architecture docs, .env.example, and .gitignore 2026-07-08 02:25:11 +00:00
README.md docs: add README, architecture docs, .env.example, and .gitignore 2026-07-08 02:25:11 +00:00

README.md

Hermes Job Tracker

AI-Powered Job Application Tracker — Track and optimize your job search with AI-powered resume analysis, cover letter generation, and full application pipeline management.

Features

  • Application Pipeline — 8-status kanban workflow (saved → applied → screening → interview → offer → accepted/rejected/withdrawn)
  • AI Match Analysis — Resume vs. job description fit scoring with strengths, gaps, and suggestions
  • AI Cover Letter Generation — Tailored cover letters with tone/length options, version history
  • Dashboard — KPI cards, status distribution chart, upcoming interviews, activity feed
  • Company Management — Directory with search, contacts, and related applications
  • Interview Preparation — Schedule interviews, prep notes, common questions, progress tracking
  • Dark Mode — Full theme support with CSS variable system
  • SSE Real-Time — Live dashboard updates on application status changes

Stack

Layer Technology
Frontend Angular 22 (signals, zoneless, standalone)
Styling Tailwind CSS v4 (dark mode via CSS variables)
Backend NestJS 11 (JWT Auth, Swagger, TypeORM)
Database SQLite (better-sqlite3) — Neon/PostgreSQL-compatible schema
AI Strategy Pattern (OpenAI + local fallback)
Testing Jest (unit tests)

Architecture

2026-07-08-job-tracker/
├── apps/
│   ├── api/          → NestJS backend (12 modules)
│   └── web/          → Angular frontend (11 lazy routes)
├── docs/             → Documentation
├── .gitignore
├── .env.example
└── README.md

Prerequisites

  • Node.js 22+
  • npm 10+

Local Setup

  1. Clone and install:
cd apps/api && npm install
cd ../web && npm install
cd ../..
  1. Environment variables:

Copy .env.example to apps/api/.env and configure:

  • JWT_SECRET — A random secret string for JWT signing
  • DATABASE_PATH=data/db.sqlite — SQLite database path
  • PORT=3000 — API server port
  • FRONTEND_URL=http://localhost:4200 — Frontend URL for CORS
  • OPENAI_API_KEY — Optional: for LLM-powered AI features
  1. Start the API:
cd apps/api
npm run start:dev
# API at http://localhost:3000
# Swagger docs at http://localhost:3000/api/docs
  1. Start the frontend:
cd apps/web
npm run start
# Frontend at http://localhost:4200
  1. Login with seeded demo users:
  • alice@example.com / password123
  • bob@example.com / password123

Build

cd apps/api && npm run build
cd apps/web && node_modules/.bin/ng build

Roadmap

  • LinkedIn CSV import
  • Email follow-up reminders
  • CSV/PDF export
  • Company comparison view
  • Real OpenAI API integration (via Strategy Pattern)
  • Neon/PostgreSQL deployment
  • CI/CD pipeline