# yashjsri-hue/ai-powered-financial-health-budget-recommendation-system architecture

> Architecture diagram of the GitHub repository yashjsri-hue/ai-powered-financial-health-budget-recommendation-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system
- Repository: https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system

## Overview

This is a personal-finance analysis and recommendation app: financial data is prepared and analyzed, classified for financial health, then used to produce prioritized, scored recommendations that users explore in a Streamlit dashboard. The README documents the generation pipeline, but its stated generator module is absent from the supplied tree and its source was not sampled; those pipeline components are represented without invented paths. The dashboard source confirms it reads the recommendation CSV and provides filtering, analysis, display, and export features.

Main entry points: [`financial_recommendation_dashboard.py`](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py) (Streamlit dashboard), [`financial_recommendations_v2.csv`](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendations_v2.csv) (Recommendations CSV), [`processed_personal_finance_dataset.csv`](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/processed_personal_finance_dataset.csv) (Processed finance data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pipeline["Finance Pipeline"]
  node_analysis["Financial indicators"]
  node_health["Health prediction"]
  node_recommendations["Recommendation engine"]
end

subgraph group_dashboard["Dashboard"]
  node_dashboard_app["Streamlit dashboard"]
  node_filters["Interactive filters"]
  node_overview["KPIs and charts"]
  node_case_views["Priority and advice views"]
  node_export["Filtered CSV download"]
end

subgraph group_data["CSV Data"]
  node_processed_data[("Processed finance data")]
  node_recommendation_data[("Recommendations CSV")]
  node_analysis_report[("Analysis report CSV")]
end

node_user(("Dashboard user"))

node_processed_data -->|"analyzed as"| node_analysis
node_analysis -->|"indicators inform"| node_health
node_health -->|"health informs"| node_recommendations
node_recommendations -->|"writes"| node_recommendation_data
node_recommendation_data -->|"loads"| node_dashboard_app
node_user -->|"opens"| node_dashboard_app
node_dashboard_app -->|"offers"| node_filters
node_dashboard_app -->|"renders"| node_overview
node_dashboard_app -->|"renders"| node_case_views
node_dashboard_app -->|"provides"| node_export
node_filters -->|"filters data for"| node_overview
node_filters -->|"filters data for"| node_case_views
node_filters -->|"filters data for"| node_export

click node_processed_data "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/processed_personal_finance_dataset.csv"
click node_recommendation_data "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendations_v2.csv"
click node_dashboard_app "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py"
click node_filters "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py"
click node_overview "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py"
click node_case_views "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py"
click node_export "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py"
click node_analysis_report "https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_analysis_report.csv"

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_analysis,node_health,node_recommendations,node_user toneBlue
class node_dashboard_app,node_filters,node_overview,node_case_views,node_export toneAmber
class node_processed_data,node_recommendation_data,node_analysis_report toneMint
```

## Components

### Finance Pipeline

- **Financial indicators**
- **Health prediction**
- **Recommendation engine**

### Dashboard

- [Streamlit dashboard](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py): `financial_recommendation_dashboard.py`
- [Interactive filters](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py): `financial_recommendation_dashboard.py`
- [KPIs and charts](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py): `financial_recommendation_dashboard.py`
- [Priority and advice views](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py): `financial_recommendation_dashboard.py`
- [Filtered CSV download](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendation_dashboard.py): `financial_recommendation_dashboard.py`

### CSV Data

- [Processed finance data](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/processed_personal_finance_dataset.csv): `processed_personal_finance_dataset.csv`
- [Recommendations CSV](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_recommendations_v2.csv): `financial_recommendations_v2.csv`
- [Analysis report CSV](https://github.com/yashjsri-hue/ai-powered-financial-health-budget-recommendation-system/blob/main/financial_analysis_report.csv): `financial_analysis_report.csv`

### Other components

- **Dashboard user**

## Connections

- Processed finance data → Financial indicators: analyzed as
- Financial indicators → Health prediction: indicators inform
- Health prediction → Recommendation engine: health informs
- Recommendation engine → Recommendations CSV: writes
- Recommendations CSV → Streamlit dashboard: loads
- Dashboard user → Streamlit dashboard: opens
- Streamlit dashboard → Interactive filters: offers
- Streamlit dashboard → KPIs and charts: renders
- Streamlit dashboard → Priority and advice views: renders
- Streamlit dashboard → Filtered CSV download: provides
- Interactive filters → KPIs and charts: filters data for
- Interactive filters → Priority and advice views: filters data for
- Interactive filters → Filtered CSV download: filters data for