# zico-hubb/company_analytics architecture

> Architecture diagram of the GitHub repository zico-hubb/company_analytics, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/zico-hubb/company_analytics
- Repository: https://github.com/zico-hubb/company_analytics

## Overview

Company Analytics Platform is a Streamlit application for uploading CSV/XLSX data, optionally cleaning it, selecting an analysis phase, and viewing or exporting results. The documented phases map to distinct analytics modules; the sampled app directly invokes cleaning, descriptive, correlation, outlier, and reporting functions. Financial calculations and forecasting are implemented and imported, but the sampled app contains placeholders rather than calls to them. The graph reflects those evidence limits; no persistent data store is shown.

Main entry points: [`app.py`](https://github.com/zico-hubb/company_analytics/blob/main/app.py) (Streamlit workflow), [`modules/cleaning.py`](https://github.com/zico-hubb/company_analytics/blob/main/modules/cleaning.py) (Data cleaning), [`modules/descriptive.py`](https://github.com/zico-hubb/company_analytics/blob/main/modules/descriptive.py) (Descriptive statistics), [`modules/inferential.py`](https://github.com/zico-hubb/company_analytics/blob/main/modules/inferential.py) (Inferential statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application Entry"]
  node_app["Streamlit workflow<br/>[app.py]"]
end

subgraph group_preparation["Data Preparation"]
  node_cleaning["Data cleaning<br/>[cleaning.py]"]
end

subgraph group_analytics["Analytics"]
  node_descriptive["Descriptive statistics<br/>[descriptive.py]"]
  node_inferential["Inferential statistics<br/>[inferential.py]"]
  node_financial["Financial calculators<br/>[financial.py]"]
  node_forecasting["Forecasting<br/>[forecasting.py]"]
  node_operational["Operational analytics<br/>[operational.py]"]
end

subgraph group_outputs["Reporting"]
  node_reporting["Excel reporting<br/>[reporting.py]"]
end

node_user(("Business user"))

node_user -->|"uploads and selects"| node_app
node_app -->|"calls cleaning"| node_cleaning
node_app -->|"calls statistics"| node_descriptive
node_app -->|"calls correlation"| node_inferential
node_app -->|"calls outlier detection"| node_operational
node_app -->|"generates report"| node_reporting
node_app -->|"imports"| node_financial
node_app -->|"imports"| node_forecasting

click node_app "https://github.com/zico-hubb/company_analytics/blob/main/app.py"
click node_cleaning "https://github.com/zico-hubb/company_analytics/blob/main/modules/cleaning.py"
click node_descriptive "https://github.com/zico-hubb/company_analytics/blob/main/modules/descriptive.py"
click node_inferential "https://github.com/zico-hubb/company_analytics/blob/main/modules/inferential.py"
click node_financial "https://github.com/zico-hubb/company_analytics/blob/main/modules/financial.py"
click node_forecasting "https://github.com/zico-hubb/company_analytics/blob/main/modules/forecasting.py"
click node_operational "https://github.com/zico-hubb/company_analytics/blob/main/modules/operational.py"
click node_reporting "https://github.com/zico-hubb/company_analytics/blob/main/modules/reporting.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_app,node_user toneBlue
class node_cleaning toneAmber
class node_descriptive,node_inferential,node_financial,node_forecasting,node_operational toneMint
class node_reporting toneRose
```

## Components

### Application Entry

- [Streamlit workflow](https://github.com/zico-hubb/company_analytics/blob/main/app.py): `app.py`

### Data Preparation

- [Data cleaning](https://github.com/zico-hubb/company_analytics/blob/main/modules/cleaning.py): `modules/cleaning.py`

### Analytics

- [Descriptive statistics](https://github.com/zico-hubb/company_analytics/blob/main/modules/descriptive.py): `modules/descriptive.py`
- [Inferential statistics](https://github.com/zico-hubb/company_analytics/blob/main/modules/inferential.py): `modules/inferential.py`
- [Financial calculators](https://github.com/zico-hubb/company_analytics/blob/main/modules/financial.py): `modules/financial.py`
- [Forecasting](https://github.com/zico-hubb/company_analytics/blob/main/modules/forecasting.py): `modules/forecasting.py`
- [Operational analytics](https://github.com/zico-hubb/company_analytics/blob/main/modules/operational.py): `modules/operational.py`

### Reporting

- [Excel reporting](https://github.com/zico-hubb/company_analytics/blob/main/modules/reporting.py): `modules/reporting.py`

### Other components

- **Business user**

## Connections

- Business user → Streamlit workflow: uploads and selects (evidence: `README.md`)
- Streamlit workflow → Data cleaning: calls cleaning (evidence: `app.py`)
- Streamlit workflow → Descriptive statistics: calls statistics (evidence: `app.py`)
- Streamlit workflow → Inferential statistics: calls correlation (evidence: `app.py`)
- Streamlit workflow → Operational analytics: calls outlier detection (evidence: `app.py`)
- Streamlit workflow → Excel reporting: generates report (evidence: `app.py`)
- Streamlit workflow → Financial calculators: imports (evidence: `app.py`)
- Streamlit workflow → Forecasting: imports (evidence: `app.py`)
