History

Shaheer Sarfaraz 6e771ce728

* initial implementation

* onboarding doesn't pop until invalid values are present

* link to job page

* proactive inputs working slightly

* onboarding gate reinstated

* better proactive buttons

* fully manual tracking for now.

* edit and delete timeline events

* status showing correctly

* tests update

* tests

* Update orchestrator/src/server/services/applicationTracking.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update orchestrator/src/server/services/applicationTracking.test.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update orchestrator/src/server/services/applicationTracking.test.ts

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update orchestrator/src/client/pages/job/Timeline.tsx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update orchestrator/src/client/pages/JobPage.tsx

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* add tests for application tracking routes and remove unused actionId from client API

* remove unnecessary await from synchronous transitionStage calls and improve test isolation

* relax externalUrl validation to allow non-URL metadata

* add toast notifications for data loading and event logging in JobPage

* comments

* fix: resolve type error in sponsor-matching.test.ts

* fix ci

* tests fix for github

* lint

* github comments

* build fix

* dedupe

* format

* types fix

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* formatting

* title and group id are discrete fields

* backfill

* hide view button on page

* show relevant dropdown options

* confetti!

* remove redundant

* confirm delete is a custom element now

* formatting

* fix styling

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

2026-01-27 23:49:11 +00:00

public

favicon image

2026-01-15 19:22:22 +00:00

src

Timeline introduced (#38 )

2026-01-27 23:49:11 +00:00

.gitignore

orchestrator initial commit...

2025-12-11 22:31:59 +00:00

components.json

tailwind transition

2025-12-14 16:48:07 +00:00

index.html

simplify injection

2026-01-16 15:40:12 +00:00

package-lock.json

Timeline introduced (#38 )

2026-01-27 23:49:11 +00:00

package.json

Timeline introduced (#38 )

2026-01-27 23:49:11 +00:00

postcss.config.cjs

tailwind transition

2025-12-14 16:48:07 +00:00

README.md

Readme updates

2026-01-23 13:11:34 +00:00

tailwind.config.ts

tailwind config artefacts cleaned up

2026-01-22 20:04:08 +00:00

tsconfig.json

fix test fiels

2026-01-27 15:12:58 +00:00

tsconfig.server.json

Dockerization :)

2025-12-11 23:56:07 +00:00

vite.config.ts

gem3 flash lint fix

2026-01-25 13:14:59 +00:00

README.md

Job Ops Orchestrator

A unified orchestrator for the job application pipeline. Discovers jobs, scores them for suitability, generates tailored resumes, and provides a UI to manage applications.

Architecture

orchestrator/
├── src/
│   ├── server/           # Express backend
│   │   ├── api/          # REST API routes
│   │   ├── db/           # SQLite + Drizzle ORM
│   │   ├── pipeline/     # Orchestration logic
│   │   ├── repositories/ # Data access layer
│   │   └── services/     # Integrations (crawler, AI, PDF)
│   ├── client/           # React frontend
│   │   ├── api/          # API client
│   │   ├── components/   # UI components
│   │   └── styles/       # CSS design system
│   └── shared/           # Shared types
├── data/                 # SQLite DB + generated PDFs (gitignored)
└── public/               # Static assets

Setup

Install dependencies:
```
cd orchestrator
npm install
```
Set up environment:
```
cp .env.example .env
# The app is self-configuring. You can add keys via the UI Onboarding.
```
After the server starts, use the onboarding modal to connect OpenRouter, link your v4.rxresu.me account, and select a template resume.
Initialize database:
```
npm run db:migrate
```
Start development server:
```
npm run dev
```
This starts:
- Backend API at http://localhost:3001
- Frontend at http://localhost:5173

API Endpoints

Jobs

Method	Endpoint	Description
GET	`/api/jobs`	List all jobs (filter with `?status=ready,discovered`)
GET	`/api/jobs/:id`	Get single job
PATCH	`/api/jobs/:id`	Update job
POST	`/api/jobs/:id/process`	Generate resume for job
POST	`/api/jobs/:id/apply`	Mark as applied + sync to Notion
POST	`/api/jobs/:id/skip`	Mark as skipped

Pipeline

Method	Endpoint	Description
GET	`/api/pipeline/status`	Get pipeline status
GET	`/api/pipeline/runs`	Get recent pipeline runs
POST	`/api/pipeline/run`	Trigger pipeline manually
POST	`/api/webhook/trigger`	Webhook for n8n (use `WEBHOOK_SECRET`)

Daily Flow

17:00 - n8n triggers pipeline:
- Calls POST /api/webhook/trigger
- Pipeline crawls Gradcracker
- Scores jobs with AI
- Generates tailored resumes for top 10
You review in the UI:
- See jobs at http://localhost:5173
- "Ready" tab shows jobs with generated PDFs
- Click "View Job" to open application
- Download PDF and apply manually
- Click "Mark Applied" → syncs to Notion

n8n Setup

Create a workflow with:

Schedule Trigger - Every day at 17:00
HTTP Request:
- Method: POST
- URL: http://localhost:3001/api/webhook/trigger
- Headers: Authorization: Bearer YOUR_WEBHOOK_SECRET

Development

# Run just the server
npm run dev:server

# Run just the client
npm run dev:client

# Run the pipeline manually
npm run pipeline:run

# Build for production
npm run build
npm start

Tech Stack

Backend: Express, TypeScript, Drizzle ORM, SQLite
Frontend: React, Vite, CSS (custom design system)
AI: OpenRouter API (GPT-4o-mini)
PDF Generation: RxResume v4 API export (configured via Settings)
Job Crawling: Wraps existing TypeScript Crawlee crawler