# coral-lab-asu/job-hunt-ai architecture

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

- Interactive diagram: https://gitdiagram.com/coral-lab-asu/job-hunt-ai
- Repository: https://github.com/coral-lab-asu/job-hunt-ai

## Overview

JobMatch AI Installation Package delivers a prebuilt job-matching application through platform-specific installers. The documented workflow is to run an installer, configure optional environment values, and start the Docker Compose services; users then access the frontend, backend API, and database interfaces. The README also documents semantic search, resume recommendations, reranking, and knowledge-graph exploration, but this repository contains no application source, so those capabilities are represented only at the service level. Database connections and demo-data loading are not shown in available source evidence.

Main entry points: [`docker-compose.yml`](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml) (Compose Stack), [`install.sh`](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.sh) (Linux Installer), [`install.ps1`](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.ps1) (Windows Installer), [`.env.example`](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/.env.example) (Environment Config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_installation["Installation"]
  node_linux_installer["Linux Installer<br/>[install.sh]"]
  node_windows_installer["Windows Installer<br/>[install.ps1]"]
  node_environment["Environment Config<br/>[.env.example]"]
  node_compose["Compose Stack<br/>[docker-compose.yml]"]
end

subgraph group_application["Application Services"]
  node_frontend["Web Frontend<br/>[docker-compose.yml]"]
  node_backend["Backend API<br/>[docker-compose.yml]"]
end

subgraph group_data["Data Services"]
  node_elasticsearch[("Elasticsearch<br/>[docker-compose.yml]")]
  node_neo4j[("Neo4j<br/>[docker-compose.yml]")]
  node_demo_jobs["Demo Jobs<br/>[SDE-Nov21.csv]"]
end

node_user(("Operator"))

node_user -->|"runs"| node_linux_installer
node_user -->|"runs"| node_windows_installer
node_linux_installer -->|"starts services"| node_compose
node_windows_installer -->|"starts services"| node_compose
node_compose -->|"configures"| node_frontend
node_compose -->|"configures"| node_backend
node_compose -->|"configures"| node_elasticsearch
node_compose -->|"configures"| node_neo4j
node_linux_installer -->|"creates from"| node_environment
node_windows_installer -->|"creates from"| node_environment

click node_linux_installer "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.sh"
click node_windows_installer "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.ps1"
click node_environment "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/.env.example"
click node_compose "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml"
click node_frontend "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml"
click node_backend "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml"
click node_elasticsearch "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml"
click node_neo4j "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml"
click node_demo_jobs "https://github.com/coral-lab-asu/job-hunt-ai/blob/main/jobs/SDE-Nov21.csv"

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_linux_installer,node_windows_installer,node_environment,node_compose toneBlue
class node_frontend,node_backend toneAmber
class node_elasticsearch,node_neo4j,node_demo_jobs toneMint
class node_user toneIndigo
```

## Components

### Installation

- [Linux Installer](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.sh): `install.sh`
- [Windows Installer](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/install.ps1): `install.ps1`
- [Environment Config](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/.env.example): `.env.example`
- [Compose Stack](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml): `docker-compose.yml`

### Application Services

- [Web Frontend](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml): `docker-compose.yml`
- [Backend API](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml): `docker-compose.yml`

### Data Services

- [Elasticsearch](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml): `docker-compose.yml`
- [Neo4j](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/docker-compose.yml): `docker-compose.yml`
- [Demo Jobs](https://github.com/coral-lab-asu/job-hunt-ai/blob/main/jobs/SDE-Nov21.csv): `jobs/SDE-Nov21.csv`

### Other components

- **Operator**

## Connections

- Operator → Linux Installer: runs (evidence: `README.md`)
- Operator → Windows Installer: runs (evidence: `README.md`)
- Linux Installer → Compose Stack: starts services (evidence: `README.md`)
- Windows Installer → Compose Stack: starts services (evidence: `README.md`)
- Compose Stack → Web Frontend: configures (evidence: `README.md`)
- Compose Stack → Backend API: configures (evidence: `README.md`)
- Compose Stack → Elasticsearch: configures (evidence: `README.md`)
- Compose Stack → Neo4j: configures (evidence: `README.md`)
- Linux Installer → Environment Config: creates from (evidence: `README.md`)
- Windows Installer → Environment Config: creates from (evidence: `README.md`)
