# shibu-patil/hakein-backend architecture

> Architecture diagram of the GitHub repository shibu-patil/hakein-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shibu-patil/hakein-backend
- Repository: https://github.com/shibu-patil/hakein-backend

## Overview

Hakein is an AI job-autopilot backend. Users configure a profile, preferences, and platform credentials; a scheduled or requested run discovers jobs, tailors an ATS-oriented resume, answers application questions, and submits applications. Unanswered questions enter an inbox and can trigger retries after the user responds. The graph also preserves standalone resume tools and health/API capabilities. Edges follow shown calls or README-described behavior; some worker and scheduler details are documented but not fully excerpted, so unsupported links are omitted.

Main entry points: [`workers/processor.js`](https://github.com/shibu-patil/hakein-backend/blob/main/workers/processor.js) (Apply Worker), [`src/index.js`](https://github.com/shibu-patil/hakein-backend/blob/main/src/index.js) (Express App), [`src/routes/resume.js`](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/resume.js) (Resume Routes), [`src/services/qaService.js`](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/qaService.js) (Question Answering)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_express["Express App<br/>[index.js]"]
  node_health["Health Routes<br/>[health.js]"]
  node_resume_routes["Resume Routes<br/>[resume.js]"]
  node_resume_service["Resume Tailoring<br/>[resumeService.js]"]
  node_job_extractor["JD Extraction<br/>[jobExtractor.js]"]
end

subgraph group_profile["Profiles And Q&amp;A"]
  node_users_routes["User Routes<br/>[users.js]"]
  node_inbox_routes["Inbox Routes<br/>[inbox.js]"]
  node_qa["Question Answering<br/>[qaService.js]"]
  node_auth["Credential Resolution<br/>[auth.js]"]
end

subgraph group_automation["Job Automation"]
  node_jobs_routes["Job Routes<br/>[jobs.js]"]
  node_applications_routes["Application Routes<br/>[applications.js]"]
  node_pdf["Resume PDF<br/>[pdfGenerator.js]"]
  node_scraper["Job Scraping<br/>[scraperService.js]"]
  node_engine["Application Engine"]
  node_worker["Apply Worker<br/>[processor.js]"]
  node_scheduler["Watch Scheduler<br/>[scheduler.js]"]
  node_alert_ingest["Alert Ingestion<br/>[alertIngest.js]"]
end

subgraph group_runtime["Runtime And Storage"]
  node_models[("Domain Models<br/>[index.js]")]
  node_db_lib["Mongo Connector<br/>[db.js]"]
  node_redis_lib["Redis Connector<br/>[redis.js]"]
  node_crypto["Credential Encryption<br/>[crypto.js]"]
end

subgraph group_integrations["External Services"]
  node_ai_factory["AI Provider Factory<br/>[aiProviders.js]"]
  node_notify["Notifications<br/>[notify.js]"]
  node_mongo[("MongoDB")]
  node_redis["Redis Queue"]
  node_platforms["Job Platforms"]
  node_ai_services["AI Providers"]
  node_mail_push["Email And Push"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_express
node_express -->|"routes health"| node_health
node_express -->|"routes resume"| node_resume_routes
node_express -->|"routes users"| node_users_routes
node_express -->|"routes jobs"| node_jobs_routes
node_express -->|"routes applications"| node_applications_routes
node_express -->|"routes inbox"| node_inbox_routes
node_resume_routes -->|"generates resumes"| node_resume_service
node_resume_routes -->|"extracts descriptions"| node_job_extractor
node_resume_routes -->|"selects provider"| node_ai_factory
node_resume_routes -->|"generates PDF"| node_pdf
node_users_routes -->|"encrypts credentials"| node_crypto
node_users_routes -->|"verifies login"| node_auth
node_users_routes -->|"previews answers"| node_qa
node_inbox_routes -->|"answers questions"| node_qa
node_jobs_routes -->|"scrapes jobs"| node_scraper
node_applications_routes -->|"queues run"| node_redis_lib
node_scheduler -->|"enqueues runs"| node_redis_lib
node_scheduler -.-> node_alert_ingest
node_worker -->|"scrapes jobs"| node_scraper
node_worker -->|"tailors resume"| node_resume_service
node_worker -->|"creates provider"| node_ai_factory
node_worker -->|"renders resume"| node_pdf
node_worker -->|"submits applications"| node_engine
node_worker -->|"resolves credentials"| node_auth
node_engine -->|"answers questions"| node_qa
node_engine -->|"resolves credentials"| node_auth
node_worker -->|"creates pending questions"| node_qa
node_worker -->|"alerts user"| node_notify
node_db_lib -->|"connects"| node_mongo
node_redis_lib -->|"connects"| node_redis
node_scraper -->|"stores jobs"| node_models
node_qa -->|"reads and writes answers"| node_models
node_models -.-> node_db_lib
node_scraper -->|"fetches listings"| node_platforms
node_engine -->|"applies to jobs"| node_platforms
node_ai_factory -->|"calls models"| node_ai_services
node_notify -->|"sends alerts"| node_mail_push

click node_express "https://github.com/shibu-patil/hakein-backend/blob/main/src/index.js"
click node_health "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/health.js"
click node_resume_routes "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/resume.js"
click node_users_routes "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/users.js"
click node_jobs_routes "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/jobs.js"
click node_applications_routes "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/applications.js"
click node_inbox_routes "https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/inbox.js"
click node_resume_service "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/resumeService.js"
click node_job_extractor "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/jobExtractor.js"
click node_pdf "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/pdfGenerator.js"
click node_qa "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/qaService.js"
click node_auth "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/auth.js"
click node_scraper "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/scraperService.js"
click node_engine "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/applicationEngine.js"
click node_worker "https://github.com/shibu-patil/hakein-backend/blob/main/workers/processor.js"
click node_scheduler "https://github.com/shibu-patil/hakein-backend/blob/main/workers/scheduler.js"
click node_alert_ingest "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/alertIngest.js"
click node_ai_factory "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/aiProviders.js"
click node_notify "https://github.com/shibu-patil/hakein-backend/blob/main/src/services/notify.js"
click node_models "https://github.com/shibu-patil/hakein-backend/blob/main/src/models/index.js"
click node_db_lib "https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/db.js"
click node_redis_lib "https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/redis.js"
click node_crypto "https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/crypto.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_express,node_health,node_resume_routes,node_resume_service,node_job_extractor,node_client toneBlue
class node_users_routes,node_inbox_routes,node_qa,node_auth toneAmber
class node_jobs_routes,node_applications_routes,node_pdf,node_scraper,node_engine,node_worker,node_scheduler,node_alert_ingest toneMint
class node_models,node_db_lib,node_redis_lib,node_crypto toneRose
class node_ai_factory,node_notify,node_mongo,node_redis,node_platforms,node_ai_services,node_mail_push toneIndigo
```

## Components

### HTTP API

- [Express App](https://github.com/shibu-patil/hakein-backend/blob/main/src/index.js): `src/index.js`
- [Health Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/health.js): `src/routes/health.js`
- [Resume Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/resume.js): `src/routes/resume.js`
- [Resume Tailoring](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/resumeService.js): `src/services/resumeService.js`
- [JD Extraction](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/jobExtractor.js): `src/services/jobExtractor.js`

### Profiles And Q&A

- [User Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/users.js): `src/routes/users.js`
- [Inbox Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/inbox.js): `src/routes/inbox.js`
- [Question Answering](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/qaService.js): `src/services/qaService.js`
- [Credential Resolution](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/auth.js): `src/services/auth.js`

### Job Automation

- [Job Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/jobs.js): `src/routes/jobs.js`
- [Application Routes](https://github.com/shibu-patil/hakein-backend/blob/main/src/routes/applications.js): `src/routes/applications.js`
- [Resume PDF](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/pdfGenerator.js): `src/services/pdfGenerator.js`
- [Job Scraping](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/scraperService.js): `src/services/scraperService.js`
- [Application Engine](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/applicationEngine.js): `src/services/applicationEngine.js`
- [Apply Worker](https://github.com/shibu-patil/hakein-backend/blob/main/workers/processor.js): `workers/processor.js`
- [Watch Scheduler](https://github.com/shibu-patil/hakein-backend/blob/main/workers/scheduler.js): `workers/scheduler.js`
- [Alert Ingestion](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/alertIngest.js): `src/services/alertIngest.js`

### Runtime And Storage

- [Domain Models](https://github.com/shibu-patil/hakein-backend/blob/main/src/models/index.js): `src/models/index.js`
- [Mongo Connector](https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/db.js): `src/lib/db.js`
- [Redis Connector](https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/redis.js): `src/lib/redis.js`
- [Credential Encryption](https://github.com/shibu-patil/hakein-backend/blob/main/src/lib/crypto.js): `src/lib/crypto.js`

### External Services

- [AI Provider Factory](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/aiProviders.js): `src/services/aiProviders.js`
- [Notifications](https://github.com/shibu-patil/hakein-backend/blob/main/src/services/notify.js): `src/services/notify.js`
- **MongoDB**
- **Redis Queue**
- **Job Platforms**
- **AI Providers**
- **Email And Push**

### Other components

- **API Client**

## Connections

- API Client → Express App: sends requests (evidence: `src/index.js`)
- Express App → Health Routes: routes health (evidence: `src/index.js`)
- Express App → Resume Routes: routes resume (evidence: `src/index.js`)
- Express App → User Routes: routes users (evidence: `src/index.js`)
- Express App → Job Routes: routes jobs (evidence: `src/index.js`)
- Express App → Application Routes: routes applications (evidence: `src/index.js`)
- Express App → Inbox Routes: routes inbox (evidence: `src/index.js`)
- Resume Routes → Resume Tailoring: generates resumes (evidence: `src/routes/resume.js`)
- Resume Routes → JD Extraction: extracts descriptions (evidence: `src/routes/resume.js`)
- Resume Routes → AI Provider Factory: selects provider (evidence: `src/routes/resume.js`)
- Resume Routes → Resume PDF: generates PDF (evidence: `src/routes/resume.js`)
- User Routes → Credential Encryption: encrypts credentials (evidence: `src/routes/users.js`)
- User Routes → Credential Resolution: verifies login (evidence: `src/routes/users.js`)
- User Routes → Question Answering: previews answers (evidence: `src/routes/users.js`)
- Inbox Routes → Question Answering: answers questions (evidence: `src/routes/inbox.js`)
- Job Routes → Job Scraping: scrapes jobs (evidence: `src/routes/jobs.js`)
- Application Routes → Redis Connector: queues run (evidence: `src/routes/applications.js`)
- Watch Scheduler → Redis Connector: enqueues runs (evidence: `workers/scheduler.js`)
- Watch Scheduler → Alert Ingestion (evidence: `workers/scheduler.js`)
- Apply Worker → Job Scraping: scrapes jobs (evidence: `workers/processor.js`)
- Apply Worker → Resume Tailoring: tailors resume (evidence: `workers/processor.js`)
- Apply Worker → AI Provider Factory: creates provider (evidence: `workers/processor.js`)
- Apply Worker → Resume PDF: renders resume (evidence: `workers/processor.js`)
- Apply Worker → Application Engine: submits applications (evidence: `workers/processor.js`)
- Apply Worker → Credential Resolution: resolves credentials (evidence: `workers/processor.js`)
- Application Engine → Question Answering: answers questions (evidence: `src/services/applicationEngine.js`)
- Application Engine → Credential Resolution: resolves credentials (evidence: `src/services/applicationEngine.js`)
- Apply Worker → Question Answering: creates pending questions (evidence: `workers/processor.js`)
- Apply Worker → Notifications: alerts user (evidence: `workers/processor.js`)
- Mongo Connector → MongoDB: connects (evidence: `src/lib/db.js`)
- Redis Connector → Redis Queue: connects (evidence: `src/lib/redis.js`)
- Job Scraping → Domain Models: stores jobs (evidence: `src/services/scraperService.js`)
- Question Answering → Domain Models: reads and writes answers (evidence: `src/services/qaService.js`)
- Domain Models → Mongo Connector
- Job Scraping → Job Platforms: fetches listings (evidence: `README.md`)
- Application Engine → Job Platforms: applies to jobs (evidence: `README.md`)
- AI Provider Factory → AI Providers: calls models (evidence: `README.md`)
- Notifications → Email And Push: sends alerts (evidence: `README.md`)
