How hashmil-muhammed/fundlens-mutual_fund_analytics works
Bluestock is a mutual-fund analytics and business-intelligence platform. Its principal workflow takes public and supplied fund data through ingestion, cleaning and database loading, then produces exploratory, performance and risk analysis for dashboards and investor-facing outputs. The Streamlit app reads analytical data for interactive exploration; separate scripts provide recommendations, portfolio optimization, forecasting and email reporting. README-described notebook and Power BI capabilities are included, but their internal wiring is not inferred where source excerpts were unavailable.
Main entry points: bluestock_mf.db Analytics Database · reports Analysis Reports · raw Source Datasets · streamlit_app.py Interactive App
Components 19
Data Ingestion
- Source Datasets
data/raw - Live NAV Fetch
scripts/live_nav_fetch.py - Data Cleaning
notebooks/02_data_cleaning.ipynb - Analytics Database
data/db/bluestock_mf.db - Pipeline Runner
run_pipeline.py
Analytics
- Exploratory Analysis
notebooks/03_EDA_Analysis.ipynb - Performance Analytics
notebooks/04_Performance_Analytics.ipynb - Advanced Risk Analysis
notebooks/05_Advanced_Analytics.ipynb - Analysis Reports
reports
Dashboards
- Interactive App
streamlit_app.py - Power BI Dashboard
dashboard/bluestock_mf_dashboard.pbix
Investor Tools
- Fund Recommender
scripts/recommender.py - Portfolio Optimizer
scripts/portfolio_optimization.py - Monte Carlo Forecast
scripts/monte_carlo.py - Report Scheduler
scripts/scheduler.py - Email Report
scripts/send_email_report.py
Other components
- Investor
- Analyst
- AMFI / mfapi.in
Connections 26
- Analyst → Pipeline Runner: runs pipeline
run_pipeline.py - Pipeline Runner → Live NAV Fetch: runs fetch
run_pipeline.py - Live NAV Fetch → AMFI / mfapi.in: fetches NAV
README.md - Analyst → Source Datasets: supplies datasets
README.md - Source Datasets → Data Cleaning: cleaned by
README.md - Data Cleaning → Analytics Database: loads tables
README.md - Analytics Database → Exploratory Analysis: analyzed in
README.md - Analytics Database → Performance Analytics: metrics from
README.md - Analytics Database → Advanced Risk Analysis: risk data from
README.md - Exploratory Analysis → Analysis Reports: produces insights
README.md - Performance Analytics → Analysis Reports: produces metrics
README.md - Advanced Risk Analysis → Analysis Reports: exports analyses
README.md - Investor → Interactive App: explores funds
README.md - Interactive App → Analytics Database: reads NAV data
streamlit_app.py - Interactive App → Source Datasets: fallback reads
streamlit_app.py - Analyst → Power BI Dashboard: views dashboard
README.md - Investor → Fund Recommender: requests recommendations
scripts/recommender.py - Fund Recommender → Source Datasets: reads fund master
scripts/recommender.py - Fund Recommender → Analysis Reports: reads scorecard
scripts/recommender.py - Portfolio Optimizer → Analytics Database: reads NAV
scripts/portfolio_optimization.py - Portfolio Optimizer → Analysis Reports: saves frontier
scripts/portfolio_optimization.py - Monte Carlo Forecast → Analytics Database: reads NAV
scripts/monte_carlo.py - Monte Carlo Forecast → Analysis Reports: saves forecast
scripts/monte_carlo.py - Report Scheduler → Email Report: schedules reports
- Email Report → Analytics Database: queries NAV
scripts/send_email_report.py - Email Report → Investor: sends summary
scripts/send_email_report.py