# fatfatma/novashop-business-analysis architecture

> Architecture diagram of the GitHub repository fatfatma/novashop-business-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fatfatma/novashop-business-analysis
- Repository: https://github.com/fatfatma/novashop-business-analysis

## Overview

NovaShop is a Business Analyst case study, not an implementation of an e-commerce platform. Its main workflow moves from framing a conversion problem through requirements and process analysis, data-backed diagnosis, solution design, and validation; the dashboard and AI assessment are additional deliverables. The README documents the lifecycle, while sampled Python excerpts confirm dataset generation and analytical work. Source for several documented subsystems was not sampled, so their internal wiring is not inferred.

Main entry points: [`data/raw/v4`](https://github.com/fatfatma/novashop-business-analysis/tree/main/data/raw/v4) (V4 raw data), [`06_Root_Cause_Analysis`](https://github.com/fatfatma/novashop-business-analysis/tree/main/06_Root_Cause_Analysis) (Root-cause analysis), [`09_Solution_Design`](https://github.com/fatfatma/novashop-business-analysis/tree/main/09_Solution_Design) (Solution design), [`05_Data_Analysis/01_eda_business_kpi.py`](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/01_eda_business_kpi.py) (KPI validation & EDA)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Business Discovery"]
  node_problem["Problem & scope"]
  node_stakeholder_analysis["Stakeholder analysis"]
  node_requirements["Requirements"]
  node_process["Process analysis"]
end

subgraph group_analysis["Data Analysis"]
  node_raw_data[("V4 raw data")]
  node_generator["Dataset generation<br/>[create_dataset.py]"]
  node_kpi_eda["KPI validation &amp; EDA"]
  node_trend["Conversion &amp; funnel"]
  node_funnel_analysis["Funnel analysis"]
  node_segment_analysis["Segment diagnostics"]
end

subgraph group_diagnosis["Diagnosis &amp; Insights"]
  node_root_cause["Root-cause analysis"]
  node_recommendations["Recommendations"]
  node_dashboard["KPI dashboard<br/>[index.html]"]
  node_ai["AI opportunity assessment"]
end

subgraph group_solution["Solution Design"]
  node_solution_design["Solution design"]
end

subgraph group_delivery["Monitoring &amp; Validation"]
  node_testing["Testing &amp; UAT"]
  node_final_docs["Final project report"]
end

node_stakeholders(("Business stakeholders"))

node_stakeholders -->|"frame problem"| node_problem
node_problem -->|"identify stakeholders"| node_stakeholder_analysis
node_stakeholder_analysis -->|"inform requirements"| node_requirements
node_requirements -->|"define change"| node_process
node_generator -->|"generates dataset"| node_raw_data
node_raw_data -->|"read data"| node_kpi_eda
node_raw_data -->|"read data"| node_trend
node_raw_data -->|"read data"| node_funnel_analysis
node_raw_data -->|"read data"| node_segment_analysis
node_kpi_eda -->|"inform diagnosis"| node_root_cause
node_trend -->|"inform diagnosis"| node_root_cause
node_funnel_analysis -->|"inform diagnosis"| node_root_cause
node_segment_analysis -->|"inform diagnosis"| node_root_cause
node_root_cause -->|"guide actions"| node_recommendations
node_recommendations -->|"inform design"| node_solution_design
node_ai -.->|"inform design"| node_solution_design
node_kpi_eda -->|"supports KPIs"| node_dashboard
node_solution_design -->|"define validation"| node_testing
node_solution_design -->|"summarize proposal"| node_final_docs
node_testing -->|"report outcomes"| node_final_docs

click node_problem "https://github.com/fatfatma/novashop-business-analysis/tree/main/01_Business_Problem"
click node_stakeholder_analysis "https://github.com/fatfatma/novashop-business-analysis/tree/main/02_Stakeholder_Analysis"
click node_requirements "https://github.com/fatfatma/novashop-business-analysis/tree/main/03_Requirements"
click node_process "https://github.com/fatfatma/novashop-business-analysis/tree/main/04_Process_Analysis"
click node_raw_data "https://github.com/fatfatma/novashop-business-analysis/tree/main/data/raw/v4"
click node_generator "https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/Data_Generation/create_dataset.py"
click node_kpi_eda "https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/01_eda_business_kpi.py"
click node_trend "https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/02_conversion_trend.py"
click node_funnel_analysis "https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/03_funnel_analysis.py"
click node_segment_analysis "https://github.com/fatfatma/novashop-business-analysis/tree/main/05_Data_Analysis"
click node_root_cause "https://github.com/fatfatma/novashop-business-analysis/tree/main/06_Root_Cause_Analysis"
click node_recommendations "https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/09_recommendations.py"
click node_dashboard "https://github.com/fatfatma/novashop-business-analysis/blob/main/07_Dashboard/dashboard/index.html"
click node_ai "https://github.com/fatfatma/novashop-business-analysis/tree/main/08_AI_Solution"
click node_solution_design "https://github.com/fatfatma/novashop-business-analysis/tree/main/09_Solution_Design"
click node_testing "https://github.com/fatfatma/novashop-business-analysis/tree/main/10_Testing"
click node_final_docs "https://github.com/fatfatma/novashop-business-analysis/tree/main/11_Project_Documentation"

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_problem,node_stakeholder_analysis,node_requirements,node_process toneBlue
class node_raw_data,node_generator,node_kpi_eda,node_trend,node_funnel_analysis,node_segment_analysis toneAmber
class node_root_cause,node_recommendations,node_dashboard,node_ai toneMint
class node_solution_design toneRose
class node_testing,node_final_docs,node_stakeholders toneIndigo
```

## Components

### Business Discovery

- [Problem & scope](https://github.com/fatfatma/novashop-business-analysis/tree/main/01_Business_Problem): `01_Business_Problem`
- [Stakeholder analysis](https://github.com/fatfatma/novashop-business-analysis/tree/main/02_Stakeholder_Analysis): `02_Stakeholder_Analysis`
- [Requirements](https://github.com/fatfatma/novashop-business-analysis/tree/main/03_Requirements): `03_Requirements`
- [Process analysis](https://github.com/fatfatma/novashop-business-analysis/tree/main/04_Process_Analysis): `04_Process_Analysis`

### Data Analysis

- [V4 raw data](https://github.com/fatfatma/novashop-business-analysis/tree/main/data/raw/v4): `data/raw/v4`
- [Dataset generation](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/Data_Generation/create_dataset.py): `05_Data_Analysis/Data_Generation/create_dataset.py`
- [KPI validation & EDA](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/01_eda_business_kpi.py): `05_Data_Analysis/01_eda_business_kpi.py`
- [Conversion & funnel](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/02_conversion_trend.py): `05_Data_Analysis/02_conversion_trend.py`
- [Funnel analysis](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/03_funnel_analysis.py): `05_Data_Analysis/03_funnel_analysis.py`
- [Segment diagnostics](https://github.com/fatfatma/novashop-business-analysis/tree/main/05_Data_Analysis): `05_Data_Analysis`

### Diagnosis & Insights

- [Root-cause analysis](https://github.com/fatfatma/novashop-business-analysis/tree/main/06_Root_Cause_Analysis): `06_Root_Cause_Analysis`
- [Recommendations](https://github.com/fatfatma/novashop-business-analysis/blob/main/05_Data_Analysis/09_recommendations.py): `05_Data_Analysis/09_recommendations.py`
- [KPI dashboard](https://github.com/fatfatma/novashop-business-analysis/blob/main/07_Dashboard/dashboard/index.html): `07_Dashboard/dashboard/index.html`
- [AI opportunity assessment](https://github.com/fatfatma/novashop-business-analysis/tree/main/08_AI_Solution): `08_AI_Solution`

### Solution Design

- [Solution design](https://github.com/fatfatma/novashop-business-analysis/tree/main/09_Solution_Design): `09_Solution_Design`

### Monitoring & Validation

- [Testing & UAT](https://github.com/fatfatma/novashop-business-analysis/tree/main/10_Testing): `10_Testing`
- [Final project report](https://github.com/fatfatma/novashop-business-analysis/tree/main/11_Project_Documentation): `11_Project_Documentation`

### Other components

- **Business stakeholders**

## Connections

- Business stakeholders → Problem & scope: frame problem
- Problem & scope → Stakeholder analysis: identify stakeholders
- Stakeholder analysis → Requirements: inform requirements
- Requirements → Process analysis: define change
- Dataset generation → V4 raw data: generates dataset
- V4 raw data → KPI validation & EDA: read data
- V4 raw data → Conversion & funnel: read data
- V4 raw data → Funnel analysis: read data
- V4 raw data → Segment diagnostics: read data
- KPI validation & EDA → Root-cause analysis: inform diagnosis
- Conversion & funnel → Root-cause analysis: inform diagnosis
- Funnel analysis → Root-cause analysis: inform diagnosis
- Segment diagnostics → Root-cause analysis: inform diagnosis
- Root-cause analysis → Recommendations: guide actions
- Recommendations → Solution design: inform design
- AI opportunity assessment → Solution design: inform design
- KPI validation & EDA → KPI dashboard: supports KPIs
- Solution design → Testing & UAT: define validation
- Solution design → Final project report: summarize proposal
- Testing & UAT → Final project report: report outcomes