# datasilvia/last-minute-business-case architecture

> Architecture diagram of the GitHub repository datasilvia/last-minute-business-case, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/datasilvia/last-minute-business-case
- Repository: https://github.com/datasilvia/last-minute-business-case

## Overview

##### Project type and purpose
- This is a data-analysis exercise built around Jupyter notebooks.
- Its purpose is to work through a travel-agency business case by answering four distinct analytic questions (Q1–Q4) and delivering visualizations and a final report.

##### File structure
Top level:
- question1.ipynb, question2.ipynb, question3.ipynb, Question_4.ipynb – core analysis notebooks
- Benja.ipynb & Question 4_additional_info.ipynb – personal/ancillary notebooks
- images/ – generated plots and figures
- lastminute_business_case.pdf – final assembled report
- README.md – project overview and links
- .gitignore – version-control settings
Observations:
- All analysis lives in Jupyter notebooks, one per question.
- The PDF report pulls together text, figures, and conclusions.

##### README for additional insights
- Confirms it’s a team exercise in a data-analysis bootcamp.
- No live service or database; the workflow is offline, notebook-driven.

##### Main components
a. Data Sources (raw travel-agency data; CSVs/Databases – implied)
b. ETL / Preprocessing layer (in-notebook code cells that ingest & clean data)
c. Analysis Notebooks (Q1, Q2, Q3, Q4)
d. Visualization Outputs (images/*.png, .jpg)
e. Final Report (lastminute_business_case.pdf)
f. Version Control (GitHub repo)

##### Relationships and data flow
- Raw Data → preprocessing cells → Cleaned Data
- Cleaned Data → Q1 notebook → Q1 outputs
- Cleaned Data → Q2 notebook → Q2 outputs
- … similarly for Q3 & Q4
- All notebook outputs → images folder → final report assembly → PDF
- Entire code + assets tracked in Git → GitHub

##### Architectural patterns and principles
- Modular notebook per question for separation of concerns
- Reproducible research pattern: each notebook can be rerun end to end
- Version control ensures collaboration and traceability

##### Key technologies and libraries
- Python & Jupyter Notebook
- Pandas for data manipulation
- Matplotlib / Seaborn (or similar) for visualization
- Git / GitHub for source control
- PDF assembler (e.g., nbconvert or external tool)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Ingestion and Preprocessing
    DataSources["Raw Data (CSVs)"]:::dataArtifact
    Preprocessing["ETL / Preprocessing"]:::processing
    CleanedData["Cleaned Data"]:::dataArtifact

    DataSources -->|"raw_data.csv"| Preprocessing
    Preprocessing -->|"cleaned_data.csv"| CleanedData

    %% Analysis Notebooks
    subgraph "Analysis Stage"
        direction TB
        Notebook1["Q1 Notebook"]:::processing
        Notebook2["Q2 Notebook"]:::processing
        Notebook3["Q3 Notebook"]:::processing
        Notebook4["Q4 Notebook"]:::processing
        subgraph "Ancillary Notebooks"
            direction TB
            Benja["Benja.ipynb"]:::processing
            Q4Info["Question 4_additional_info.ipynb"]:::processing
        end
    end

    CleanedData -->|"cleaned_data.csv"| Notebook1
    CleanedData -->|"cleaned_data.csv"| Notebook2
    CleanedData -->|"cleaned_data.csv"| Notebook3
    CleanedData -->|"cleaned_data.csv"| Notebook4
    CleanedData -->|"cleaned_data.csv"| Benja
    CleanedData -->|"cleaned_data.csv"| Q4Info

    %% Visualization Store
    Images["images/ (plots & figures)"]:::dataArtifact
    Notebook1 -->|"plot_Q1.png"| Images
    Notebook2 -->|"plot_Q2.png"| Images
    Notebook3 -->|"plot_Q3.png"| Images
    Notebook4 -->|"plot_Q4.png"| Images
    Benja -->|"plots"| Images
    Q4Info -->|"plots"| Images

    %% Report Generation
    ReportGen["Report Generator (nbconvert)"]:::processing
    Images -->|"figures folder"| ReportGen
    ReportGen -->|"lastminute_business_case.pdf"| PDF["Final Report PDF"]:::deliverable

    %% Version Control
    subgraph "Version Control"
        direction TB
        README["README.md"]:::infra
        GitIgnore[".gitignore"]:::infra
        RepoHub["GitHub Repository"]:::infra
    end

    Notebook1 -->|commit| RepoHub
    Notebook2 -->|commit| RepoHub
    Notebook3 -->|commit| RepoHub
    Notebook4 -->|commit| RepoHub
    Benja -->|commit| RepoHub
    Q4Info -->|commit| RepoHub
    Images -->|add| RepoHub
    PDF -->|add| RepoHub
    README -->|add| RepoHub
    GitIgnore -->|add| RepoHub

    %% Click Events
    click Notebook1 "https://github.com/datasilvia/last-minute-business-case/blob/main/question1.ipynb"
    click Notebook2 "https://github.com/datasilvia/last-minute-business-case/blob/main/question2.ipynb"
    click Notebook3 "https://github.com/datasilvia/last-minute-business-case/blob/main/question3.ipynb"
    click Notebook4 "https://github.com/datasilvia/last-minute-business-case/blob/main/Question_4.ipynb"
    click Benja "https://github.com/datasilvia/last-minute-business-case/blob/main/Benja.ipynb"
    click Q4Info "https://github.com/datasilvia/last-minute-business-case/blob/main/Question 4_additional_info.ipynb"
    click Images "https://github.com/datasilvia/last-minute-business-case/tree/main/images/"
    click PDF "https://github.com/datasilvia/last-minute-business-case/blob/main/lastminute_business_case.pdf"
    click README "https://github.com/datasilvia/last-minute-business-case/blob/main/README.md"
    click GitIgnore "https://github.com/datasilvia/last-minute-business-case/blob/main/.gitignore"

    %% Styling
    classDef dataArtifact fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef processing fill:#90EE90,stroke:#333,stroke-width:1px
    classDef deliverable fill:#FFCC99,stroke:#333,stroke-width:1px
    classDef infra fill:#D3D3D3,stroke:#333,stroke-width:1px
```
