How wafyimady/jobsync works
JobSync is a reverse ATS: a scheduled worker turns job-related inbox messages into application records, which an authenticated dashboard displays and lets the user update. The worker fetches and decodes email, asks Gemini to extract and classify job details, and stores results in PostgreSQL; the frontend protects access, reads those records, and supports search, metrics, and drag-and-drop status updates. The README documents the overall pipeline; source excerpts confirm the worker’s processing and the frontend’s query, authentication, and update calls. Some worker internals are grouped because they share one source file.
Main entry points: worker.py Email worker · page.tsx Protected dashboard · actions.ts Status update action · db.ts Postgres pool
Components 15
Email processing
- Email worker
worker.py - Body decoding
worker.py - AI extraction
worker.py
Application data
- Applications
- Processed messages
- Postgres pool
frontend/lib/db.ts
Dashboard
- Protected dashboard
frontend/app/page.tsx - Kanban and metrics
frontend/components/KanbanBoard.tsx - Status update action
frontend/app/actions.ts
Admin access
- Login page
frontend/app/login/page.tsx - Session auth
frontend/lib/auth.ts
Other components
- Scheduled trigger
- Gmail inbox
- Gemini API
- Admin user
Connections 16
- Scheduled trigger → Email worker: runs
README.md - Email worker → Gmail inbox: fetches messages
README.md - Email worker → Body decoding: decodes bodies
worker.py - Email worker → AI extraction: processes content
worker.py - AI extraction → Gemini API: requests extraction
README.md - Email worker → Applications: upserts records
README.md - Email worker → Processed messages: tracks message IDs
worker.py - Admin user → Login page: submits credentials
frontend/app/login/page.tsx - Login page → Session auth: authenticates
frontend/app/login/page.tsx - Protected dashboard → Session auth: requires access
frontend/app/page.tsx - Protected dashboard → Postgres pool: queries applications
frontend/app/page.tsx - Postgres pool → Applications: reads and writes
README.md - Protected dashboard → Kanban and metrics: renders records
frontend/app/page.tsx - Kanban and metrics → Status update action: submits status
frontend/components/KanbanBoard.tsx - Status update action → Session auth: checks session
frontend/app/actions.ts - Status update action → Postgres pool: updates status
frontend/app/actions.ts