orchestrator initial commit...

2025-12-11 22:31:59 +00:00
parent 7ab024efda
commit 1b082a3eb6
46 changed files with 9792 additions and 5 deletions
@@ -0,0 +1,123 @@
+# 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
+
+1. **Install dependencies:**
+   ```bash
+   cd orchestrator
+   npm install
+   ```
+
+2. **Set up environment:**
+   ```bash
+   cp .env.example .env
+   # Edit .env with your API keys
+   ```
+
+3. **Initialize database:**
+   ```bash
+   npm run db:migrate
+   ```
+
+4. **Start development server:**
+   ```bash
+   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/reject` | Mark as rejected |
+
+### 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
+
+1. **17:00 - n8n triggers pipeline:**
+   - Calls `POST /api/webhook/trigger`
+   - Pipeline crawls Gradcracker
+   - Scores jobs with AI
+   - Generates tailored resumes for top 10
+
+2. **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:
+
+1. **Schedule Trigger** - Every day at 17:00
+2. **HTTP Request:**
+   - Method: POST
+   - URL: `http://localhost:3001/api/webhook/trigger`
+   - Headers: `Authorization: Bearer YOUR_WEBHOOK_SECRET`
+
+## Development
+
+```bash
+# 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:** Wraps existing Python RXResume automation
+- **Job Crawling:** Wraps existing TypeScript Crawlee crawler