History

feat: add remote jobs filter for JobSpy (#70 )

* feat(types): add jobspyIsRemote to TypeScript type definitions

- Add jobspyIsRemote boolean fields to AppSettings interface
- Follow three-field pattern: value, default, override
- Update test fixture with default values (false)

* feat(validation): add jobspyIsRemote validation schema

Add Zod validation schema for jobspyIsRemote boolean setting to ensure type safety in the settings API endpoint.

* feat(db): add jobspyIsRemote to database repository setting keys

* feat(api): add jobspyIsRemote storage to settings API route

* feat(service): add jobspyIsRemote to settings service with environment variable support

* feat(jobspy): add isRemote parameter to JobSpy service interface

* feat(pipeline): pass isRemote setting to JobSpy service

* feat(python): add is_remote parameter to JobSpy scraper script

* feat(ui): add Remote Jobs checkbox to JobSpy settings

* feat(ui): add Remote badge to job display

- Display Remote badge when job.isRemote === true
- Position badge next to Source badge in JobHeader
- Use Badge component with outline variant
- Badge does not display when isRemote is false or null

* docs(env): add JOBSPY_IS_REMOTE environment variable documentation

- Added JobSpy section to .env.example with JOBSPY_IS_REMOTE variable
- Documents remote-only job filtering option with default value of 0 (disabled)
- Follows existing .env.example format with clear section headers and descriptions

* test(remote-jobs): verify end-to-end functionality with comprehensive feedback loops

2026-01-31 16:48:17 +00:00

public

favicon image

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

src

feat: add remote jobs filter for JobSpy (#70 )

2026-01-31 16:48:17 +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

Starting work on Dashboard! (#65 )

2026-01-30 11:40:17 +00:00

package.json

Starting work on Dashboard! (#65 )

2026-01-30 11:40:17 +00:00

postcss.config.cjs

tailwind transition

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

README.md

documentation update

2026-01-29 16:46:01 +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.

OpenRouter is the default LLM provider, but LM Studio, Ollama, OpenAI, and Gemini are also supported.

Deprecated: OPENROUTER_API_KEY / openrouterApiKey. Use LLM_API_KEY / llmApiKey instead (legacy values are auto-migrated/copied for compatibility).
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: Configurable LLM provider (OpenRouter default; also supports OpenAI/Gemini/LM Studio/Ollama)
PDF Generation: RxResume v4 API export (configured via Settings)
Job Crawling: Wraps existing TypeScript Crawlee crawler