# farazajmal/gp-ultrahub-availability architecture

> Architecture diagram of the GitHub repository farazajmal/gp-ultrahub-availability, 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/farazajmal/gp-ultrahub-availability
- Repository: https://github.com/farazajmal/gp-ultrahub-availability

## Overview

This repository collects GP UltraHub clinic information, doctor metadata, services, and appointment availability. The visible main entry point, `scrape.py`, invokes availability scraping; doctor metadata and services are separate scraper capabilities. The sampled availability code includes appointment-flow interaction, slot parsing, and validation, while doctor scraping combines website profiles with clinic data. Several persistence and orchestration details are unsampled, so those links are omitted rather than inferred.

Main entry points: [`scrape_availability.py`](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py) (Availability scraper), [`scrape_services.py`](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_services.py) (Services scraper), [`scrape_doctors.py`](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_doctors.py) (Clinic doctor data), [`scrape.py`](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape.py) (Scrape runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Scrape entry point"]
  node_runner["Scrape runner<br/>[scrape.py]"]
end

subgraph group_doctors["Doctor metadata"]
  node_website_profiles["Website profiles<br/>[scrape_doctors.py]"]
  node_clinic_doctors["Clinic doctor data<br/>[scrape_doctors.py]"]
  node_doctor_metadata["Doctor metadata"]
end

subgraph group_availability["Appointment availability"]
  node_availability_scraper["Availability scraper"]
  node_appointment_flow["Appointment flow"]
  node_slot_parser["Slot parsing"]
  node_availability_validation["Availability validation"]
  node_availability_data["Availability data<br/>[availability.json]"]
end

subgraph group_services["Services information"]
  node_services_scraper["Services scraper<br/>[scrape_services.py]"]
  node_services_data["Services data<br/>[services.json]"]
  node_clinic_directory["Clinic locations<br/>[scrape_services.py]"]
end

node_operator(("Scrape operator"))
node_gp_website{{"GP UltraHub website"}}
node_hotdoc{{"HotDoc"}}

node_operator -.->|"runs"| node_runner
node_runner -->|"calls"| node_availability_scraper
node_clinic_doctors -->|"saves"| node_doctor_metadata
node_availability_scraper -->|"drives"| node_appointment_flow
node_availability_scraper -->|"builds slots"| node_slot_parser
node_availability_scraper -->|"validates"| node_availability_validation
node_website_profiles -->|"fetches profiles"| node_gp_website
node_clinic_doctors -->|"fetches clinic data"| node_hotdoc
node_services_scraper -->|"fetches pages"| node_gp_website
node_services_scraper -->|"extracts locations"| node_clinic_directory
node_services_scraper -->|"writes"| node_services_data

click node_runner "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape.py"
click node_website_profiles "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_doctors.py"
click node_clinic_doctors "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_doctors.py"
click node_doctor_metadata "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/doctors_metadata.json"
click node_availability_scraper "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py"
click node_appointment_flow "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py"
click node_slot_parser "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py"
click node_availability_validation "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py"
click node_availability_data "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/availability.json"
click node_services_scraper "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_services.py"
click node_services_data "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/services.json"
click node_clinic_directory "https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_services.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_runner toneBlue
class node_website_profiles,node_clinic_doctors,node_doctor_metadata toneAmber
class node_availability_scraper,node_appointment_flow,node_slot_parser,node_availability_validation,node_availability_data toneMint
class node_services_scraper,node_services_data,node_clinic_directory toneRose
class node_operator,node_gp_website,node_hotdoc toneIndigo
```

## Components

### Scrape entry point

- [Scrape runner](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape.py): `scrape.py`

### Doctor metadata

- [Website profiles](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_doctors.py): `scrape_doctors.py`
- [Clinic doctor data](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_doctors.py): `scrape_doctors.py`
- [Doctor metadata](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/doctors_metadata.json): `doctors_metadata.json`

### Appointment availability

- [Availability scraper](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py): `scrape_availability.py`
- [Appointment flow](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py): `scrape_availability.py`
- [Slot parsing](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py): `scrape_availability.py`
- [Availability validation](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_availability.py): `scrape_availability.py`
- [Availability data](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/availability.json): `availability.json`

### Services information

- [Services scraper](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_services.py): `scrape_services.py`
- [Services data](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/services.json): `services.json`
- [Clinic locations](https://github.com/farazajmal/gp-ultrahub-availability/blob/main/scrape_services.py): `scrape_services.py`

### Other components

- **Scrape operator**
- **GP UltraHub website**
- **HotDoc**

## Connections

- Scrape operator → Scrape runner: runs
- Scrape runner → Availability scraper: calls (evidence: `scrape.py`)
- Clinic doctor data → Doctor metadata: saves (evidence: `scrape_doctors.py`)
- Availability scraper → Appointment flow: drives (evidence: `scrape_availability.py`)
- Availability scraper → Slot parsing: builds slots (evidence: `scrape_availability.py`)
- Availability scraper → Availability validation: validates (evidence: `scrape_availability.py`)
- Website profiles → GP UltraHub website: fetches profiles (evidence: `scrape_doctors.py`)
- Clinic doctor data → HotDoc: fetches clinic data (evidence: `scrape_doctors.py`)
- Services scraper → GP UltraHub website: fetches pages (evidence: `scrape_services.py`)
- Services scraper → Clinic locations: extracts locations (evidence: `scrape_services.py`)
- Services scraper → Services data: writes (evidence: `scrape_services.py`)
