formaComp Runway Model

This repository contains a Streamlit-based financial runway model for behavioral health practices. The app models a 36-month horizon with staffing, patient KPIs, billing lag, and cash flow logic.

Features

• Mobile-friendly Streamlit UI with tabs (Overview, Staffing, Patients, Assumptions) and KPI tiles.
• Editable monthly staffing (BT, Mid-Tier, BCBA) and patient KPIs (new patients, churn) with validation and persistence to data/runway_state.json.
• Demand, capacity, utilization, billed hours, revenue, payroll with taxes/benefits, overhead, capital injections, billing lag handling, and cash balance tracking (including lagged cash beyond month 36).
• Additional outputs: role-level utilization, role margins, cumulative burn chart, and role allocation documentation in code.
• Lightweight pytest sanity checks covering billing lag cash collection, churn bounds, scheduled payroll, and role metrics.

Running the app

1. Install dependencies: pip install -r requirements.txt.
2. Launch Streamlit: streamlit run runway_app.py.
3. Adjust staffing/patient assumptions in the UI; inputs are saved locally for subsequent sessions.

Testing

Run sanity tests with:

python -m pytest

Contributing

Feel free to open issues or submit pull requests with improvements or bug fixes.