# krishnaprasath2006/job-applying-bot architecture

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

- Interactive diagram: https://gitdiagram.com/krishnaprasath2006/job-applying-bot
- Repository: https://github.com/krishnaprasath2006/job-applying-bot

## Overview

AI Job Assistant is a read-only, evidence-first job-fit system: a candidate maintains sourced profile facts and resume variants, supplies saved job-posting content, and receives an auditable fit verdict plus human-review work. The modern workflow runs through React, FastAPI, the Assistant service layer, and Python job-intelligence stages; safety policy blocks application submission. The README documents the tier boundaries and major capabilities. Source-index references support several internal links, but unsampled implementations and the truncated system-flow diagram limit finer call-level detail.

Main entry points: [`src/assistant/job_service.py`](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/job_service.py) (Job service), [`src/assistant/app.py`](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/app.py) (Assistant container), [`src/profile/service.py`](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/profile/service.py) (Verified profile), [`src/resumes/service.py`](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/resumes/service.py) (Resume ingestion)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Presentation"]
  node_web_app["React interface<br/>[App.tsx]"]
end

subgraph group_boundary["API boundary"]
  node_api["FastAPI routes<br/>[app.py]"]
  node_assistant["Assistant container<br/>[app.py]"]
end

subgraph group_domain["Candidate and job domain"]
  node_profile["Verified profile<br/>[service.py]"]
  node_profile_validation["Profile validation<br/>[validator.py]"]
  node_resume_ingestion["Resume ingestion<br/>[service.py]"]
  node_resume_parsing["Resume parsing<br/>[parser.py]"]
end

subgraph group_intelligence["Job intelligence"]
  node_job_service["Job service<br/>[job_service.py]"]
  node_job_discovery["Job discovery<br/>[discovery.py]"]
  node_job_acquisition["Posting acquisition<br/>[acquisition.py]"]
  node_job_analysis["Posting analysis<br/>[analysis.py]"]
  node_job_requirements["Requirement extraction<br/>[requirements.py]"]
  node_hard_gate{{"Hard-requirement gate<br/>[hard_gate.py]"}}
  node_matching["Fit matching<br/>[matching.py]"]
  node_explanation["Auditable explanation<br/>[explain.py]"]
  node_review["Human review queue<br/>[review.py]"]
  node_ai["AI provider registry<br/>[registry.py]"]
  node_semantic_scorer["Semantic scoring<br/>[embeddings.py]"]
end

subgraph group_persistence["Persistence and safety"]
  node_safety{{"Safety policy<br/>[policies.py]"}}
  node_sqlite[("SQLite database<br/>[connection.py]")]
  node_repositories["Domain repositories"]
end

node_candidate(("Job seeker"))
node_saved_posting["Saved posting"]
node_ollama(("Local Ollama"))

node_candidate -->|"uses"| node_web_app
node_web_app -->|"requests data"| node_api
node_api -->|"constructs"| node_assistant
node_candidate -->|"records facts"| node_profile
node_profile -->|"validates"| node_profile_validation
node_candidate -->|"adds resumes"| node_resume_ingestion
node_resume_ingestion -->|"parses"| node_resume_parsing
node_saved_posting -->|"ingests offline"| node_job_service
node_assistant -->|"provides service"| node_profile
node_assistant -->|"provides service"| node_resume_ingestion
node_assistant -->|"provides service"| node_job_service
node_assistant -->|"enforces policy"| node_safety
node_job_service -->|"runs discovery"| node_job_discovery
node_job_service -->|"acquires postings"| node_job_acquisition
node_job_service -->|"runs analysis"| node_job_analysis
node_job_analysis -.->|"extracts requirements"| node_job_requirements
node_job_service -.->|"evaluates gate"| node_hard_gate
node_job_service -.->|"computes fit"| node_matching
node_job_service -.->|"builds explanation"| node_explanation
node_job_service -.->|"manages review"| node_review
node_matching -->|"uses scorer"| node_semantic_scorer
node_semantic_scorer -->|"embeds text"| node_ai
node_ai -.->|"selects provider"| node_ollama
node_assistant -->|"initializes"| node_sqlite
node_profile -->|"persists facts"| node_repositories
node_resume_ingestion -->|"stores resumes"| node_repositories
node_job_service -->|"stores job data"| node_repositories
node_repositories -->|"reads and writes"| node_sqlite

click node_web_app "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/App.tsx"
click node_api "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/api/app.py"
click node_assistant "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/app.py"
click node_profile "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/profile/service.py"
click node_profile_validation "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/profile/validator.py"
click node_resume_ingestion "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/resumes/service.py"
click node_resume_parsing "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/resumes/parser.py"
click node_job_service "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/job_service.py"
click node_job_discovery "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/discovery.py"
click node_job_acquisition "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/acquisition.py"
click node_job_analysis "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/analysis.py"
click node_job_requirements "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/requirements.py"
click node_hard_gate "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/hard_gate.py"
click node_matching "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/matching.py"
click node_explanation "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/explain.py"
click node_review "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/review.py"
click node_ai "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/ai/registry.py"
click node_semantic_scorer "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/ai/embeddings.py"
click node_safety "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/safety/policies.py"
click node_sqlite "https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/database/connection.py"
click node_repositories "https://github.com/krishnaprasath2006/job-applying-bot/tree/main/src/database/repositories"

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_web_app toneBlue
class node_api,node_assistant toneAmber
class node_profile,node_profile_validation,node_resume_ingestion,node_resume_parsing toneMint
class node_job_service,node_job_discovery,node_job_acquisition,node_job_analysis,node_job_requirements,node_hard_gate,node_matching,node_explanation,node_review,node_ai,node_semantic_scorer toneRose
class node_safety,node_sqlite,node_repositories,node_candidate,node_saved_posting,node_ollama toneIndigo
```

## Components

### Presentation

- [React interface](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/App.tsx): `src/App.tsx`

### API boundary

- [FastAPI routes](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/api/app.py): `src/api/app.py`
- [Assistant container](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/app.py): `src/assistant/app.py`

### Candidate and job domain

- [Verified profile](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/profile/service.py): `src/profile/service.py`
- [Profile validation](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/profile/validator.py): `src/profile/validator.py`
- [Resume ingestion](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/resumes/service.py): `src/resumes/service.py`
- [Resume parsing](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/resumes/parser.py): `src/resumes/parser.py`

### Job intelligence

- [Job service](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/assistant/job_service.py): `src/assistant/job_service.py`
- [Job discovery](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/discovery.py): `src/jobs/discovery.py`
- [Posting acquisition](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/acquisition.py): `src/jobs/acquisition.py`
- [Posting analysis](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/analysis.py): `src/jobs/analysis.py`
- [Requirement extraction](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/requirements.py): `src/jobs/requirements.py`
- [Hard-requirement gate](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/hard_gate.py): `src/jobs/hard_gate.py`
- [Fit matching](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/matching.py): `src/jobs/matching.py`
- [Auditable explanation](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/explain.py): `src/jobs/explain.py`
- [Human review queue](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/jobs/review.py): `src/jobs/review.py`
- [AI provider registry](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/ai/registry.py): `src/ai/registry.py`
- [Semantic scoring](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/ai/embeddings.py): `src/ai/embeddings.py`

### Persistence and safety

- [Safety policy](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/safety/policies.py): `src/safety/policies.py`
- [SQLite database](https://github.com/krishnaprasath2006/job-applying-bot/blob/main/src/database/connection.py): `src/database/connection.py`
- [Domain repositories](https://github.com/krishnaprasath2006/job-applying-bot/tree/main/src/database/repositories): `src/database/repositories`

### Other components

- **Job seeker**
- **Saved posting**
- **Local Ollama**

## Connections

- Job seeker → React interface: uses (evidence: `README.md`)
- React interface → FastAPI routes: requests data (evidence: `README.md`)
- FastAPI routes → Assistant container: constructs (evidence: `src/api/app.py`)
- Job seeker → Verified profile: records facts (evidence: `README.md`)
- Verified profile → Profile validation: validates (evidence: `src/profile/service.py`)
- Job seeker → Resume ingestion: adds resumes (evidence: `README.md`)
- Resume ingestion → Resume parsing: parses (evidence: `src/resumes/service.py`)
- Saved posting → Job service: ingests offline (evidence: `src/assistant/job_service.py`)
- Assistant container → Verified profile: provides service (evidence: `README.md`)
- Assistant container → Resume ingestion: provides service (evidence: `README.md`)
- Assistant container → Job service: provides service (evidence: `README.md`)
- Assistant container → Safety policy: enforces policy (evidence: `README.md`)
- Job service → Job discovery: runs discovery (evidence: `src/assistant/job_service.py`)
- Job service → Posting acquisition: acquires postings (evidence: `src/assistant/job_service.py`)
- Job service → Posting analysis: runs analysis (evidence: `src/assistant/job_service.py`)
- Posting analysis → Requirement extraction: extracts requirements
- Job service → Hard-requirement gate: evaluates gate
- Job service → Fit matching: computes fit (evidence: `src/assistant/job_service.py`)
- Job service → Auditable explanation: builds explanation (evidence: `src/assistant/job_service.py`)
- Job service → Human review queue: manages review (evidence: `src/assistant/job_service.py`)
- Fit matching → Semantic scoring: uses scorer (evidence: `src/jobs/matching.py`)
- Semantic scoring → AI provider registry: embeds text (evidence: `src/ai/embeddings.py`)
- AI provider registry → Local Ollama: selects provider
- Assistant container → SQLite database: initializes (evidence: `src/assistant/app.py`)
- Verified profile → Domain repositories: persists facts (evidence: `src/profile/service.py`)
- Resume ingestion → Domain repositories: stores resumes (evidence: `src/resumes/service.py`)
- Job service → Domain repositories: stores job data (evidence: `src/assistant/job_service.py`)
- Domain repositories → SQLite database: reads and writes (evidence: `src/database/repositories/jobs.py`)
