# hanfia-sattar/rossmore_sales_project architecture

> Architecture diagram of the GitHub repository hanfia-sattar/rossmore_sales_project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hanfia-sattar/rossmore_sales_project
- Repository: https://github.com/hanfia-sattar/rossmore_sales_project

## Overview

This repository is a Rossmann store-sales analysis and forecasting project, with both a Streamlit dashboard and a command-line workflow. The command-line path loads sales data, explores and preprocesses it, runs forecasting, then generates business insights. A separate Streamlit app implements a store-series LSTM forecasting flow. The larger dashboard advertises preprocessing, model training, forecasts, and insights; its source is only partially excerpted, so unshown runtime links are omitted. The README is empty, and no external service integration is evident in the sampled material.

Main entry points: [`main.py`](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/main.py) (CLI Workflow), [`forecasting_pipeline.py`](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/forecasting_pipeline.py) (Forecast Pipeline), [`app.py`](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/app.py) (LSTM App), [`data_preprocessing.py`](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/data_preprocessing.py) (Data Preparation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Analysis Workflow"]
  node_cli_workflow["CLI Workflow<br/>[main.py]"]
  node_exploration["Exploratory Analysis"]
  node_preprocessing["Data Preparation"]
  node_insights["Business Insights"]
  node_data_cal["Data Calculations<br/>[data_cal.py]"]
end

subgraph group_dashboard["User Interfaces"]
  node_main_dashboard["Forecast Dashboard<br/>[dashboard.py]"]
  node_dashboard_copy["Dashboard Copy<br/>[dashboard_copy.py]"]
  node_lstm_app["LSTM App<br/>[app.py]"]
end

subgraph group_modeling["Forecasting Models"]
  node_forecast_pipeline["Forecast Pipeline"]
  node_hybrid_model["Hybrid Stacking"]
end

subgraph group_artifacts["Data and Artifacts"]
  node_sales_data["Sales Data<br/>[train.csv]"]
  node_store_data["Store Data<br/>[store.csv]"]
  node_forecast_results["Forecast Results"]
  node_saved_model["Saved Model"]
end

node_analyst(("Analyst"))

node_analyst -->|"runs"| node_cli_workflow
node_cli_workflow -->|"loads and prepares"| node_preprocessing
node_cli_workflow -->|"runs analysis"| node_exploration
node_cli_workflow -->|"engineers features"| node_preprocessing
node_cli_workflow -->|"runs forecasts"| node_forecast_pipeline
node_cli_workflow -->|"generates insights"| node_insights
node_analyst -.->|"uses"| node_main_dashboard
node_analyst -.->|"uses"| node_dashboard_copy
node_analyst -->|"uses"| node_lstm_app
node_lstm_app -->|"loads"| node_sales_data
node_forecast_pipeline -->|"saves model"| node_saved_model
node_forecast_pipeline -->|"saves results"| node_forecast_results

click node_cli_workflow "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/main.py"
click node_exploration "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/exploratory_analysis.py"
click node_preprocessing "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/data_preprocessing.py"
click node_insights "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/business_insights.py"
click node_main_dashboard "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/dashboard.py"
click node_dashboard_copy "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/dashboard_copy.py"
click node_lstm_app "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/app.py"
click node_forecast_pipeline "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/forecasting_pipeline.py"
click node_hybrid_model "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/hybrid_stacking_model.py"
click node_sales_data "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/Data/train.csv"
click node_store_data "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/Data/store.csv"
click node_forecast_results "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/sales_forecast_results.csv"
click node_saved_model "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/rossmann_sales_forecast_random_forest_model.pkl"
click node_data_cal "https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/data_cal.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_cli_workflow,node_exploration,node_preprocessing,node_insights,node_data_cal toneBlue
class node_main_dashboard,node_dashboard_copy,node_lstm_app toneAmber
class node_forecast_pipeline,node_hybrid_model toneMint
class node_sales_data,node_store_data,node_forecast_results,node_saved_model toneRose
class node_analyst toneIndigo
```

## Components

### Analysis Workflow

- [CLI Workflow](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/main.py): `main.py`
- [Exploratory Analysis](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/exploratory_analysis.py): `exploratory_analysis.py`
- [Data Preparation](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/data_preprocessing.py): `data_preprocessing.py`
- [Business Insights](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/business_insights.py): `business_insights.py`
- [Data Calculations](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/data_cal.py): `data_cal.py`

### User Interfaces

- [Forecast Dashboard](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/dashboard.py): `dashboard.py`
- [Dashboard Copy](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/dashboard_copy.py): `dashboard_copy.py`
- [LSTM App](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/app.py): `app.py`

### Forecasting Models

- [Forecast Pipeline](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/forecasting_pipeline.py): `forecasting_pipeline.py`
- [Hybrid Stacking](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/hybrid_stacking_model.py): `hybrid_stacking_model.py`

### Data and Artifacts

- [Sales Data](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/Data/train.csv): `Data/train.csv`
- [Store Data](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/Data/store.csv): `Data/store.csv`
- [Forecast Results](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/sales_forecast_results.csv): `sales_forecast_results.csv`
- [Saved Model](https://github.com/hanfia-sattar/rossmore_sales_project/blob/main/rossmann_sales_forecast_random_forest_model.pkl): `rossmann_sales_forecast_random_forest_model.pkl`

### Other components

- **Analyst**

## Connections

- Analyst → CLI Workflow: runs (evidence: `main.py`)
- CLI Workflow → Data Preparation: loads and prepares (evidence: `main.py`)
- CLI Workflow → Exploratory Analysis: runs analysis (evidence: `main.py`)
- CLI Workflow → Data Preparation: engineers features (evidence: `main.py`)
- CLI Workflow → Forecast Pipeline: runs forecasts (evidence: `main.py`)
- CLI Workflow → Business Insights: generates insights (evidence: `main.py`)
- Analyst → Forecast Dashboard: uses
- Analyst → Dashboard Copy: uses
- Analyst → LSTM App: uses (evidence: `app.py`)
- LSTM App → Sales Data: loads (evidence: `app.py`)
- Forecast Pipeline → Saved Model: saves model (evidence: `forecasting_pipeline.py`)
- Forecast Pipeline → Forecast Results: saves results (evidence: `forecasting_pipeline.py`)
