# esvanth/intelligent-agents-and-process-automation--ca architecture

> Architecture diagram of the GitHub repository esvanth/intelligent-agents-and-process-automation--ca, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/esvanth/intelligent-agents-and-process-automation--ca
- Repository: https://github.com/esvanth/intelligent-agents-and-process-automation--ca

## Overview

This repository automates candidate intake and shortlisting for a Junior Data Analyst role. Applications are polled from a mock or IMAP inbox, CV PDFs are stored and logged, then parsed, scored against the job description, and given draft emails. The Streamlit dashboard presents ranked results for recruiter review; approved communications can be sent through SMTP or saved to a mock outbox, and rejected candidates can receive development feedback. The documented workflow is clear, though some dashboard actions are in omitted source excerpts, so those links are cited to the README or left unverified.

Main entry points: [`main.py`](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/main.py) (Pipeline Runner), [`dashboard/app.py`](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/dashboard/app.py) (Recruiter Dashboard), [`rpa/email_sender.py`](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/email_sender.py) (Email Sender), [`agentic/scorer.py`](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/scorer.py) (Candidate Scorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_intake["RPA Intake"]
  node_orchestrator["Pipeline Runner<br/>[main.py]"]
  node_poller["Inbox Poller<br/>[inbox_poller.py]"]
  node_extractor["CV Extractor<br/>[cv_extractor.py]"]
  node_sender["Email Sender<br/>[email_sender.py]"]
end

subgraph group_screening["AI Screening"]
  node_cvparser["CV Parser<br/>[cv_parser.py]"]
  node_scorer["Candidate Scorer<br/>[scorer.py]"]
  node_schemas["Score Schemas<br/>[schemas.py]"]
  node_drafter["Email Drafter<br/>[email_drafter.py]"]
  node_feedback["Feedback Generator"]
end

subgraph group_review["Recruiter Review"]
  node_dashboard["Recruiter Dashboard<br/>[app.py]"]
end

subgraph group_records["Recruitment Records"]
  node_tracker[("Applicant Tracker<br/>[tracker.py]")]
  node_jobdescription["Job Description"]
  node_results[("Screening Results<br/>[app.py]")]
end

node_applicant(("Applicant"))
node_inbox["Application Inbox"]
node_mailservice["IMAP / SMTP"]
node_outbox[("Mock Outbox")]
node_groq["Groq LLM"]

node_applicant -->|"submits application"| node_inbox
node_inbox -->|"provides messages"| node_poller
node_orchestrator -->|"polls inbox"| node_poller
node_orchestrator -->|"stores CVs"| node_extractor
node_orchestrator -->|"logs applicants"| node_tracker
node_orchestrator -->|"parses CVs"| node_cvparser
node_orchestrator -->|"scores candidates"| node_scorer
node_orchestrator -->|"drafts emails"| node_drafter
node_orchestrator -->|"reads criteria"| node_jobdescription
node_orchestrator -->|"writes results"| node_results
node_scorer -->|"validates output"| node_schemas
node_drafter -->|"uses score"| node_schemas
node_feedback -->|"uses score"| node_schemas
node_scorer -.->|"requests scoring"| node_groq
node_drafter -.->|"requests drafts"| node_groq
node_feedback -.->|"requests feedback"| node_groq
node_dashboard -->|"reads results"| node_results
node_dashboard -->|"generates feedback"| node_feedback
node_dashboard -->|"sends approved mail"| node_sender
node_dashboard -.->|"updates review status"| node_tracker
node_poller -.->|"polls IMAP"| node_mailservice
node_sender -.->|"sends via SMTP"| node_mailservice
node_sender -->|"writes mock mail"| node_outbox

click node_orchestrator "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/main.py"
click node_poller "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/inbox_poller.py"
click node_extractor "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/cv_extractor.py"
click node_tracker "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/tracker.py"
click node_cvparser "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/cv_parser.py"
click node_scorer "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/scorer.py"
click node_schemas "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/schemas.py"
click node_drafter "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/email_drafter.py"
click node_feedback "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/feedback_generator.py"
click node_jobdescription "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/data/job_description.txt"
click node_results "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/dashboard/app.py"
click node_dashboard "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/dashboard/app.py"
click node_sender "https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/email_sender.py"

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_orchestrator,node_poller,node_extractor,node_sender toneBlue
class node_cvparser,node_scorer,node_schemas,node_drafter,node_feedback,node_outbox toneAmber
class node_dashboard toneMint
class node_tracker,node_jobdescription,node_results toneRose
class node_applicant,node_inbox,node_mailservice,node_groq toneIndigo
```

## Components

### RPA Intake

- [Pipeline Runner](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/main.py): `main.py`
- [Inbox Poller](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/inbox_poller.py): `rpa/inbox_poller.py`
- [CV Extractor](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/cv_extractor.py): `rpa/cv_extractor.py`
- [Email Sender](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/email_sender.py): `rpa/email_sender.py`

### AI Screening

- [CV Parser](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/cv_parser.py): `agentic/cv_parser.py`
- [Candidate Scorer](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/scorer.py): `agentic/scorer.py`
- [Score Schemas](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/schemas.py): `agentic/schemas.py`
- [Email Drafter](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/email_drafter.py): `agentic/email_drafter.py`
- [Feedback Generator](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/agentic/feedback_generator.py): `agentic/feedback_generator.py`

### Recruiter Review

- [Recruiter Dashboard](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/dashboard/app.py): `dashboard/app.py`

### Recruitment Records

- [Applicant Tracker](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/rpa/tracker.py): `rpa/tracker.py`
- [Job Description](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/data/job_description.txt): `data/job_description.txt`
- [Screening Results](https://github.com/esvanth/intelligent-agents-and-process-automation--ca/blob/main/dashboard/app.py): `dashboard/app.py`

### Other components

- **Applicant**
- **Application Inbox**
- **IMAP / SMTP**
- **Mock Outbox**
- **Groq LLM**

## Connections

- Applicant → Application Inbox: submits application (evidence: `README.md`)
- Application Inbox → Inbox Poller: provides messages (evidence: `rpa/inbox_poller.py`)
- Pipeline Runner → Inbox Poller: polls inbox (evidence: `main.py`)
- Pipeline Runner → CV Extractor: stores CVs (evidence: `main.py`)
- Pipeline Runner → Applicant Tracker: logs applicants (evidence: `main.py`)
- Pipeline Runner → CV Parser: parses CVs (evidence: `main.py`)
- Pipeline Runner → Candidate Scorer: scores candidates (evidence: `main.py`)
- Pipeline Runner → Email Drafter: drafts emails (evidence: `main.py`)
- Pipeline Runner → Job Description: reads criteria (evidence: `main.py`)
- Pipeline Runner → Screening Results: writes results (evidence: `main.py`)
- Candidate Scorer → Score Schemas: validates output (evidence: `agentic/scorer.py`)
- Email Drafter → Score Schemas: uses score (evidence: `agentic/email_drafter.py`)
- Feedback Generator → Score Schemas: uses score (evidence: `agentic/feedback_generator.py`)
- Candidate Scorer → Groq LLM: requests scoring (evidence: `agentic/scorer.py`)
- Email Drafter → Groq LLM: requests drafts (evidence: `agentic/email_drafter.py`)
- Feedback Generator → Groq LLM: requests feedback (evidence: `agentic/feedback_generator.py`)
- Recruiter Dashboard → Screening Results: reads results (evidence: `dashboard/app.py`)
- Recruiter Dashboard → Feedback Generator: generates feedback (evidence: `dashboard/app.py`)
- Recruiter Dashboard → Email Sender: sends approved mail (evidence: `README.md`)
- Recruiter Dashboard → Applicant Tracker: updates review status (evidence: `README.md`)
- Inbox Poller → IMAP / SMTP: polls IMAP (evidence: `rpa/inbox_poller.py`)
- Email Sender → IMAP / SMTP: sends via SMTP (evidence: `rpa/email_sender.py`)
- Email Sender → Mock Outbox: writes mock mail (evidence: `rpa/email_sender.py`)
