# chegefranklynn/jobapplication architecture

> Architecture diagram of the GitHub repository chegefranklynn/jobapplication, 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/chegefranklynn/jobapplication
- Repository: https://github.com/chegefranklynn/jobapplication

## Overview

This PHP job-application automation system centers on scraping job listings: a CLI accepts a URL and scraper type, a factory selects static or dynamic scraping, and results are displayed. The README also describes output formatting and a Puppeteer bridge. A separate resume-processing service parses uploads, calculates ATS scores, matches skills against jobs, and persists applicant, resume, and match data. The graph preserves these documented capabilities, but source excerpts do not establish every implementation link; uncertain links are omitted. The resume parser implementation is not present in the tree, so its node points to the existing Resume directory.

Main entry points: [`src/php/Service/ResumeProcessor.php`](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Service/ResumeProcessor.php) (Resume Processor), [`src/cli/run.php`](https://github.com/chegefranklynn/jobapplication/blob/main/src/cli/run.php) (Scrape CLI), [`src/php/patterns/ScraperFactory.php`](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/patterns/ScraperFactory.php) (Scraper Factory), [`src/php/Domain/scraping/contracts/dynamicscraper.php`](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/scraping/contracts/dynamicscraper.php) (Dynamic Scraper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scrape["Job Scraping"]
  node_cli["Scrape CLI<br/>[run.php]"]
  node_factory["Scraper Factory<br/>[ScraperFactory.php]"]
  node_static["Static Scraper<br/>[staticscraper.php]"]
  node_dynamic["Dynamic Scraper<br/>[dynamicscraper.php]"]
  node_puppeteer["Puppeteer Bridge<br/>[puppeter.js]"]
end

subgraph group_resume["Resume Processing"]
  node_processor["Resume Processor"]
  node_parser["Resume Parser"]
  node_ats["ATS Optimizer<br/>[AtsOptimizer.php]"]
  node_matcher["Skill Matcher<br/>[skillMatcher.php]"]
end

subgraph group_domain["Domain Models"]
  node_applicant["Applicant Model<br/>[Applicant.php]"]
  node_job["Job Model<br/>[job.php]"]
  node_experience["Experience Range"]
end

subgraph group_persistence["Persistence"]
  node_repository["Resume Repository"]
  node_database[("Application Database")]
end

node_user(("CLI User"))
node_websites["Job Websites"]
node_resume_input(("Resume Upload"))

node_user -->|"runs scrape"| node_cli
node_cli -->|"creates scraper"| node_factory
node_factory -->|"selects static"| node_static
node_factory -->|"selects dynamic"| node_dynamic
node_cli -->|"scrapes URL"| node_websites
node_dynamic -->|"uses bridge"| node_puppeteer
node_dynamic -->|"scrapes URL"| node_websites
node_resume_input -.->|"submits resume"| node_processor
node_processor -->|"parses upload"| node_parser
node_processor -->|"calculates score"| node_ats
node_processor -->|"matches skills"| node_matcher
node_processor -->|"saves records"| node_repository
node_repository -->|"writes records"| node_database
node_repository -->|"persists applicant"| node_applicant
node_job -->|"uses range"| node_experience

click node_cli "https://github.com/chegefranklynn/jobapplication/blob/main/src/cli/run.php"
click node_factory "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/patterns/ScraperFactory.php"
click node_static "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/scraping/contracts/staticscraper.php"
click node_dynamic "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/scraping/contracts/dynamicscraper.php"
click node_puppeteer "https://github.com/chegefranklynn/jobapplication/blob/main/src/node/puppeter.js"
click node_processor "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Service/ResumeProcessor.php"
click node_parser "https://github.com/chegefranklynn/jobapplication/tree/main/src/php/Resume"
click node_ats "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Resume/AtsOptimizer.php"
click node_matcher "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Resume/skillMatcher.php"
click node_applicant "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/Applicant.php"
click node_job "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/job.php"
click node_experience "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/ValueObject/ExperienceRange.php"
click node_repository "https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Repositories/ResumeRepository.php"

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_cli,node_factory,node_static,node_dynamic,node_puppeteer,node_user toneBlue
class node_processor,node_parser,node_ats,node_matcher toneAmber
class node_applicant,node_job,node_experience toneMint
class node_repository,node_database toneRose
class node_websites,node_resume_input toneIndigo
```

## Components

### Job Scraping

- [Scrape CLI](https://github.com/chegefranklynn/jobapplication/blob/main/src/cli/run.php): `src/cli/run.php`
- [Scraper Factory](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/patterns/ScraperFactory.php): `src/php/patterns/ScraperFactory.php`
- [Static Scraper](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/scraping/contracts/staticscraper.php): `src/php/Domain/scraping/contracts/staticscraper.php`
- [Dynamic Scraper](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/scraping/contracts/dynamicscraper.php): `src/php/Domain/scraping/contracts/dynamicscraper.php`
- [Puppeteer Bridge](https://github.com/chegefranklynn/jobapplication/blob/main/src/node/puppeter.js): `src/node/puppeter.js`

### Resume Processing

- [Resume Processor](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Service/ResumeProcessor.php): `src/php/Service/ResumeProcessor.php`
- [Resume Parser](https://github.com/chegefranklynn/jobapplication/tree/main/src/php/Resume): `src/php/Resume`
- [ATS Optimizer](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Resume/AtsOptimizer.php): `src/php/Resume/AtsOptimizer.php`
- [Skill Matcher](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Resume/skillMatcher.php): `src/php/Resume/skillMatcher.php`

### Domain Models

- [Applicant Model](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/Applicant.php): `src/php/Domain/Models/Applicant.php`
- [Job Model](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/job.php): `src/php/Domain/Models/job.php`
- [Experience Range](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Domain/Models/ValueObject/ExperienceRange.php): `src/php/Domain/Models/ValueObject/ExperienceRange.php`

### Persistence

- [Resume Repository](https://github.com/chegefranklynn/jobapplication/blob/main/src/php/Repositories/ResumeRepository.php): `src/php/Repositories/ResumeRepository.php`
- **Application Database**

### Other components

- **CLI User**
- **Job Websites**
- **Resume Upload**

## Connections

- CLI User → Scrape CLI: runs scrape (evidence: `README.md`)
- Scrape CLI → Scraper Factory: creates scraper (evidence: `src/cli/run.php`)
- Scraper Factory → Static Scraper: selects static (evidence: `src/php/patterns/ScraperFactory.php`)
- Scraper Factory → Dynamic Scraper: selects dynamic (evidence: `src/php/patterns/ScraperFactory.php`)
- Scrape CLI → Job Websites: scrapes URL (evidence: `README.md`)
- Dynamic Scraper → Puppeteer Bridge: uses bridge (evidence: `README.md`)
- Dynamic Scraper → Job Websites: scrapes URL (evidence: `README.md`)
- Resume Upload → Resume Processor: submits resume
- Resume Processor → Resume Parser: parses upload (evidence: `src/php/Service/ResumeProcessor.php`)
- Resume Processor → ATS Optimizer: calculates score (evidence: `src/php/Service/ResumeProcessor.php`)
- Resume Processor → Skill Matcher: matches skills (evidence: `src/php/Service/ResumeProcessor.php`)
- Resume Processor → Resume Repository: saves records (evidence: `src/php/Service/ResumeProcessor.php`)
- Resume Repository → Application Database: writes records (evidence: `src/php/Repositories/ResumeRepository.php`)
- Resume Repository → Applicant Model: persists applicant (evidence: `src/php/Repositories/ResumeRepository.php`)
- Job Model → Experience Range: uses range (evidence: `src/php/Domain/Models/job.php`)
