# abrahamtartalos/prediccion-aterrizaje-falcon9-spacex architecture

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

- Interactive diagram: https://gitdiagram.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex
- Repository: https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex

## Overview

##### Identificación del tipo de proyecto y su propósito
- Este es un proyecto de ciencia de datos/ML cuyo objetivo es predecir el éxito del aterrizaje de la primera etapa del Falcon 9 de SpaceX.
- Incluye un pipeline ETL (Extracción, Transformación y Carga), análisis exploratorio, modelado, evaluación y despliegue de resultados en una aplicación Dash.

##### Análisis de la estructura de archivos
- data/
- raw/ ─ datos brutos obtenidos de la API de SpaceX y scrapping web
- interim/ ─ datos parcialmente procesados (split, limpieza básica)
- processed/ ─ dataset final listo para modelar
- ingestion/ ─ notebooks de extracción de datos (API + webscraping)
- preprocessing/ ─ notebook de wrangling y estandarización de variables
- exploration/ ─ notebooks de EDA y visualización
- modeling/ ─ notebooks de creación, ajuste y comparación de modelos
- results/
- ds-capstone-coursera.pdf ─ informe final
- spacex_dash_app.py ─ código de la aplicación Dash para visualización interactiva
- requirements.txt y venv/ ─ entorno de Python y dependencias

##### Puntos clave del README
- Descripción clara: análisis predictivo de aterrizajes exitosos.
- Tecnologías implicadas: Python, Jupyter, scikit-learn (u otras librerías ML), Dash.

##### Componentes principales y relaciones (Diagrama de alto nivel)
a. Fuentes de datos
- API SpaceX
- Web scraping
b. Ingestión (ETL)
- Notebooks en ingestion/
- Generan data/raw/*.csv
c. Almacenamiento intermedio
- data/interim/*.csv
d. Preprocesamiento
- Notebook en preprocessing/
- Produce data/processed/data_set_processed.csv
e. Análisis exploratorio
- Notebooks en exploration/
- Consume raw/interim/processed
f. Modelado
- Notebooks en modeling/
- Crea modelos ML y guarda métricas
g. Resultados y despliegue
- Informe PDF en results/
- Aplicación Dash (spacex_dash_app.py) consume modelos o data procesada
h. Entorno de ejecución
- venv/ con todas las dependencias listadas en requirements.txt

##### Patrones y principios arquitectónicos
- Pipeline secuencial ETL + ML
- Cada fase aislada en carpetas y notebooks para reproducibilidad
- Separación clara entre datos (data/), código (ingestion/, preprocessing/, modeling/, results/) y entorno (venv/)

##### Guías para el diagrama
- Usar cajas (rectángulos) para cada componente lógico: “Fuente API”, “Web scraping”, “Ingestión”, “Raw Data”, “Preprocesamiento”, “Interim Data”, “Modelado”, “Resultados/Dash App”.
- Conectar con flechas direccionales que indiquen flujos de datos (✔ extracción → raw → interim → processed → modelado → dashboard).
- Azul para almacenamiento de datos (data/)
- Verde para notebooks de proceso (ingestion/, preprocessing/, modeling/, exploration/)
- Naranja para despliegue (Dash App, informes)
- Gris para entorno (venv, requirements.txt)
- Etiquetar cada flecha con el tipo de artefacto (.csv, modelo entrenado, métrica, dashboard HTTP).
- Incluir leyenda con colores y formas.

##### Detalle mínimo indispensable
- No agrupar demasiado: cada carpeta/notebook como un componente.
- Mostrar interacciones hacia/desde el entorno virtual (venv) para indicar dependencias.
- Señalar tecnologías clave en cada nodo (Python, Jupyter, scikit-learn, Dash).

Con este diagrama el equipo obtendrá una visión clara, reproducible y detallada del flujo de datos y componentes de “prediccion-aterrizaje-falcon9-spacex”.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Data Sources
    API["API SpaceX"]:::process
    WS["Web Scraping"]:::process

    %% Ingestion Notebooks
    ING_API["API Data Ingestion Notebook"]:::process
    ING_WS["Web Scraping Ingestion Notebook"]:::process

    %% Raw Data Storage
    RAW1["dataset_part_1.csv"]:::storage
    RAW2["spacex_web_scraped.csv"]:::storage

    %% Interim Data Storage
    INTERIM["dataset_part_2.csv"]:::storage

    %% Preprocessing
    PRE["Preprocessing Notebook"]:::process

    %% Processed Data
    PROC["data_set_processed.csv"]:::storage

    %% Exploration Notebooks
    EDA1["EDA & Visualization Notebook"]:::process
    EDA2["EDA SQL Notebook"]:::process
    EDA3["Launch Site EDA Notebook"]:::process

    %% Modeling
    MODEL["Modeling Notebook"]:::process

    %% Results & Deployment
    REPORT["Final Report PDF"]:::deploy
    DASH["Dash Application"]:::deploy

    %% Environment
    REQ["requirements.txt"]:::env
    VENV["venv/"]:::env

    %% Flows
    API -->|"JSON/.csv"| ING_API
    WS -->|"HTML/.csv"| ING_WS

    ING_API -->|".csv"| RAW1
    ING_WS -->|".csv"| RAW2

    RAW1 -->|".csv"| INTERIM
    RAW2 -->|".csv"| INTERIM

    INTERIM -->|".csv"| PRE
    PRE -->|".csv"| PROC

    RAW1 -->|consumed| EDA1
    RAW2 -->|consumed| EDA1
    INTERIM -->|consumed| EDA1
    PROC -->|consumed| EDA1

    RAW1 -->|consumed| EDA2
    RAW2 -->|consumed| EDA2
    INTERIM -->|consumed| EDA2
    PROC -->|consumed| EDA2

    RAW1 -->|consumed| EDA3
    RAW2 -->|consumed| EDA3
    INTERIM -->|consumed| EDA3
    PROC -->|consumed| EDA3

    PROC -->|".csv"| MODEL
    MODEL -->|"trained model & metrics"| REPORT
    MODEL -->|"trained model"| DASH
    PROC -->|"processed data"| DASH

    %% Environment Dependencies
    REQ --> ING_API
    REQ --> ING_WS
    REQ --> PRE
    REQ --> EDA1
    REQ --> EDA2
    REQ --> EDA3
    REQ --> MODEL
    REQ --> DASH

    VENV --> ING_API
    VENV --> ING_WS
    VENV --> PRE
    VENV --> EDA1
    VENV --> EDA2
    VENV --> EDA3
    VENV --> MODEL
    VENV --> DASH

    %% Click Events
    click ING_API "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/ingestion/jupyter-labs-spacex-data-collection-api.ipynb"
    click ING_WS "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/ingestion/jupyter-labs-webscraping.ipynb"
    click RAW1 "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/data/raw/dataset_part_1.csv"
    click RAW2 "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/data/raw/spacex_web_scraped.csv"
    click INTERIM "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/data/interim/dataset_part_2.csv"
    click PRE "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/preprocessing/labs-jupyter-spacex-Data wrangling.ipynb"
    click PROC "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/data/processed/data_set_processed.csv"
    click EDA1 "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/exploration/jupyter-labs-eda-dataviz.ipynb.jupyterlite.ipynb"
    click EDA2 "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/exploration/jupyter-labs-eda-sql-coursera_sqllite.ipynb"
    click EDA3 "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/exploration/lab_jupyter_launch_site_location.jupyterlite.ipynb"
    click MODEL "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/modeling/SpaceX_Machine_Learning_Prediction_Part_5.jupyterlite.ipynb"
    click REPORT "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/results/ds-capstone-coursera.pdf"
    click DASH "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/results/spacex_dash_app.py"
    click REQ "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/blob/main/requirements.txt"
    click VENV "https://github.com/abrahamtartalos/prediccion-aterrizaje-falcon9-spacex/tree/main/venv/"

    %% Styles
    classDef storage fill:#AED6F1,stroke:#21618C,color:#1B4F72
    classDef process fill:#A9DFBF,stroke:#27AE60,color:#145A32
    classDef deploy  fill:#F5B041,stroke:#B9770E,color:#7E5109
    classDef env     fill:#D5D8DC,stroke:#566573,color:#2E4053
```
