How rugved0014/buyer-segmentation-and-investment-profiling- works
This is a real-estate buyer segmentation and investment-profiling project. Its main workflow cleans client and property records, engineers transaction behavior, clusters and labels buyers, then presents segment and client-level insights in a filterable Streamlit dashboard. The README also describes model validation and exploratory analysis. Pipeline and dashboard excerpts support the main stages; dashboard loading details are partly omitted, so the graph shows only the documented artifact-to-dashboard relationship.
Main entry points: streamlit_app.py Streamlit Dashboard · 02_clustering.py Feature Scaling · clients_clustered.csv Labeled Clients · 01_clean_and_engineer.py Clean and Engineer
Components 18
Data Preparation
- Client Records
- Property Records
- Clean and Engineer
01_clean_and_engineer.py - Client Features
data/client_features.csv
Segmentation Analysis
- Feature Scaling
02_clustering.py - Cluster Validation
02_clustering.py - K-Means Segments
02_clustering.py - Segment Profiles
outputs/cluster_profile.csv - Labeled Clients
data/clients_clustered.csv - Model Summary
outputs/clustering_summary.txt - Exploratory Analysis
03_eda_extra.py
Buyer Insights
- Streamlit Dashboard
streamlit_app.py - Segment Overview
streamlit_app.py - Behavior Analysis
streamlit_app.py - Geographic Analysis
streamlit_app.py - Segment Playbooks
streamlit_app.py - Client Explorer
streamlit_app.py
Other components
- Analyst
Connections 18
- Analyst → Streamlit Dashboard: opens
- Client Records → Clean and Engineer: reads
- Property Records → Clean and Engineer: reads
- Clean and Engineer → Client Features: writes
- Client Features → Feature Scaling: reads
- Feature Scaling → Cluster Validation: evaluates
- Feature Scaling → K-Means Segments: clusters
- Cluster Validation → Model Summary: writes
- K-Means Segments → Labeled Clients: labels
- K-Means Segments → Segment Profiles: summarizes
- Labeled Clients → Exploratory Analysis: reads
- Labeled Clients → Streamlit Dashboard: loads
- Segment Profiles → Streamlit Dashboard: loads
- Streamlit Dashboard → Segment Overview: renders
- Streamlit Dashboard → Behavior Analysis: renders
- Streamlit Dashboard → Geographic Analysis: renders
- Streamlit Dashboard → Segment Playbooks: renders
- Streamlit Dashboard → Client Explorer: renders