Student Loan Payoff & Major ROI Calculator

A Streamlit app that models the real financial outcome of a major/loan choice: standard vs. income-driven repayment, take-home pay after real 2024 federal/state taxes, cost-of-living by city, and a 10-year ROI comparison against a debt-free high school graduate. Built as a summer portfolio project with a companion research paper on how this kind of tool influences student decision-making — the app also logs anonymous usage and collects an in-app survey toward that end.

Salary data comes from real BLS OEWS occupation wage percentiles (not guesses), taxes use real 2024 IRS/state brackets, and cost of living uses BEA Regional Price Parities. Medicine, Law, and Athletic Training model the actual multi-year delay (med/law school, residency) before professional earnings begin, instead of pretending a 4-year degree leads straight into a doctor's or lawyer's salary. Full sourcing is in the app's "Methodology & Sources" section at the bottom of the page.

For how the whole system is put together — hosting topology, data pipelines, the financial model's flow, and the research telemetry — see ARCHITECTURE.md.

Setup

Requires Python 3.9+.

git clone https://github.com/OneVVish/StudentLoanROI.git
cd StudentLoanROI
python3 -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Run

streamlit run app.py

This opens the app at http://localhost:8501 in your browser.

Optional: College Scorecard API key

The sidebar's "College Scorecard Lookup" pulls real tuition/debt figures for the school you enter. It works out of the box with the public DEMO_KEY (rate-limited). For regular use, get a free key at api.data.gov/signup and paste it into the sidebar field.

Data storage (Supabase)

Usage/survey logging is backed by a Supabase Postgres database instead of local files, since Streamlit Community Cloud's filesystem is ephemeral — local CSVs would silently get wiped on every sleep/restart, which defeats the point of collecting this data for the companion research paper.

To run the app yourself, you need your own free Supabase project:

1. Sign up at supabase.com (GitHub login works) and create a new project (free tier).

2. In the project's SQL Editor, run the schema below. Five tables: usage_logs (one row per pageview/event), survey_responses (one row per feedback submission), pdf_downloads (one per PDF report), scenario_shares (one per "Share Scenario" click), and scenario_events (one per distinct major/school a visitor tries, so the path through the app is recoverable and not just the destination). The last four all store the same simulation-context columns — Scenario A's inputs and results, Scenario B's when Compare Mode is on at save-time, and a column per optional Advanced Analysis module — so a response can be analyzed against the exact scenario that produced it.

   Every table also carries a session_id: a random per-visit UUID shared by every row one browser session writes, so events can be joined across tables (e.g. "did this survey response come from someone who had just downloaded a PDF?"). It's still anonymous — nothing is derived from the visitor, and a refresh starts a new id.

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗