# ericr6/platform_analysis architecture

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

- Interactive diagram: https://gitdiagram.com/ericr6/platform_analysis
- Repository: https://github.com/ericr6/platform_analysis

## Overview

##### Project type and purpose
- This is a data‐analysis project comprised exclusively of Jupyter notebooks, aimed at “platform_analysis” on Google Colab.
- There are no distinct frontend or backend services—each notebook represents an interactive data‐processing step that runs in the Colab environment.

##### File structure
- Top level:
- README.md – brief project description
- TRD.ipynb, Voucher_Report.ipynb, deal_analysis.ipynb, hw_analysis.ipynb, reach_campaign.ipynb – individual analysis modules
- No separate source directory, libraries, or configuration files beyond the notebooks themselves.

##### README for additional insights
- Confirms the project lives in Google Colab.

##### Elements
- Clear labels for: Data Sources, Colab Environment, Individual Notebooks, Python Kernel & Libraries, Outputs
– Data ingestion flows (Data Source → Notebook)
– Processing flows (Notebook → Python library modules → intermediate data stores)
– Output flows (Notebook → Report/Visualization → Storage/GitHub)
– A third for outputs (reports, dashboards)
- Cluster boundaries:

##### Final advice
- Data lineage end-to-end.
- Avoid overthinking—there is no hidden microservice layer; it’s simply a set of notebooks processing data in Colab.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Systems
    subgraph "External Data Sources" 
        direction TB
        DS1["Google Drive"]:::external
        DS2["BigQuery"]:::external
        DS3["S3"]:::external
        DS4["CSV/Excel Files"]:::external
    end

    ProjectOverview["Project Description\n(README.md)"]:::external
    click ProjectOverview "https://github.com/ericr6/platform_analysis/blob/main/README.md"

    %% Compute Environment
    subgraph "Google Colab Environment" 
        direction TB
        Kernel["Python Kernel & Libraries\n(pandas, NumPy, matplotlib, seaborn)"]:::compute

        TRD["TRD Analysis\n(TRD.ipynb)"]:::compute
        click TRD "https://github.com/ericr6/platform_analysis/blob/main/TRD.ipynb"

        Voucher["Voucher Usage Report\n(Voucher_Report.ipynb)"]:::compute
        click Voucher "https://github.com/ericr6/platform_analysis/blob/main/Voucher_Report.ipynb"

        Deal["Deal Analysis\n(deal_analysis.ipynb)"]:::compute
        click Deal "https://github.com/ericr6/platform_analysis/blob/main/deal_analysis.ipynb"

        HW["Hardware Analysis\n(hw_analysis.ipynb)"]:::compute
        click HW "https://github.com/ericr6/platform_analysis/blob/main/hw_analysis.ipynb"

        Reach["Reach Campaign Analysis\n(reach_campaign.ipynb)"]:::compute
        click Reach "https://github.com/ericr6/platform_analysis/blob/main/reach_campaign.ipynb"
    end

    %% Outputs
    subgraph "Outputs & Storage" 
        direction TB
        Reports["Reports & Visualizations\n(PDF/HTML)"]:::output
        GitHub["GitHub Repository"]:::external
        DriveOut["Google Drive"]:::external
    end

    %% Data flows
    DS1 -->|ingest| TRD
    DS2 -->|ingest| TRD
    DS3 -->|ingest| TRD
    DS4 -->|ingest| TRD

    DS1 -->|ingest| Voucher
    DS2 -->|ingest| Voucher
    DS3 -->|ingest| Voucher
    DS4 -->|ingest| Voucher

    DS1 -->|ingest| Deal
    DS2 -->|ingest| Deal
    DS3 -->|ingest| Deal
    DS4 -->|ingest| Deal

    DS1 -->|ingest| HW
    DS2 -->|ingest| HW
    DS3 -->|ingest| HW
    DS4 -->|ingest| HW

    DS1 -->|ingest| Reach
    DS2 -->|ingest| Reach
    DS3 -->|ingest| Reach
    DS4 -->|ingest| Reach

    %% Processing flows
    TRD -->|"uses"| Kernel
    Voucher -->|"uses"| Kernel
    Deal -->|"uses"| Kernel
    HW -->|"uses"| Kernel
    Reach -->|"uses"| Kernel

    %% Output flows
    TRD -->|"generates"| Reports
    Voucher -->|"generates"| Reports
    Deal -->|"generates"| Reports
    HW -->|"generates"| Reports
    Reach -->|"generates"| Reports

    Reports -->|"stores to"| DriveOut
    Reports -->|"push to"| GitHub

    %% Project overview link
    ProjectOverview -->|"repo pull/push"| GitHub

    %% Styles
    classDef external fill:#E0F7FA,stroke:#006064,color:#004D40
    classDef compute fill:#BBDEFB,stroke:#0D47A1,color:#0D47A1
    classDef output fill:#C8E6C9,stroke:#2E7D32,color:#1B5E20
```
