# otniel113/ba-jobsim architecture

> Architecture diagram of the GitHub repository otniel113/ba-jobsim, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/otniel113/ba-jobsim
- Repository: https://github.com/otniel113/ba-jobsim

## Overview

##### Project type and purpose
- This is a data‐science “job simulation” project (BA-JobSim) consisting of two main Python Jupyter notebooks: one for web scraping/insight generation, and one for ML feature importance and prediction.
- Purpose: scrape customer reviews of British Airways, analyze perceptions, select key booking variables, train/predict a customer booking outcome, and summarize findings in a PPTX.

##### File structure
Top-level files:
- BA_01_Data_Scrapping.ipynb – notebook that fetches and cleans review data from external websites.
- BA_02_ML_Prediction.ipynb – notebook that engineers features, trains a model, and outputs predictions/importance.
- British Airways – Task 01.pptx & Task 02.pptx – slide decks containing visual summaries of each task’s results.
- README.md – high-level overview and links.

No separate “src” or “lib” folders; code and analysis live in notebooks. No deployment descriptors or service definitions–this is a local analysis pipeline.

##### README for additional insights
- Confirms two tasks: scraping & insight, then feature-importance and prediction.
- Shows screenshots of intermediate outputs (e.g., charts).
- Lists external links (Forage profile, certificate): ancillary to the core pipeline.

##### Elements
· From Web Data Source → Scraper
· Scraper → Raw Data Store → Processor → Model Trainer → Visualization
· Model Trainer → Trained Model artifact
· Visualization → PPTX & Report

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Sources
    WebSource["Web Data Source<br/>(Review Website)"]:::external
    GitHub["GitHub Repository"]:::external
    README["README.md"]:::doc

    %% ETL Pipeline
    subgraph "ETL Pipeline"
        direction TB
        Scraper["Scraper Module<br/>(BA_01_Data_Scrapping.ipynb)<br/>Python 3.x, BeautifulSoup"]:::compute
        RawData["Raw Data Store<br/>(CSV/JSON or DataFrame)"]:::data
        Processing["Data Processing &<br/>Feature Engineering<br/>(BA_01_Data_Scrapping.ipynb)"]:::compute
    end

    %% Modeling Pipeline
    subgraph "Modeling & Output"
        direction TB
        MLModeling["ML Modeling Module<br/>(BA_02_ML_Prediction.ipynb)<br/>scikit-learn"]:::compute
        TrainedModel["Trained Model Artifact<br/>(pickle)"]:::data
        Visualization["Prediction Output & Visualization<br/>(BA_02_ML_Prediction.ipynb)<br/>matplotlib/seaborn"]:::compute
    end

    %% Reporting
    subgraph "Reporting"
        direction TB
        PPT1["Task 01 Findings<br/>(Insight Summary Slides)"]:::report
        PPT2["Task 02 Findings<br/>(Model Results Slides)"]:::report
    end

    %% Connections
    WebSource -->|HTML| Scraper
    Scraper -->|CSV/DF| RawData
    RawData -->|DataFrame| Processing
    Processing -->|Feature Matrix| MLModeling
    MLModeling -->|Model| TrainedModel
    MLModeling -->|Predictions & Charts| Visualization
    Visualization -->|Embed Charts| PPT1
    Visualization -->|Embed Charts| PPT2

    %% Version Control & Docs
    Scraper -->|versioned in| GitHub
    Processing -->|versioned in| GitHub
    MLModeling -->|versioned in| GitHub
    Visualization -->|versioned in| GitHub
    PPT1 -->|tracked in| GitHub
    PPT2 -->|tracked in| GitHub
    GitHub -->|documentation| README

    %% Click Events
    click Scraper "https://github.com/otniel113/ba-jobsim/blob/main/BA_01_Data_Scrapping.ipynb"
    click Processing "https://github.com/otniel113/ba-jobsim/blob/main/BA_01_Data_Scrapping.ipynb"
    click MLModeling "https://github.com/otniel113/ba-jobsim/blob/main/BA_02_ML_Prediction.ipynb"
    click Visualization "https://github.com/otniel113/ba-jobsim/blob/main/BA_02_ML_Prediction.ipynb"
    click PPT1 "https://github.com/otniel113/ba-jobsim/blob/main/British Airways - Task 01.pptx"
    click PPT2 "https://github.com/otniel113/ba-jobsim/blob/main/British Airways - Task 02.pptx"
    click README "https://github.com/otniel113/ba-jobsim/blob/main/README.md"

    %% Styles
    classDef data fill:#FFD580,stroke:#DDA000;
    classDef compute fill:#80C0FF,stroke:#0077C8;
    classDef report fill:#C0FF80,stroke:#44A000;
    classDef external fill:#E0E0E0,stroke:#888888;
    classDef doc fill:#F0E0F0,stroke:#AA77AA;
```
